Karuseli
Një komponent i shfaqjes së rrëshqitjes për kalimin me biçikletë nëpër elementë - imazhe ose rrëshqitje teksti - si një karusel.
Karuseli është një shfaqje rrëshqitëse për çiklizëm nëpër një seri përmbajtjesh, e ndërtuar me transformime CSS 3D dhe pak JavaScript. Ai funksionon me një seri imazhesh, teksti ose shënimesh të personalizuara. Ai gjithashtu përfshin mbështetje për kontrollet dhe treguesit e mëparshëm/të ardhshëm.
Në shfletuesit ku mbështetet API-ja e dukshmërisë së faqes , karuseli do të shmangë rrëshqitjen kur faqja e internetit nuk është e dukshme për përdoruesin (si p.sh. kur skeda e shfletuesit është joaktive, dritarja e shfletuesit është minimizuar, etj.).
Ju lutemi, kini parasysh se karuselet e mbivendosur nuk mbështeten dhe karuselat në përgjithësi nuk janë në përputhje me standardet e aksesueshmërisë.
Së fundi, nëse po ndërtoni JavaScript-in tonë nga burimi, ai kërkonutil.js
.
Karuselet nuk normalizojnë automatikisht dimensionet e rrëshqitjes. Si i tillë, mund t'ju duhet të përdorni shërbime shtesë ose stile të personalizuara për madhësinë e duhur të përmbajtjes. Ndërsa karuselat mbështesin kontrollet dhe treguesit e mëparshëm/të ardhshëm, ato nuk kërkohen në mënyrë eksplicite. Shtoni dhe personalizoni sipas mendimit tuaj.
Sigurohuni që të vendosni një ID unike në .carousel
kontrollet opsionale, veçanërisht nëse jeni duke përdorur karusele të shumta në një faqe të vetme.
Këtu është një karusel vetëm me rrëshqitje. Vini re praninë e imazheve të karuselit .d-block
dhe në për të parandaluar shtrirjen e paracaktuar të imazhit të shfletuesit..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>
Shtimi në kontrollet e mëparshme dhe të ardhshme:
<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>
Gjithashtu, mund t'i shtoni treguesit në karusel, së bashku me kontrollet.
<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>
Kërkohet elementi aktiv fillestar
Klasa .active
duhet të shtohet në një nga sllajdet. Përndryshe, karuseli nuk do të jetë i dukshëm.
Shtoni titrat në rrëshqitjet tuaja me lehtësi me .carousel-caption
elementin brenda çdo .carousel-item
. Ato mund të fshihen lehtësisht në porta më të vogla të shikimit, siç tregohet më poshtë, me programe opsionale të ekranit . Ne i fshehim ato fillimisht me .d-none
dhe i kthejmë në pajisje të mesme me .d-md-block
.
Përdorni atributet e të dhënave për të kontrolluar me lehtësi pozicionin e karuselit. data-slide
pranon fjalët kyçe prev
ose next
, e cila ndryshon pozicionin e rrëshqitjes në lidhje me pozicionin e tij aktual. Përndryshe, përdorni data-slide-to
për të kaluar një indeks të papërpunuar të rrëshqitjes te karuseli data-slide-to="2"
, i cili e zhvendos pozicionin e rrëshqitjes në një indeks të veçantë duke filluar me 0
.
Atributi data-ride="carousel"
përdoret për të shënuar një karusel si animues duke filluar nga ngarkimi i faqes. Nuk mund të përdoret në kombinim me inicializimin e qartë JavaScript (të tepërt dhe të panevojshëm) të të njëjtit karusel.
Thirrni karuselin manualisht me:
Opsionet mund të kalohen nëpërmjet atributeve të të dhënave ose JavaScript. Për atributet e të dhënave, shtoni emrin e opsionit në data-
, si në data-interval=""
.
Emri | Lloji | E paracaktuar | Përshkrim |
---|---|---|---|
intervali | numri | 5000 | Sasia e kohës për të vonuar ndërmjet çiklizmit automatik të një artikulli. Nëse është false, karuseli nuk do të qarkullojë automatikisht. |
tastierë | logjike | e vërtetë | Nëse karuseli duhet të reagojë ndaj ngjarjeve të tastierës. |
pauzë | varg | logjike | "rri pezull" | Nëse caktohet në Në pajisjet me prekje, kur vendoset në |
ngasin | varg | i rremë | Luan automatikisht karuselin pasi përdoruesi të ciklojë manualisht artikullin e parë. Nëse "carousel", luan automatikisht karuselin në ngarkim. |
mbështjell | logjike | e vërtetë | Nëse karuseli duhet të qarkullojë vazhdimisht ose të ketë ndalesa të vështira. |
Metodat dhe tranzicionet asinkrone
Të gjitha metodat API janë asinkrone dhe fillojnë një tranzicion . Ata kthehen te thirrësi sapo të fillojë tranzicioni, por para se të përfundojë . Përveç kësaj, një thirrje metodë në një komponent në tranzicion do të injorohet .
Shikoni dokumentacionin tonë JavaScript për më shumë informacion.
Inicializon karuselin me një opsion opsional object
dhe fillon të lëvizë me biçikletë nëpër artikuj.
Ciklet nëpër artikujt e karuselit nga e majta në të djathtë.
Ndalon karuselin të lëvizë me biçikletë nëpër artikuj.
Ciklizon karuselin në një kornizë të caktuar (bazuar në 0, e ngjashme me një grup). Kthehet te thirrësi përpara se të shfaqet artikulli i synuar (dmth. përpara se të slid.bs.carousel
ndodhë ngjarja).
Ciklet në artikullin e mëparshëm. Kthehet te thirrësi përpara se të shfaqet artikulli i mëparshëm (dmth. përpara se të slid.bs.carousel
ndodhë ngjarja).
Ciklet te artikulli tjetër. Kthehet te thirrësi përpara se të shfaqet artikulli tjetër (dmth. përpara se të slid.bs.carousel
ndodhë ngjarja).
Shkatërron karuselin e një elementi.
Klasa e karuselit të Bootstrap ekspozon dy ngjarje për t'u lidhur me funksionalitetin e karuselit. Të dyja ngjarjet kanë karakteristikat e mëposhtme shtesë:
direction
: Drejtimi në të cilin rrëshqet karuseli (ose"left"
ose"right"
).relatedTarget
: Elementi DOM që po futet në vend si artikull aktiv.from
: Indeksi i artikullit aktualto
: Indeksi i artikullit pasardhës
Të gjitha ngjarjet e karuselit shkrepen në vetë karuselin (dmth. në <div class="carousel">
).
Lloji i ngjarjes | Përshkrim |
---|---|
rrëshqitje.bs.carousel | Kjo ngjarje ndizet menjëherë kur slide thirret metoda e shembullit. |
rrëshqiti.bs.carousel | Kjo ngjarje aktivizohet kur karuseli ka përfunduar tranzicionin e tij të rrëshqitjes. |