Karusell
En bildspelskomponent för att cykla genom element – bilder eller bilder med text – som en karusell.
Hur det fungerar
Karusellen är ett bildspel för att cykla genom en serie innehåll, byggt med CSS 3D-transformationer och lite JavaScript. Det fungerar med en serie bilder, text eller anpassad uppmärkning. Den innehåller också stöd för tidigare/nästa kontroller och indikatorer.
I webbläsare där Page Visibility API stöds kommer karusellen att undvika att glida när webbsidan inte är synlig för användaren (som när webbläsarfliken är inaktiv, webbläsarfönstret är minimerat, etc.).
prefers-reduced-motion
mediefrågan. Se
avsnittet för reducerad rörelse i vår tillgänglighetsdokumentation .
Tänk på att kapslade karuseller inte stöds, och karuseller är i allmänhet inte kompatibla med tillgänglighetsstandarder.
Slutligen, om du bygger vårt JavaScript från källan, kräverutil.js
det .
Exempel
Karuseller normaliserar inte automatiskt bildens dimensioner. Som sådan kan du behöva använda ytterligare verktyg eller anpassade stilar för att anpassa innehållet. Även om karuseller stöder föregående/nästa kontroller och indikatorer, krävs de inte uttryckligen. Lägg till och anpassa som du tycker passar.
Klassen .active
måste läggas till på en av bilderna annars syns inte karusellen. Se också till att ställa in en unik id
på .carousel
för valfria kontroller, särskilt om du använder flera karuseller på en enda sida. Kontroll- och indikatorelement måste ha ett data-target
attribut (eller href
för länkar) som matchar id
elementets .carousel
.
Endast diabilder
Här är en karusell med endast rutschbanor. Observera förekomsten av .d-block
och .w-100
på karusellbilder för att förhindra webbläsarens standardbildjustering.
<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>
Med kontroller
Lägger till föregående och nästa kontroller. Vi rekommenderar att du använder <button>
element, men du kan också använda <a>
element med role="button"
.
<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>
<button class="carousel-control-prev" type="button" data-target="#carouselExampleControls" data-slide="prev">
<span class="carousel-control-prev-icon" aria-hidden="true"></span>
<span class="sr-only">Previous</span>
</button>
<button class="carousel-control-next" type="button" data-target="#carouselExampleControls" data-slide="next">
<span class="carousel-control-next-icon" aria-hidden="true"></span>
<span class="sr-only">Next</span>
</button>
</div>
Med indikatorer
Du kan också lägga till indikatorerna i karusellen, tillsammans med kontrollerna.
<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>
<button class="carousel-control-prev" type="button" data-target="#carouselExampleIndicators" data-slide="prev">
<span class="carousel-control-prev-icon" aria-hidden="true"></span>
<span class="sr-only">Previous</span>
</button>
<button class="carousel-control-next" type="button" data-target="#carouselExampleIndicators" data-slide="next">
<span class="carousel-control-next-icon" aria-hidden="true"></span>
<span class="sr-only">Next</span>
</button>
</div>
Med bildtexter
Lägg enkelt till bildtexter till dina bilder med .carousel-caption
elementet i valfri .carousel-item
. De kan enkelt döljas i mindre visningsportar, som visas nedan, med valfria skärmverktyg . Vi gömmer dem först med .d-none
och tar tillbaka dem på medelstora enheter med .d-md-block
.
<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>Some representative placeholder content for the first slide.</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>Some representative placeholder content for the second slide.</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>Some representative placeholder content for the third slide.</p>
</div>
</div>
</div>
<button class="carousel-control-prev" type="button" data-target="#carouselExampleCaptions" data-slide="prev">
<span class="carousel-control-prev-icon" aria-hidden="true"></span>
<span class="sr-only">Previous</span>
</button>
<button class="carousel-control-next" type="button" data-target="#carouselExampleCaptions" data-slide="next">
<span class="carousel-control-next-icon" aria-hidden="true"></span>
<span class="sr-only">Next</span>
</button>
</div>
Crossfade
Lägg .carousel-fade
till i din karusell för att animera bilder med en tona övergång istället för en bild. Beroende på ditt karusellinnehåll (t.ex. endast textbilder) kanske du vill lägga till .bg-body
eller någon anpassad CSS till .carousel-item
s för korrekt övertoning.
<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>
<button class="carousel-control-prev" type="button" data-target="#carouselExampleFade" data-slide="prev">
<span class="carousel-control-prev-icon" aria-hidden="true"></span>
<span class="sr-only">Previous</span>
</button>
<button class="carousel-control-next" type="button" data-target="#carouselExampleFade" data-slide="next">
<span class="carousel-control-next-icon" aria-hidden="true"></span>
<span class="sr-only">Next</span>
</button>
</div>
Individuellt .carousel-item
intervall
Lägg data-interval=""
till en .carousel-item
för att ändra hur lång tid det ska gå mellan att automatiskt cykla till nästa objekt.
<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>
<button class="carousel-control-prev" type="button" data-target="#carouselExampleInterval" data-slide="prev">
<span class="carousel-control-prev-icon" aria-hidden="true"></span>
<span class="sr-only">Previous</span>
</button>
<button class="carousel-control-next" type="button" data-target="#carouselExampleInterval" data-slide="next">
<span class="carousel-control-next-icon" aria-hidden="true"></span>
<span class="sr-only">Next</span>
</button>
</div>
Inaktivera peksvepning
Karuseller stöder svep åt vänster/höger på enheter med pekskärm för att flytta mellan bilderna. Detta kan inaktiveras med data-touch
attributet. Exemplet nedan inkluderar inte heller data-ride
attributet och har data-interval="false"
så att det inte spelas upp automatiskt.
<div id="carouselExampleControlsNoTouching" class="carousel slide" data-touch="false" data-interval="false">
<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>
<button class="carousel-control-prev" type="button" data-target="#carouselExampleControlsNoTouching" data-slide="prev">
<span class="carousel-control-prev-icon" aria-hidden="true"></span>
<span class="sr-only">Previous</span>
</button>
<button class="carousel-control-next" type="button" data-target="#carouselExampleControlsNoTouching" data-slide="next">
<span class="carousel-control-next-icon" aria-hidden="true"></span>
<span class="sr-only">Next</span>
</button>
</div>
Användande
Via dataattribut
Använd dataattribut för att enkelt kontrollera karusellens position. data-slide
accepterar nyckelorden prev
eller next
, vilket ändrar bildens position i förhållande till dess nuvarande position. Alternativt kan du använda data-slide-to
för att skicka ett obearbetat diabildsindex till karusellen data-slide-to="2"
, vilket skiftar objektglaspositionen till ett visst index som börjar med 0
.
Attributet data-ride="carousel"
används för att markera en karusell som animering med början vid sidladdning. Om du inte använder data-ride="carousel"
för att initiera din karusell, måste du initiera den själv. Den kan inte användas i kombination med (redundant och onödig) explicit JavaScript-initiering av samma karusell.
Via JavaScript
Ring karusellen manuellt med:
$('.carousel').carousel()
alternativ
Alternativ kan skickas via dataattribut eller JavaScript. För dataattribut, lägg till alternativnamnet till data-
, som i data-interval=""
.
namn | Typ | Standard | Beskrivning |
---|---|---|---|
intervall | siffra | 5 000 | Hur lång tid det tar mellan att automatiskt cykla ett objekt. Om false , kommer karusellen inte att cykla automatiskt. |
tangentbord | booleskt | Sann | Om karusellen ska reagera på tangentbordshändelser. |
paus | sträng | booleskt | 'sväva' | Om inställt på På pekaktiverade enheter, när den är inställd på |
rida | sträng | falsk | Spelar upp karusellen automatiskt efter att användaren manuellt cyklar det första objektet. Om inställt på 'carousel' , spelar karusellen automatiskt vid laddning. |
slå in | booleskt | Sann | Om karusellen ska cykla kontinuerligt eller ha hårda stopp. |
Rör | booleskt | Sann | Huruvida karusellen ska stödja vänster/höger svep-interaktioner på pekskärmsenheter. |
Metoder
Asynkrona metoder och övergångar
Alla API - metoder är asynkrona och startar en övergång . De återvänder till den som ringer så snart övergången har påbörjats men innan den slutar . Dessutom kommer ett metodanrop på en övergångskomponent att ignoreras .
.carousel(options)
Initierar karusellen med ett valfritt alternativ object
och börjar cykla igenom föremål.
$('.carousel').carousel({
interval: 2000
})
.carousel('cycle')
Cyklar genom karusellföremålen från vänster till höger.
.carousel('pause')
Stoppar karusellen från att cykla genom föremål.
.carousel(number)
Cyklar karusellen till en viss bildruta (0-baserad, liknande en array). Återgår till den som ringer innan målobjektet har visats (dvs innan slid.bs.carousel
händelsen inträffar).
.carousel('prev')
Går till föregående post. Återgår till den som ringer innan föregående objekt har visats (dvs innan slid.bs.carousel
händelsen inträffar).
.carousel('next')
Går till nästa objekt. Återgår till den som ringer innan nästa objekt har visats (dvs innan slid.bs.carousel
händelsen inträffar).
.carousel('dispose')
Förstör ett elements karusell.
.carousel('nextWhenVisible')
Cykla inte karusellen till nästa när sidan inte är synlig eller karusellen eller dess förälder inte är synlig. Återgår till den som ringer innan nästa objekt har visats (dvs innan slid.bs.carousel
händelsen inträffar).
.carousel('to')
Cyklar karusellen till en viss bildruta (0-baserad, liknande en array). Återgår till den som ringer innan nästa objekt har visats (dvs innan slid.bs.carousel
händelsen inträffar).
evenemang
Bootstraps karusellklass avslöjar två händelser för att koppla in karusellfunktionalitet. Båda händelserna har följande ytterligare egenskaper:
direction
: Den riktning i vilken karusellen glider (antingen"left"
eller"right"
).relatedTarget
: DOM-elementet som skjuts på plats som det aktiva objektet.from
: Indexet för det aktuella objektetto
: Indexet för nästa objekt
Alla karusellhändelser avfyras mot själva karusellen (dvs. vid <div class="carousel">
).
Event typ | Beskrivning |
---|---|
slide.bs.carousel | Denna händelse aktiveras omedelbart när slide instansmetoden anropas. |
slid.bs.karusell | Denna händelse aktiveras när karusellen har slutfört sin bildövergång. |
$('#myCarousel').on('slide.bs.carousel', function () {
// do something...
})
Ändra övergångens varaktighet
Övergångslängden för .carousel-item
kan ändras med $carousel-transition
Sass-variabeln före kompilering eller anpassade stilar om du använder den kompilerade CSS. Om flera övergångar tillämpas, se till att transformationsövergången definieras först (t.ex. transition: transform 2s ease, opacity .5s ease-out
).