វង់
សមាសធាតុបញ្ចាំងស្លាយសម្រាប់ការជិះកង់តាមធាតុ—រូបភាព ឬស្លាយនៃអត្ថបទ—ដូចជារង្វង់មូល។
របៀបដែលវាដំណើរការ
រង្វង់មូលគឺជាការបញ្ចាំងស្លាយសម្រាប់ជិះកង់តាមរយៈខ្លឹមសារជាបន្តបន្ទាប់ ដែលបង្កើតឡើងជាមួយនឹងការបំប្លែង CSS 3D និង JavaScript បន្តិច។ វាដំណើរការជាមួយស៊េរីរូបភាព អត្ថបទ ឬការសម្គាល់ផ្ទាល់ខ្លួន។ វាក៏រួមបញ្ចូលការគាំទ្រសម្រាប់ការត្រួតពិនិត្យពីមុន/បន្ទាប់ និងសូចនាករផងដែរ។
នៅក្នុងកម្មវិធីរុករកតាមអ៊ីនធឺណិតដែល API លទ្ធភាពមើលឃើញទំព័រ ត្រូវបានគាំទ្រ រង្វង់នឹងជៀសវាងការរអិលនៅពេលដែលគេហទំព័រមិនអាចមើលឃើញដោយអ្នកប្រើប្រាស់ (ដូចជានៅពេលដែលផ្ទាំងកម្មវិធីរុករកមិនដំណើរការ បង្អួចកម្មវិធីរុករកត្រូវបានបង្រួមអប្បបរមា។ល។)។
prefers-reduced-motion
សំណួរមេឌៀ។ សូមមើល
ផ្នែកចលនាដែលបានកាត់បន្ថយនៃឯកសារភាពងាយស្រួលរបស់យើង ។
សូមដឹងថា រង្វង់មូលមិនត្រូវបានគាំទ្រទេ ហើយរង្វង់មូលមិនត្រូវបានអនុលោមតាមស្តង់ដារលទ្ធភាពប្រើប្រាស់ទេ។
ឧទាហរណ៍
Carousels មិនធ្វើឱ្យទំហំស្លាយធម្មតាដោយស្វ័យប្រវត្តិទេ។ ដូចនេះ អ្នកប្រហែលជាត្រូវប្រើឧបករណ៍ប្រើប្រាស់បន្ថែម ឬរចនាប័ទ្មផ្ទាល់ខ្លួន ដើម្បីទំហំមាតិកាសមស្រប។ ខណៈពេលដែល carousels គាំទ្រការគ្រប់គ្រង និងសូចនាករពីមុន/បន្ទាប់ ពួកវាមិនត្រូវបានទាមទារច្បាស់លាស់ទេ។ បន្ថែម និងប្ដូរតាមបំណងតាមដែលអ្នកឃើញសម។
ថ្នាក់ .active
ត្រូវបន្ថែមទៅស្លាយមួយ បើមិនដូច្នេះទេ រង្វង់នឹងមើលមិនឃើញទេ។ ត្រូវប្រាកដថាកំណត់លក្ខណៈពិសេសតែមួយគត់ សម្រាប់ការគ្រប់គ្រង id
ជា .carousel
ជម្រើស ជាពិសេសប្រសិនបើអ្នកកំពុងប្រើរង្វង់មូលច្រើននៅលើទំព័រតែមួយ។ ធាតុត្រួតពិនិត្យ និងសូចនាករត្រូវតែមាន data-bs-target
គុណលក្ខណៈ (ឬ href
សម្រាប់តំណភ្ជាប់) ដែលផ្គូផ្គង ធាតុ id
នៃ .carousel
ធាតុ។
ស្លាយតែប៉ុណ្ណោះ
នេះជារង្វង់មូលដែលមានស្លាយប៉ុណ្ណោះ។ ចំណាំវត្តមានរបស់រូបភាព .d-block
និង .w-100
នៅលើរង្វង់មូល ដើម្បីការពារការតម្រឹមរូបភាពលំនាំដើមរបស់កម្មវិធីរុករកតាមអ៊ីនធឺណិត។
<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"
.
<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>
ជាមួយនឹងសូចនាករ
អ្នកក៏អាចបន្ថែមសូចនាករទៅរង្វង់មូល រួមជាមួយនឹងវត្ថុបញ្ជាផងដែរ។
<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
.
<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-item
s សម្រាប់ការកាត់ឱ្យបានត្រឹមត្រូវ។
<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>
.carousel-item
ចន្លោះពេល បុគ្គល
បន្ថែម data-bs-interval=""
ទៅ a .carousel-item
ដើម្បីផ្លាស់ប្តូរចំនួនពេលវេលាដើម្បីពន្យាពេលរវាងការជិះកង់ដោយស្វ័យប្រវត្តិទៅធាតុបន្ទាប់។
<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
គុណលក្ខណៈដែរ ដូច្នេះវាមិនលេងដោយស្វ័យប្រវត្តិទេ។
<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
.
<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
ទទួលយកពាក្យគន្លឹះ prev
ឬ next
ដែលផ្លាស់ប្តូរទីតាំងស្លាយទាក់ទងទៅនឹងទីតាំងបច្ចុប្បន្នរបស់វា។ ម៉្យាងទៀត ប្រើ 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 ទាំងអស់គឺ អសមកាល ហើយចាប់ផ្តើមការ ផ្លាស់ប្តូរ ។ ពួកគេត្រឡប់ទៅអ្នកហៅចូលវិញភ្លាមៗ នៅពេលដែលការផ្លាស់ប្តូរត្រូវបានចាប់ផ្តើម ប៉ុន្តែ មុនពេលវាបញ្ចប់ ។ លើសពីនេះទៀត ការហៅតាមវិធីសាស្ត្រលើ សមាសភាគអន្តរកាលនឹងត្រូវបានមិនអើពើ ។
អ្នកអាចបង្កើតឧទាហរណ៍រង្វង់មូលមួយជាមួយអ្នកបង្កើតរង្វង់មូល ជាឧទាហរណ៍ ដើម្បីចាប់ផ្ដើមជាមួយជម្រើសបន្ថែម ហើយចាប់ផ្ដើមជិះកង់តាមធាតុ៖
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...
})