Source

Karużell

Komponent tal-wiri ta' pjastri għaċ-ċikliżmu minn elementi—immaġini jew slides ta' test—bħal karużell.

Kif taħdem

Il-karużell huwa slideshow għaċ-ċikliżmu permezz ta 'serje ta' kontenut, mibnija bi CSS 3D transforms u daqsxejn ta 'JavaScript. Jaħdem b'serje ta 'immaġini, test, jew markup personalizzat. Jinkludi wkoll appoġġ għal kontrolli u indikaturi preċedenti/li jmiss.

Fil-browsers fejn l- API tal-Viżibilità tal-Paġni hija appoġġjata, il-karużell jevita li jiżżerżaq meta l-paġna tal-web ma tkunx viżibbli għall-utent (bħal meta t-tab tal-browser tkun inattiva, it-tieqa tal-browser tkun minimizzata, eċċ.).

L-effett ta 'animazzjoni ta' dan il-komponent jiddependi fuq il prefers-reduced-motion-mistoqsija tal-midja. Ara t- taqsima tal-mozzjoni mnaqqsa tad-dokumentazzjoni tagħna dwar l-aċċessibbiltà .

Jekk jogħġbok kun konxju li l-karużelli nested mhumiex appoġġjati, u l-karużelli ġeneralment mhumiex konformi mal-istandards tal-aċċessibbiltà.

Fl-aħħar nett, jekk qed tibni l-JavaScript tagħna mis-sors, teħtieġutil.js .

Eżempju

Karużelli ma awtomatikament jinnormalizzaw id-dimensjonijiet slide. Bħala tali, jista 'jkollok bżonn tuża utilitajiet addizzjonali jew stili tad-dwana biex id-daqs xieraq tal-kontenut. Filwaqt li l-karużelli jappoġġjaw kontrolli u indikaturi preċedenti/li jmiss, mhumiex meħtieġa b'mod espliċitu. Żid u ppersonalizza kif tara xieraq.

Il- .activeklassi trid tiżdied ma' waħda mill-pjastri inkella l-karużell ma jkunx viżibbli. Kun żgur ukoll li tissettja id unika fuq il- .carouselkontrolli mhux obbligatorji, speċjalment jekk qed tuża karużelli multipli fuq paġna waħda. L-elementi ta' kontroll u indikaturi għandu jkollhom data-targetattribut (jew hrefgħal links) li jaqbel mal-id tal- .carouselelement.

Slajds biss

Hawn karużell bi slides biss. Innota l-preżenza tal- .d-blocku .w-100fuq immaġini tal-karużell biex tevita l-allinjament tal-immaġni default tal-browser.

<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>

Bil-kontrolli

Żieda fil-kontrolli preċedenti u li jmiss:

<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>
  <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>

B'indikaturi

Tista 'wkoll iżżid l-indikaturi mal-karużell, flimkien mal-kontrolli, ukoll.

<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>
  <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>

Bil-titoli

Żid captions mal-pjastri tiegħek faċilment bl- .carousel-captionelement fi kwalunkwe .carousel-item. Jistgħu jinħbew faċilment fuq viewports iżgħar, kif muri hawn taħt, b'utilitajiet tal- wiri fakultattivi . Aħna naħbuhom inizjalment .d-noneu nġibuhom lura fuq apparat ta 'daqs medju b' .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>Nulla vitae elit libero, a pharetra augue mollis interdum.</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>Lorem ipsum dolor sit amet, consectetur adipiscing elit.</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>Praesent commodo cursus magna, vel scelerisque nisl consectetur.</p>
      </div>
    </div>
  </div>
  <a class="carousel-control-prev" href="#carouselExampleCaptions" 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="#carouselExampleCaptions" role="button" data-slide="next">
    <span class="carousel-control-next-icon" aria-hidden="true"></span>
    <span class="sr-only">Next</span>
  </a>
</div>

Crossfade

Żid .carousel-fademal-karużell tiegħek biex tanima slajds bi transizzjoni fade minflok slide.

<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>
  <a class="carousel-control-prev" href="#carouselExampleFade" 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="#carouselExampleFade" role="button" data-slide="next">
    <span class="carousel-control-next-icon" aria-hidden="true"></span>
    <span class="sr-only">Next</span>
  </a>
</div>

Żid data-interval=""ma 'a .carousel-itembiex tibdel l-ammont ta' ħin biex tittardja bejn iċ-ċikliżmu awtomatikament għall-oġġett li jmiss.

<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>
  <a class="carousel-control-prev" href="#carouselExampleInterval" 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="#carouselExampleInterval" role="button" data-slide="next">
    <span class="carousel-control-next-icon" aria-hidden="true"></span>
    <span class="sr-only">Next</span>
  </a>
</div>

Użu

Via attributi tad-data

Uża l-attributi tad-dejta biex tikkontrolla faċilment il-pożizzjoni tal-karużell. data-slidejaċċetta l-kliem kjavi prevjew next, li jibdel il-pożizzjoni slide relattiva għall-pożizzjoni attwali tagħha. Inkella, uża data-slide-tobiex tgħaddi indiċi ta' slide mhux ipproċessat lill-karużell data-slide-to="2", li jbiddel il-pożizzjoni tal-islajd għal indiċi partikolari li jibda b' 0.

L- data-ride="carousel"attribut jintuża biex jimmarka karużell bħala animazzjoni li jibda mat-tagħbija tal-paġna. Jekk ma tużax data-ride="carousel"biex initialize carousel tiegħek, inti għandek initialize it yourself. Ma jistax jintuża flimkien ma 'inizjalizzazzjoni JavaScript espliċita (superjuri u mhux meħtieġa) tal-istess carousel.

Via JavaScript

Ċempel il-karużell manwalment bi:

$('.carousel').carousel()

Għażliet

L-għażliet jistgħu jiġu mgħoddija permezz ta' attributi tad-dejta jew JavaScript. Għal attributi tad-dejta, ehmeż l-isem tal-għażla ma' data-, bħal f' data-interval="".

Isem Tip Default Deskrizzjoni
intervall numru 5000 L-ammont ta 'ħin biex tittardja bejn iċ-ċikliżmu ta' oġġett awtomatikament. Jekk falza, il-karużell mhux awtomatikament iċ-ċiklu.
tastiera boolean veru Jekk il-karużell għandux jirreaġixxi għall-avvenimenti tat-tastiera.
waqfa spag | boolean "idwar"

Jekk issettjat għal "hover", iwaqqaf iċ-ċikliżmu tal-karużell mixgħul mouseenteru jerġa' jibda ċ-ċikliżmu tal-karużell mixgħul mouseleave. Jekk issettjat għal false, iddur fuq il-karużell ma jieqafx.

Fuq apparati li għandhom touch, meta ssettjat għal "hover", iċ-ċikliżmu se jieqaf mixgħul touchend(ladarba l-utent lest jinteraġixxi mal-karużell) għal żewġ intervalli, qabel ma jerġa’ jibda awtomatikament. Innota li dan huwa minbarra l-imġieba tal-maws ta 'hawn fuq.
ride spag falza Iddoqq awtomatikament il-karużell wara li l-utent iċċikkel manwalment l-ewwel oġġett. Jekk "carousel", iddoqq awtomatikament il-karużell waqt it-tagħbija.
wrap boolean veru Jekk il-karużell għandux iċ-ċiklu kontinwu jew ikollux waqfiet iebsin.
mess boolean veru Jekk il-karużell għandux jappoġġja interazzjonijiet ta' swipe xellug/lemin fuq apparati touchscreen.

Metodi

Metodi asinkroniċi u tranżizzjonijiet

Il-metodi kollha tal-API huma asinkroniċi u jibdew transizzjoni . Jirritornaw għand min iċempel hekk kif tinbeda t-tranżizzjoni iżda qabel ma tispiċċa . Barra minn hekk, sejħa ta' metodu fuq komponent ta' tranżizzjoni se tiġi injorata .

Ara d-dokumentazzjoni JavaScript tagħna għal aktar informazzjoni .

.carousel(options)

Inizjalizza l-karużell b'għażliet fakultattivi objectu jibda jiċċirkola permezz ta 'oġġetti.

$('.carousel').carousel({
  interval: 2000
})

.carousel('cycle')

Ċikli permezz tal-oġġetti tal-karużell mix-xellug għal-lemin.

.carousel('pause')

Jwaqqaf il-karużell milli jiċċirkola permezz ta' oġġetti.

.carousel(number)

Iċċekkja l-karużell għal qafas partikolari (ibbażat fuq 0, simili għal firxa). Jirritorna lil min iċempel qabel ma jkun intwera l-oġġett fil-mira (jiġifieri qabel ma slid.bs.carouseljseħħ l-avveniment).

.carousel('prev')

Ċikli għall-oġġett preċedenti. Jirritorna lil min iċempel qabel ma jkun intwera l-oġġett preċedenti (jiġifieri qabel ma slid.bs.carouseljseħħ l-avveniment).

.carousel('next')

Ċikli għall-oġġett li jmiss. Jirritorna lil min iċempel qabel ma jkun intwera l-oġġett li jmiss (jiġifieri qabel ma slid.bs.carouseljseħħ l-avveniment).

.carousel('dispose')

Jeqred il-karużell ta' element.

Avvenimenti

Il-klassi tal-karużell tal-Bootstrap tesponi żewġ avvenimenti biex tgħaqqad il-funzjonalità tal-karużell. Iż-żewġ avvenimenti għandhom il-proprjetajiet addizzjonali li ġejjin:

  • direction: Id-direzzjoni li fiha l-karużell qed jiżżerżaq ( "left"jew "right").
  • relatedTarget: L-element DOM li qed jiżżerżaq fil-post bħala l-oġġett attiv.
  • from: L-indiċi tal-oġġett kurrenti
  • to: L-indiċi tal-oġġett li jmiss

L-avvenimenti kollha tal-karużell jiġu sparati lejn il-karużell innifsu (jiġifieri fil- <div class="carousel">).

Tip ta' Avveniment Deskrizzjoni
slide.bs.carousel Dan l-avveniment jispara immedjatament meta slidejiġi invokat il-metodu tal-istanza.
jiżżerżaq.bs.karużell Dan l-avveniment jiġi sparat meta l-karużell ikun lesta t-transizzjoni tal-islajds tiegħu. 
$('#myCarousel').on('slide.bs.carousel', function () {
  // do something...
})

Ibdel it-tul tat-tranżizzjoni

It-tul tat-tranżizzjoni ta ' .carousel-itemjista' jinbidel bil- $carousel-transitionvarjabbli Sass qabel il-kompilazzjoni jew stili personalizzati jekk qed tuża s-CSS ikkumpilat. Jekk jiġu applikati transizzjonijiet multipli, kun żgur li t-tranżizzjoni tat-trasformazzjoni hija definita l-ewwel (eż. transition: transform 2s ease, opacity .5s ease-out).