Carousel

ئېلېمېنتلار ئارقىلىق ۋېلىسىپىت مىنىشنىڭ تام تەسۋىر زاپچاسلىرى - رەسىم ياكى تېكىست تام تەسۋىرلىرى كارۇسېلغا ئوخشاش.

قانداق ئىشلەيدۇ

كارۇسېل ۋېلىسىپىت مىنىشنىڭ بىر يۈرۈش مەزمۇنلىرى بولۇپ ، CSS 3D ئۆزگەرتىش ۋە بىر ئاز JavaScript بىلەن ياسالغان. ئۇ بىر يۈرۈش رەسىم ، تېكىست ياكى ئىختىيارى بەلگە بىلەن ئىشلەيدۇ. ئۇ يەنە ئىلگىرىكى / كېيىنكى كونترول ۋە كۆرسەتكۈچلەرنى قوللاشنى ئۆز ئىچىگە ئالىدۇ.

Page Visibility API قوللايدىغان توركۆرگۈچلەردە ، تور بەت ئىشلەتكۈچىگە كۆرۈنمىگەندە كارۇسېل سىيرىلىپ كېتىشتىن ساقلىنىدۇ (مەسىلەن توركۆرگۈچ بەتكۈچى ئاكتىپلانمىغان ۋاقىتتا ، توركۆرگۈچ كۆزنىكى كىچىكلىتىلىدۇ).

بۇ زاپچاسنىڭ كارتون ئۈنۈمى prefers-reduced-motionمېدىيا سوئالىغا باغلىق. قولايلىق ھۆججەتلىرىمىزنىڭ قىسقارتىلغان ھەرىكەت بۆلىكىنى كۆرۈڭ .

شۇنىڭغا دىققەت قىلىڭكى ، ئۇۋىسى كارۇسېلنى قوللىمايدۇ ، كارۇسېل ئادەتتە ئىشلىتىش ئۆلچىمىگە ماس كەلمەيدۇ.

ئاخىرىدا ، ئەگەر سىز JavaScript نى مەنبەدىن قۇرغان بولسىڭىز ، ئۇ تەلەپ قىلىدۇutil.js .

مىسال

كارۇسېل تام تەسۋىرنى ئاپتوماتىك نورماللاشتۇرمايدۇ. بۇنداق بولغاندا ، مەزمۇننى مۇۋاپىق چوڭايتىش ئۈچۈن قوشۇمچە ئىقتىدار ياكى ئىختىيارى ئۇسلۇبلارنى ئىشلىتىشىڭىز مۇمكىن. كارۇسېل ئالدىنقى / كېيىنكى كونترول ۋە كۆرسەتكۈچلەرنى قوللىسىمۇ ، ئېنىق تەلەپ قىلىنمايدۇ. ئۆزىڭىز خالىغانچە قوشۇڭ ۋە خاسلاشتۇرۇڭ.

سىنىپنى بىر تام .activeتەسۋىرگە قوشۇش كېرەك ، بولمىسا كارۇسېل كۆرۈنمەيدۇ. ئىختىيارى كونترول قىلىش ئۈچۈن ئۆزگىچە ID ئورنىتىشقا كاپالەتلىك قىلىڭ .carousel، بولۇپمۇ بىر بەتتە كۆپ كارۇسېل ئىشلىتىۋاتقان بولسىڭىز. كونترول ۋە كۆرسەتكۈچ ئېلېمېنتلىرىنىڭ ئېلېمېنتنىڭ id غا ماس كېلىدىغان data-targetخاسلىقى (ياكى hrefئۇلىنىش ئۈچۈن) بولۇشى كېرەك .carousel.

پەقەت تام تەسۋىر

بۇ يەردە پەقەت تام تەسۋىر بار كارۇسېل بار. .d-blockۋە كارۇسېل رەسىملىرىنىڭ بارلىقىغا دىققەت قىلىڭ ، .w-100توركۆرگۈنىڭ سۈكۈتتىكى رەسىمنىڭ توغرىلىنىشىنىڭ ئالدىنى ئالىدۇ.

<div id="carouselExampleSlidesOnly" class="carousel slide" data-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>

كونترول بىلەن

ئالدىنقى ۋە كېيىنكى كونتروللارغا قوشۇش:

<div id="carouselExampleControls" class="carousel slide" data-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>
  <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 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>
  <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>

ئىزاھلار بىلەن

.carousel-captionتام تەسۋىرگە خالىغان مەزمۇننى ئاسانلا قوشۇڭ .carousel-item. ئىختىيارىي كۆرسىتىش قوراللىرى بىلەن تۆۋەندە كۆرسىتىلگەندەك كىچىك كۆرۈنۈشلەرگە ئاسانلا يوشۇرۇنغىلى بولىدۇ . بىز دەسلەپتە ئۇلارنى يوشۇرۇپ .d-none، ئوتتۇرا تىپتىكى ئۈسكۈنىلەرگە قايتۇرىمىز .d-md-block.

بىرىنچى تام تەسۋىر بەلگىسى

Nulla vitae elit libero, a pharetra augue mollis interdum.

ئىككىنچى تام تەسۋىر بەلگىسى

Lorem ipsum dolor amet ، كونسېرۋاتىپلىق ماسلاشتۇرغۇچى سەرخىل.

ئۈچىنچى تام تەسۋىر بەلگىسى

مەدھىيىلەنگەن تاۋار كۇرس ماگنا ، vel scelerisque nisl consectetur.

<div id="carouselExampleCaptions" class="carousel slide" data-ride="carousel">
  <ol class="carousel-indicators">
    <li data-target="#carouselExampleCaptions" data-slide-to="0" class="active"></li>
    <li data-target="#carouselExampleCaptions" data-slide-to="1"></li>
    <li data-target="#carouselExampleCaptions" data-slide-to="2"></li>
  </ol>
  <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>Nulla vitae elit libero, a pharetra augue mollis interdum.</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>Lorem ipsum dolor sit amet, consectetur adipiscing elit.</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>Praesent commodo cursus magna, vel scelerisque nisl consectetur.</p>
      </div>
    </div>
  </div>
  <a class="carousel-control-prev" href="#carouselExampleCaptions" 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="#carouselExampleCaptions" role="button" data-slide="next">
    <span class="carousel-control-next-icon" aria-hidden="true"></span>
    <span class="sr-only">Next</span>
  </a>
</div>

Crossfade

كاروسېلغا .carousel-fadeتام تەسۋىرنىڭ ئورنىغا سۇس ئۆتكۈنچى ھالەتتە جانلاندۇرۇڭ.

<div id="carouselExampleFade" class="carousel slide carousel-fade" data-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>
  <a class="carousel-control-prev" href="#carouselExampleFade" 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="#carouselExampleFade" role="button" data-slide="next">
    <span class="carousel-control-next-icon" aria-hidden="true"></span>
    <span class="sr-only">Next</span>
  </a>
</div>

يەككە `.carousel-item`ئارىلىق

ئاپتوماتىك ۋېلىسىپىت مىنىشنىڭ كېيىنكى تۈرگە كېچىكتۈرۈش ۋاقتىنى ئۆزگەرتىش data-interval=""ئۈچۈن a غا قوشۇڭ ..carousel-item

<div id="carouselExampleInterval" class="carousel slide" data-ride="carousel">
  <div class="carousel-inner">
    <div class="carousel-item active" data-interval="10000">
      <img src="..." class="d-block w-100" alt="...">
    </div>
    <div class="carousel-item" data-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>
  <a class="carousel-control-prev" href="#carouselExampleInterval" 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="#carouselExampleInterval" role="button" data-slide="next">
    <span class="carousel-control-next-icon" aria-hidden="true"></span>
    <span class="sr-only">Next</span>
  </a>
</div>

ئىشلىتىش

سانلىق مەلۇمات خاسلىقى ئارقىلىق

سانلىق مەلۇمات خاسلىقىنى ئىشلىتىپ كارۇسېلنىڭ ئورنىنى ئاسانلا كونترول قىلىڭ. data-slideئاچقۇچلۇق سۆزلەرنى قوبۇل قىلىدۇ prevياكى nextتام تەسۋىر ئورنىنى ھازىرقى ئورنىغا ئۆزگەرتىدۇ. ئۇنىڭدىن باشقا ، data-slide-toخام تام تەسۋىر كۆرسەتكۈچىنى كارۇسېلغا يەتكۈزۈش ئۈچۈن ئىشلىتىڭ data-slide-to="2"، بۇ تام تەسۋىر ئورنىنى باشلىنىشتىن باشلاپ مەلۇم كۆرسەتكۈچكە يۆتكەيدۇ 0.

بۇ data-ride="carousel"خاسلىق كارۇسېلنى بەت يۈكىدىن باشلاپ جانلاندۇرۇش دەپ بەلگە قىلىشقا ئىشلىتىلىدۇ. data-ride="carousel"ئەگەر كارولىڭىزنى دەسلەپكى قەدەمدە ئىشلەتمىسىڭىز ، ئۇنى ئۆزىڭىز باشلىشىڭىز كېرەك. ئۇنى ئوخشاش كارۇسېلنىڭ (ئارتۇقچە ۋە ھاجەتسىز) ئېنىق JavaScript دەسلەپكى قەدەمدە بىرلەشتۈرۈپ ئىشلىتىشكە بولمايدۇ.

JavaScript ئارقىلىق

كارۇسېل بىلەن قولدا تېلېفون قىلىڭ:

$('.carousel').carousel()

تاللانما

تاللانمىلارنى سانلىق مەلۇمات خاسلىقى ياكى JavaScript ئارقىلىق يەتكۈزگىلى بولىدۇ. سانلىق مەلۇمات خاسلىقى ئۈچۈن ، تاللاش نامىغا data-ئوخشاش data-interval="".

ئىسمى	تىپ	سۈكۈتتىكى	چۈشەندۈرۈش
ئارىلىق	سان	5000	بىر نەرسىنى ئاپتوماتىك ۋېلىسىپىت مىنىشنىڭ كېچىكىش ۋاقتى. ئەگەر يالغان بولسا ، كارۇسېل ئاپتوماتىك ئايلىنالمايدۇ.
كۇنۇپكا تاختىسى	boolean	true	كارۇسېل كۇنۇپكا تاختىسىدىكى ھادىسىلەرگە ئىنكاس قايتۇرامدۇ يوق.
توختاپ	string \| boolean	"hover"	تەڭشەلسە `"hover"`، كارۇسېلنىڭ ۋېلىسىپىت مىنىشنى توختىتىدۇ `mouseenter`ۋە كارۇسېلنىڭ ۋېلىسىپىت مىنىشنى ئەسلىگە كەلتۈرىدۇ `mouseleave`. تەڭشەلسە `false`، كارۇسېل ئۈستىدە لەيلەپ توختاپ قالمايدۇ. سېزىمچان ئۈسكۈنىلەردە تەڭشەلگەندە `"hover"`، ۋېلىسىپىت مىنىش `touchend`(ئىشلەتكۈچى كارۇسېل بىلەن ئۆز-ئارا تەسىرنى تۈگەتكەندىن كېيىن) ئىككى قېتىم توختاپ ، ئاپتوماتىك ئەسلىگە كېلىدۇ. شۇنىڭغا دىققەت قىلىڭكى ، بۇ يۇقىرىدىكى مائۇس ھەرىكىتىدىن باشقا.
ride	string	false	ئىشلەتكۈچى بىرىنچى تۈرنى قولدا ئايلاندۇرغاندىن كېيىن كارۇسېلنى ئاپتوماتىك كۆرسىتىدۇ. ئەگەر «كارۇسېل» بولسا ، كارۇسېلنى يۈككە ئاپتوماتىك ھەيدەيدۇ.
wrap	boolean	true	كارۇسېل ئۇدا ئايلىنىشى كېرەكمۇ ياكى قاتتىق توختاپ قېلىش كېرەكمۇ.
touch	boolean	true	كارۇسېل سېزىمچان ئېكران ئۈسكۈنىلىرىدە سول / ئوڭ سۈرتۈش ئۆز-ئارا تەسىر كۆرسىتىشنى قوللامدۇ يوق.

Methods

ماس قەدەمسىز ئۇسۇل ۋە ئۆتكۈنچى

بارلىق API ئۇسۇللىرى ماس قەدەمسىز بولۇپ ، ئۆتكۈنچى باسقۇچنى باشلايدۇ . ئۇلار بۇرۇلۇش باشلانغان ھامان ، ئۇ ئاخىرلاشماي تۇرۇپلا تېلېفون قىلغۇچىغا قايتىپ كېلىدۇ . بۇنىڭدىن باشقا ، ئۆتكۈنچى زاپچاسنى چاقىرىش ئۇسۇلىغا سەل قارىلىدۇ .

تېخىمۇ كۆپ ئۇچۇرغا ئېرىشىش ئۈچۈن JavaScript ھۆججىتىمىزنى كۆرۈڭ .

`.carousel(options)`

كارۇسېلنى ئىختىيارى تاللاش objectبىلەن باشلايدۇ ۋە تۈرلەر ئارقىلىق ۋېلىسىپىت مىنىشكە باشلايدۇ.

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

`.carousel('cycle')`

سولدىن ئوڭغا كارۇسېل بۇيۇملىرى ئارقىلىق ۋېلىسىپىت.

`.carousel('pause')`

كارۇسېلنى بۇيۇملار ئارقىلىق ۋېلىسىپىت مىنىشتىن توختىتىدۇ.

`.carousel(number)`

كارۇسېلنى مەلۇم بىر رامكىغا ئايلاندۇرىدۇ (0 ئاساس قىلىنغان ، سانلار گۇرپىسىغا ئوخشايدۇ). نىشان تۈرى كۆرسىتىلىشتىن بۇرۇن (يەنى ۋەقە يۈز بېرىشتىن بۇرۇن) دەۋەتچىگە قايتىدۇ .slid.bs.carousel

`.carousel('prev')`

ئالدىنقى تۈرگە ئايلىنىش. ئالدىنقى تۈر كۆرسىتىلىشتىن بۇرۇن (يەنى ۋەقە يۈز بېرىشتىن بۇرۇن) دەۋەتچىگە قايتىدۇ .slid.bs.carousel

`.carousel('next')`

كېيىنكى تۈرگە ئايلىنىش. كېيىنكى تۈر كۆرسىتىلىشتىن بۇرۇن (يەنى ۋەقە يۈز بېرىشتىن بۇرۇن) دەۋەتچىگە قايتىدۇ .slid.bs.carousel

`.carousel('dispose')`

بىر ئېلېمېنتنىڭ كارۇسېلنى بۇزىدۇ.

Events

Bootstrap نىڭ كارۇسېل سىنىپى كارۇسېل ئىقتىدارىغا باغلانغان ئىككى خىل ھادىسىنى ئاشكارىلىدى. ھەر ئىككى ھادىسىنىڭ تۆۋەندىكى قوشۇمچە خۇسۇسىيەتلىرى بار:

direction: كارۇسېلنىڭ سىيرىلىش يۆنىلىشى (ياكى "left"ياكى "right").
relatedTarget: ئاكتىپ تۈر سۈپىتىدە جايىغا سىيرىلىۋاتقان DOM ئېلېمېنتى.
from: نۆۋەتتىكى تۈرنىڭ كۆرسەتكۈچى
to: كېيىنكى تۈرنىڭ كۆرسەتكۈچى

بارلىق كارۇسېل ھادىسىلىرى كارۇسېلنىڭ ئۆزىگە قارىتىلغان (يەنى <div class="carousel">).

پائالىيەت تىپى	چۈشەندۈرۈش
slide.bs.carousel	`slide`مىسال ئۇسۇلى قوللىنىلغاندا بۇ ھادىسە دەرھال ئېتىلىدۇ.
slid.bs.carousel	كارۇسېل سىيرىلما ئۆتۈشنى تاماملىغاندا بۇ پائالىيەت ئېتىلىدۇ.

$('#myCarousel').on('slide.bs.carousel', function () {
  // do something...
})

ئۆتكۈنچى مۇددىتىنى ئۆزگەرتىش

ئەگەر سىز تۈزۈلگەن CSS نى ئىشلىتىۋاتقان بولسىڭىز ، Sass ئۆزگەرگۈچى مىقدارنى .carousel-itemئۆزگەرتىشتىن بۇرۇن ياكى خاس ئۇسلۇبنى ئۆزگەرتىشكە بولىدۇ . $carousel-transitionئەگەر كۆپ خىل ئۆتكۈنچى قوللىنىلسا ، ئالدى بىلەن ئۆزگەرتىشنىڭ ئېنىقلانغانلىقىنى جەزملەشتۈرۈڭ (مەسىلەن transition: transform 2s ease, opacity .5s ease-out).