JavaScript
Pote eleman Bootstrap yo bay lavi ak plis pase yon douzèn grefon jQuery koutim. Fasil enkli yo tout, oswa youn pa youn.
Pote eleman Bootstrap yo bay lavi ak plis pase yon douzèn grefon jQuery koutim. Fasil enkli yo tout, oswa youn pa youn.
Plugins yo ka enkli endividyèlman (lè l sèvi avèk *.js
dosye endividyèl Bootstrap a), oswa tout nan yon fwa (itilize bootstrap.js
oswa minified la bootstrap.min.js
).
Tou de bootstrap.js
ak bootstrap.min.js
genyen tout grefon nan yon sèl dosye. Mete yon sèl sèlman.
Gen kèk grefon ak eleman CSS depann sou lòt grefon. Si ou enkli grefon endividyèlman, asire w ou tcheke pou depandans sa yo nan dokiman yo. Epitou sonje ke tout grefon depann sou jQuery (sa vle di jQuery dwe enkli anvan dosye yo plugin). Konsilte noubower.json
pou wè ki vèsyon jQuery yo sipòte.
Ou ka sèvi ak tout grefon Bootstrap piman atravè API a make san ekri yon sèl liy JavaScript. Sa a se premye klas API Bootstrap a epi li ta dwe premye konsiderasyon ou lè w ap itilize yon Plugin.
Sa te di, nan kèk sitiyasyon li ka dezirab fèmen fonksyonalite sa a. Se poutèt sa, nou bay tou kapasite pou enfim API atribi done yo lè nou dekonekte tout evènman sou dokiman an ki gen espas non ak data-api
. Sa a sanble tankou sa a:
Altènativman, vize yon plugin espesifik, jis enkli non plugin a kòm yon espas non ansanm ak espas non done-api tankou sa a:
Pa sèvi ak atribi done ki soti nan plizyè grefon sou menm eleman an. Pou egzanp, yon bouton pa ka tou de gen yon konsèy sou zouti ak aktive yon modal. Pou akonpli sa, sèvi ak yon eleman anbalaj.
Nou kwè tou ou ta dwe kapab itilize tout grefon Bootstrap sèlman atravè API JavaScript. Tout API piblik yo se yon sèl, metòd chèn, epi retounen koleksyon an aji sou.
Tout metòd yo ta dwe aksepte yon opsyon opsyon opsyon, yon kòd ki vize yon metòd patikilye, oswa pa gen anyen (ki inisye yon plugin ak konpòtman default):
Chak Plugin tou ekspoze konstrukteur anvan tout koreksyon li yo sou yon Constructor
pwopriyete: $.fn.popover.Constructor
. Si ou ta renmen jwenn yon egzanp plugin patikilye, rekipere li dirèkteman nan yon eleman: $('[rel="popover"]').data('popover')
.
Ou ka chanje paramèt defo pou yon plugin lè w modifye Constructor.DEFAULTS
objè plugin a:
Pafwa li nesesè pou itilize grefon Bootstrap ak lòt kad UI. Nan sikonstans sa yo, kolizyon espas non ka detanzantan rive. Si sa rive, ou ka rele .noConflict
sou Plugin ou vle retounen valè a.
Bootstrap bay evènman koutim pou aksyon inik pifò grefon yo. Anjeneral, sa yo vini nan yon fòm enfinitif ak patisipan sot pase yo - kote infinitif la (egzanp show
) deklanche nan kòmansman yon evènman, ak fòm patisipasyon sot pase li yo (egzanp shown
) deklanche sou fini an nan yon aksyon.
Apati 3.0.0, tout evènman Bootstrap yo gen espas non.
Tout evènman infinitif bay preventDefault
fonksyonalite. Sa a bay kapasite pou sispann ekzekisyon yon aksyon anvan li kòmanse.
Tooltips ak Popovers itilize dezenfektan entegre nou an pou dezenfekte opsyon ki aksepte HTML.
Valè default whiteList
la se sa ki annapre yo:
Si ou vle ajoute nouvo valè nan default sa a whiteList
ou ka fè bagay sa yo:
Si ou vle kontoune dezenfektan nou an paske ou prefere sèvi ak yon bibliyotèk devwe, pa egzanp DOMPurify , ou ta dwe fè bagay sa yo:
document.implementation.createHTMLDocument
Nan ka navigatè ki pa sipòte document.implementation.createHTMLDocument
, tankou Internet Explorer 8, fonksyon sanitize entegre la retounen HTML la jan li ye.
Si ou vle fè dezenfekte nan ka sa a, tanpri presize sanitizeFn
epi sèvi ak yon bibliyotèk ekstèn tankou DOMPurify .
Ou ka jwenn vèsyon an nan chak grefon jQuery Bootstrap la atravè VERSION
pwopriyete a nan konstrukteur plugin a. Pa egzanp, pou plugin tooltip la:
Plugins Bootstrap yo pa tonbe patikilyèman avèk gras lè JavaScript enfim. Si ou pran swen eksperyans itilizatè a nan ka sa a, sèvi ak <noscript>
yo eksplike sitiyasyon an (ak ki jan yo re-aktive JavaScript) itilizatè ou yo, epi/oswa ajoute pwòp repwodiksyon koutim ou yo.
Bootstrap pa sipòte ofisyèlman bibliyotèk JavaScript twazyèm pati tankou Prototype oswa jQuery UI. Malgre .noConflict
ak evènman namespaced, ka gen pwoblèm konpatibilite ke ou bezwen ranje poukont ou.
Pou efè tranzisyon senp, enkli transition.js
yon fwa ansanm ak lòt dosye JS yo. Si w ap itilize konpile a (oswa minified) bootstrap.js
, pa gen okenn nesesite pou mete sa a—li deja la.
Transition.js se yon asistan debaz pou transitionEnd
evènman ak yon Emulation tranzisyon CSS. Lòt grefon yo itilize li pou tcheke sipò tranzisyon CSS ak pou trape tranzisyon pandye yo.
Tranzisyon yo ka dezaktive globalman lè l sèvi avèk snippet JavaScript sa a, ki dwe vini apre transition.js
(oswa bootstrap.js
, bootstrap.min.js
selon ka a) te chaje:
Modèl yo rasyonalize, men fleksib, envit dyalòg ak fonksyonalite minimòm ki nesesè yo ak default entelijan.
Asire w ou pa louvri yon modal pandan yon lòt toujou vizib. Montre plis pase yon modal alafwa mande kòd koutim.
Toujou eseye mete kòd HTML yon modal nan yon pozisyon siperyè nan dokiman ou pou evite lòt eleman ki afekte aparans ak/oswa fonksyonalite modal la.
Gen kèk opozisyon konsènan lè l sèvi avèk modal sou aparèy mobil. Gade dokiman sipò navigatè nou an pou plis detay.
Akòz fason HTML5 defini semantik li yo, autofocus
atribi HTML la pa gen okenn efè nan modal Bootstrap. Pou reyalize menm efè a, sèvi ak kèk JavaScript koutim:
Yon modal rann ak header, kò, ak seri aksyon nan pye a.
Aktive yon modal atravè JavaScript lè w klike sou bouton ki anba a. Li pral glise desann ak fennen soti nan tèt paj la.
Asire w ou ajoute role="dialog"
ak aria-labelledby="..."
, referans tit modal la, nan .modal
, ak role="document"
nan .modal-dialog
tèt li.
Anplis de sa, ou ka bay yon deskripsyon dyalòg modal ou a ak aria-describedby
sou .modal
.
Anrejistre videyo YouTube nan modal mande pou JavaScript adisyonèl ki pa nan Bootstrap otomatikman sispann lekti ak plis ankò. Gade pòs itil Stack Overflow sa a pou plis enfòmasyon.
Modal yo gen de gwosè opsyonèl, ki disponib atravè klas modifye yo dwe mete sou yon .modal-dialog
.
Pou modal ki tou senpleman parèt olye ke fennen nan yo wè, retire .fade
klas la nan maketing modal ou a.
Pou pran avantaj de sistèm kadriyaj Bootstrap la nan yon modal, jis nich .row
yo nan .modal-body
ak Lè sa a, sèvi ak klas sistèm kadriyaj nòmal yo.
Gen yon pakèt bouton ki tout deklanche menm modal la, jis ak kontni yon ti kras diferan? Sèvi event.relatedTarget
ak ak HTML data-*
atribi (petèt atravè jQuery ) yo varye sa ki nan modal la depann sou ki bouton yo te klike. Gade dokiman Evènman Modal yo pou plis detay sou relatedTarget
,
Plugin modal la chanje kontni kache ou sou demann, atravè atribi done oswa JavaScript. Li ajoute tou .modal-open
pou <body>
pase sou konpòtman defile default ak jenere yon .modal-backdrop
pou bay yon zòn klike sou pou ranvwaye modal yo montre lè klike deyò modal la.
Aktive yon modal san w pa ekri JavaScript. Mete data-toggle="modal"
sou yon eleman kontwolè, tankou yon bouton, ansanm ak yon data-target="#foo"
oswa href="#foo"
pou vize yon modal espesifik pou activer.
Rele yon modal ak id myModal
ak yon sèl liy JavaScript:
Opsyon yo ka pase atravè atribi done oswa JavaScript. Pou atribi done, ajoute non opsyon a nan data-
, tankou nan data-backdrop=""
.
Non | kalite | default | deskripsyon |
---|---|---|---|
seri | boolean oswa fisèl la'static' |
vre | Gen ladann yon eleman modal-backdrop. Altènativman, presize static pou yon seri ki pa fèmen modal la sou klike sou. |
klavye | booleyen | vre | Fèmen modal la lè yo peze kle chape |
montre | booleyen | vre | Montre modal la lè inisyalize. |
aleka | chemen | fo | Opsyon sa a demode depi v3.3.0 e li te retire nan v4. Nou rekòmande olye pou itilize modèl bò kliyan oswa yon fondasyon done obligatwa, oswa rele jQuery.load tèt ou. Si yo bay yon URL aleka, kontni yo pral chaje yon sèl fwa atravè metòd jQuery a |
.modal(options)
Aktive kontni ou kòm yon modal. Aksepte yon opsyon opsyonèl object
.
.modal('toggle')
Manyèlman aktive yon modal. Retounen bay moun kap rele a anvan modal la aktyèlman te montre oswa kache (sa vle di anvan evènman shown.bs.modal
an hidden.bs.modal
rive).
.modal('show')
Manyèlman ouvè yon modal. Retounen bay moun k ap rele a anvan yo montre modal la (sa vle di anvan shown.bs.modal
evènman an rive).
.modal('hide')
Manyèlman kache yon modal. Retounen bay moun kap rele a anvan modal la te kache (sa vle di anvan hidden.bs.modal
evènman an rive).
.modal('handleUpdate')
Rejiste pozisyon modal la pou kontrekare yon defile nan ka youn ta parèt, ki ta fè so modal la sou bò gòch la.
Sèlman nesesè lè wotè modal la chanje pandan li louvri.
Klas modal Bootstrap a ekspoze kèk evènman pou branche nan fonksyonalite modal.
Tout evènman modal yo tire sou modal la li menm (sa vle di nan la <div class="modal">
).
Kalite Evènman | Deskripsyon |
---|---|
montre.bs.modal | Evènman sa a dife imedyatman lè yo show rele metòd egzanp lan. Si sa te koze pa yon klik, eleman klike la disponib kòm relatedTarget pwopriyete evènman an. |
montre.bs.modal | Evènman sa a revoke lè modal la vin vizib pou itilizatè a (ap tann tranzisyon CSS yo fini). Si sa te koze pa yon klik, eleman klike la disponib kòm relatedTarget pwopriyete evènman an. |
kache.bs.modal | Evènman sa a te tire imedyatman lè yo hide te rele metòd egzanp lan. |
hidden.bs.modal | Evènman sa a revoke lè modal la fini kache pou itilizatè a (ap tann pou tranzisyon CSS fini). |
loaded.bs.modal | Evènman sa a revoke lè modal la te chaje kontni lè l sèvi avèk remote opsyon an. |
Ajoute meni deroulan nan prèske nenpòt bagay ak senp plugin sa a, ki gen ladan navbar la, onglè, ak grenn.
Atravè atribi done oswa JavaScript, Plugin deroule a chanje kontni kache (meni deroulant) lè w chanje .open
klas la sou atik lis paran an.
Sou aparèy mobil, ouvèti yon dropdown ajoute yon .dropdown-backdrop
kòm yon zòn tiyo pou fèmen meni dropdown lè frape deyò meni an, yon kondisyon pou sipò iOS apwopriye. Sa vle di ke chanje soti nan yon meni deroule louvri nan yon meni deroule diferan mande pou yon tiyo siplemantè sou mobil.
Remak: Se data-toggle="dropdown"
atribi a konte sou pou fèmen meni deroulan nan yon nivo aplikasyon, kidonk li se yon bon lide pou toujou sèvi ak li.
Ajoute data-toggle="dropdown"
nan yon lyen oswa bouton pou aktive yon deroulan.
Pou kenbe URL yo entak ak bouton lyen, sèvi ak data-target
atribi a olye pou yo href="#"
.
Rele dropdowns yo atravè JavaScript:
data-toggle="dropdown"
toujou obligatwaKèlkeswa si wi ou non ou rele dropdown ou atravè JavaScript oswa olye de itilize done-api a, data-toggle="dropdown"
se toujou oblije prezan sou eleman deklanche dropdown la.
Okenn
$().dropdown('toggle')
Aktive meni dewoulman yon ba nav oswa navigasyon onglet yo bay.
Tout evènman dropdown yo tire nan .dropdown-menu
eleman paran '.
Tout evènman dropdown gen yon relatedTarget
pwopriyete, ki gen valè se eleman jete lank baskile.
Kalite Evènman | Deskripsyon |
---|---|
montre.bs.dropdown | Evènman sa a dife imedyatman lè yo rele metòd montre egzanp lan. |
montre.bs.dropdown | Evènman sa a te revoke lè deroule a te fè vizib itilizatè a (ap tann tranzisyon CSS, pou konplete). |
kache.bs.dropdown | Evènman sa a revoke imedyatman lè yo te rele metòd egzanp kache. |
hidden.bs.dropdown | Evènman sa a revoke lè dropdown la fini kache pou itilizatè a (ap tann tranzisyon CSS, pou konplete). |
Plugin ScrollSpy a se pou mete ajou otomatikman sib navigasyon ki baze sou pozisyon woulo liv la. Scroll zòn ki anba a navbar epi gade chanjman nan klas aktif. Sou atik yo deroule yo pral make tou.
Ad leggings keytar, kolasyon id atizay pati dolor labore. Pitchfork yr enim lo-fi avan yo vann out qui. Tumblr dwa bisiklèt fèm-a-tab tou sa. Anim keffiyeh carles cardigan. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby sweater lomo jean shorts, williamsburg hoodie minim qui ou pwobableman pa tande pale de yo et cardigan trust fund culpa biodiesel wes anderson estetik. Nihil tattooed accusamus, kredi iwoni biodiesel keffiyeh atizan ullamco consequat.
Veniam marfa moustache skateboard, adipisicing fugiat velit pitchfork bab. Freegan beard aliqua cupidatat mcsweeney's vero. Cupidatat kat loko nisi, ea helvetica nulla carles. Kamyon manje kosby chanday tatouage, mcsweeney's quis non freegan vinyl. Lo-fi wes anderson +1 sartorial. Carles non ekzèsisman estetik kis gentrify. Brooklyn adipisicing craft byer vis keytar deserunt.
Occaecat commodo aliqua delectus. Fap craft byer deserunt skateboard ea. Lomo bicycle right adipisicing banh mi, velit ea are next level locavore single-orijin coffee in magna veniam. High life id vinyl, echo park consequat quis aliquip banh mi pitchfork. Vero VHS se adipisicing. Consectetur nisi DIY minim messenger bag. Kredi ansyen nan, durable delectus consectetur fanny pack iphone.
In incididunt echo park, officia deserunt mcsweeney's proident master cleanse thundercats sapiente veniam. Excepteur VHS elit, proident shoreditch +1 biodiesel laborum craft beer. Single-origin coffee wayfarers irure four loko, cupidatat terry richardson master cleanse. Assumenda you probably haven't heard of them art party fanny pack, tattooed nulla cardigan tempor ad. Proident wolf nesciunt sartorial keffiyeh eu banh mi sustainable. Elit wolf voluptate, lo-fi ea portland before they sold out four loko. Locavore enim nostrud mlkshk brooklyn nesciunt.
Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi before they sold out qui. Tumblr farm-to-table bicycle rights whatever. Anim keffiyeh carles cardigan. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby sweater lomo jean shorts, williamsburg hoodie minim qui you probably haven't heard of them et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tattooed accusamus, cred irony biodiesel keffiyeh artisan ullamco consequat.
Keytar twee blog, culpa messenger bag marfa whatever delectus food truck. Sapient synth id assumenda. Locavore sed helvetica cliche iwoni, thundercats ou pwobableman pa te tande pale de yo consequat hoodie gluten-free lo-fi fap aliquip. Travay elit placeat before they sold out, Terry Richardson proident brunch nesciunt kis cosby sweater pariatur keffiyeh ut helvetica artisan. Cardigan craft beer seitan readymade velit. VHS chambray laboris tempor veniam. Anim mollit minim commodo ullamco thundercats.
Lyen Navbar yo dwe gen sib id ki ka rezoud. Pou egzanp, yon <a href="#home">home</a>
dwe koresponn ak yon bagay nan DOM la tankou <div id="home"></div>
.
:visible
sib yo inyoreEleman sib ki pa :visible
dapre jQuery yo pral inyore ak atik nav korespondan yo p ap janm make.
Pa gen pwoblèm metòd aplikasyon an, scrollspy mande pou itilize position: relative;
sou eleman w ap espyonaj sou. Nan pifò ka sa a se <body>
. Lè scrollspying sou eleman lòt pase <body>
, asire w ke ou gen yon height
seri ak overflow-y: scroll;
aplike.
Pou ajoute fasilman konpòtman scrollspy nan navigasyon topbar ou a, ajoute data-spy="scroll"
nan eleman ou vle al rekonèt (pi tipikman sa a ta dwe <body>
). Lè sa a, ajoute data-target
atribi a ak ID oswa klas eleman paran nenpòt .nav
eleman Bootstrap.
Apre w fin ajoute position: relative;
CSS ou a, rele scrollspy via JavaScript:
.scrollspy('refresh')
Lè w ap itilize scrollspy ansanm ak ajoute oswa retire eleman nan DOM, w ap bezwen rele metòd rafrechisman an konsa:
Opsyon yo ka pase atravè atribi done oswa JavaScript. Pou atribi done, ajoute non opsyon a nan data-
, tankou nan data-offset=""
.
Non | kalite | default | deskripsyon |
---|---|---|---|
konpanse | nimewo | 10 | Piksèl pou konpanse nan tèt lè w ap kalkile pozisyon woulo liv la. |
Kalite Evènman | Deskripsyon |
---|---|
active.bs.scrollspy | Evènman sa a dife chak fwa yon nouvo atik vin aktive pa scrollspy la. |
Ajoute fonksyonalite rapid, dinamik tab pou tranzisyon atravè fenèt kontni lokal yo, menm atravè meni dewoulan. Onglet anbrike yo pa sipòte.
Denim kri ou pwobableman pa te tande pale de yo pantalon pantalon jean Austin. Nesciunt tofou stumptown aliqua, rétro synth mèt netwaye. Moustache cliche tempor, williamsburg carles vegan helvetica. Reprehenderit bouche retro kefiyeh dreamcatcher synth. Cosby sweater eu banh mi, ki irure terry richardson ex squid. Aliquip placeat salvia cillum iphone. Seitan aliquip quis cardigan american apparel, butcher voluptate nisi qui.
Food truck fixie locavore, accusamus mcsweeney's marfa nulla single-origin coffee squid. Exercitation +1 labore velit, blog sartorial PBR leggings next level wes anderson artisan four loko farm-to-table craft beer twee. Qui photo booth letterpress, commodo enim craft beer mlkshk aliquip jean shorts ullamco ad vinyl cillum PBR. Homo nostrud organic, assumenda labore aesthetic magna delectus mollit. Keytar helvetica VHS salvia yr, vero magna velit sapiente labore stumptown. Vegan fanny pack odio cillum wes anderson 8-bit, sustainable jean shorts beard ut DIY ethical culpa terry richardson biodiesel. Art party scenester stumptown, tumblr butcher vero sint qui sapiente accusamus tattooed echo park.
Etsy mixtape wayfarers, ethical wes anderson tofu before they sold out mcsweeney's organic lomo retro fanny pack lo-fi farm-to-table readymade. Messenger bag gentrify pitchfork tattooed craft beer, iphone skateboard locavore carles etsy salvia banksy hoodie helvetica. DIY synth PBR banksy irony. Leggings gentrify squid 8-bit cred pitchfork. Williamsburg banh mi whatever gluten-free, carles pitchfork biodiesel fixie etsy retro mlkshk vice blog. Scenester cred you probably haven't heard of them, vinyl craft beer blog stumptown. Pitchfork sustainable tofu synth chambray yr.
Trust fund seitan letterpress, keytar raw denim keffiyeh etsy art party before they sold out master cleanse gluten-free squid scenester freegan cosby sweater. Fanny pack portland seitan DIY, art party locavore wolf cliche high life echo park Austin. Cred vinyl keffiyeh DIY salvia PBR, banh mi before they sold out farm-to-table VHS viral locavore cosby sweater. Lomo wolf viral, mustache readymade thundercats keffiyeh craft beer marfa ethical. Wolf salvia freegan, sartorial keffiyeh echo park vegan.
Plugin sa a pwolonje eleman navigasyon tab la pou ajoute zòn tabtab.
Pèmèt onglè tabulab yo atravè JavaScript (yo bezwen chak tab aktive endividyèlman):
Ou ka aktive onglè endividyèl yo nan plizyè fason:
Ou ka aktive yon tab oswa navigasyon grenn san yo pa ekri okenn JavaScript pa senpleman espesifye data-toggle="tab"
oswa data-toggle="pill"
sou yon eleman. Ajoute nav
ak nav-tabs
klas yo nan tab la pral aplike style tabul
la Bootstrap , pandan y ap ajoute klas yo ak yo pral aplike stil grenn .nav
nav-pills
Pou fè onglet fennen nan, ajoute .fade
nan chak .tab-pane
. Premye volet tab la dwe genyen tou .in
pou fè kontni inisyal la vizib.
$().tab
Aktive yon eleman tab ak yon veso kontni. Tab ta dwe gen swa yon data-target
oswa yon href
vize yon ne veso nan DOM la. Nan egzanp ki anwo yo, onglè yo se <a>
s yo ak data-toggle="tab"
atribi.
.tab('show')
Chwazi tab la bay epi montre kontni ki asosye li yo. Nenpòt lòt tab ki te chwazi deja vin pa seleksyone epi kontni ki asosye li yo kache. Retounen bay moun kap rele a anvan yo te montre volet tab la (sa vle di anvan shown.bs.tab
evènman an rive).
Lè w ap montre yon nouvo tab, evènman yo pran dife nan lòd sa a:
hide.bs.tab
(sou onglet aktif aktyèl la)show.bs.tab
(sou onglet ki dwe montre)hidden.bs.tab
(sou onglet aktif anvan an, menm jan ak hide.bs.tab
evènman an)shown.bs.tab
(sou onglet ki fèk parèt aktif la, menm bagay la tou pou show.bs.tab
evènman an)Si pa gen okenn tab te deja aktif, Lè sa a, hide.bs.tab
ak hidden.bs.tab
evènman yo pa pral revoke.
Kalite Evènman | Deskripsyon |
---|---|
montre.bs.tab | Evènman sa a dife sou tab montre, men anvan yo te montre nouvo tab la. Sèvi event.target ak ak event.relatedTarget pou vize tab aktif la ak tab aktif anvan an (si disponib) respektivman. |
montre.bs.tab | Evènman sa a pran dife sou tab montre apre yo fin montre yon tab. Sèvi event.target ak ak event.relatedTarget pou vize tab aktif la ak tab aktif anvan an (si disponib) respektivman. |
kache.bs.tab | Evènman sa a dife lè yon nouvo tab yo dwe montre (e konsa tab aktif anvan an dwe kache). Sèvi event.target ak ak event.relatedTarget pou vize onglet aktyèl la aktif ak nouvo tab la byento-a-aktif, respektivman. |
hidden.bs.tab | Evènman sa a dife apre yo fin montre yon nouvo tab (e konsa tab aktif anvan an kache). Sèvi event.target ak ak event.relatedTarget pou vize tab aktif anvan an ak nouvo tab aktif la, respektivman. |
Enspire pa ekselan plugin jQuery.tipsy ekri pa Jason Frame; Ti konsèy yo se yon vèsyon mete ajou, ki pa konte sou imaj, sèvi ak CSS3 pou animasyon, ak done-atribi pou estokaj tit lokal yo.
Konsèy zouti ak tit zewo-longè pa janm parèt.
Pase sou lyen ki anba yo pou wè konsèy sou zouti:
Pantalon sere pwochen nivo keffiyeh ou pwobableman pa te tande pale de yo. Photo Booth bab kri abako letterpress vegan mesaje sak stumptown. Farm-to-table seitan, mcsweeney's fixie sustainable quinoa 8-bit american clothing gen yon terry richardson vinyl chambray. Beard stumptown, cardigans banh mi lomo thundercats. Tofou biodiesel williamsburg marfa, kat loko Mcsweeney a netwaye vegan chambray. Yon atizan vrèman ironik kèlkeswa keytar , scenester farm-to-table banksy Austin twitter manch freegan cred raw denim sèl-orijin kafe viral.
Gen kat opsyon ki disponib: anwo, adwat, anba, ak aliye agoch.
Pou rezon pèfòmans, Tooltip ak Popover done-apis yo patisipe, sa vle di ou dwe inisyalize yo tèt ou .
Youn nan fason yo inisyalize tout konsèy sou yon paj ta dwe chwazi yo pa data-toggle
atribi yo:
Plugin konsèy zouti a jenere kontni ak mak sou demann, epi pa default mete konsèy zouti apre eleman deklanche yo.
Deklanche konsèy zouti a atravè JavaScript:
Marke ki nesesè pou yon konsèy zouti se sèlman yon data
atribi epi title
sou eleman HTML ou vle gen yon konsèy. Markup pwodwi a nan yon konsèy zouti se pito senp, menm si li mande pou yon pozisyon (pa default, mete nan top
pa Plugin la).
Pafwa ou vle ajoute yon konsèy sou yon lyen ki vlope plizyè liy. Konpòtman defo plugin tooltip la se santre li orizontal ak vètikal. Ajoute white-space: nowrap;
lank ou pou evite sa.
Lè w ap itilize konsèy sou eleman ki nan yon .btn-group
oswa yon .input-group
, oswa sou eleman ki gen rapò ak tab ( <td>
, <th>
, <tr>
, <thead>
, <tbody>
, <tfoot>
), w ap oblije presize opsyon an container: 'body'
(ki dokimante anba a) pou evite efè segondè endezirab (tankou eleman an ap grandi pi laj ak/). oswa pèdi kwen awondi li yo lè konsèy zouti a deklanche).
Pou itilizatè k ap navige ak yon klavye, epi an patikilye itilizatè teknoloji asistans, ou ta dwe sèlman ajoute konsèy sou eleman ki konsantre sou klavye tankou lyen, kontwòl fòm, oswa nenpòt eleman abitrè ki gen yon tabindex="0"
atribi.
Pou ajoute yon konsèy sou yon disabled
oswa yon .disabled
eleman, mete eleman nan andedan yon <div>
epi aplike enfòmasyon an sou sa <div>
pito.
Opsyon yo ka pase atravè atribi done oswa JavaScript. Pou atribi done, ajoute non opsyon a nan data-
, tankou nan data-animation=""
.
Remake byen ke pou rezon sekirite sanitize
, sanitizeFn
ak whiteList
opsyon yo pa ka apwovizyone lè l sèvi avèk atribi done yo.
Non | Kalite | Default | Deskripsyon |
---|---|---|---|
animasyon | booleyen | vre | Aplike yon tranzisyon CSS fennen nan konsèy zouti a |
veso | fisèl | fo | fo | Mete konsèy zouti a nan yon eleman espesifik. Egzanp: |
reta | nimewo | objè | 0 | Reta montre ak kache konsèy zouti a (ms) - pa aplike nan kalite deklanche manyèl Si yo bay yon nimewo, reta aplike pou tou de kache/montre Estrikti objè se: |
html | booleyen | fo | Mete HTML nan enfòmasyon an. Si se fo, yo text pral itilize metòd jQuery pou mete kontni nan DOM la. Sèvi ak tèks si w enkyete w pou atak XSS. |
plasman | fisèl | fonksyon | 'top' | Ki jan yo pozisyon konsèy la - tèt | anba | kite | dwa | oto. Lè yo itilize yon fonksyon pou detèmine plasman an, yo rele li ak ne DOM konsèy kòm premye agiman li yo ak ne DOM eleman deklanche kòm dezyèm li. Kontèks |
seleksyon | fisèl | fo | Si yo bay yon seleksyon, objè konsèy yo pral delege nan sib yo espesifye. Nan pratik, sa a yo itilize pou aplike tou konsèy sou eleman DOM ( jQuery.on sipò). Gade sa a ak yon egzanp enfòmatif . |
modèl | fisèl | '<div class="tooltip" role="tooltip"><div class="tooltip-arrow"></div><div class="tooltip-inner"></div></div>' |
Sèvi ak HTML de baz lè w ap kreye enfòmasyon an. Yo
Eleman wrapper ki pi eksteryè a ta dwe gen |
tit | fisèl | fonksyon | '' | Valè tit default si Si yo bay yon fonksyon, yo pral rele l ak |
deklanche | fisèl | 'konsantre sou plan' | Ki jan konsèy zouti yo deklanche - klike sou | hover | konsantre | manyèl. Ou ka pase plizyè deklanche; separe yo ak yon espas. manual pa ka konbine avèk okenn lòt deklanche. |
Viewport | fisèl | objè | fonksyon | {Selektè: 'kò', padding: 0} | Kenbe ti konsèy la nan limit eleman sa a. Egzanp: Si yo bay yon fonksyon, li rele ak eleman deklanche DOM ne kòm sèl agiman li. Kontèks |
dezenfekte | booleyen | vre | Aktive oswa enfim sanitizasyon an. Si yo aktive 'template' , 'content' ak 'title' opsyon yo pral dezenfekte. |
lis blan | objè | Valè default | Objè ki gen atribi ak tags pèmèt |
sanitizeFn | nil | fonksyon | nil | Isit la ou ka bay pwòp fonksyon dezenfekte ou. Sa a ka itil si ou prefere sèvi ak yon bibliyotèk devwe pou fè dezenfekte. |
Opsyon pou konsèy endividyèl yo ka altènativman espesifye atravè itilizasyon atribi done, jan yo eksplike sa pi wo a.
$().tooltip(options)
Tache yon moun ki okipe enfòmasyon sou yon koleksyon eleman.
.tooltip('show')
Revele konsèy zouti yon eleman. Retounen bay moun kap rele a anvan yo te montre enfòmasyon an (sa vle di anvan shown.bs.tooltip
evènman an rive). Sa a konsidere kòm yon "manyèl" deklanche nan konsèy la. Konsèy zouti ak tit zewo-longè pa janm parèt.
.tooltip('hide')
Kache konsèy yon eleman. Retounen bay moun kap rele a anvan enfòmasyon an te kache (sa vle di anvan hidden.bs.tooltip
evènman an rive). Sa a konsidere kòm yon "manyèl" deklanche nan konsèy la.
.tooltip('toggle')
Aktivite konsèy zouti yon eleman. Retounen bay moun kap rele a anvan yo te montre enfòmasyon an aktyèlman oswa kache (sa vle di anvan evènman shown.bs.tooltip
an hidden.bs.tooltip
rive). Sa a konsidere kòm yon "manyèl" deklanche nan konsèy la.
.tooltip('destroy')
Kache epi detwi ti konsèy yon eleman. Konsèy zouti ki sèvi ak delegasyon (ki kreye lè l sèvi avèk opsyon selector
an ) pa ka detwi endividyèlman sou eleman deklanche desandan yo.
Kalite Evènman | Deskripsyon |
---|---|
montre.bs.tooltip | Evènman sa a dife imedyatman lè yo show rele metòd egzanp lan. |
montre.bs.tooltip | Evènman sa a revoke lè konsèy zouti a vin vizib pou itilizatè a (ap tann tranzisyon CSS yo fini). |
kache.bs.tooltip | Evènman sa a te tire imedyatman lè yo hide te rele metòd egzanp lan. |
hidden.bs.tooltip | Evènman sa a revoke lè konsèy zouti a fini kache pou itilizatè a (ap tann pou tranzisyon CSS fini). |
inserted.bs.tooltip | Evènman sa a revoke apre show.bs.tooltip evènman an lè yo te ajoute modèl konsèy zouti a nan DOM la. |
Ajoute ti kouvri kontni, tankou sa yo sou iPad a, nan nenpòt eleman pou lojman segondè enfòmasyon.
Popovers ki gen tou de tit ak kontni se zewo longè yo pa janm parèt.
Popovers mande pou plugin tooltip la pou mete nan vèsyon ou nan Bootstrap.
Pou rezon pèfòmans, Tooltip ak Popover done-apis yo patisipe, sa vle di ou dwe inisyalize yo tèt ou .
Youn nan fason yo inisyalize tout popovers sou yon paj ta dwe chwazi yo pa data-toggle
atribi yo:
Lè w ap itilize popovers sou eleman ki nan yon .btn-group
oswa yon .input-group
, oswa sou eleman ki gen rapò ak tab ( <td>
, <th>
, <tr>
, <thead>
, <tbody>
, <tfoot>
), w ap oblije presize opsyon a container: 'body'
(ki dokimante anba a) pou evite efè segondè vle (tankou eleman an ap grandi pi laj ak/). oswa pèdi kwen awondi li yo lè popover a deklanche).
Pou ajoute yon popover nan yon disabled
oswa .disabled
eleman, mete eleman nan andedan yon <div>
epi aplike popover a <div>
pito.
Pafwa ou vle ajoute yon popover nan yon hyperlink ki vlope plizyè liy. Konpòtman default plugin popover a se santre li orizontal ak vètikal. Ajoute white-space: nowrap;
lank ou pou evite sa.
Gen kat opsyon ki disponib: anwo, adwat, anba, ak aliye agoch.
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Sèvi ak focus
deklanche a pou ranvwaye popovers sou pwochen klik itilizatè a fè.
Pou bon konpòtman kwa-navigatè ak kwa-platfòm, ou dwe itilize <a>
tag la, pa tag la <button>
, epi ou dwe gen ladan tou atribi yo role="button"
ak .tabindex
Pèmèt popovers via JavaScript:
Opsyon yo ka pase atravè atribi done oswa JavaScript. Pou atribi done, ajoute non opsyon a nan data-
, tankou nan data-animation=""
.
Remake byen ke pou rezon sekirite sanitize
, sanitizeFn
ak whiteList
opsyon yo pa ka apwovizyone lè l sèvi avèk atribi done yo.
Non | Kalite | Default | Deskripsyon |
---|---|---|---|
animasyon | booleyen | vre | Aplike yon tranzisyon CSS fennen nan popover la |
veso | fisèl | fo | fo | Mete popover a nan yon eleman espesifik. Egzanp: |
kontni | fisèl | fonksyon | '' | Valè kontni par défaut si Si yo bay yon fonksyon, yo pral rele li ak |
reta | nimewo | objè | 0 | Reta montre ak kache popover a (ms) - pa aplike nan kalite deklanche manyèl Si yo bay yon nimewo, reta aplike pou tou de kache/montre Estrikti objè se: |
html | booleyen | fo | Mete HTML nan popover a. Si se fo, yo text pral itilize metòd jQuery pou mete kontni nan DOM la. Sèvi ak tèks si w enkyete w pou atak XSS. |
plasman | fisèl | fonksyon | 'dwa' | Ki jan yo pozisyon popover a - tèt | anba | kite | dwa | oto. Lè yo itilize yon fonksyon pou detèmine plasman an, yo rele li ak popover DOM kòm premye agiman li epi deklanche eleman DOM kòm dezyèm li. Kontèks |
seleksyon | fisèl | fo | Si yo bay yon seleksyon, objè popover yo pral delege nan sib yo espesifye. Nan pratik, sa a yo itilize pou pèmèt kontni HTML dinamik pou ajoute popovers. Gade sa a ak yon egzanp enfòmatif . |
modèl | fisèl | '<div class="popover" role="tooltip"><div class="arrow"></div><h3 class="popover-title"></h3><div class="popover-content"></div></div>' |
Baz HTML pou itilize lè w ap kreye popover a. Popover a Popover a
Eleman wrapper ki pi eksteryè a ta dwe gen |
tit | fisèl | fonksyon | '' | Valè tit default si Si yo bay yon fonksyon, yo pral rele li ak |
deklanche | fisèl | 'klike' | Ki jan popover deklanche - klike sou | hover | konsantre | manyèl. Ou ka pase plizyè deklanche; separe yo ak yon espas. manual pa ka konbine avèk okenn lòt deklanche. |
Viewport | fisèl | objè | fonksyon | {Selektè: 'kò', padding: 0} | Kenbe popover a nan limit eleman sa a. Egzanp: Si yo bay yon fonksyon, li rele ak eleman deklanche DOM ne kòm sèl agiman li. Kontèks |
dezenfekte | booleyen | vre | Aktive oswa enfim sanitizasyon an. Si yo aktive 'template' , 'content' ak 'title' opsyon yo pral dezenfekte. |
lis blan | objè | Valè default | Objè ki gen atribi ak tags pèmèt |
sanitizeFn | nil | fonksyon | nil | Isit la ou ka bay pwòp fonksyon dezenfekte ou. Sa a ka itil si ou prefere sèvi ak yon bibliyotèk devwe pou fè dezenfekte. |
Opsyon pou popovers endividyèl yo ka altènativman espesifye atravè itilizasyon atribi done, jan yo eksplike sa pi wo a.
$().popover(options)
Inisyalize popovers pou yon koleksyon eleman.
.popover('show')
Revele popover yon eleman. Retounen bay moun kap rele a anvan popover a aktyèlman te montre (sa vle di anvan shown.bs.popover
evènman an rive). Sa a konsidere kòm yon "manyèl" deklanche popover la. Popovers ki gen tou de tit ak kontni se zewo longè yo pa janm parèt.
.popover('hide')
Kache popover yon eleman. Retounen bay moun kap rele a anvan popover a aktyèlman kache (sa vle di anvan hidden.bs.popover
evènman an rive). Sa a konsidere kòm yon "manyèl" deklanche popover la.
.popover('toggle')
Aktivite popover yon eleman. Retounen bay moun kap rele a anvan popover a aktyèlman te montre oswa kache (sa vle di anvan evènman shown.bs.popover
an hidden.bs.popover
rive). Sa a konsidere kòm yon "manyèl" deklanche popover la.
.popover('destroy')
Kache epi detwi popover yon eleman. Popovers ki itilize delegasyon (ki kreye lè l sèvi avèk opsyon selector
an ) pa ka detwi endividyèlman sou eleman deklanche desandan yo.
Kalite Evènman | Deskripsyon |
---|---|
montre.bs.popover | Evènman sa a dife imedyatman lè yo show rele metòd egzanp lan. |
montre.bs.popover | Evènman sa a revoke lè popover a vin vizib pou itilizatè a (ap tann pou tranzisyon CSS fini). |
kache.bs.popover | Evènman sa a te tire imedyatman lè yo hide te rele metòd egzanp lan. |
hidden.bs.popover | Evènman sa a revoke lè popover a fini kache pou itilizatè a (ap tann pou tranzisyon CSS fini). |
inserted.bs.popover | Evènman sa a revoke apre show.bs.popover evènman an lè yo te ajoute modèl popover nan DOM la. |
Ajoute fonksyonalite ranvwaye nan tout mesaj alèt ak plugin sa a.
Lè w ap itilize yon .close
bouton, li dwe premye pitit la .alert-dismissible
epi pa gen okenn kontni tèks ki ka vin devan li nan maketing la.
Chanje sa ak sa epi eseye ankò. Men, li pa gen okenn komodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.
Jis ajoute data-dismiss="alert"
nan bouton fèmen ou a otomatikman bay yon fonksyonalite fèmen alèt. Fèmen yon alèt retire li nan DOM la.
Pou fè alèt ou yo sèvi ak animasyon lè yo fèmen, asire w ke yo gen klas yo .fade
ak .in
yo deja aplike pou yo.
$().alert()
Fè yon alèt koute pou evènman klike sou eleman desandan ki gen data-dismiss="alert"
atribi a. (Pa nesesè lè w ap itilize oto-inisyalizasyon done-api a.)
$().alert('close')
Fèmen yon alèt lè w retire li nan DOM la. Si klas yo .fade
ak .in
yo prezan sou eleman an, alèt la ap disparèt anvan li retire li.
Plugin alèt Bootstrap a ekspoze kèk evènman pou branche nan fonksyonalite alèt.
Kalite Evènman | Deskripsyon |
---|---|
fèmen.bs.alèt | Evènman sa a dife imedyatman lè yo close rele metòd egzanp lan. |
fèmen.bs.alèt | Evènman sa a revoke lè alèt la fèmen (ap tann tranzisyon CSS yo fini). |
Fè plis ak bouton. Kontwole eta bouton oswa kreye gwoup bouton pou plis konpozan tankou ba zouti.
Firefox pèsiste eta kontwòl fòm (enfimite ak checkedness) atravè chaj paj . Yon solisyon pou sa a se sèvi ak autocomplete="off"
. Gade ensèk Mozilla #654072 .
Ajoute data-loading-text="Loading..."
pou itilize yon eta chaje sou yon bouton.
Karakteristik sa a demode depi v3.3.5 e li te retire nan v4.
Pou dedomajman pou demonstrasyon sa a, nou ap itilize data-loading-text
ak $().button('loading')
, men sa a se pa eta a sèlman ou ka itilize. Gade plis sou sa anba a nan $().button(string)
dokiman an .
Ajoute data-toggle="button"
pou aktive baskile sou yon sèl bouton.
.active
akaria-pressed="true"
Pou bouton pre-toggled, ou dwe ajoute .active
klas la ak aria-pressed="true"
atribi a nan button
tèt ou.
Ajoute data-toggle="buttons"
nan yon .btn-group
kaz ki gen ladann oswa entrées radyo pou pèmèt baskile nan estil respektif yo.
.active
Pou opsyon preseleksyone, ou dwe ajoute .active
klas la nan opinyon an label
tèt ou.
Si eta tcheke kaz bouton an mete ajou san yo pa tire yon click
evènman sou bouton an (egzanp atravè <input type="reset">
oswa atravè mete checked
pwopriyete a nan opinyon an), w ap bezwen aktive .active
klas la sou opinyon an label
tèt ou.
$().button('toggle')
Baskile pouse eta a. Bay bouton an aparans ke li te aktive.
$().button('reset')
Reyajiste eta bouton - chanje tèks nan tèks orijinal la. Metòd sa a se asenkron epi li retounen anvan reset la fini.
$().button(string)
Boukante tèks nan nenpòt eta done defini tèks.
Plugin fleksib ki itilize yon ti ponyen klas pou yon konpòtman fasil.
Efondreman mande pou Plugin tranzisyon an dwe enkli nan vèsyon ou nan Bootstrap.
Klike sou bouton ki anba yo pou montre ak kache yon lòt eleman atravè chanjman klas yo:
.collapse
kache kontni.collapsing
yo aplike pandan tranzisyon yo.collapse.in
montre kontniOu ka itilize yon lyen ak href
atribi a, oswa yon bouton ak data-target
atribi a. Nan de ka yo, data-toggle="collapse"
li nesesè.
Pwolonje konpòtman efondreman default la pou kreye yon akòdeyon ak eleman panèl la.
Li posib tou pou swap soti .panel-body
s ak .list-group
s.
Asire ou ke ou ajoute aria-expanded
nan eleman kontwòl la. Atribi sa a klèman defini eta aktyèl la nan eleman ki rabat nan ekran lektè ak teknoloji asistans menm jan an. Si eleman plimyab la fèmen pa default, li ta dwe gen yon valè aria-expanded="false"
. Si ou te mete eleman ki rabat la louvri pa default lè l sèvi avèk in
klas la, mete aria-expanded="true"
sou kontwòl la pito. Plugin a pral otomatikman aktive atribi sa a ki baze sou si wi ou non eleman ki rabat la te louvri oswa fèmen.
Anplis de sa, si eleman kontwòl ou a ap vize yon sèl eleman ki plizye – sa vle di data-target
atribi a ap lonje dwèt sou yon id
seleksyon – ou ka ajoute yon lòt aria-controls
atribi nan eleman kontwòl la, ki gen ladan id
eleman ki pliye a. Lektè ekran modèn yo ak teknoloji asistans ki sanble yo sèvi ak atribi sa a pou bay itilizatè yo rakoursi adisyonèl pou navige dirèkteman nan eleman ki rabat nan tèt li.
Plugin efondreman an itilize kèk klas pou okipe leve lou:
.collapse
kache kontni an.collapse.in
montre kontni an.collapsing
yo ajoute lè tranzisyon an kòmanse, epi li retire lè li finiOu ka jwenn klas sa yo nan component-animations.less
.
Jis ajoute data-toggle="collapse"
ak yon data-target
nan eleman nan otomatikman bay kontwòl nan yon eleman pliable. Atribi a data-target
aksepte yon seleksyon CSS pou aplike efondreman an. Asire ou ke ou ajoute klas collapse
la nan eleman ki rabat. Si ou ta renmen li louvri defo, ajoute klas adisyonèl lain
.
Pou ajoute jesyon gwoup ki sanble ak akòdeyon nan yon kontwòl ki kapab retire, ajoute atribi done yo data-parent="#selector"
. Al gade nan Demo a pou wè sa a an aksyon.
Pèmèt manyèlman ak:
Opsyon yo ka pase atravè atribi done oswa JavaScript. Pou atribi done, ajoute non opsyon a nan data-
, tankou nan data-parent=""
.
Non | kalite | default | deskripsyon |
---|---|---|---|
paran | seleksyon | fo | Si yo bay yon seleksyon, Lè sa a, tout eleman plimyab anba paran espesifye a pral fèmen lè yo montre atik plimyab sa a. (menm jan ak konpòtman akòdeyon tradisyonèl - sa a depann sou panel klas la) |
baskile | booleyen | vre | Aktivite eleman ki rabat sou envokasyon |
.collapse(options)
Aktive kontni ou kòm yon eleman plim. Aksepte yon opsyon opsyonèl object
.
.collapse('toggle')
Baskile yon eleman ki rabat pou montre oswa kache. Retounen bay moun k ap rele a anvan yo te montre oswa kache eleman ki rabat (sa vle di anvan evènman shown.bs.collapse
an hidden.bs.collapse
rive).
.collapse('show')
Montre yon eleman rabat. Retounen bay moun k ap rele a anvan yo te montre eleman ki rabat la (sa vle di anvan shown.bs.collapse
evènman an rive).
.collapse('hide')
Kache yon eleman rabat. Retounen bay moun k ap rele a anvan yo te kache eleman ki rabat (sa vle di anvan hidden.bs.collapse
evènman an rive).
Klas efondreman Bootstrap a ekspoze kèk evènman pou branche nan fonksyonalite efondreman.
Kalite Evènman | Deskripsyon |
---|---|
montre.bs.effondreman | Evènman sa a dife imedyatman lè yo show rele metòd egzanp lan. |
montre.bs.effondreman | Evènman sa a revoke lè yon eleman tonbe vin vizib pou itilizatè a (ap tann tranzisyon CSS yo fini). |
kache.bs.effondreman | Evènman sa a te tire imedyatman lè yo hide te rele metòd la. |
hidden.bs.effondreman | Evènman sa a revoke lè yon eleman tonbe kache nan men itilizatè a (ap tann pou tranzisyon CSS fini). |
Yon eleman diaporama pou monte bisiklèt nan eleman, tankou yon Carousel. Karousel anbrike yo pa sipòte.
Eleman Carousel la jeneralman pa konfòme ak estanda aksè. Si ou bezwen konfòme, tanpri konsidere lòt opsyon pou prezante kontni ou.
Bootstrap itilize sèlman CSS3 pou animasyon li yo, men Internet Explorer 8 & 9 pa sipòte pwopriyete CSS ki nesesè yo. Kidonk, pa gen okenn animasyon tranzisyon glise lè w ap itilize navigatè sa yo. Nou te espre deside pa enkli jQuery ki baze sou remplacement pou tranzisyon yo.
Yo .active
dwe ajoute klas la nan youn nan glisad yo. Sinon, Carousel la pa pral vizib.
Ak klas .glyphicon .glyphicon-chevron-left
yo .glyphicon .glyphicon-chevron-right
pa nesesèman nesesè pou kontwòl yo. Bootstrap bay .icon-prev
ak .icon-next
kòm altènativ Unicode plenn.
Ajoute ti tit nan diapositives ou yo fasil ak .carousel-caption
eleman ki nan nenpòt ki .item
. Mete jis sou nenpòt HTML opsyonèl nan la epi li pral otomatikman aliyen ak fòma.
Carousels mande pou yo sèvi ak yon id
sou veso ki pi eksteryè a (la .carousel
) pou kontwòl Carousel yo fonksyone byen. Lè w ajoute plizyè karousèl, oswa lè w ap chanje yon karousèl id
, asire w ke w mete ajou kontwòl ki enpòtan yo.
Sèvi ak atribi done yo fasil kontwole pozisyon nan Carousel la. data-slide
aksepte mo kle yo prev
oswa next
, ki chanje pozisyon glise an parapò ak pozisyon aktyèl li. Altènativman, sèvi ak data-slide-to
yo pase yon endèks glise anvan tout koreksyon nan Carousel la data-slide-to="2"
, ki chanjman pozisyon glise nan yon endèks patikilye kòmanse ak 0
.
Yo data-ride="carousel"
itilize atribi a pou make yon Carousel kòm animasyon apati chaj paj la. Li pa ka itilize nan konbinezon ak (redondan ak nesesè) inisyalizasyon JavaScript eksplisit nan menm Carousel la.
Rele Carousel manyèlman ak:
Opsyon yo ka pase atravè atribi done oswa JavaScript. Pou atribi done, ajoute non opsyon a nan data-
, tankou nan data-interval=""
.
Non | kalite | default | deskripsyon |
---|---|---|---|
entèval | nimewo | 5000 | Kantite tan pou retade ant otomatikman monte bisiklèt yon atik. Si fo, Carousel pa pral otomatikman sik. |
pran yon poz | fisèl | nil | "plane" | Si mete sou "hover" , pran yon poz monte bisiklèt nan Carousel la mouseenter epi rekòmanse monte bisiklèt la nan Carousel la mouseleave . Si mete sou null , plane sou Carousel la pa pral pran poz li. |
vlope | booleyen | vre | Kit Carousel la ta dwe sikile kontinyèlman oswa si wi ou non si w ta dwe fè yon kanpe difisil. |
klavye | booleyen | vre | Si Carousel la ta dwe reyaji nan evènman klavye yo. |
.carousel(options)
Inisyalize Carousel la ak yon opsyon opsyonèlobject
epi kòmanse monte bisiklèt nan atik yo.
.carousel('cycle')
Fè sik nan atik yo Carousel de goch a dwat.
.carousel('pause')
Sispann Carousel la soti nan monte bisiklèt nan atik yo.
.carousel(number)
Cycles Carousel la nan yon ankadreman patikilye (0 ki baze sou, menm jan ak yon etalaj).
.carousel('prev')
Cycles pou atik anvan an.
.carousel('next')
Cycles pou atik kap vini an.
Klas Carousel Bootstrap la ekspoze de evènman pou branche nan fonksyonalite Carousel.
Tou de evènman yo gen pwopriyete adisyonèl sa yo:
direction
: Direksyon kote kawozèl la ap glise (swa "left"
oswa "right"
).relatedTarget
: Eleman DOM ke yo te glise an plas kòm atik aktif la.Tout evènman Carousel yo tire sou Carousel la li menm (sa vle di nan la <div class="carousel">
).
Kalite Evènman | Deskripsyon |
---|---|
slide.bs.carousel | Evènman sa a dife imedyatman lè yo slide envoke metòd egzanp lan. |
glise.bs.carousel | Evènman sa a revoke lè Carousel la fini tranzisyon glise li. |
Plugin afiks la active position: fixed;
ak koupe, imite efè yo jwenn ak position: sticky;
. Subnavigation sou bò dwat la se yon demonstrasyon ap viv nan plugin afiks la.
Sèvi ak Plugin afiks la atravè atribi done oswa manyèlman ak pwòp JavaScript ou. Nan tou de sitiyasyon, ou dwe bay CSS pou pwezante ak lajè kontni ou apoze.
Remak: Pa sèvi ak plugin afiks la sou yon eleman ki nan yon eleman relativman pozisyone, tankou yon kolòn rale oswa pouse, akòz yon ensèk rann Safari .
Plugin afiks la chanje ant twa klas, chak reprezante yon eta patikilye: .affix
, .affix-top
, ak .affix-bottom
. Ou dwe bay estil yo, eksepte position: fixed;
sou .affix
, pou klas sa yo tèt ou (endepandan de plugin sa a) pou okipe pozisyon aktyèl yo.
Men ki jan plugin afiks la ap travay:
.affix-top
pou endike eleman an nan pozisyon ki pi wo a. Nan pwen sa a pa gen okenn pozisyon CSS obligatwa..affix
ranplase .affix-top
ak mete position: fixed;
(ki bay pa CSS Bootstrap a)..affix
ak .affix-bottom
. Depi konpansasyon yo opsyonèl, mete youn mande pou ou mete CSS ki apwopriye a. Nan ka sa a, ajoute position: absolute;
lè sa nesesè. Plugin a sèvi ak atribi done oswa opsyon JavaScript pou detèmine ki kote yo pozisyone eleman nan la.Swiv etap ki anwo yo pou mete CSS ou pou youn nan opsyon itilizasyon ki anba yo.
Pou fasilman ajoute konpòtman apoze nan nenpòt eleman, jis ajoute data-spy="affix"
nan eleman ou vle al rekonèt sou. Sèvi ak konpansasyon pou defini ki lè pou aktive pinning yon eleman.
Rele plugin afiks la atravè JavaScript:
Opsyon yo ka pase atravè atribi done oswa JavaScript. Pou atribi done, ajoute non opsyon a nan data-
, tankou nan data-offset-top="200"
.
Non | kalite | default | deskripsyon |
---|---|---|---|
konpanse | nimewo | fonksyon | objè | 10 | Piksèl pou konpanse nan ekran lè w ap kalkile pozisyon woulo liv la. Si yo bay yon sèl nimewo, konpanse a pral aplike nan tou de direksyon anwo ak anba. Pou bay yon inik, anba ak tèt konpanse jis bay yon objè offset: { top: 10 } oswa offset: { top: 10, bottom: 5 } . Sèvi ak yon fonksyon lè ou bezwen dinamik kalkile yon konpanse. |
sib | seleksyon | ne | Eleman jQuery | window objè a |
Espesifye eleman sib nan afiks la. |
.affix(options)
Aktive kontni ou kòm kontni apoze. Aksepte yon opsyon opsyonèl object
.
.affix('checkPosition')
Rekalkile eta afiks la baze sou dimansyon, pozisyon, ak pozisyon woulo liv eleman ki enpòtan yo. , .affix
, .affix-top
ak .affix-bottom
klas yo ajoute oswa retire nan kontni apoze selon nouvo eta a. Metòd sa a bezwen yo dwe rele chak fwa dimansyon yo nan kontni apoze a oswa eleman sib la chanje, asire pozisyon kòrèk nan kontni an apoze.
Plugin afiks Bootstrap a ekspoze kèk evènman pou branche nan fonksyonalite afiks.
Kalite Evènman | Deskripsyon |
---|---|
afiks.bs.afiks | Evènman sa a dife imedyatman anvan eleman an te apoze. |
apoze.bs.afiks | Evènman sa a revoke apre yo fin mete eleman an. |
afich-top.bs.affix | Evènman sa a dife imedyatman anvan eleman an te apoze anlè. |
apoze-top.bs.affix | Evènman sa a te revoke apre eleman an te apoze anlè. |
afiks-anba.bs.afiks | Evènman sa a dife imedyatman anvan eleman an te apoze-anba. |
apoze-anba.bs.afiks | Evènman sa a te revoke apre eleman an te apoze-anba. |