JavaScript
Oživite komponente Bootstrapa z več kot ducatom vtičnikov jQuery po meri. Preprosto jih vključite vse ali enega za drugim.
Oživite komponente Bootstrapa z več kot ducatom vtičnikov jQuery po meri. Preprosto jih vključite vse ali enega za drugim.
Vtičnike je mogoče vključiti posamezno (z uporabo posameznih *.js
datotek Bootstrapa) ali vse naenkrat (z uporabo bootstrap.js
ali pomanjšanim bootstrap.min.js
).
Oba bootstrap.js
in bootstrap.min.js
vsebujeta vse vtičnike v eni datoteki. Vključi samo eno.
Nekateri vtičniki in komponente CSS so odvisni od drugih vtičnikov. Če dodate vtičnike posamezno, preverite te odvisnosti v dokumentih. Upoštevajte tudi, da so vsi vtičniki odvisni od jQuery (to pomeni, da mora biti jQuery vključen pred datotekami vtičnikov). Posvetujte se z našimibower.json
, da vidite, katere različice jQuery so podprte.
Vse vtičnike Bootstrap lahko uporabljate izključno prek API-ja za označevanje, ne da bi napisali eno vrstico JavaScripta. To je prvorazredni API Bootstrapa in bi ga morali najprej upoštevati pri uporabi vtičnika.
Kljub temu je v nekaterih situacijah morda zaželeno, da to funkcijo izklopite. Zato nudimo tudi možnost onemogočanja API-ja atributa podatkov tako, da razvežete vse dogodke v imenskem prostoru dokumenta z data-api
. To izgleda takole:
Druga možnost je, da ciljate na določen vtičnik, samo vključite ime vtičnika kot imenski prostor skupaj z imenskim prostorom data-api, kot je ta:
Ne uporabljajte atributov podatkov iz več vtičnikov na istem elementu. Na primer, gumb ne more hkrati imeti namiga za orodje in preklopiti modala. Če želite to narediti, uporabite ovojni element.
Prav tako verjamemo, da bi morali imeti možnost uporabljati vse vtičnike Bootstrap zgolj prek JavaScript API-ja. Vsi javni API-ji so enojne metode, ki jih je mogoče verižiti, in vrnejo zbirko, po kateri je ukrepal.
Vse metode morajo sprejeti izbirni predmet možnosti, niz, ki cilja na določeno metodo, ali nič (kar sproži vtičnik s privzetim vedenjem):
Vsak vtičnik izpostavi tudi svoj neobdelani konstruktor v Constructor
lastnosti: $.fn.popover.Constructor
. Če želite dobiti določen primerek vtičnika, ga pridobite neposredno iz elementa: $('[rel="popover"]').data('popover')
.
Privzete nastavitve za vtičnik lahko spremenite tako, da spremenite predmet vtičnika Constructor.DEFAULTS
:
Včasih je treba uporabiti vtičnike Bootstrap z drugimi okviri uporabniškega vmesnika. V teh okoliščinah lahko občasno pride do kolizij imenskega prostora. Če se to zgodi, lahko pokličete .noConflict
vtičnik, katerega vrednost želite razveljaviti.
Bootstrap ponuja dogodke po meri za večino edinstvenih dejanj vtičnikov. Na splošno so ti v obliki nedoločnika in deležnika preteklosti – kjer se nedoločnik (npr. show
) sproži na začetku dogodka, njegova oblika deležnika preteklosti (npr. shown
) pa se sproži ob zaključku dejanja.
Od 3.0.0 so vsi dogodki Bootstrap v imenskem prostoru.
Vsi nedoločni dogodki zagotavljajo preventDefault
funkcionalnost. To omogoča, da ustavite izvajanje dejanja, preden se začne.
Namigi orodij in pojavni elementi uporabljajo naš vgrajeni čistilec za čiščenje možnosti, ki sprejemajo HTML.
Privzeta whiteList
vrednost je naslednja:
Če želite tej privzeti vrednosti dodati nove vrednosti whiteList
, lahko storite naslednje:
Če želite zaobiti naš sanitizer, ker raje uporabljate namensko knjižnico, na primer DOMPurify , storite naslednje:
document.implementation.createHTMLDocument
V primeru brskalnikov, ki ne podpirajo document.implementation.createHTMLDocument
, kot je Internet Explorer 8, vgrajena funkcija saniranja vrne HTML, kot je.
Če želite v tem primeru izvesti sanacijo, navedite sanitizeFn
in uporabite zunanjo knjižnico, kot je DOMPurify .
Do različice vsakega od Bootstrapovih vtičnikov jQuery je mogoče dostopati prek VERSION
lastnosti konstruktorja vtičnika. Na primer za vtičnik orodnih namigov:
Bootstrapovi vtičniki se ne vrnejo posebej elegantno, ko je JavaScript onemogočen. Če vam je mar za uporabniško izkušnjo v tem primeru, uporabite, <noscript>
da svojim uporabnikom pojasnite situacijo (in kako znova omogočiti JavaScript) in/ali dodajte lastne nadomestne možnosti po meri.
Bootstrap uradno ne podpira knjižnic JavaScript tretjih oseb, kot sta Prototype ali jQuery UI. Kljub .noConflict
dogodkom in imenskim prostorom lahko pride do težav z združljivostjo, ki jih morate odpraviti sami.
Za preproste učinke prehoda vključite transition.js
enkrat poleg drugih datotek JS. Če uporabljate prevedeno (ali zmanjšano) bootstrap.js
, tega ni treba vključiti – že je tam.
Transition.js je osnovni pomočnik za transitionEnd
dogodke, pa tudi emulator prehodov CSS. Uporabljajo ga drugi vtičniki za preverjanje podpore za prehode CSS in za lovljenje visečih prehodov.
Prehode je mogoče globalno onemogočiti z naslednjim delčkom JavaScripta, ki mora priti po nalaganju transition.js
(ali bootstrap.js
ali bootstrap.min.js
, odvisno od primera):
Modali so poenostavljeni, a prilagodljivi pogovorni pozivi z minimalno zahtevano funkcionalnostjo in pametnimi privzetimi nastavitvami.
Pazite, da ne odprete modala, medtem ko je drug še viden. Za prikaz več kot enega modala hkrati je potrebna koda po meri.
Kodo HTML modala vedno poskušajte postaviti na najvišji položaj v dokumentu, da preprečite, da bi druge komponente vplivale na videz in/ali funkcionalnost modala.
Obstaja nekaj opozoril glede uporabe načinov na mobilnih napravah. Za podrobnosti si oglejte naše podporne dokumente za brskalnik .
Zaradi tega, kako HTML5 opredeljuje svojo semantiko, autofocus
atribut HTML nima vpliva na modale Bootstrap. Če želite doseči enak učinek, uporabite JavaScript po meri:
Upodobljen modal z glavo, telesom in nizom dejanj v nogi.
Preklopite modal prek JavaScripta s klikom na spodnji gumb. Zdrsel bo navzdol in zbledel z vrha strani.
Prepričajte se, da ste dodali role="dialog"
in aria-labelledby="..."
, ki se sklicuje na modalni naslov, k .modal
in role="document"
k .modal-dialog
samemu.
Poleg tega lahko podate opis svojega modalnega pogovornega okna z aria-describedby
on .modal
.
Vdelava YouTube videoposnetkov v modale zahteva dodaten JavaScript, ki ni v programu Bootstrap, za samodejno zaustavitev predvajanja in več. Za več informacij si oglejte to koristno objavo Stack Overflow .
Modali imajo dve izbirni velikosti, ki sta na voljo prek modifikatorskih razredov, ki jih je treba postaviti na .modal-dialog
.
Za modale, ki se preprosto prikažejo, namesto da bi zbledeli, odstranite .fade
razred iz svoje modalne oznake.
Če želite izkoristiti omrežni sistem Bootstrap znotraj modalnega, samo ugnezdite .row
s znotraj .modal-body
in nato uporabite običajne razrede omrežnega sistema.
Imate kup gumbov, ki sprožijo isti način, le z nekoliko drugačno vsebino? Uporabite atributeevent.relatedTarget
in HTMLdata-*
(po možnosti prek jQuery ), da spremenite vsebino modala glede na to, kateri gumb je bil kliknjen. Oglejte si dokumente o modalnih dogodkih za podrobnosti o relatedTarget
,
Modalni vtičnik preklaplja vašo skrito vsebino na zahtevo prek podatkovnih atributov ali JavaScripta. Doda .modal-open
tudi <body>
k preglasitvi privzetega vedenja drsenja in ustvari .modal-backdrop
območje za klikanje za opustitev prikazanih modal, ko kliknete zunaj modala.
Aktivirajte modal brez pisanja JavaScripta. Nastavite data-toggle="modal"
na element krmilnika, kot je gumb, skupaj z data-target="#foo"
ali href="#foo"
za ciljanje določenega načina za preklop.
Pokličite modal z ID -jem myModal
z eno vrstico JavaScripta:
Možnosti je mogoče posredovati prek podatkovnih atributov ali JavaScripta. Za atribute podatkov pripnite ime možnosti v data-
, kot v data-backdrop=""
.
Ime | vrsta | privzeto | opis |
---|---|---|---|
ozadje | boolean ali niz'static' |
prav | Vključuje element modalne kulise. Druga možnost je, da določite static za ozadje, ki ob kliku ne zapre modala. |
tipkovnico | logično | prav | Zapre modal, ko pritisnete tipko za izhod |
pokazati | logično | prav | Pri inicializaciji prikaže modal. |
na daljavo | pot | lažno | Ta možnost je zastarela od različice 3.3.0 in je bila odstranjena v različici 4. Namesto tega priporočamo uporabo predlog na strani odjemalca ali ogrodje za vezavo podatkov ali pa sami pokličete jQuery.load . Če je na voljo oddaljeni URL, bo vsebina naložena enkrat prek |
.modal(options)
Aktivira vašo vsebino kot modalno. Sprejema neobvezne možnosti object
.
.modal('toggle')
Ročno preklopi modal. Vrne se klicatelju, preden je modal dejansko prikazan ali skrit (tj. preden pride do dogodka shown.bs.modal
ali ).hidden.bs.modal
.modal('show')
Ročno odpre modal. Vrne se klicatelju, preden je modal dejansko prikazan (tj. preden shown.bs.modal
pride do dogodka).
.modal('hide')
Ročno skrije modal. Vrne se klicatelju, preden je bil modal dejansko skrit (tj. preden hidden.bs.modal
pride do dogodka).
.modal('handleUpdate')
Ponovno prilagodi položaj modala, da prepreči drsni trak, če bi se pojavil, zaradi česar bi modal skočil v levo.
Potreben le, če se višina modala spremeni, ko je odprt.
Modalni razred Bootstrapa izpostavlja nekaj dogodkov za priključitev na modalno funkcionalnost.
Vsi modalni dogodki se sprožijo na samem modalu (tj. na <div class="modal">
).
Vrsta dogodka | Opis |
---|---|
show.bs.modal | Ta dogodek se sproži takoj, ko show se pokliče metoda primerka. Če je vzrok klik, je kliknjeni element na voljo kot relatedTarget lastnost dogodka. |
prikazano.bs.modal | Ta dogodek se sproži, ko je modal viden uporabniku (počakal bo, da se zaključijo prehodi CSS). Če je vzrok klik, je kliknjeni element na voljo kot relatedTarget lastnost dogodka. |
hide.bs.modal | Ta dogodek se sproži takoj, ko hide je bila poklicana metoda primerka. |
skrito.bs.modal | Ta dogodek se sproži, ko je modal prenehal biti skrit pred uporabnikom (počakal bo, da se zaključijo prehodi CSS). |
loaded.bs.modal | Ta dogodek se sproži, ko je modal naložil vsebino z remote možnostjo. |
S tem preprostim vtičnikom dodajte spustne menije skoraj vsemu, vključno z navbarom, zavihki in pilulami.
Spustni vtičnik prek podatkovnih atributov ali JavaScripta preklopi skrito vsebino (spustne menije) tako, da preklopi .open
razred na nadrejenem elementu seznama.
V mobilnih napravah odpiranje spustnega menija doda .dropdown-backdrop
kot območje za dotik za zapiranje spustnih menijev, ko tapnete zunaj menija, kar je zahteva za ustrezno podporo za iOS. To pomeni, da preklop z odprtega spustnega menija na drug spustni meni zahteva dodaten dotik na mobilni napravi.
Opomba: data-toggle="dropdown"
atribut se uporablja za zapiranje spustnih menijev na ravni aplikacije, zato je dobro, da ga vedno uporabite.
Dodajte data-toggle="dropdown"
na povezavo ali gumb, da preklopite spustni meni.
Če želite URL-je ohraniti nedotaknjene z gumbi povezav, uporabite data-target
atribut namesto href="#"
.
Prikličite spustne menije prek JavaScripta:
data-toggle="dropdown"
še potrebnoNe glede na to, ali spustni meni pokličete prek JavaScripta ali namesto tega uporabite data-api, data-toggle="dropdown"
mora biti vedno prisoten v sprožilnem elementu spustnega menija.
Noben
$().dropdown('toggle')
Preklopi spustni meni dane navigacijske vrstice ali navigacije z zavihki.
Vsi spustni dogodki se sprožijo pri .dropdown-menu
nadrejenem elementu.
Vsi spustni dogodki imajo relatedTarget
lastnost, katere vrednost je preklopni sidrni element.
Vrsta dogodka | Opis |
---|---|
show.bs.dropdown | Ta dogodek se sproži takoj, ko se pokliče metoda show instance. |
prikazano.bs.spustni meni | Ta dogodek se sproži, ko je spustni meni viden uporabniku (čakal bo na prehode CSS, da se dokončajo). |
hide.bs.dropdown | Ta dogodek se sproži takoj, ko je bila poklicana metoda hide instance. |
hidden.bs.dropdown | Ta dogodek se sproži, ko spustni meni ni več skrit pred uporabnikom (čakal bo na dokončanje prehodov CSS). |
Vtičnik ScrollSpy je namenjen samodejnemu posodabljanju ciljev navigacije glede na položaj drsenja. Pomaknite se po območju pod vrstico za krmarjenje in opazujte spremembo aktivnega razreda. Označeni bodo tudi spustni podelementi.
Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi preden so razprodali qui. Pravice za kolesa Tumblr od kmetije do mize. Jopica Anim keffiyeh carles. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby pulover lomo jean kratke hlače, williamsburg hoodie minim qui verjetno še niste slišali zanje in jopica skrbniški sklad culpa biodiesel wes anderson aesthetic. Nihil tetoviran akuzamus, cred ironija biodizel keffiyeh obrtnik ullamco consequat.
Veniam marfa brki rolka, adipisicing fugiat velit vile brada. Freegan beard aliqua cupidatat mcsweeney's vero. Cupidatat four loko nisi, ea helvetica nulla carles. Tetoviran cosby pulover s hrano, mcsweeneyjev quis non freegan vinil. Lo-fi wes anderson +1 krojaško. Carles ne estetsko vajo quis gentrify. Brooklyn adipisicing craft beer vice keytar deserunt.
Occaecat commodo aliqua delectus. Fap craft beer deserunt skateboard ea. Lomo kolesarske pravice adipisicing banh mi, velit ea sunt next level locavore single-origin coffee in magna veniam. High life id vinil, echo park consequat quis aliquip banh mi pitchfork. Vero VHS est adipisicing. Consectetur nisi DIY minimalna kurirska torba. Cred ex in, trajnostni 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. Sapiente synth id domnevno. Locavore sed helvetica kliše ironija, thundercats verjetno še niste slišali zanje consequat pulover s kapuco brez glutena lo-fi fap aliquip. Labore elit placeat preden so bili razprodani, terry richardson proident brunch nesciunt quis cosby pulover pariatur keffiyeh ut helvetica artisan. Cardigan craft beer seitan readymade velit. VHS chambray laboris tempor veniam. Anim mollit minim commodo ullamco thundercats.
Povezave vrstice za krmarjenje morajo imeti razločljive cilje ID-ja. Na primer, <a href="#home">home</a>
mora ustrezati nečemu v DOM, kot je <div id="home"></div>
.
:visible
elementi so prezrtiCiljni elementi, ki niso :visible
v skladu z jQuery , bodo prezrti in njihovi ustrezni navigacijski elementi ne bodo nikoli označeni.
Ne glede na metodo implementacije, scrollspy zahteva uporabo position: relative;
na elementu, za katerim vohunite. V večini primerov je to <body>
. Pri vohunjenju po elementih, ki niso <body>
, se prepričajte, da imate height
nastavljen in overflow-y: scroll;
uporabljen.
Če želite enostavno dodati vohunsko vedenje v svojo zgornjo vrstico, dodajte data-spy="scroll"
element, za katerim želite vohuniti (najpogosteje je to <body>
). Nato dodajte data-target
atribut z ID-jem ali razredom nadrejenega elementa katere koli .nav
komponente Bootstrap.
Ko dodate position: relative;
svoj CSS, pokličite scrollspy prek JavaScripta:
.scrollspy('refresh')
Ko uporabljate scrollspy v povezavi z dodajanjem ali odstranjevanjem elementov iz DOM, boste morali poklicati metodo osveževanja takole:
Možnosti je mogoče posredovati prek podatkovnih atributov ali JavaScripta. Za atribute podatkov pripnite ime možnosti v data-
, kot v data-offset=""
.
Ime | vrsta | privzeto | opis |
---|---|---|---|
odmik | število | 10 | Slikovne pike za zamik od vrha pri izračunu položaja drsenja. |
Vrsta dogodka | Opis |
---|---|
activate.bs.scrollspy | Ta dogodek se sproži vsakič, ko scrollspy aktivira nov element. |
Dodajte hitro, dinamično funkcijo zavihkov za prehod med podokni lokalne vsebine, tudi prek spustnih menijev. Ugnezdeni zavihki niso podprti.
Surov denim, za katere verjetno še niste slišali, jeans kratke hlače Austin. Nesciunt tofu stumptown aliqua, retro synth master cleanse. Moustache cliche tempor, williamsburg carles vegan helvetica. Reprehenderit butcher retro keffiyeh dreamcatcher synth. Cosby pulover eu banh mi, qui irure terry richardson ex squid. Aliquip placeat salvia cillum iphone. Seitan aliquip quis kardigan ameriška oblačila, mesar 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.
Ta vtičnik razširja navigacijsko komponento z zavihki za dodajanje območij z zavihki.
Omogoči zavihke z možnostjo zavihkov prek JavaScripta (vsak zavihek je treba aktivirati posebej):
Posamezne zavihke lahko aktivirate na več načinov:
Navigacijo po zavihku ali tabletki lahko aktivirate, ne da bi pisali JavaScript, tako da preprosto določite data-toggle="tab"
ali data-toggle="pill"
na elementu. Če na zavihek dodate razrede nav
in , boste uporabili slog zavihka Bootstrap , medtem ko boste dodali razrede in uporabili slog tabletke .nav-tabs
ul
nav
nav-pills
Če želite, da zavihki zbledijo, dodajte .fade
vsakemu .tab-pane
. V prvem podoknu z zavihki mora biti .in
vidna tudi začetna vsebina.
$().tab
Aktivira element zavihka in vsebnik vsebine. Zavihek mora imeti bodisi data-target
ali href
ciljno usmerjen na vozlišče vsebnika v DOM. V zgornjih primerih so zavihki <a>
s z data-toggle="tab"
atributi.
.tab('show')
Izbere dani zavihek in prikaže povezano vsebino. Vsi drugi zavihki, ki so bili predhodno izbrani, postanejo neizbrani in njihova povezana vsebina je skrita. Vrne se klicatelju, preden je podokno z zavihki dejansko prikazano (tj. preden shown.bs.tab
pride do dogodka).
Pri prikazu novega zavihka se dogodki sprožijo v naslednjem vrstnem redu:
hide.bs.tab
(na trenutno aktivnem zavihku)show.bs.tab
(na zavihku za prikaz)hidden.bs.tab
(na prejšnjem aktivnem zavihku, enak kot za hide.bs.tab
dogodek)shown.bs.tab
(na novoaktivnem pravkar prikazanem zavihku, isti kot za show.bs.tab
dogodek)Če noben zavihek še ni bil aktiven, se dogodki hide.bs.tab
in hidden.bs.tab
ne bodo sprožili.
Vrsta dogodka | Opis |
---|---|
show.bs.tab | Ta dogodek se sproži ob prikazu zavihka, vendar preden je prikazan nov zavihek. Uporabite event.target in event.relatedTarget za ciljanje na aktivni zavihek oziroma prejšnji aktivni zavihek (če je na voljo). |
prikazano.bs.tab | Ta dogodek se sproži na prikazu zavihkov po prikazu zavihka. Uporabite event.target in event.relatedTarget za ciljanje na aktivni zavihek oziroma prejšnji aktivni zavihek (če je na voljo). |
hide.bs.tab | Ta dogodek se sproži, ko je treba prikazati nov zavihek (in tako naj bi bil prejšnji aktivni zavihek skrit). Uporabite event.target in event.relatedTarget za ciljanje na trenutni aktivni zavihek oziroma novi zavihek, ki bo kmalu aktiven. |
skriti.bs.tab | Ta dogodek se sproži, ko je prikazan nov zavihek (in tako je prejšnji aktivni zavihek skrit). Uporabite event.target in event.relatedTarget za ciljanje prejšnjega aktivnega zavihka oziroma novega aktivnega zavihka. |
Navdih za odličen vtičnik jQuery.tipsy, ki ga je napisal Jason Frame; Namigi orodij so posodobljena različica, ki se ne zanaša na slike, uporablja CSS3 za animacije in podatkovne atribute za lokalno shranjevanje naslovov.
Namigi z naslovi ničelne dolžine niso nikoli prikazani.
Premaknite miškin kazalec nad spodnje povezave, da si ogledate opise orodij:
Ozke hlače naslednje stopnje keffiyeh , za katere verjetno še niste slišali. Photo booth beard raw denim letterpress veganska kurirska torba stumptown. Seitan od kmetije do mize, 8-bitna ameriška oblačila mcsweeney's fixie trajnostna kvinoja imajo vinil chambray terryja richardsona. Beard stumptown, kardigani banh mi lomo thundercats. Tofu biodizel williamsburg marfa, štiri loko mcsweeney's cleanse veganski chambray. Resnično ironični rokodelec , karkoli keytar , scenester farm-to-table banksy Austin twitter handle freegan cred raw denim single-origin kava virusna.
Na voljo so štiri možnosti: zgoraj, desno, spodaj in levo poravnano.
Zaradi zmogljivosti sta API-ja Tooltip in Popover data-apis opt-in, kar pomeni, da ju morate inicializirati sami .
Eden od načinov inicializacije vseh namigov orodij na strani bi bil, da jih izberete po njihovem data-toggle
atributu:
Vtičnik orodnih namigov ustvari vsebino in oznake na zahtevo ter privzeto postavi namige orodij za njihov sprožilni element.
Sproži opis orodja prek JavaScripta:
Zahtevana oznaka za opis orodja je le data
atribut in title
na elementu HTML, za katerega želite, da je opis orodja. Ustvarjena oznaka orodnega opisa je precej preprosta, čeprav zahteva položaj (privzeto nastavljen top
s strani vtičnika).
Včasih želite dodati opis orodja hiperpovezavi, ki prekriva več vrstic. Privzeto vedenje vtičnika orodnih namigov je centriranje vodoravno in navpično. Dodajte white-space: nowrap;
svojim sidrom, da se temu izognete.
Ko uporabljate opise orodij na elementih znotraj .btn-group
ali .input-group
, ali na elementih, povezanih s tabelo ( <td>
, <th>
, <tr>
, <thead>
, <tbody>
, <tfoot>
), boste morali določiti možnost container: 'body'
(dokumentirano spodaj), da se izognete neželenim stranskim učinkom (kot je širitev elementa in/ ali izguba zaobljenih vogalov, ko se sproži opis orodja).
Za uporabnike, ki se pomikajo s tipkovnico, in še posebej za uporabnike podpornih tehnologij, dodajte nasvete orodij le elementom, na katere se osredotoči tipkovnica, kot so povezave, kontrolniki obrazcev ali kateri koli poljuben element z tabindex="0"
atributom.
Če želite dodati opis orodja elementu disabled
ali .disabled
, postavite element znotraj a <div>
in <div>
namesto tega uporabite opis orodja zanj.
Možnosti je mogoče posredovati prek podatkovnih atributov ali JavaScripta. Za atribute podatkov pripnite ime možnosti v data-
, kot v data-animation=""
.
Upoštevajte, da iz varnostnih razlogov možnosti sanitize
, sanitizeFn
in whiteList
ni mogoče zagotoviti z uporabo podatkovnih atributov.
Ime | Vrsta | Privzeto | Opis |
---|---|---|---|
animacija | logično | prav | Na opisu orodja uporabite bledeči prehod CSS |
posoda | niz | lažno | lažno | Doda namig orodja določenemu elementu. Primer: |
zamuda | številka | predmet | 0 | Zakasnitev prikaza in skrivanja namiga orodja (ms) – ne velja za tip ročnega proženja Če je navedena številka, se zakasnitev uporabi za skrij/prikaži Struktura objekta je: |
html | logično | lažno | V opis orodja vstavite HTML. Če je nastavljeno na false, text bo za vstavljanje vsebine v DOM uporabljena metoda jQuery. Če vas skrbijo napadi XSS, uporabite besedilo. |
umestitev | niz | funkcijo | 'top' | Kako postaviti opis orodja - vrh | dno | levo | desno | avto. Ko se funkcija uporabi za določitev umestitve, se pokliče z vozliščem DOM z opisom orodja kot prvim argumentom in vozliščem prožilnega elementa DOM kot drugim. Kontekst |
selektor | vrvica | lažno | Če je na voljo izbirnik, bodo predmeti namigov orodja dodeljeni navedenim ciljem. V praksi se to uporablja tudi za uporabo namigov orodij za dinamično dodane elemente DOM ( jQuery.on podpora). Oglejte si to in informativen primer . |
predlogo | vrvica | '<div class="tooltip" role="tooltip"><div class="tooltip-arrow"></div><div class="tooltip-inner"></div></div>' |
Osnovni HTML za uporabo pri ustvarjanju opisa orodja. Namigi orodij
Zunanji ovojni element mora imeti |
naslov | niz | funkcijo | '' | Privzeta vrednost naslova, če Če je podana funkcija, bo klicana s |
sprožilec | vrvica | 'hover focus' | Kako se sproži opis orodja - kliknite | lebdi | fokus | priročnik. Lahko prenesete več sprožilcev; ločite jih s presledkom. manual ni mogoče kombinirati z nobenim drugim sprožilcem. |
vidno polje | niz | predmet | funkcijo | { izbirnik: 'body', oblazinjenje: 0 } | Ohranja opis orodja v mejah tega elementa. Primer: Če je funkcija podana, se kliče z vozliščem prožilnega elementa DOM kot edinim argumentom. Kontekst |
razkužiti | logično | prav | Omogočite ali onemogočite čiščenje. Če je aktivirano 'template' , bodo možnosti 'content' in 'title' možnosti razčiščene. |
beli seznam | predmet | Privzeta vrednost | Objekt, ki vsebuje dovoljene atribute in oznake |
sanitizeFn | nič | funkcijo | nič | Tukaj lahko zagotovite lastno funkcijo razkuževanja. To je lahko uporabno, če za izvajanje sanacije raje uporabljate namensko knjižnico. |
Možnosti za posamezne namige orodij je mogoče določiti tudi z uporabo atributov podatkov, kot je razloženo zgoraj.
$().tooltip(options)
Zbirki elementov priloži obravnavo namigov orodij.
.tooltip('show')
Razkrije namig elementa. Vrne se klicatelju, preden se dejansko prikaže opis orodja (tj. preden shown.bs.tooltip
pride do dogodka). To velja za "ročno" proženje namiga orodja. Namigi z naslovi ničelne dolžine niso nikoli prikazani.
.tooltip('hide')
Skrije namig elementa. Vrne se klicatelju, preden je bil opis orodja dejansko skrit (tj. preden se hidden.bs.tooltip
zgodi dogodek). To velja za "ročno" proženje namiga orodja.
.tooltip('toggle')
Preklopi opis orodja elementa. Vrne se klicatelju, preden je bil opis orodja dejansko prikazan ali skrit (tj. preden pride do dogodka shown.bs.tooltip
ali ). hidden.bs.tooltip
To velja za "ročno" proženje namiga orodja.
.tooltip('destroy')
Skrije in uniči namig elementa. Namigov orodij, ki uporabljajo delegiranje (ki so ustvarjeni z možnostjo selector
) , ni mogoče posamično uničiti na podrejenih sprožilnih elementih.
Vrsta dogodka | Opis |
---|---|
show.bs.tooltip | Ta dogodek se sproži takoj, ko show se pokliče metoda primerka. |
prikazano.bs.tooltip | Ta dogodek se sproži, ko je opis orodja viden uporabniku (počakal bo, da se zaključijo prehodi CSS). |
hide.bs.tooltip | Ta dogodek se sproži takoj, ko hide je bila poklicana metoda primerka. |
hidden.bs.tooltip | Ta dogodek se sproži, ko opis orodja ni več skrit pred uporabnikom (počakal bo, da se zaključijo prehodi CSS). |
inserted.bs.tooltip | Ta dogodek se sproži po show.bs.tooltip dogodku, ko je predloga orodja dodana v DOM. |
Dodajte majhne prekrivne vsebine, kot so tiste na iPadu, kateremu koli elementu za namestitev sekundarnih informacij.
Popoverji, katerih naslov in vsebina sta ničelne dolžine, niso nikoli prikazani.
Popovers zahtevajo, da je v vašo različico Bootstrapa vključen vtičnik orodnih namigov.
Zaradi zmogljivosti sta API-ja Tooltip in Popover data-apis opt-in, kar pomeni, da ju morate inicializirati sami .
Eden od načinov inicializacije vseh pojavnih oken na strani bi bil, da jih izberete po njihovem data-toggle
atributu:
Ko uporabljate pojavne elemente na elementih znotraj .btn-group
ali .input-group
, ali na elementih, povezanih s tabelo ( <td>
, <th>
, <tr>
, <thead>
, <tbody>
, <tfoot>
), boste morali določiti možnost container: 'body'
(dokumentirano spodaj), da se izognete neželenim stranskim učinkom (kot je širitev elementa in/ ali izguba zaobljenih vogalov, ko se sproži popover).
disabled
Če želite elementu ali dodati popover .disabled
, postavite element znotraj a <div>
in <div>
namesto tega uporabite pojavni pojav za to.
Včasih želite hiperpovezavi, ki ovije več vrstic, dodati pojavni pojav. Privzeto vedenje popover vtičnika je, da ga centrira vodoravno in navpično. Dodajte white-space: nowrap;
svojim sidrom, da se temu izognete.
Na voljo so štiri možnosti: zgoraj, desno, spodaj in levo poravnano.
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.
Uporabite focus
sprožilec, da opustite pojavna okna ob naslednjem kliku uporabnika.
Za pravilno delovanje med brskalniki in platformami morate uporabiti <a>
oznako, ne oznake <button>
, vključiti pa morate tudi atributa role="button"
in .tabindex
Omogoči pojavna okna prek JavaScripta:
Možnosti je mogoče posredovati prek podatkovnih atributov ali JavaScripta. Za atribute podatkov pripnite ime možnosti v data-
, kot v data-animation=""
.
Upoštevajte, da iz varnostnih razlogov možnosti sanitize
, sanitizeFn
in whiteList
ni mogoče zagotoviti z uporabo podatkovnih atributov.
Ime | Vrsta | Privzeto | Opis |
---|---|---|---|
animacija | logično | prav | Uporabite prehod CSS zbledenja na pojavni element |
posoda | niz | lažno | lažno | Popover doda določenemu elementu. Primer: |
vsebino | niz | funkcijo | '' | Privzeta vrednost vsebine, če Če je podana funkcija, bo klicana s |
zamuda | številka | predmet | 0 | Zakasnitev prikaza in skrivanja pojavnega pojava (ms) - ne velja za tip ročnega proženja Če je navedena številka, se zakasnitev uporabi za skrij/prikaži Struktura objekta je: |
html | logično | lažno | V pojavno okno vstavite HTML. Če je nastavljeno na false, text bo za vstavljanje vsebine v DOM uporabljena metoda jQuery. Če vas skrbijo napadi XSS, uporabite besedilo. |
umestitev | niz | funkcijo | 'prav' | Kako postaviti popover - zgoraj | dno | levo | desno | avto. Ko se funkcija uporabi za določitev umestitve, se pokliče s pojavnim vozliščem DOM kot prvim argumentom in prožilnim elementom DOM vozliščem kot drugim. Kontekst |
selektor | vrvica | lažno | Če je na voljo izbirnik, bodo pojavni objekti dodeljeni navedenim ciljem. V praksi se to uporablja za omogočanje dodajanja pojavnih oken dinamični vsebini HTML. Oglejte si to in informativen primer . |
predlogo | vrvica | '<div class="popover" role="tooltip"><div class="arrow"></div><h3 class="popover-title"></h3><div class="popover-content"></div></div>' |
Osnovni HTML za uporabo pri ustvarjanju pojavnega okna. Popoverji Popoverji
Zunanji ovojni element mora imeti |
naslov | niz | funkcijo | '' | Privzeta vrednost naslova, če Če je podana funkcija, bo klicana s |
sprožilec | vrvica | 'klik' | Kako se sproži popover - kliknite | lebdi | fokus | priročnik. Lahko prenesete več sprožilcev; ločite jih s presledkom. manual ni mogoče kombinirati z nobenim drugim sprožilcem. |
vidno polje | niz | predmet | funkcijo | { izbirnik: 'body', oblazinjenje: 0 } | Popover ohranja v mejah tega elementa. Primer: Če je funkcija podana, se kliče z vozliščem prožilnega elementa DOM kot edinim argumentom. Kontekst |
razkužiti | logično | prav | Omogočite ali onemogočite čiščenje. Če je aktivirano 'template' , bodo možnosti 'content' in 'title' možnosti razčiščene. |
beli seznam | predmet | Privzeta vrednost | Objekt, ki vsebuje dovoljene atribute in oznake |
sanitizeFn | nič | funkcijo | nič | Tukaj lahko zagotovite lastno funkcijo razkuževanja. To je lahko uporabno, če za izvajanje sanacije raje uporabljate namensko knjižnico. |
Možnosti za posamezna pojavna okna se lahko določijo tudi z uporabo podatkovnih atributov, kot je razloženo zgoraj.
$().popover(options)
Inicializira pojavna okna za zbirko elementov.
.popover('show')
Razkrije popover elementa. Vrne se k klicatelju, preden je pojavno okno dejansko prikazano (tj. preden shown.bs.popover
pride do dogodka). To velja za "ročno" sprožitev popoverja. Popoverji, katerih naslov in vsebina sta ničelne dolžine, niso nikoli prikazani.
.popover('hide')
Skrije pojavni element elementa. Vrne se k klicatelju, preden je bil popover dejansko skrit (tj. preden hidden.bs.popover
pride do dogodka). To velja za "ročno" sprožitev popoverja.
.popover('toggle')
Preklopi pojavni element elementa. Vrne se klicatelju, preden je pojavni element dejansko prikazan ali skrit (tj. preden pride do dogodka shown.bs.popover
ali ). hidden.bs.popover
To velja za "ročno" sprožitev popoverja.
.popover('destroy')
Skrije in uniči popover elementa. Popoverjev, ki uporabljajo delegiranje (ki so ustvarjeni z možnostjo selector
) , ni mogoče posamično uničiti na podrejenih prožilnih elementih.
Vrsta dogodka | Opis |
---|---|
show.bs.popover | Ta dogodek se sproži takoj, ko show se pokliče metoda primerka. |
prikazano.bs.popover | Ta dogodek se sproži, ko postane pojavni element viden uporabniku (počakal bo, da se zaključijo prehodi CSS). |
hide.bs.popover | Ta dogodek se sproži takoj, ko hide je bila poklicana metoda primerka. |
hidden.bs.popover | Ta dogodek se sproži, ko se pojavni pomik neha skriti pred uporabnikom (počakal bo, da se zaključijo prehodi CSS). |
vstavljeno.bs.popover | Ta dogodek se sproži po show.bs.popover dogodku, ko je bila v DOM dodana popover predloga. |
S tem vtičnikom dodajte funkcijo opustitve vsem opozorilnim sporočilom.
Ko uporabljate .close
gumb, mora biti prvi podrejeni gumb .alert-dismissible
in nobena besedilna vsebina ne sme biti pred njim v označevanju.
Spremenite to in ono in poskusite znova. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.
Preprosto dodajte data-dismiss="alert"
svojemu gumbu za zapiranje, da samodejno omogočite funkcijo zapiranja opozorila. Če zaprete opozorilo, ga odstranite iz DOM.
Če želite, da vaša opozorila ob zapiranju uporabljajo animacijo, se prepričajte, da so zanje že uporabljeni razredi .fade
in ..in
$().alert()
Naredi opozorilo, da posluša dogodke klikov na podrejenih elementih, ki imajo data-dismiss="alert"
atribut. (Ni potrebno pri uporabi samodejne inicializacije data-api.)
$().alert('close')
Zapre opozorilo tako, da ga odstrani iz DOM. Če .fade
in.in
, bo opozorilo zbledelo, preden bo odstranjeno.
Bootstrapov vtičnik za opozorila razkriva nekaj dogodkov za priključitev na funkcijo opozorila.
Vrsta dogodka | Opis |
---|---|
close.bs.alert | Ta dogodek se sproži takoj, ko close se pokliče metoda primerka. |
zaprto.bs.alert | Ta dogodek se sproži, ko je bilo opozorilo zaprto (počakal bo, da se zaključijo prehodi CSS). |
Naredite več z gumbi. Nadzorni gumb navaja ali ustvari skupine gumbov za več komponent, kot so orodne vrstice.
Firefox med nalaganjem strani ohranja stanja nadzora obrazca (onemogočenost in preverjanje) . Rešitev za to je uporaba autocomplete="off"
. Oglejte si napako Mozilla #654072 .
Dodajte data-loading-text="Loading..."
za uporabo stanja nalaganja na gumbu.
Ta funkcija je zastarela od različice 3.3.5 in je bila odstranjena v različici 4.
Zaradi te predstavitve uporabljamo data-loading-text
in $().button('loading')
, vendar to ni edino stanje, ki ga lahko uporabite. Več o tem si oglejte spodaj v $().button(string)
dokumentaciji .
Dodajte data-toggle="button"
za aktiviranje preklapljanja na enem gumbu.
.active
inaria-pressed="true"
Za vnaprej preklopne gumbe morate dodati .active
razred in aria-pressed="true"
atribut button
sebi.
Dodajte vsebujočemu data-toggle="buttons"
potrditvenemu .btn-group
polju ali radijske vnose, da omogočite preklapljanje v njihovih slogih.
.active
Za vnaprej izbrane možnosti morate sami dodati .active
razred v vnos label
.
Če se potrjeno stanje gumba potrditvenega polja posodobi brez sprožitve click
dogodka na gumbu (npr. prek <input type="reset">
ali prek nastavitve checked
lastnosti vnosa), boste morali sami preklopiti .active
razred na vnosu label
.
$().button('toggle')
Preklopi potisno stanje. Gumb daje videz, kot da je bil aktiviran.
$().button('reset')
Ponastavi stanje gumba - besedilo zamenja z izvirnim besedilom. Ta metoda je asinhrona in se vrne, preden je ponastavitev dejansko končana.
$().button(string)
Zamenja besedilo v poljubno podatkovno definirano stanje besedila.
Prilagodljiv vtičnik, ki uporablja peščico razredov za enostavno preklapljanje.
Strnitev zahteva, da je vtičnik za prehode vključen v vašo različico Bootstrapa.
Kliknite spodnje gumbe, da prikažete ali skrijete drug element prek sprememb razreda:
.collapse
skriva vsebino.collapsing
se uporablja med prehodi.collapse.in
prikazuje vsebinoUporabite lahko povezavo z href
atributom ali gumb z data-target
atributom. V obeh primerih data-toggle="collapse"
je potrebno.
Razširite privzeto vedenje strnjevanja, da ustvarite harmoniko s komponento plošče.
Možna je tudi zamenjava .panel-body
s s .list-group
s.
Bodite prepričani, da dodate aria-expanded
v kontrolni element. Ta atribut izrecno definira trenutno stanje zložljivega elementa za bralnike zaslona in podobne podporne tehnologije. Če je zložljivi element privzeto zaprt, mora imeti vrednost aria-expanded="false"
. in
Če ste z razredom nastavili, da je zložljivi element privzeto odprt, ga aria-expanded="true"
namesto tega nastavite na kontrolniku. Vtičnik bo samodejno preklopil ta atribut glede na to, ali je bil zložljivi element odprt ali zaprt.
Poleg tega, če vaš kontrolni element cilja na en sam zložljiv element – tj. data-target
atribut kaže na id
izbirnik –, lahko dodate dodaten aria-controls
atribut kontrolnemu elementu, ki vsebuje id
element zložljivega elementa. Sodobni bralniki zaslona in podobne podporne tehnologije uporabljajo ta atribut, da uporabnikom zagotovijo dodatne bližnjice za navigacijo neposredno do samega zložljivega elementa.
Vtičnik Collapse uporablja nekaj razredov za obvladovanje težkega dvigovanja:
.collapse
skriva vsebino.collapse.in
prikazuje vsebino.collapsing
se doda, ko se prehod začne, in odstrani, ko se končaTe razrede lahko najdete v component-animations.less
.
Samo dodajte data-toggle="collapse"
in data-target
elementu, da samodejno dodelite nadzor nad zložljivim elementom. Atribut data-target
sprejme izbirnik CSS za uporabo strnjenja. Ne pozabite dodati razreda collapse
zložljivemu elementu. Če želite, da se privzeto odpre, dodajte dodatni razred in
.
Če želite zložljivemu nadzoru dodati upravljanje skupine, podobno harmoniki, dodajte atribut podatkov data-parent="#selector"
. Oglejte si predstavitev, da vidite to v akciji.
Omogoči ročno z:
Možnosti je mogoče posredovati prek podatkovnih atributov ali JavaScripta. Za atribute podatkov pripnite ime možnosti v data-
, kot v data-parent=""
.
Ime | vrsta | privzeto | opis |
---|---|---|---|
starš | selektor | lažno | Če je na voljo izbirnik, bodo vsi zložljivi elementi pod podanim nadrejenim elementom zaprti, ko je prikazan ta zložljivi element. (podobno kot tradicionalno vedenje harmonike - to je odvisno od panel razreda) |
preklop | logično | prav | Ob klicu preklopi zložljivi element |
.collapse(options)
Aktivira vašo vsebino kot zložljiv element. Sprejema neobvezne možnosti object
.
.collapse('toggle')
Preklopi zložljiv element med prikazanim ali skritim. Vrne se klicatelju, preden je zložljivi element dejansko prikazan ali skrit (tj. preden pride do dogodka shown.bs.collapse
ali ).hidden.bs.collapse
.collapse('show')
Prikazuje zložljiv element. Vrne se klicatelju, preden je zložljivi element dejansko prikazan (tj. preden shown.bs.collapse
pride do dogodka).
.collapse('hide')
Skrije zložljiv element. Vrne se klicatelju, preden je bil zložljivi element dejansko skrit (tj. preden hidden.bs.collapse
pride do dogodka).
Bootstrapov razred kolapsa razkrije nekaj dogodkov za priključitev na funkcionalnost kolapsa.
Vrsta dogodka | Opis |
---|---|
show.bs.collapse | Ta dogodek se sproži takoj, ko show se pokliče metoda primerka. |
prikazano.bs.zruši | Ta dogodek se sproži, ko je element strnjenja viden uporabniku (počakal bo, da se prehodi CSS zaključijo). |
hide.bs.collapse | Ta dogodek se sproži takoj, ko hide je bila metoda poklicana. |
hidden.bs.collapse | Ta dogodek se sproži, ko je bil strnjeni element skrit pred uporabnikom (počakal bo, da se zaključijo prehodi CSS). |
Komponenta diaprojekcije za kroženje po elementih, kot je vrtiljak. Ugnezdeni vrtiljaki niso podprti.
Komponenta vrtiljaka na splošno ni skladna s standardi dostopnosti. Če morate biti skladni, razmislite o drugih možnostih za predstavitev svoje vsebine.
Bootstrap za svoje animacije uporablja izključno CSS3, vendar Internet Explorer 8 in 9 ne podpirata potrebnih lastnosti CSS. Tako pri uporabi teh brskalnikov ni animacij prehodov med diapozitivi. Namenoma smo se odločili, da za prehode ne bomo vključili nadomestnih različic, ki temeljijo na jQuery.
Razred .active
je treba dodati enemu od diapozitivov. V nasprotnem primeru vrtiljak ne bo viden.
Razredi .glyphicon .glyphicon-chevron-left
in .glyphicon .glyphicon-chevron-right
niso nujno potrebni za kontrole. Bootstrap ponuja .icon-prev
in .icon-next
kot navadne alternative unicode.
Svojim diapozitivom preprosto dodajte napise z .carousel-caption
elementom znotraj katerega koli .item
. Vanj vstavite skoraj vsak izbirni HTML in samodejno bo poravnan in oblikovan.
Vrtiljaki zahtevajo uporabo id
na skrajni zunanji posodi ( .carousel
) za pravilno delovanje krmilnikov vrtiljaka. Ko dodajate več vrtiljakov ali spreminjate vrtiljak id
, ne pozabite posodobiti ustreznih kontrolnikov.
Uporabite atribute podatkov za preprost nadzor položaja vrtiljaka. data-slide
sprejme ključne besede prev
ali next
, ki spremenijo položaj diapozitiva glede na trenutni položaj. Druga možnost je, da uporabite data-slide-to
za posredovanje neobdelanega indeksa diapozitiva na vrtiljak data-slide-to="2"
, ki premakne položaj diapozitiva na določen indeks, ki se začne z 0
.
Atribut data-ride="carousel"
se uporablja za označevanje vrtiljaka kot animiranega, ki se začne ob nalaganju strani. Ni ga mogoče uporabiti v kombinaciji z (odvečno in nepotrebno) eksplicitno inicializacijo JavaScript istega vrtiljaka.
Ročno pokličite vrtiljak z:
Možnosti je mogoče posredovati prek podatkovnih atributov ali JavaScripta. Za atribute podatkov pripnite ime možnosti v data-
, kot v data-interval=""
.
Ime | vrsta | privzeto | opis |
---|---|---|---|
interval | število | 5000 | Količina časa zakasnitve med samodejnim kroženjem elementa. Če je false, se vrtiljak ne bo samodejno vrtel. |
pavza | niz | nič | "lebdeti" | Če je nastavljeno na "hover" , začasno ustavi kroženje vrtiljaka na mouseenter in nadaljuje s kroženjem vrtiljaka na mouseleave . Če je nastavljeno na null , se s kazalcem miške nad vrtiljakom ne zaustavite. |
zaviti | logično | prav | Ali naj vrtiljak kroži neprekinjeno ali se mora močno ustaviti. |
tipkovnico | logično | prav | Ali naj se vrtiljak odzove na dogodke na tipkovnici. |
.carousel(options)
Inicializira vrtiljak z izbirnimi možnostmi object
in začne krožiti med elementi.
.carousel('cycle')
Kroži skozi elemente vrtiljaka od leve proti desni.
.carousel('pause')
Prepreči kroženje vrtiljaka med predmeti.
.carousel(number)
Preklopi vrtiljak na določen okvir (na osnovi 0, podobno matriki).
.carousel('prev')
Preklopi na prejšnji element.
.carousel('next')
Preklopi na naslednji element.
Bootstrapov razred vrtiljaka izpostavlja dva dogodka za priključitev na funkcijo vrtiljaka.
Oba dogodka imata naslednje dodatne lastnosti:
direction
: Smer, v katero drsi vrtiljak ( "left"
ali "right"
).relatedTarget
: Element DOM, ki je potisnjen na svoje mesto kot aktivni element.Vsi dogodki vrtiljaka se sprožijo na samem vrtiljaku (tj. na <div class="carousel">
).
Vrsta dogodka | Opis |
---|---|
slide.bs.carousel | Ta dogodek se sproži takoj, ko slide je priklicana metoda primerka. |
slid.bs.carousel | Ta dogodek se sproži, ko vrtiljak zaključi prehod diapozitivov. |
Vtičnik za pritrditev se vklopi position: fixed;
in izklopi ter posnema učinek, ki ga najdete z position: sticky;
. Podnavigacija na desni je predstavitev vtičnika za pritrditev v živo.
Uporabite vtičnik za pritrditev prek atributov podatkov ali ročno z lastnim JavaScriptom. V obeh primerih morate zagotoviti CSS za položaj in širino vaše pripete vsebine.
Opomba: ne uporabljajte vtičnika za pritrditev na elementu, ki je v sorazmerno postavljenem elementu, kot je vlečeni ali potisnjeni stolpec, zaradi napake pri upodabljanju Safarija .
Vtičnik za pritrditev preklaplja med tremi razredi, od katerih vsak predstavlja določeno stanje: .affix
, .affix-top
in .affix-bottom
. Za obdelavo dejanskih položajev morate za te razrede zagotoviti sloge, z izjemo position: fixed;
na , sami (neodvisno od tega vtičnika)..affix
Takole deluje vtičnik za pritrditev:
.affix-top
, da označi, da je element na skrajnem zgornjem položaju. Na tej točki CSS pozicioniranje ni potrebno..affix
zamenja .affix-top
in nastavi position: fixed;
(zagotavlja Bootstrapov CSS)..affix
z .affix-bottom
. Ker odmiki niso obvezni, morate za nastavitev enega nastaviti ustrezen CSS. V tem primeru dodajte position: absolute;
po potrebi. Vtičnik uporablja atribut podatkov ali možnost JavaScript, da od tam določi, kam naj postavi element.Sledite zgornjim korakom, da nastavite svoj CSS za eno od spodnjih možnosti uporabe.
Če želite preprosto dodati vedenje pritrjevanja kateremu koli elementu, preprosto dodajte data-spy="affix"
elementu, za katerim želite vohuniti. Uporabite odmike, da določite, kdaj želite preklopiti pripenjanje elementa.
Pokličite vtičnik za pritrditev prek JavaScripta:
Možnosti je mogoče posredovati prek podatkovnih atributov ali JavaScripta. Za atribute podatkov pripnite ime možnosti v data-
, kot v data-offset-top="200"
.
Ime | vrsta | privzeto | opis |
---|---|---|---|
odmik | številka | funkcija | predmet | 10 | Slikovne pike za odmik od zaslona pri izračunu položaja drsenja. Če je navedena ena sama številka, bo odmik uporabljen tako v zgornji kot spodnji smeri. Če želite zagotoviti edinstven, spodnji in zgornji odmik, samo zagotovite predmet offset: { top: 10 } ali offset: { top: 10, bottom: 5 } . Uporabite funkcijo, ko morate dinamično izračunati odmik. |
tarča | selektor | vozlišče | element jQuery | window predmet _ |
Podaja ciljni element pripone. |
.affix(options)
Aktivira vašo vsebino kot priloženo vsebino. Sprejema neobvezne možnostiobject
.
.affix('checkPosition')
Ponovno izračuna stanje pritrditve na podlagi dimenzij, položaja in položaja drsenja ustreznih elementov. , .affix
, .affix-top
in.affix-bottom
se dodajo ali odstranijo iz pripete vsebine glede na novo stanje. To metodo je treba poklicati vsakič, ko se spremenijo dimenzije pritrjene vsebine ali ciljnega elementa, da se zagotovi pravilno pozicioniranje pritrjene vsebine.
Bootstrapov vtičnik za pritrditev razkrije nekaj dogodkov za priključitev na funkcionalnost pritrditev.
Vrsta dogodka | Opis |
---|---|
affix.bs.affix | Ta dogodek se sproži tik preden je element pritrjen. |
pritrjen.bs.pritrditev | Ta dogodek se sproži, ko je bil element pritrjen. |
affix-top.bs.affix | Ta dogodek se sproži tik preden je element pritrjen na vrh. |
affixed-top.bs.affix | Ta dogodek se sproži, ko je element pritrjen na vrh. |
affix-bottom.bs.affix | Ta dogodek se sproži tik preden je element pritrjen na dno. |
pritrjeno-dno.bs.pritrditev | Ta dogodek se sproži, ko je element pritrjen na dno. |