Karusell
En lysbildefremvisningskomponent for å sykle gjennom elementer – bilder eller lysbilder med tekst – som en karusell.
Karusellen er en lysbildefremvisning for å sykle gjennom en rekke innhold, bygget med CSS 3D-transformasjoner og litt JavaScript. Det fungerer med en serie bilder, tekst eller egendefinerte markeringer. Den inkluderer også støtte for forrige/neste kontroller og indikatorer.
I nettlesere der Page Visibility API støttes, vil karusellen unngå å skli når nettsiden ikke er synlig for brukeren (for eksempel når nettleserfanen er inaktiv, nettleservinduet er minimert osv.).
Vær oppmerksom på at nestede karuseller ikke støttes, og karuseller er generelt sett ikke i samsvar med tilgjengelighetsstandarder.
Til slutt, hvis du bygger JavaScript fra kilden, kreverutil.js
det .
Karuseller normaliserer ikke lysbildedimensjonene automatisk. Som sådan kan det hende du må bruke ekstra verktøy eller tilpassede stiler for å tilpasse innholdet. Mens karuseller støtter forrige/neste kontroller og indikatorer, er de ikke eksplisitt påkrevd. Legg til og tilpass etter eget ønske.
Sørg for å angi en unik ID på .carousel
for valgfrie kontroller, spesielt hvis du bruker flere karuseller på en enkelt side.
Her er en karusell med bare lysbilder. Legg merke til tilstedeværelsen av .d-block
og .img-fluid
på karusellbildene for å forhindre nettleserstandardbildejustering.
<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>
Legger til forrige og neste kontroll:
<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>
Du kan også legge til indikatorene i karusellen, sammen med kontrollene, også.
<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>
Opprinnelig aktive element kreves
Klassen .active
må legges til et av lysbildene. Ellers vil ikke karusellen være synlig.
Legg enkelt til bildetekster til lysbildene dine med .carousel-caption
elementet i en hvilken som helst .carousel-item
. De kan enkelt skjules på mindre visningsporter, som vist nedenfor, med valgfrie skjermverktøy . Vi skjuler dem først med .d-none
og bringer dem tilbake på mellomstore enheter med .d-md-block
.
Bruk dataattributter for enkelt å kontrollere posisjonen til karusellen. data-slide
godtar nøkkelordene prev
eller next
, som endrer lysbildeposisjonen i forhold til gjeldende posisjon. Alternativt kan du bruke data-slide-to
for å sende en rå lysbildeindeks til karusellen data-slide-to="2"
, som flytter lysbildeposisjonen til en bestemt indeks som begynner med 0
.
Attributtet brukes til å merke en karusell som animasjon fra og data-ride="carousel"
med sideinnlasting. Den kan ikke brukes i kombinasjon med (overflødig og unødvendig) eksplisitt JavaScript-initialisering av samme karusell.
Ring karusell manuelt med:
Alternativer kan sendes via dataattributter eller JavaScript. For dataattributter, legg til alternativnavnet til data-
, som i data-interval=""
.
Navn | Type | Misligholde | Beskrivelse |
---|---|---|---|
intervall | Antall | 5000 | Tiden det tar mellom automatisk sykling av et element. Hvis falsk, vil ikke karusellen gå automatisk. |
tastatur | boolsk | ekte | Om karusellen skal reagere på tastaturhendelser. |
pause | streng | boolsk | "sveve" | Hvis satt til På berøringsaktiverte enheter, når satt til |
ri | streng | falsk | Automatisk spiller av karusellen etter at brukeren manuelt går gjennom det første elementet. Hvis "karusell", spiller karusellen automatisk når den er lastet. |
pakke inn | boolsk | ekte | Om karusellen skal sykle kontinuerlig eller ha harde stopp. |
Asynkrone metoder og overganger
Alle API-metoder er asynkrone og starter en overgang . De går tilbake til den som ringer så snart overgangen er startet, men før den avsluttes . I tillegg vil et metodekall på en overgangskomponent bli ignorert .
Initialiserer karusellen med valgfrie alternativer object
og begynner å sykle gjennom gjenstander.
Bla gjennom karusellelementene fra venstre til høyre.
Stopper karusellen fra å sykle gjennom gjenstander.
Sykler karusellen til en bestemt ramme (0-basert, ligner på en matrise). Går tilbake til den som ringer før målelementet har blitt vist (dvs. før slid.bs.carousel
hendelsen inntreffer).
Går til forrige element. Går tilbake til den som ringer før forrige element har blitt vist (dvs. før slid.bs.carousel
hendelsen inntreffer).
Går til neste element. Går tilbake til den som ringer før neste element har blitt vist (dvs. før slid.bs.carousel
hendelsen inntreffer).
Ødelegger et elements karusell.
Bootstraps karusellklasse avslører to hendelser for å koble til karusellfunksjonalitet. Begge arrangementene har følgende tilleggsegenskaper:
direction
: Retningen som karusellen glir (enten"left"
eller"right"
).relatedTarget
: DOM-elementet som skyves på plass som det aktive elementet.from
: Indeksen til gjeldende elementto
: Indeksen til neste element
Alle karusellbegivenheter skytes mot selve karusellen (dvs. ved <div class="carousel">
).
Hendelsestype | Beskrivelse |
---|---|
slide.bs.karusell | Denne hendelsen utløses umiddelbart når slide instansmetoden påkalles. |
slide.bs.karusell | Denne hendelsen utløses når karusellen har fullført lysbildeovergangen. |