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.
Klasa .active
duhet të shtohet në një nga sllajdet përndryshe karuseli nuk do të jetë i dukshëm. Gjithashtu, 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. Elementet e kontrollit dhe treguesit duhet të kenë një data-target
atribut (ose href
për lidhje) që përputhet me ID-në e .carousel
elementit.
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..w-100
Shtimi në kontrollet e mëparshme dhe të ardhshme:
Gjithashtu, mund t'i shtoni treguesit në karusel, së bashku me kontrollet.
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
.
Shtoni .carousel-fade
në karuselin tuaj për të animuar rrëshqitjet me një tranzicion fade në vend të një rrëshqitjeje.
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 caktohet 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. |
Kohëzgjatja e tranzicionit të .carousel-item
mund të ndryshohet me $carousel-transition
variablin Sass përpara kompilimit ose stilet e personalizuara nëse jeni duke përdorur CSS të përpiluar. Nëse aplikohen tranzicione të shumta, sigurohuni që tranzicioni i transformimit të jetë përcaktuar së pari (p.sh. transition: transform 2s ease, opacity .5s ease-out
).