Körhinta
Diavetítés-összetevő az elemek – képek vagy szöveges diák – közötti kerékpározáshoz, mint egy körhinta.
A körhinta egy diavetítés a tartalom sorozatának végigjátszásához, CSS 3D-transzformációkkal és egy kis JavaScript-kóddal. Képsorozattal, szöveggel vagy egyéni jelöléssel működik. Tartalmazza az előző/következő vezérlők és indikátorok támogatását is.
Azokban a böngészőkben, ahol az oldalláthatósági API támogatott, a körhinta elkerüli a csúszást, ha a weboldal nem látható a felhasználó számára (például amikor a böngésző lap inaktív, a böngészőablak le van kicsinyítve stb.).
Kérjük, vegye figyelembe, hogy a beágyazott körhinta nem támogatott, és a körhinta általában nem felel meg a kisegítő lehetőségek szabványainak.
Végül, ha forrásból készíti a JavaScriptünket, akkor ehhezutil.js
.
A körhinta nem normalizálja automatikusan a diák méreteit. Ezért előfordulhat, hogy további segédprogramokat vagy egyéni stílusokat kell használnia a tartalom megfelelő méretéhez. Míg a körhinta támogatja az előző/következő vezérlőket és jelzőket, ezekre nincs kifejezetten szükség. Adja hozzá és szabja testre, ahogy jónak látja.
Ügyeljen arra, hogy egyedi azonosítót állítson be az .carousel
opcionális vezérlőkhöz, különösen akkor, ha több körhintat használ egyetlen oldalon.
Itt egy körhinta csak csúszdákkal. Jegyezze meg a .d-block
és .img-fluid
a körhinta képen való jelenlétét, hogy megakadályozza a böngésző alapértelmezett képigazítását.
<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>
Az előző és a következő vezérlőelemek hozzáadása:
<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>
A kijelzőket a kezelőszervek mellé is hozzáadhatja a körhintahoz.
<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>
Kezdeti aktív elem szükséges
Az .active
osztályt hozzá kell adni az egyik diához. Ellenkező esetben a körhinta nem lesz látható.
Egyszerűen adhat feliratokat diákjaihoz a .carousel-caption
tetszőleges elemen belül .carousel-item
. Könnyen elrejthetők kisebb nézetablakban, amint az alább látható, opcionális megjelenítési segédprogramokkal . Kezdetben elrejtjük őket a segítségével, .d-none
majd a közepes méretű eszközökön visszahozzuk a segítségével .d-md-block
.
Használjon adatattribútumokat a körhinta helyzetének egyszerű szabályozásához. data-slide
elfogadja a prev
vagy kulcsszavakat next
, amely megváltoztatja a dia helyzetét az aktuális pozícióhoz képest. Alternatív megoldásként használja data-slide-to
a nyers diaindexet a körhintahoz data-slide-to="2"
, amely eltolja a dia pozícióját egy adott indexre, kezdve a -val 0
.
Az data-ride="carousel"
attribútum a körhinta animációsként való megjelölésére szolgál az oldal betöltésével kezdődően. Nem használható ugyanazon körhinta (redundáns és szükségtelen) explicit JavaScript inicializálásával együtt.
Körhinta kézi hívása a következővel:
Az opciók átadhatók adatattribútumokon vagy JavaScripten keresztül. Az adatattribútumokhoz fűzze hozzá az opció nevét a data-
következőhöz: data-interval=""
.
Név | típus | Alapértelmezett | Leírás |
---|---|---|---|
intervallum | szám | 5000 | Az a késleltetési idő, amely eltelik egy tétel automatikus ciklusba állítása között. Ha hamis, a körhinta nem forog automatikusan. |
billentyűzet | logikai érték | igaz | A körhinta reagáljon-e a billentyűzet eseményeire. |
szünet | húr | logikai érték | "lebeg" | Ha ez a beállítás Érintésképes eszközökön, ha értékre van állítva |
lovagol | húr | hamis | Automatikusan lejátssza a körhinta, miután a felhasználó manuálisan körbeforgatta az első elemet. Ha „körhinta”, automatikusan lejátssza a körhintat betöltéskor. |
betakar | logikai érték | igaz | Függetlenül attól, hogy a körhinta folyamatosan forog-e, vagy keményen kell-e megállnia. |
Aszinkron módszerek és átmenetek
Minden API metódus aszinkron , és átmenetet indít . Visszatérnek a hívóhoz, amint az átmenet elkezdődik, de még azelőtt, hogy az véget érne . Ezenkívül a rendszer figyelmen kívül hagyja az átmeneti komponens metódushívásait .
További információért tekintse meg JavaScript dokumentációnkat.
Inicializálja a körhinta egy opcionális opcióval object
, és elkezdi az elemek közötti körözést.
Balról jobbra körbejárja a körhinta elemeit.
Megakadályozza, hogy a körhinta az elemek között mozogjon.
A körhinta egy adott kerethez kapcsolja (0 alapú, hasonlóan egy tömbhöz). Visszatér a hívóhoz, mielőtt a céltárgy megjelenik (azaz az slid.bs.carousel
esemény bekövetkezte előtt).
Az előző elemre vált. Visszatér a hívóhoz az előző elem megjelenítése előtt (azaz az slid.bs.carousel
esemény bekövetkezte előtt).
Ugrás a következő elemre. A következő elem megjelenítése előtt (azaz az esemény bekövetkezte előtt) visszatér a hívóhoz .slid.bs.carousel
Elpusztítja egy elem körhinta.
A Bootstrap körhinta osztálya két eseményt tesz közzé a körhinta funkcióihoz való kapcsolódáshoz. Mindkét esemény a következő további tulajdonságokkal rendelkezik:
direction
: A körhinta csúszási iránya ("left"
vagy"right"
).relatedTarget
: Az aktív elemként a helyére csúsztatott DOM-elem.from
: Az aktuális elem indexeto
: A következő elem indexe
Minden körhinta esemény magára a körhintara (azaz a <div class="carousel">
) indul.
Esemény típus | Leírás |
---|---|
slide.bs.carousel | Ez az esemény azonnal aktiválódik, amikor a slide példánymetódus meghívásra kerül. |
csúsztatott.bs.körhinta | Ez az esemény akkor aktiválódik, amikor a körhinta befejezte a diaátmenetet. |