រំលងទៅមាតិកាសំខាន់ រំលងទៅការរុករកឯកសារ
Check
in English

វង់

សមាសធាតុ​បញ្ចាំងស្លាយ​សម្រាប់​ការ​ជិះកង់​តាម​ធាតុ—រូបភាព ឬ​ស្លាយ​នៃ​អត្ថបទ—ដូចជា​រង្វង់មូល។

របៀបដែលវាដំណើរការ

រង្វង់មូលគឺជាការបញ្ចាំងស្លាយសម្រាប់ជិះកង់តាមរយៈខ្លឹមសារជាបន្តបន្ទាប់ ដែលបង្កើតឡើងជាមួយនឹងការបំប្លែង CSS 3D និង JavaScript បន្តិច។ វាដំណើរការជាមួយស៊េរីរូបភាព អត្ថបទ ឬការសម្គាល់ផ្ទាល់ខ្លួន។ វាក៏រួមបញ្ចូលការគាំទ្រសម្រាប់ការត្រួតពិនិត្យពីមុន/បន្ទាប់ និងសូចនាករផងដែរ។

នៅក្នុងកម្មវិធីរុករកតាមអ៊ីនធឺណិតដែល API លទ្ធភាពមើលឃើញទំព័រ ត្រូវបានគាំទ្រ រង្វង់នឹងជៀសវាងការរអិលនៅពេលដែលគេហទំព័រមិនអាចមើលឃើញដោយអ្នកប្រើប្រាស់ (ដូចជានៅពេលដែលផ្ទាំងកម្មវិធីរុករកមិនដំណើរការ បង្អួចកម្មវិធីរុករកត្រូវបានបង្រួមអប្បបរមា។ល។)។

ឥទ្ធិពលចលនានៃសមាសភាគនេះគឺអាស្រ័យលើ prefers-reduced-motionសំណួរមេឌៀ។ សូមមើល ផ្នែកចលនាដែលបានកាត់បន្ថយនៃឯកសារភាពងាយស្រួលរបស់យើង

សូម​ដឹង​ថា រង្វង់មូល​មិន​ត្រូវ​បាន​គាំទ្រ​ទេ ហើយ​រង្វង់​មូល​មិន​ត្រូវ​បាន​អនុលោម​តាម​ស្តង់ដារ​លទ្ធភាព​ប្រើប្រាស់​ទេ។

ឧទាហរណ៍

Carousels មិនធ្វើឱ្យទំហំស្លាយធម្មតាដោយស្វ័យប្រវត្តិទេ។ ដូចនេះ អ្នកប្រហែលជាត្រូវប្រើឧបករណ៍ប្រើប្រាស់បន្ថែម ឬរចនាប័ទ្មផ្ទាល់ខ្លួន ដើម្បីទំហំមាតិកាសមស្រប។ ខណៈពេលដែល carousels គាំទ្រការគ្រប់គ្រង និងសូចនាករពីមុន/បន្ទាប់ ពួកវាមិនត្រូវបានទាមទារច្បាស់លាស់ទេ។ បន្ថែម និងប្ដូរតាមបំណងតាមដែលអ្នកឃើញសម។

ថ្នាក់ .activeត្រូវបន្ថែមទៅស្លាយមួយ បើមិនដូច្នេះទេ រង្វង់នឹងមើលមិនឃើញទេ។ ត្រូវប្រាកដថាកំណត់លក្ខណៈពិសេសតែមួយគត់ សម្រាប់ការគ្រប់គ្រង idជា .carouselជម្រើស ជាពិសេសប្រសិនបើអ្នកកំពុងប្រើរង្វង់មូលច្រើននៅលើទំព័រតែមួយ។ ធាតុត្រួតពិនិត្យ និងសូចនាករត្រូវតែមាន data-bs-targetគុណលក្ខណៈ (ឬ hrefសម្រាប់តំណភ្ជាប់) ដែលផ្គូផ្គង ធាតុ idនៃ .carouselធាតុ។

ស្លាយតែប៉ុណ្ណោះ

នេះ​ជា​រង្វង់​មូល​ដែល​មាន​ស្លាយ​ប៉ុណ្ណោះ។ ចំណាំវត្តមានរបស់រូបភាព .d-blockនិង .w-100នៅលើរង្វង់មូល ដើម្បីការពារការតម្រឹមរូបភាពលំនាំដើមរបស់កម្មវិធីរុករកតាមអ៊ីនធឺណិត។

html
<div id="carouselExampleSlidesOnly" class="carousel slide" data-bs-ride="carousel">
  <div class="carousel-inner">
    <div class="carousel-item active">
      <img src="..." class="d-block w-100" alt="...">
    </div>
    <div class="carousel-item">
      <img src="..." class="d-block w-100" alt="...">
    </div>
    <div class="carousel-item">
      <img src="..." class="d-block w-100" alt="...">
    </div>
  </div>
</div>

ជាមួយនឹងការគ្រប់គ្រង

ការបន្ថែមនៅក្នុងការគ្រប់គ្រងពីមុន និងបន្ទាប់។ យើងសូមណែនាំឱ្យប្រើ <button>ធាតុ ប៉ុន្តែអ្នកក៏អាចប្រើ <a>ធាតុជាមួយ role="button".

html
<div id="carouselExampleControls" class="carousel slide" data-bs-ride="carousel">
  <div class="carousel-inner">
    <div class="carousel-item active">
      <img src="..." class="d-block w-100" alt="...">
    </div>
    <div class="carousel-item">
      <img src="..." class="d-block w-100" alt="...">
    </div>
    <div class="carousel-item">
      <img src="..." class="d-block w-100" alt="...">
    </div>
  </div>
  <button class="carousel-control-prev" type="button" data-bs-target="#carouselExampleControls" data-bs-slide="prev">
    <span class="carousel-control-prev-icon" aria-hidden="true"></span>
    <span class="visually-hidden">Previous</span>
  </button>
  <button class="carousel-control-next" type="button" data-bs-target="#carouselExampleControls" data-bs-slide="next">
    <span class="carousel-control-next-icon" aria-hidden="true"></span>
    <span class="visually-hidden">Next</span>
  </button>
</div>

ជាមួយនឹងសូចនាករ

អ្នកក៏អាចបន្ថែមសូចនាករទៅរង្វង់មូល រួមជាមួយនឹងវត្ថុបញ្ជាផងដែរ។

html
<div id="carouselExampleIndicators" class="carousel slide" data-bs-ride="true">
  <div class="carousel-indicators">
    <button type="button" data-bs-target="#carouselExampleIndicators" data-bs-slide-to="0" class="active" aria-current="true" aria-label="Slide 1"></button>
    <button type="button" data-bs-target="#carouselExampleIndicators" data-bs-slide-to="1" aria-label="Slide 2"></button>
    <button type="button" data-bs-target="#carouselExampleIndicators" data-bs-slide-to="2" aria-label="Slide 3"></button>
  </div>
  <div class="carousel-inner">
    <div class="carousel-item active">
      <img src="..." class="d-block w-100" alt="...">
    </div>
    <div class="carousel-item">
      <img src="..." class="d-block w-100" alt="...">
    </div>
    <div class="carousel-item">
      <img src="..." class="d-block w-100" alt="...">
    </div>
  </div>
  <button class="carousel-control-prev" type="button" data-bs-target="#carouselExampleIndicators" data-bs-slide="prev">
    <span class="carousel-control-prev-icon" aria-hidden="true"></span>
    <span class="visually-hidden">Previous</span>
  </button>
  <button class="carousel-control-next" type="button" data-bs-target="#carouselExampleIndicators" data-bs-slide="next">
    <span class="carousel-control-next-icon" aria-hidden="true"></span>
    <span class="visually-hidden">Next</span>
  </button>
</div>

ជាមួយនឹងចំណងជើង

បន្ថែមចំណងជើងទៅស្លាយរបស់អ្នកយ៉ាងងាយស្រួលជាមួយនឹង .carousel-captionធាតុនៅក្នុងណាមួយ .carousel-item។ ពួកវាអាចលាក់បានយ៉ាងងាយស្រួលនៅលើច្រកចូលមើលតូចៗ ដូចបានបង្ហាញខាងក្រោម ជាមួយនឹង ឧបករណ៍ប្រើប្រាស់បង្ហាញ ស្រេចចិត្ត ។ យើង​លាក់​ពួកវា​ពីដំបូង​ជាមួយ .d-noneនិង​នាំ​ពួកគេ​មកវិញ​នៅលើ​ឧបករណ៍​ទំហំ​មធ្យម​ជាមួយ .d-md-block.

html
<div id="carouselExampleCaptions" class="carousel slide" data-bs-ride="false">
  <div class="carousel-indicators">
    <button type="button" data-bs-target="#carouselExampleCaptions" data-bs-slide-to="0" class="active" aria-current="true" aria-label="Slide 1"></button>
    <button type="button" data-bs-target="#carouselExampleCaptions" data-bs-slide-to="1" aria-label="Slide 2"></button>
    <button type="button" data-bs-target="#carouselExampleCaptions" data-bs-slide-to="2" aria-label="Slide 3"></button>
  </div>
  <div class="carousel-inner">
    <div class="carousel-item active">
      <img src="..." class="d-block w-100" alt="...">
      <div class="carousel-caption d-none d-md-block">
        <h5>First slide label</h5>
        <p>Some representative placeholder content for the first slide.</p>
      </div>
    </div>
    <div class="carousel-item">
      <img src="..." class="d-block w-100" alt="...">
      <div class="carousel-caption d-none d-md-block">
        <h5>Second slide label</h5>
        <p>Some representative placeholder content for the second slide.</p>
      </div>
    </div>
    <div class="carousel-item">
      <img src="..." class="d-block w-100" alt="...">
      <div class="carousel-caption d-none d-md-block">
        <h5>Third slide label</h5>
        <p>Some representative placeholder content for the third slide.</p>
      </div>
    </div>
  </div>
  <button class="carousel-control-prev" type="button" data-bs-target="#carouselExampleCaptions" data-bs-slide="prev">
    <span class="carousel-control-prev-icon" aria-hidden="true"></span>
    <span class="visually-hidden">Previous</span>
  </button>
  <button class="carousel-control-next" type="button" data-bs-target="#carouselExampleCaptions" data-bs-slide="next">
    <span class="carousel-control-next-icon" aria-hidden="true"></span>
    <span class="visually-hidden">Next</span>
  </button>
</div>

ខ្វែង

បន្ថែម .carousel-fade​ទៅ​រង្វង់​មូល​របស់​អ្នក​ដើម្បី​ធ្វើ​ឱ្យ​ស្លាយ​មាន​ចលនា​ជាមួយ​នឹង​ការ​ផ្លាស់​ប្តូរ​បន្ថយ​ជា​ជាង​ស្លាយ។ អាស្រ័យ​លើ​ខ្លឹមសារ​រង្វង់​មូល​របស់​អ្នក (ឧ. អត្ថបទ​សម្រាប់​តែ​ស្លាយ) អ្នក​ប្រហែល​ជា​ចង់​បន្ថែម .bg-bodyឬ CSS ផ្ទាល់ខ្លួន​ខ្លះ​ទៅ .carousel-items សម្រាប់​ការ​កាត់​ឱ្យ​បាន​ត្រឹមត្រូវ។

html
<div id="carouselExampleFade" class="carousel slide carousel-fade" data-bs-ride="carousel">
  <div class="carousel-inner">
    <div class="carousel-item active">
      <img src="..." class="d-block w-100" alt="...">
    </div>
    <div class="carousel-item">
      <img src="..." class="d-block w-100" alt="...">
    </div>
    <div class="carousel-item">
      <img src="..." class="d-block w-100" alt="...">
    </div>
  </div>
  <button class="carousel-control-prev" type="button" data-bs-target="#carouselExampleFade" data-bs-slide="prev">
    <span class="carousel-control-prev-icon" aria-hidden="true"></span>
    <span class="visually-hidden">Previous</span>
  </button>
  <button class="carousel-control-next" type="button" data-bs-target="#carouselExampleFade" data-bs-slide="next">
    <span class="carousel-control-next-icon" aria-hidden="true"></span>
    <span class="visually-hidden">Next</span>
  </button>
</div>

បន្ថែម data-bs-interval=""ទៅ a .carousel-itemដើម្បីផ្លាស់ប្តូរចំនួនពេលវេលាដើម្បីពន្យាពេលរវាងការជិះកង់ដោយស្វ័យប្រវត្តិទៅធាតុបន្ទាប់។

html
<div id="carouselExampleInterval" class="carousel slide" data-bs-ride="carousel">
  <div class="carousel-inner">
    <div class="carousel-item active" data-bs-interval="10000">
      <img src="..." class="d-block w-100" alt="...">
    </div>
    <div class="carousel-item" data-bs-interval="2000">
      <img src="..." class="d-block w-100" alt="...">
    </div>
    <div class="carousel-item">
      <img src="..." class="d-block w-100" alt="...">
    </div>
  </div>
  <button class="carousel-control-prev" type="button" data-bs-target="#carouselExampleInterval" data-bs-slide="prev">
    <span class="carousel-control-prev-icon" aria-hidden="true"></span>
    <span class="visually-hidden">Previous</span>
  </button>
  <button class="carousel-control-next" type="button" data-bs-target="#carouselExampleInterval" data-bs-slide="next">
    <span class="carousel-control-next-icon" aria-hidden="true"></span>
    <span class="visually-hidden">Next</span>
  </button>
</div>

បិទការអូសដោយប៉ះ

Carousels គាំទ្រការអូសទៅឆ្វេង/ស្តាំនៅលើឧបករណ៍ touchscreen ដើម្បីផ្លាស់ទីរវាងស្លាយ។ វាអាចត្រូវបានបិទដោយប្រើ data-bs-touchគុណលក្ខណៈ។ ឧទាហរណ៍ខាងក្រោមក៏មិនរួមបញ្ចូល data-bs-rideគុណលក្ខណៈដែរ ដូច្នេះវាមិនលេងដោយស្វ័យប្រវត្តិទេ។

html
<div id="carouselExampleControlsNoTouching" class="carousel slide" data-bs-touch="false">
  <div class="carousel-inner">
    <div class="carousel-item active">
      <img src="..." class="d-block w-100" alt="...">
    </div>
    <div class="carousel-item">
      <img src="..." class="d-block w-100" alt="...">
    </div>
    <div class="carousel-item">
      <img src="..." class="d-block w-100" alt="...">
    </div>
  </div>
  <button class="carousel-control-prev" type="button" data-bs-target="#carouselExampleControlsNoTouching" data-bs-slide="prev">
    <span class="carousel-control-prev-icon" aria-hidden="true"></span>
    <span class="visually-hidden">Previous</span>
  </button>
  <button class="carousel-control-next" type="button" data-bs-target="#carouselExampleControlsNoTouching" data-bs-slide="next">
    <span class="carousel-control-next-icon" aria-hidden="true"></span>
    <span class="visually-hidden">Next</span>
  </button>
</div>

វ៉ារ្យ៉ង់ងងឹត

បន្ថែម .carousel-darkទៅ .carouselវត្ថុបញ្ជា សូចនាករ និងចំណងជើងដែលកាន់តែងងឹត។ ការគ្រប់គ្រងត្រូវបានដាក់បញ្ច្រាសពីការបំពេញពណ៌សលំនាំដើមរបស់ពួកគេជាមួយនឹង filterលក្ខណៈសម្បត្តិ CSS ។ ចំណងជើង និងការគ្រប់គ្រងមានអថេរ Sass បន្ថែម ដែលកំណត់ colorនិង background-color.

html
<div id="carouselExampleDark" class="carousel carousel-dark slide" data-bs-ride="carousel">
  <div class="carousel-indicators">
    <button type="button" data-bs-target="#carouselExampleDark" data-bs-slide-to="0" class="active" aria-current="true" aria-label="Slide 1"></button>
    <button type="button" data-bs-target="#carouselExampleDark" data-bs-slide-to="1" aria-label="Slide 2"></button>
    <button type="button" data-bs-target="#carouselExampleDark" data-bs-slide-to="2" aria-label="Slide 3"></button>
  </div>
  <div class="carousel-inner">
    <div class="carousel-item active" data-bs-interval="10000">
      <img src="..." class="d-block w-100" alt="...">
      <div class="carousel-caption d-none d-md-block">
        <h5>First slide label</h5>
        <p>Some representative placeholder content for the first slide.</p>
      </div>
    </div>
    <div class="carousel-item" data-bs-interval="2000">
      <img src="..." class="d-block w-100" alt="...">
      <div class="carousel-caption d-none d-md-block">
        <h5>Second slide label</h5>
        <p>Some representative placeholder content for the second slide.</p>
      </div>
    </div>
    <div class="carousel-item">
      <img src="..." class="d-block w-100" alt="...">
      <div class="carousel-caption d-none d-md-block">
        <h5>Third slide label</h5>
        <p>Some representative placeholder content for the third slide.</p>
      </div>
    </div>
  </div>
  <button class="carousel-control-prev" type="button" data-bs-target="#carouselExampleDark" data-bs-slide="prev">
    <span class="carousel-control-prev-icon" aria-hidden="true"></span>
    <span class="visually-hidden">Previous</span>
  </button>
  <button class="carousel-control-next" type="button" data-bs-target="#carouselExampleDark" data-bs-slide="next">
    <span class="carousel-control-next-icon" aria-hidden="true"></span>
    <span class="visually-hidden">Next</span>
  </button>
</div>

ការផ្លាស់ប្តូរផ្ទាល់ខ្លួន

រយៈពេលនៃការផ្លាស់ប្តូរ .carousel-itemអាចត្រូវបានផ្លាស់ប្តូរជាមួយនឹង $carousel-transition-durationអថេរ Sass មុនពេលចងក្រង ឬរចនាប័ទ្មផ្ទាល់ខ្លួន ប្រសិនបើអ្នកកំពុងប្រើ CSS ដែលបានចងក្រង។ ប្រសិនបើការផ្លាស់ប្តូរច្រើនត្រូវបានអនុវត្ត ត្រូវប្រាកដថាការផ្លាស់ប្តូរការផ្លាស់ប្តូរត្រូវបានកំណត់ជាមុនសិន (ឧ transition: transform 2s ease, opacity .5s ease-out)។

សាស

អថេរ

អថេរសម្រាប់រង្វង់មូលទាំងអស់៖

$carousel-control-color:             $white;
$carousel-control-width:             15%;
$carousel-control-opacity:           .5;
$carousel-control-hover-opacity:     .9;
$carousel-control-transition:        opacity .15s ease;

$carousel-indicator-width:           30px;
$carousel-indicator-height:          3px;
$carousel-indicator-hit-area-height: 10px;
$carousel-indicator-spacer:          3px;
$carousel-indicator-opacity:         .5;
$carousel-indicator-active-bg:       $white;
$carousel-indicator-active-opacity:  1;
$carousel-indicator-transition:      opacity .6s ease;

$carousel-caption-width:             70%;
$carousel-caption-color:             $white;
$carousel-caption-padding-y:         1.25rem;
$carousel-caption-spacer:            1.25rem;

$carousel-control-icon-width:        2rem;

$carousel-control-prev-icon-bg:      url("data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='#{$carousel-control-color}'><path d='M11.354 1.646a.5.5 0 0 1 0 .708L5.707 8l5.647 5.646a.5.5 0 0 1-.708.708l-6-6a.5.5 0 0 1 0-.708l6-6a.5.5 0 0 1 .708 0z'/></svg>");
$carousel-control-next-icon-bg:      url("data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='#{$carousel-control-color}'><path d='M4.646 1.646a.5.5 0 0 1 .708 0l6 6a.5.5 0 0 1 0 .708l-6 6a.5.5 0 0 1-.708-.708L10.293 8 4.646 2.354a.5.5 0 0 1 0-.708z'/></svg>");

$carousel-transition-duration:       .6s;
$carousel-transition:                transform $carousel-transition-duration ease-in-out; // Define transform transition first if using multiple transitions (e.g., `transform 2s ease, opacity .5s ease-out`)

អថេរសម្រាប់ រង្វង់ងងឹត

$carousel-dark-indicator-active-bg:  $black;
$carousel-dark-caption-color:        $black;
$carousel-dark-control-icon-filter:  invert(1) grayscale(100);

ការប្រើប្រាស់

តាមរយៈគុណលក្ខណៈទិន្នន័យ

ប្រើគុណលក្ខណៈទិន្នន័យ ដើម្បីងាយស្រួលគ្រប់គ្រងទីតាំងរបស់រង្វង់មូល។ data-bs-slideទទួលយកពាក្យគន្លឹះ prevnextដែលផ្លាស់ប្តូរទីតាំងស្លាយទាក់ទងទៅនឹងទីតាំងបច្ចុប្បន្នរបស់វា។ ម៉្យាងទៀត ប្រើ data-bs-slide-toដើម្បីបញ្ជូនសន្ទស្សន៍ស្លាយឆៅទៅរង្វង់មូល data-bs-slide-to="2"ដែលផ្លាស់ប្តូរទីតាំងស្លាយទៅសន្ទស្សន៍ជាក់លាក់ដែលចាប់ផ្តើមដោយ 0.

គុណលក្ខណៈ data-bs-ride="carousel"​ត្រូវ​បាន​ប្រើ​ដើម្បី​សម្គាល់​រង្វង់​មូល​ថា​ជា​ចលនា​ចាប់​ផ្តើម​នៅ​ពេល​ផ្ទុក​ទំព័រ។ ប្រសិនបើអ្នកមិនប្រើ data-bs-ride="carousel"ដើម្បីចាប់ផ្តើមរង្វង់របស់អ្នកទេ អ្នកត្រូវតែចាប់ផ្តើមវាដោយខ្លួនឯង។ វាមិនអាចប្រើរួមជាមួយនឹង (លែងត្រូវការតទៅទៀត និងមិនចាំបាច់) ការចាប់ផ្តើម JavaScript ច្បាស់លាស់នៃរង្វង់មូលដូចគ្នា។

តាមរយៈ JavaScript

ហៅទូរសព្ទទៅរង្វង់ដោយដៃដោយប្រើ៖

const carousel = new bootstrap.Carousel('#myCarousel')

ជម្រើស

ដោយសារជម្រើសអាចត្រូវបានឆ្លងកាត់តាមគុណលក្ខណៈទិន្នន័យ ឬ JavaScript អ្នកអាចបន្ថែមឈ្មោះជម្រើសទៅ data-bs-ដូចក្នុង data-bs-animation="{value}". ត្រូវប្រាកដថាផ្លាស់ប្តូរប្រភេទករណីនៃឈ្មោះជម្រើសពី " camelCase " ទៅ " kebab-case " នៅពេលឆ្លងកាត់ជម្រើសតាមរយៈគុណលក្ខណៈទិន្នន័យ។ ឧទាហរណ៍ ប្រើ data-bs-custom-class="beautifier"ជំនួស data-bs-customClass="beautifier".

ចាប់ពី Bootstrap 5.2.0 សមាសធាតុទាំងអស់គាំទ្រ គុណលក្ខណៈទិន្នន័យដែលបានបម្រុងទុក ដោយពិសោធន៍data-bs-config ដែលអាចដាក់ការកំណត់រចនាសម្ព័ន្ធសមាសធាតុសាមញ្ញជាខ្សែអក្សរ JSON ។ នៅពេលដែលធាតុមាន data-bs-config='{"delay":0, "title":123}'និង data-bs-title="456"គុណលក្ខណៈ តម្លៃចុងក្រោយ titleនឹងជា 456ហើយគុណលក្ខណៈទិន្នន័យដាច់ដោយឡែកនឹងបដិសេធតម្លៃដែលបានផ្តល់ឱ្យនៅលើ data-bs-config. លើសពីនេះ គុណលក្ខណៈទិន្នន័យដែលមានស្រាប់អាចដាក់តម្លៃ JSON ដូចជា data-bs-delay='{"show":0,"hide":150}'.

ឈ្មោះ ប្រភេទ លំនាំដើម ការពិពណ៌នា
interval ចំនួន 5000 ចំនួនពេលវេលាដើម្បីពន្យាពេលរវាងការជិះកង់ដោយស្វ័យប្រវត្តិនូវវត្ថុមួយ។
keyboard ប៊ូលីន true ថាតើរង្វង់គួរមានប្រតិកម្មចំពោះព្រឹត្តិការណ៍ក្តារចុចដែរឬទេ។
pause ខ្សែអក្សរ, ប៊ូលីន "hover" ប្រសិនបើ​កំណត់​ទៅ "hover"ផ្អាក​ការ​ជិះ​កង់​នៃ​រង្វង់​មូល​នៅលើ mouseenterហើយ​បន្ត​ការ​ជិះ​កង់​របស់​រង្វង់​មូល​នៅលើ mouseleave. ប្រសិនបើ​កំណត់​ទៅ ការ false​ដាក់​លើ​រង្វង់​មូល​នឹង​មិន​ផ្អាក​វា​ទេ។ នៅលើឧបករណ៍ដែលបើកការប៉ះ នៅពេលកំណត់ទៅ "hover"ការជិះកង់នឹងផ្អាកនៅលើ touchend(នៅពេលអ្នកប្រើប្រាស់បានបញ្ចប់អន្តរកម្មជាមួយរង្វង់) សម្រាប់ចន្លោះពេលពីរ មុនពេលបន្តដោយស្វ័យប្រវត្តិ។ នេះបន្ថែមពីលើឥរិយាបថកណ្តុរ។
ride ខ្សែអក្សរ, ប៊ូលីន false ប្រសិនបើ​កំណត់​ទៅ trueនោះ​នឹង​លេង​រង្វង់​ដោយ​ស្វ័យ​ប្រវត្តិ​បន្ទាប់​ពី​អ្នក​ប្រើ​បង្វិល​ធាតុ​ដំបូង​ដោយ​ដៃ។ ប្រសិនបើ​កំណត់​ទៅ "carousel"នោះ​នឹង​លេង​រង្វង់​ដោយស្វ័យប្រវត្តិ​នៅពេល​ផ្ទុក។
touch ប៊ូលីន true ថាតើរង្វង់មូលគួរគាំទ្រអន្តរកម្មអូសទៅឆ្វេង/ស្តាំនៅលើឧបករណ៍អេក្រង់ប៉ះឬអត់។
wrap ប៊ូលីន true ថាតើរង្វង់មូលគួរធ្វើចលនាបន្ត ឬមានការឈប់ពិបាក។

វិធីសាស្រ្ត

វិធីសាស្រ្ត និងការផ្លាស់ប្តូរអសមកាល

វិធីសាស្រ្ត API ទាំងអស់គឺ អសមកាល ហើយចាប់ផ្តើមការ ផ្លាស់ប្តូរ ។ ពួកគេត្រឡប់ទៅអ្នកហៅចូលវិញភ្លាមៗ នៅពេលដែលការផ្លាស់ប្តូរត្រូវបានចាប់ផ្តើម ប៉ុន្តែ មុនពេលវាបញ្ចប់ ។ លើស​ពី​នេះ​ទៀត ការ​ហៅ​តាម​វិធី​សាស្ត្រ​លើ ​សមាសភាគ​អន្តរកាល​នឹង​ត្រូវ​បាន​មិន​អើពើ

សូមមើលឯកសារ JavaScript របស់យើងសម្រាប់ព័ត៌មានបន្ថែម

អ្នក​អាច​បង្កើត​ឧទាហរណ៍​រង្វង់​មូល​មួយ​ជាមួយ​អ្នក​បង្កើត​រង្វង់​មូល ជា​ឧទាហរណ៍ ដើម្បី​ចាប់ផ្ដើម​ជាមួយ​ជម្រើស​បន្ថែម ហើយ​ចាប់​ផ្ដើម​ជិះ​កង់​តាម​ធាតុ៖

const myCarouselElement = document.querySelector('#myCarousel')
const carousel = new bootstrap.Carousel(myCarouselElement, {
  interval: 2000,
  wrap: false
})
វិធីសាស្រ្ត ការពិពណ៌នា
cycle ធ្វើរង្វង់តាមធាតុរង្វង់ពីឆ្វេងទៅស្តាំ។
dispose បំផ្លាញរង្វង់នៃធាតុមួយ។ (លុបទិន្នន័យដែលបានរក្សាទុកនៅលើធាតុ DOM)
getInstance វិធីសាស្ត្រឋិតិវន្តដែលអនុញ្ញាតឱ្យអ្នកទទួលបានឧទាហរណ៍រង្វង់ដែលភ្ជាប់ជាមួយធាតុ DOM អ្នកអាចប្រើវាដូចនេះ៖ bootstrap.Carousel.getInstance(element).
getOrCreateInstance វិធីសាស្ត្រឋិតិវន្តដែលផ្តល់លទ្ធផលវត្ថុរាងជារង្វង់ដែលពាក់ព័ន្ធទៅនឹងធាតុ DOM ឬបង្កើតថ្មីមួយ ក្នុងករណីដែលវាមិនត្រូវបានចាប់ផ្តើម។ អ្នកអាចប្រើវាដូចនេះ៖ bootstrap.Carousel.getOrCreateInstance(element).
next រង្វង់ទៅធាតុបន្ទាប់។ ត្រឡប់ទៅអ្នកហៅទូរស័ព្ទវិញ មុនពេលដែលធាតុបន្ទាប់ត្រូវបានបង្ហាញ (ឧទាហរណ៍ មុនពេល slid.bs.carouselព្រឹត្តិការណ៍កើតឡើង)។
nextWhenVisible កុំបង្វិលរង្វង់ទៅបន្ទាប់ នៅពេលដែលទំព័រមើលមិនឃើញ ឬរង្វង់មូល ឬមេរបស់វាមើលមិនឃើញ។ ត្រឡប់ទៅអ្នកហៅទូរស័ព្ទវិញ មុនពេលធាតុគោលដៅត្រូវបានបង្ហាញ
pause បញ្ឈប់​រង្វង់​មូល​មិន​ឱ្យ​ជិះ​កង់​កាត់​វត្ថុ។
prev រង្វង់ទៅធាតុមុន។ ត្រឡប់ទៅអ្នកហៅទូរស័ព្ទវិញ មុនពេលដែលធាតុមុនត្រូវបានបង្ហាញ (ឧ slid.bs.carousel.
to បង្វិល​រង្វង់​ទៅ​ស៊ុម​ជាក់លាក់​មួយ (ដោយ​ផ្អែក 0 ស្រដៀង​នឹង​អារេ​មួយ)។ ត្រឡប់ទៅកាន់អ្នកហៅទូរសព្ទ មុនពេលធាតុគោលដៅត្រូវបានបង្ហាញ (ឧ. មុនពេល slid.bs.carouselព្រឹត្តិការណ៍កើតឡើង)។

ព្រឹត្តិការណ៍

ថ្នាក់ carousel របស់ Bootstrap លាតត្រដាងព្រឹត្តិការណ៍ចំនួនពីរសម្រាប់ភ្ជាប់មុខងារ carousel ។ ព្រឹត្តិការណ៍ទាំងពីរមានលក្ខណៈសម្បត្តិបន្ថែមដូចខាងក្រោមៈ

  • direction៖ ទិស​ដែល​រង្វង់​មូល​កំពុង​រអិល ( "left""right")។
  • relatedTarget៖ ធាតុ DOM ដែលកំពុងត្រូវបានដាក់បញ្ចូលជាធាតុសកម្ម។
  • from៖ លិបិក្រមនៃធាតុបច្ចុប្បន្ន
  • to៖ លិបិក្រមនៃធាតុបន្ទាប់

ព្រឹត្តិការណ៍ carousel ទាំងអស់ត្រូវបានបាញ់នៅ carousel ខ្លួនវា (ឧទាហរណ៍នៅ <div class="carousel">) ។

ប្រភេទព្រឹត្តិការណ៍ ការពិពណ៌នា
slid.bs.carousel បាន​បាញ់​នៅ​ពេល​ដែល​រង្វង់​បាន​បញ្ចប់​ការ​ផ្លាស់​ប្តូរ​ស្លាយ​របស់​ខ្លួន។
slide.bs.carousel ឆេះភ្លាមៗនៅពេលដែល slideវិធីសាស្ត្រ instance ត្រូវបានហៅ។
const myCarousel = document.getElementById('myCarousel')

myCarousel.addEventListener('slide.bs.carousel', event => {
  // do something...
})