Carousel
Usa ka bahin sa slideshow alang sa pagbisikleta pinaagi sa mga elemento—mga hulagway o mga slide sa teksto—sama sa usa ka carousel.
Ang carousel usa ka slideshow alang sa pagbisikleta pinaagi sa usa ka serye sa sulod, nga gitukod uban sa CSS 3D transforms ug gamay sa JavaScript. Naglihok kini sa usa ka serye sa mga imahe, teksto, o naandan nga marka. Naglakip usab kini sa suporta alang sa nangagi / sunod nga mga kontrol ug mga timailhan.
Sa mga browser diin ang Page Visibility API gisuportahan, ang carousel maglikay sa pag-slide kung ang webpage dili makita sa user (sama sa dihang ang tab sa browser dili aktibo, ang browser window giminusan, ug uban pa).
Palihug hibaloi nga ang mga nested carousel dili suportado, ug ang mga carousel sa kasagaran dili uyon sa mga sumbanan sa accessibility.
Katapusan, kung nagtukod ka sa among JavaScript gikan sa gigikanan, nanginahanglan kiniutil.js
.
Ang mga carousel dili awtomatikong mag-normalize sa mga dimensyon sa slide. Ingon niana, mahimo nimong gamiton ang dugang nga mga gamit o naandan nga mga istilo sa tukma nga gidak-on sa sulud. Samtang ang mga carousel nagsuporta sa nangagi/sunod nga mga kontrol ug mga timailhan, dili kini klaro nga gikinahanglan. Idugang ug ipasibo sumala sa imong nakita nga angay.
Siguruha nga magbutang usa ka talagsaon nga id sa .carousel
alang sa mga opsyonal nga kontrol, labi na kung naggamit ka daghang mga carousel sa usa ka panid.
Ania ang usa ka carousel nga adunay mga slide lamang. Timan-i ang presensya sa .d-block
ug .img-fluid
sa carousel nga mga hulagway aron mapugngan ang default nga pag-align sa imahe sa browser.
<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>
Pagdugang sa nangagi ug sunod nga mga kontrol:
<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>
Mahimo usab nimong idugang ang mga timailhan sa carousel, kauban ang mga kontrol, usab.
<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>
Kinahanglan ang una nga aktibo nga elemento
Ang .active
klase kinahanglang idugang sa usa sa mga slide. Kay kon dili, ang carousel dili makita.
Idugang ang mga kapsyon sa imong mga slide nga dali gamit ang .carousel-caption
elemento sa sulod sa bisan unsang .carousel-item
. Kini dali nga matago sa gagmay nga mga viewport, sama sa gipakita sa ubos, nga adunay opsyonal nga mga gamit sa pagpakita . Among itago kini sa sinugdanan .d-none
ug ibalik kini sa medium-sized nga mga himan nga adunay .d-md-block
.
Gamita ang data attributes aron dali makontrol ang posisyon sa carousel. data-slide
midawat sa mga keyword prev
o next
, nga nag-usab sa posisyon sa slide kalabot sa kasamtangan nga posisyon niini. Sa laing paagi, gamita data-slide-to
ang pagpasa sa usa ka hilaw nga slide index ngadto sa carousel data-slide-to="2"
, nga mobalhin sa slide position ngadto sa usa ka partikular nga index nga nagsugod sa 0
.
Ang data-ride="carousel"
attribute kay gigamit sa pagmarka sa carousel isip animating sugod sa page load. Dili kini magamit sa kombinasyon sa (kadaghanan ug wala kinahanglana) klaro nga pagsugod sa JavaScript sa parehas nga carousel.
Tawga ang carousel nga mano-mano gamit ang:
Ang mga kapilian mahimong ipasa pinaagi sa mga hiyas sa datos o JavaScript. Para sa data attributes, idugang ang opsyon nga ngalan sa data-
, sama sa data-interval=""
.
Ngalan | Matang | Default | Deskripsyon |
---|---|---|---|
agwat | numero | 5000 | Ang gidugayon sa paglangan tali sa awtomatik nga pagbisikleta sa usa ka butang. Kung bakak, ang carousel dili awtomatik nga mag-cycle. |
keyboard | boolean | tinuod | Kung ang carousel kinahanglan nga mo-react sa mga panghitabo sa keyboard. |
paghunong | hilo | boolean | "lutaw" | Kung itakda sa Sa touch-enabled nga mga device, kung i-set sa |
sakay | hilo | bakak | I-autoplay ang carousel human manu-mano nga i-cycle sa user ang unang butang. Kung "carousel", autoplay ang carousel sa load. |
putos | boolean | tinuod | Kung ang carousel kinahanglan nga magpadayon sa pag-ikot o adunay lisud nga paghunong. |
Asynchronous nga mga pamaagi ug transisyon
Ang tanan nga mga pamaagi sa API kay asynchronous ug magsugod ug transisyon . Mibalik sila sa nanawag sa diha nga nagsugod ang transisyon apan sa wala pa kini matapos . Dugang pa, ang usa ka paagi sa pagtawag sa usa ka transisyon nga sangkap dili tagdon .
Tan-awa ang among JavaScript nga dokumentasyon para sa dugang nga impormasyon.
Nagsugod sa carousel nga adunay opsyonal nga mga kapilian object
ug nagsugod sa pagbisikleta sa mga butang.
Naglibot sa mga butang sa carousel gikan sa wala ngadto sa tuo.
Gipahunong ang carousel gikan sa pagbisikleta sa mga butang.
I-cycle ang carousel ngadto sa usa ka partikular nga frame (base sa 0, susama sa array). Mibalik sa nagtawag sa wala pa ipakita ang target nga butang (ie sa wala pa slid.bs.carousel
mahitabo ang panghitabo).
Mga siklo sa miaging aytem. Mibalik sa nagtawag sa wala pa ipakita ang miaging butang (ie sa wala pa slid.bs.carousel
mahitabo ang panghitabo).
Mga siklo sa sunod nga aytem. Mibalik sa nagtawag sa wala pa ipakita ang sunod nga butang (ie sa wala pa slid.bs.carousel
mahitabo ang panghitabo).
Giguba ang carousel sa usa ka elemento.
Ang klase sa carousel sa Bootstrap nagbutyag sa duha ka mga panghitabo alang sa pag-hook sa pagpaandar sa carousel. Ang duha ka mga panghitabo adunay mga mosunod nga dugang nga mga kabtangan:
direction
: Ang direksyon diin ang carousel nag-slide (bisan"left"
o"right"
).relatedTarget
: Ang elemento sa DOM nga gi-slide sa lugar isip aktibo nga butang.from
: Ang indeks sa kasamtangan nga butangto
: Ang indeks sa sunod nga aytem
Ang tanan nga mga panghitabo sa carousel gipabuto sa carousel mismo (ie sa <div class="carousel">
).
Uri sa Hitabo | Deskripsyon |
---|---|
slide.bs.carousel | Kini nga panghitabo modilaab dayon kung ang slide pamaagi sa pananglitan gigamit. |
slid.bs.carousel | Kini nga panghitabo gipabuto kung nahuman na sa carousel ang pagbalhin sa slide niini. |