Carwsél
Elfen sioe sleidiau ar gyfer beicio trwy elfennau - delweddau neu sleidiau o destun - fel carwsél.
Mae'r carwsél yn sioe sleidiau ar gyfer beicio trwy gyfres o gynnwys, wedi'i adeiladu gyda thrawsnewidiadau CSS 3D ac ychydig o JavaScript. Mae'n gweithio gyda chyfres o ddelweddau, testun, neu farcio personol. Mae hefyd yn cynnwys cefnogaeth ar gyfer rheolaethau a dangosyddion blaenorol/nesaf.
Mewn porwyr lle mae'r API Gwelededd Tudalen yn cael ei gefnogi, bydd y carwsél yn osgoi llithro pan nad yw'r dudalen we yn weladwy i'r defnyddiwr (fel pan fydd tab y porwr yn anactif, ffenestr y porwr yn cael ei lleihau, ac ati).
Sylwch nad yw carwsél nythu yn cael eu cefnogi, ac yn gyffredinol nid yw carwsél yn cydymffurfio â safonau hygyrchedd.
Yn olaf, os ydych chi'n adeiladu ein JavaScript o'r ffynhonnell, mae angenutil.js
.
Nid yw carwsél yn normaleiddio dimensiynau sleidiau yn awtomatig. O'r herwydd, efallai y bydd angen i chi ddefnyddio cyfleustodau ychwanegol neu arddulliau arferol i faint cynnwys priodol. Er bod carwsél yn cefnogi rheolaethau a dangosyddion blaenorol/nesaf, nid oes eu hangen yn benodol. Ychwanegu ac addasu fel y gwelwch yn dda.
Gwnewch yn siŵr eich bod chi'n gosod id unigryw ar y .carousel
rheolyddion dewisol, yn enwedig os ydych chi'n defnyddio carwsél lluosog ar un dudalen.
Dyma garwsél gyda sleidiau yn unig. Sylwch ar bresenoldeb y delweddau carwsél .d-block
ac .img-fluid
arnynt i atal aliniad delwedd rhagosodedig y porwr.
<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>
Gan ychwanegu'r rheolyddion blaenorol a'r rheolaethau nesaf:
<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>
Gallwch hefyd ychwanegu'r dangosyddion at y carwsél, ochr yn ochr â'r rheolyddion, hefyd.
<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>
Angen elfen weithredol gychwynnol
Mae .active
angen ychwanegu'r dosbarth at un o'r sleidiau. Fel arall, ni fydd y carwsél yn weladwy.
Ychwanegwch gapsiynau i'ch sleidiau yn hawdd gyda'r .carousel-caption
elfen o fewn unrhyw .carousel-item
. Gellir eu cuddio'n hawdd ar fannau gwylio llai, fel y dangosir isod, gyda chyfleustodau arddangos dewisol . Rydyn ni'n eu cuddio i ddechrau gyda nhw .d-none
ac yn dod â nhw yn ôl ar ddyfeisiau maint canolig gyda .d-md-block
.
Defnyddio priodoleddau data i reoli lleoliad y carwsél yn hawdd. data-slide
yn derbyn yr allweddeiriau prev
neu next
, sy'n newid safle'r sleidiau o'i gymharu â'i safle presennol. Fel arall, defnyddiwch data-slide-to
i basio mynegai sleidiau crai i'r carwsél data-slide-to="2"
, sy'n symud lleoliad y sleidiau i fynegai penodol gan ddechrau gyda 0
.
Defnyddir y data-ride="carousel"
briodwedd i nodi carwsél fel animeiddiad sy'n dechrau ar lwyth tudalen. Ni ellir ei ddefnyddio ar y cyd â chychwyniad JavaScript penodol (diangen a diangen) o'r un carwsél.
Ffoniwch y carwsél â llaw gyda:
Gellir trosglwyddo opsiynau trwy briodoleddau data neu JavaScript. Ar gyfer priodoleddau data, atodwch enw'r opsiwn i data-
, fel yn data-interval=""
.
Enw | Math | Diofyn | Disgrifiad |
---|---|---|---|
cyfwng | rhif | 5000 | Faint o amser i oedi rhwng beicio eitem yn awtomatig. Os yw'n ffug, ni fydd carwsél yn beicio'n awtomatig. |
bysellfwrdd | boolaidd | gwir | A ddylai'r carwsél ymateb i ddigwyddiadau bysellfwrdd. |
saib | llinyn | boolaidd | "hofran" | Os caiff ei osod Ar ddyfeisiadau cyffyrddiad, pan gaiff ei osod i |
marchogaeth | llinyn | ffug | Yn chwarae'r carwsél yn awtomatig ar ôl i'r defnyddiwr feicio'r eitem gyntaf â llaw. Os yw "carwsél", yn chwarae'r carwsél ar lwyth yn awtomatig. |
lapio | boolaidd | gwir | A ddylai'r carwsél feicio'n barhaus neu gael stopiau caled. |
Dulliau a thrawsnewidiadau anghydamserol
Mae pob dull API yn anghydamserol ac yn dechrau trawsnewid . Maen nhw'n dychwelyd at y galwr cyn gynted ag y bydd y cyfnod pontio wedi dechrau ond cyn iddo ddod i ben . Yn ogystal, bydd galwad dull ar gydran trawsnewid yn cael ei anwybyddu .
Yn cychwyn y carwsél gydag opsiynau dewisol object
ac yn dechrau beicio trwy eitemau.
Beicio drwy'r eitemau carwsél o'r chwith i'r dde.
Yn atal y carwsél rhag beicio trwy eitemau.
Yn beicio'r carwsél i ffrâm benodol (0 seiliedig, tebyg i arae). Yn dychwelyd i'r galwr cyn i'r eitem darged gael ei dangos (hy cyn i'r slid.bs.carousel
digwyddiad ddigwydd).
Cylchoedd i'r eitem flaenorol. Yn dychwelyd i'r galwr cyn i'r eitem flaenorol gael ei dangos (hy cyn i'r slid.bs.carousel
digwyddiad ddigwydd).
Beiciau i'r eitem nesaf. Yn dychwelyd i'r galwr cyn i'r eitem nesaf gael ei dangos (hy cyn i'r slid.bs.carousel
digwyddiad ddigwydd).
Yn dinistrio carwsél elfen.
Mae dosbarth carwsél Bootstrap yn datgelu dau ddigwyddiad ar gyfer cysylltu â swyddogaethau carwsél. Mae gan y ddau ddigwyddiad yr eiddo ychwanegol a ganlyn:
direction
: Y cyfeiriad y mae'r carwsél yn llithro iddo (naill ai"left"
neu"right"
).relatedTarget
: Yr elfen DOM sy'n cael ei llithro i'w lle fel yr eitem weithredol.from
: Mynegai'r eitem gyfredolto
: Mynegai'r eitem nesaf
Mae pob digwyddiad carwsél yn cael ei danio at y carwsél ei hun (hy yn y <div class="carousel">
).
Math o Ddigwyddiad | Disgrifiad |
---|---|
sleid.bs.carwsél | Mae'r digwyddiad hwn yn tanio ar unwaith pan fydd y slide dull enghraifft yn cael ei ddefnyddio. |
sleid.bs.carousel | Mae'r digwyddiad hwn yn cael ei danio pan fydd y carwsél wedi cwblhau ei drawsnewidiad sleidiau. |