Source

វង់

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

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

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

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

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

ជាចុងក្រោយ ប្រសិនបើអ្នកកំពុងបង្កើត JavaScript របស់យើងពីប្រភព វា ទាមទារutil.js .

ឧទាហរណ៍

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

ត្រូវប្រាកដថាកំណត់លេខសម្គាល់ពិសេសមួយ .carouselសម្រាប់ការគ្រប់គ្រងជាជម្រើស ជាពិសេសប្រសិនបើអ្នកកំពុងប្រើរង្វង់មូលច្រើននៅលើទំព័រតែមួយ។

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

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

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

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

ការបន្ថែមនៅក្នុងការគ្រប់គ្រងពីមុន និងបន្ទាប់៖

<div id="carouselExampleControls" class="carousel slide" data-ride="carousel">
  <div class="carousel-inner">
    <div class="carousel-item active">
      <img class="d-block w-100" src="..." alt="First slide">
    </div>
    <div class="carousel-item">
      <img class="d-block w-100" src="..." alt="Second slide">
    </div>
    <div class="carousel-item">
      <img class="d-block w-100" src="..." alt="Third slide">
    </div>
  </div>
  <a class="carousel-control-prev" href="#carouselExampleControls" role="button" data-slide="prev">
    <span class="carousel-control-prev-icon" aria-hidden="true"></span>
    <span class="sr-only">Previous</span>
  </a>
  <a class="carousel-control-next" href="#carouselExampleControls" role="button" data-slide="next">
    <span class="carousel-control-next-icon" aria-hidden="true"></span>
    <span class="sr-only">Next</span>
  </a>
</div>

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

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

<div id="carouselExampleIndicators" class="carousel slide" data-ride="carousel">
  <ol class="carousel-indicators">
    <li data-target="#carouselExampleIndicators" data-slide-to="0" class="active"></li>
    <li data-target="#carouselExampleIndicators" data-slide-to="1"></li>
    <li data-target="#carouselExampleIndicators" data-slide-to="2"></li>
  </ol>
  <div class="carousel-inner">
    <div class="carousel-item active">
      <img class="d-block w-100" src="..." alt="First slide">
    </div>
    <div class="carousel-item">
      <img class="d-block w-100" src="..." alt="Second slide">
    </div>
    <div class="carousel-item">
      <img class="d-block w-100" src="..." alt="Third slide">
    </div>
  </div>
  <a class="carousel-control-prev" href="#carouselExampleIndicators" role="button" data-slide="prev">
    <span class="carousel-control-prev-icon" aria-hidden="true"></span>
    <span class="sr-only">Previous</span>
  </a>
  <a class="carousel-control-next" href="#carouselExampleIndicators" role="button" data-slide="next">
    <span class="carousel-control-next-icon" aria-hidden="true"></span>
    <span class="sr-only">Next</span>
  </a>
</div>
ត្រូវការធាតុសកម្មដំបូង

ថ្នាក់ .activeត្រូវបន្ថែមទៅស្លាយមួយ។ បើមិនដូច្នេះទេ រង្វង់មូលនឹងមិនអាចមើលឃើញទេ។

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

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

<div class="carousel-item">
  <img src="..." alt="...">
  <div class="carousel-caption d-none d-md-block">
    <h5>...</h5>
    <p>...</p>
  </div>
</div>

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

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

Use data attributes to easily control the position of the carousel. data-slide accepts the keywords prev or next, which alters the slide position relative to its current position. Alternatively, use data-slide-to to pass a raw slide index to the carousel data-slide-to="2", which shifts the slide position to a particular index beginning with 0.

The data-ride="carousel" attribute is used to mark a carousel as animating starting at page load. It cannot be used in combination with (redundant and unnecessary) explicit JavaScript initialization of the same carousel.

Via JavaScript

Call carousel manually with:

$('.carousel').carousel()

Options

Options can be passed via data attributes or JavaScript. For data attributes, append the option name to data-, as in data-interval="".

Name Type Default Description
interval number 5000 The amount of time to delay between automatically cycling an item. If false, carousel will not automatically cycle.
keyboard boolean true Whether the carousel should react to keyboard events.
pause string | boolean "hover"

If set to "hover", pauses the cycling of the carousel on mouseenter and resumes the cycling of the carousel on mouseleave. If set to false, hovering over the carousel won't pause it.

On touch-enabled devices, when set to "hover", cycling will pause on touchend (once the user finished interacting with the carousel) for two intervals, before automatically resuming. Note that this is in addition to the above mouse behavior.

ride string false Autoplays the carousel after the user manually cycles the first item. If "carousel", autoplays the carousel on load.
wrap boolean true Whether the carousel should cycle continuously or have hard stops.

Methods

Asynchronous methods and transitions

All API methods are asynchronous and start a transition. They return to the caller as soon as the transition is started but before it ends. In addition, a method call on a transitioning component will be ignored.

See our JavaScript documentation for more information.

.carousel(options)

Initializes the carousel with an optional options object and starts cycling through items.

$('.carousel').carousel({
  interval: 2000
})

.carousel('cycle')

Cycles through the carousel items from left to right.

.carousel('pause')

Stops the carousel from cycling through items.

.carousel(number)

Cycles the carousel to a particular frame (0 based, similar to an array). Returns to the caller before the target item has been shown (i.e. before the slid.bs.carousel event occurs).

.carousel('prev')

Cycles to the previous item. Returns to the caller before the previous item has been shown (i.e. before the slid.bs.carousel event occurs).

.carousel('next')

Cycles to the next item. Returns to the caller before the next item has been shown (i.e. before the slid.bs.carousel event occurs).

.carousel('dispose')

Destroys an element’s carousel.

Events

Bootstrap’s carousel class exposes two events for hooking into carousel functionality. Both events have the following additional properties:

  • direction: The direction in which the carousel is sliding (either "left" or "right").
  • relatedTarget៖ ធាតុ DOM ដែលកំពុងត្រូវបានដាក់បញ្ចូលជាធាតុសកម្ម។
  • from៖ លិបិក្រមនៃធាតុបច្ចុប្បន្ន
  • to៖ លិបិក្រមនៃធាតុបន្ទាប់

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

ប្រភេទព្រឹត្តិការណ៍ ការពិពណ៌នា
slide.bs.carousel ព្រឹត្តិការណ៍នេះឆេះភ្លាមៗ នៅពេលដែល slideវិធីសាស្ត្រ instance ត្រូវបានហៅ។
slid.bs.carousel ព្រឹត្តិការណ៍​នេះ​ត្រូវ​បាន​បញ្ឈប់​នៅ​ពេល​ដែល​រង្វង់​បាន​បញ្ចប់​ការ​ផ្លាស់​ប្តូរ​ស្លាយ​របស់​ខ្លួន។
$('#myCarousel').on('slide.bs.carousel', function () {
  // do something…
})