JavaScript
Atdzīviniet Bootstrap komponentus, izmantojot vairāk nekā duci pielāgotu jQuery spraudņu. Viegli iekļaujiet tos visus vai pa vienam.
Atdzīviniet Bootstrap komponentus, izmantojot vairāk nekā duci pielāgotu jQuery spraudņu. Viegli iekļaujiet tos visus vai pa vienam.
Spraudņus var iekļaut atsevišķi (izmantojot Bootstrap atsevišķus *.js
failus) vai visus vienlaikus (izmantojot bootstrap.js
vai samazināto bootstrap.min.js
).
Abi bootstrap.js
un bootstrap.min.js
satur visus spraudņus vienā failā. Iekļauts tikai viens.
Daži spraudņi un CSS komponenti ir atkarīgi no citiem spraudņiem. Ja spraudņus iekļaujat atsevišķi, noteikti pārbaudiet, vai dokumentos nav šīs atkarības. Ņemiet vērā arī to, ka visi spraudņi ir atkarīgi no jQuery (tas nozīmē, ka jQuery ir jāiekļauj pirms spraudņa failiem). Sazinieties ar mūsubower.json
, lai uzzinātu, kuras jQuery versijas tiek atbalstītas.
Varat izmantot visus Bootstrap spraudņus, izmantojot tikai iezīmēšanas API, neierakstot nevienu JavaScript rindiņu. Šis ir Bootstrap pirmās klases API, un tas ir vispirms jāņem vērā, lietojot spraudni.
Tomēr dažās situācijās var būt vēlams šo funkcionalitāti izslēgt. Tāpēc mēs arī nodrošinām iespēju atspējot datu atribūta API, atsaistot visus notikumus dokumentā, kas atrodas nosaukumvietā ar data-api
. Tas izskatās šādi:
Alternatīvi, lai atlasītu konkrētu spraudni, vienkārši iekļaujiet spraudņa nosaukumu kā nosaukumvietu kopā ar datu api nosaukumvietu, piemēram:
Vienam elementam neizmantojiet datu atribūtus no vairākiem spraudņiem. Piemēram, pogai nevar būt gan rīka padoms, gan modāla pārslēgšana. Lai to paveiktu, izmantojiet iesaiņojuma elementu.
Mēs arī uzskatām, ka jums vajadzētu būt iespējai izmantot visus Bootstrap spraudņus, tikai izmantojot JavaScript API. Visas publiskās API ir atsevišķas, ķēdējamas metodes, un tās atgriež kolekciju, uz kuru ir veikta darbība.
Visām metodēm ir jāpieņem neobligāto opciju objekts, virkne, kuras mērķis ir noteikta metode, vai nekas (kas iniciē spraudni ar noklusējuma darbību):
Katrs spraudnis arī parāda savu neapstrādāto konstruktoru Constructor
īpašumā: $.fn.popover.Constructor
. Ja vēlaties iegūt konkrētu spraudņa instanci, izgūstiet to tieši no elementa: $('[rel="popover"]').data('popover')
.
Varat mainīt spraudņa noklusējuma iestatījumus, modificējot spraudņa Constructor.DEFAULTS
objektu:
Dažreiz ir nepieciešams izmantot Bootstrap spraudņus ar citiem lietotāja interfeisa ietvariem. Šādos apstākļos dažkārt var rasties nosaukumtelpas sadursmes. Ja tā notiek, varat izsaukt .noConflict
spraudni, kura vērtību vēlaties atjaunot.
Bootstrap nodrošina pielāgotus notikumus lielākajai daļai spraudņu unikālo darbību. Parasti tie ir infinitīva un pagātnes divdabja formā — kur infinitīvs (piem. show
) tiek aktivizēts notikuma sākumā, bet tā pagātnes divdabja forma (piem. shown
) tiek aktivizēta pēc darbības pabeigšanas.
Sākot ar versiju 3.0.0, visi Bootstrap notikumi ir nosaukumos.
Visi infinitīvie notikumi nodrošina preventDefault
funkcionalitāti. Tas nodrošina iespēju apturēt darbības izpildi pirms tās sākšanas.
Katra Bootstrap jQuery spraudņa versijai var piekļūt, izmantojot VERSION
spraudņa konstruktora īpašumu. Piemēram, rīka padoma spraudnim:
Bootstrap spraudņi nav īpaši graciozi, ja JavaScript ir atspējots. Ja jums rūp lietotāja pieredze šajā gadījumā, izmantojiet <noscript>
, lai izskaidrotu situāciju (un kā atkārtoti iespējot JavaScript) saviem lietotājiem un/vai pievienojiet savus pielāgotos atkāpšanās variantus.
Bootstrap oficiāli neatbalsta trešo pušu JavaScript bibliotēkas , piemēram, Prototype vai jQuery UI. Neskatoties uz .noConflict
nosaukumiem sadalītiem notikumiem, var rasties saderības problēmas, kas jums ir jānovērš pašam.
Lai iegūtu vienkāršus pārejas efektus, transition.js
vienu reizi iekļaujiet kopā ar citiem JS failiem. Ja izmantojat kompilēto (vai samazināto) bootstrap.js
, tas nav jāiekļauj — tas jau ir tur.
Transition.js ir pamata palīgs transitionEnd
notikumiem, kā arī CSS pārejas emulators. To izmanto citi spraudņi, lai pārbaudītu CSS pārejas atbalstu un noķertu pārejas.
Pārejas var globāli atspējot, izmantojot šādu JavaScript fragmentu, kuram ir jānāk pēc transition.js
(vai bootstrap.js
vai bootstrap.min.js
, atkarībā no gadījuma) ielādes:
Modāļi ir racionalizēti, bet elastīgi dialoga uzvednes ar minimālo nepieciešamo funkcionalitāti un viedajiem noklusējuma iestatījumiem.
Noteikti neatveriet modālu, kamēr vēl ir redzams cits. Lai vienlaikus rādītu vairāk nekā vienu modālu, ir nepieciešams pielāgots kods.
Vienmēr mēģiniet ievietot modāla HTML kodu sava dokumenta augstākā līmeņa pozīcijā, lai izvairītos no citiem komponentiem, kas ietekmē modāla izskatu un/vai funkcionalitāti.
Ir daži brīdinājumi par modālu izmantošanu mobilajās ierīcēs. Detalizētu informāciju skatiet mūsu pārlūkprogrammas atbalsta dokumentos .
Tā kā HTML5 definē savu semantiku, autofocus
HTML atribūts Bootstrap modālos neietekmē. Lai sasniegtu tādu pašu efektu, izmantojiet kādu pielāgotu JavaScript:
Renderēts modāls ar galveni, pamattekstu un darbību kopu kājenē.
Pārslēdziet modālu, izmantojot JavaScript, noklikšķinot uz tālāk esošās pogas. Tas noslīdēs uz leju un pazudīs no lapas augšdaļas.
Noteikti pievienojiet role="dialog"
un aria-labelledby="..."
, atsaucoties uz modālo nosaukumu, uz .modal
un role="document"
uz .modal-dialog
pašu.
Turklāt varat sniegt modālā dialoga aprakstu, aria-describedby
izmantojot .modal
.
Lai iegultu YouTube videoklipus modālos, ir nepieciešams papildu JavaScript, kas nav Bootstrap, lai automātiski apturētu atskaņošanu un daudz ko citu. Lai iegūtu papildinformāciju, skatiet šo noderīgo Stack Overflow ziņu .
Modāļiem ir divi izvēles izmēri, kas pieejami modifikatoru klasēs, lai tos ievietotu .modal-dialog
.
Modāliem, kas vienkārši parādās, nevis izgaist, lai skatītu, noņemiet .fade
klasi no modālā marķējuma.
Lai modālā izmantotu Bootstrap režģa sistēmas priekšrocības, vienkārši ievietojiet .row
s modālā .modal-body
un pēc tam izmantojiet parastās režģa sistēmas klases.
Vai jums ir vairākas pogas, kas aktivizē vienu un to pašu modāli, tikai ar nedaudz atšķirīgu saturu? Izmantojiet event.relatedTarget
un HTML data-*
atribūtus (iespējams , izmantojot jQuery ), lai mainītu modāla saturu atkarībā no tā, kura poga tika noklikšķināta. Skatiet Modal Events dokumentus, lai iegūtu sīkāku informāciju par relatedTarget
,
Modālais spraudnis pēc pieprasījuma pārslēdz jūsu slēpto saturu, izmantojot datu atribūtus vai JavaScript. Tas arī papildina noklusējuma ritināšanas darbību ignorēšanai un ģenerē .modal-open
klikšķa apgabalu parādīto modāļu noraidīšanai, noklikšķinot ārpus modāla.<body>
.modal-backdrop
Aktivizējiet modālu, neierakstot JavaScript. Iestatiet data-toggle="modal"
kontroliera elementu, piemēram, pogu, kopā ar data-target="#foo"
vai href="#foo"
, lai atlasītu konkrētu modālu, lai pārslēgtu.
Izsauciet modālu ar ID myModal
ar vienu JavaScript rindiņu:
Opcijas var nodot, izmantojot datu atribūtus vai JavaScript. Datu atribūtiem pievienojiet opcijas nosaukumu data-
, tāpat kā data-backdrop=""
.
Vārds | veids | noklusējuma | apraksts |
---|---|---|---|
fons | Būla vērtība vai virkne'static' |
taisnība | Ietver modāla fona elementu. Vai arī norādiet static fona kolāžu, kas neaizver modālu, noklikšķinot. |
tastatūra | Būla | taisnība | Aizver modālu, kad tiek nospiests evakuācijas taustiņš |
parādīt | Būla | taisnība | Parāda modālu inicializācijas laikā. |
tālvadības pults | ceļš | viltus | Šī opcija ir novecojusi kopš v3.3.0 un ir noņemta versijā 4. Tā vietā mēs iesakām izmantot klienta puses veidni vai datu saistīšanas ietvaru vai pašam izsaukt jQuery.load . Ja tiek nodrošināts attālais URL, saturs tiks ielādēts vienu reizi , izmantojot jQuery |
.modal(options)
Aktivizē jūsu saturu kā modālu. Pieņem izvēles opcijas object
.
.modal('toggle')
Manuāli pārslēdz modālu. Atgriežas pie zvanītāja, pirms modāls ir faktiski parādīts vai paslēpts (ti, pirms notiek notikums shown.bs.modal
vai ).hidden.bs.modal
.modal('show')
Manuāli atver modālu. Atgriežas pie zvanītāja, pirms modāls ir faktiski parādīts (ti, pirms shown.bs.modal
notikuma).
.modal('hide')
Manuāli slēpj modālu. Atgriežas pie zvanītāja, pirms modāls ir faktiski paslēpts (ti, pirms hidden.bs.modal
notikuma).
.modal('handleUpdate')
Pārregulē modāla pozicionēšanu, lai novērstu ritjoslu, ja tāda parādās, kas liktu modālam lēkt pa kreisi.
Nepieciešams tikai tad, ja modāla augstums mainās, kamēr tas ir atvērts.
Bootstrap modālā klase atklāj dažus notikumus, lai piesaistītu modālo funkcionalitāti.
Visi modālie notikumi tiek aktivizēti uz pašu modālu (ti, uz <div class="modal">
).
Pasākuma veids | Apraksts |
---|---|
show.bs.modal | Šis notikums tiek aktivizēts nekavējoties, kad show tiek izsaukta instances metode. Ja to izraisījis klikšķis, noklikšķinātais elements ir pieejams kā relatedTarget notikuma īpašums. |
parādīts.bs.modal | Šis notikums tiek aktivizēts, kad modāls ir padarīts redzams lietotājam (pagaidīs, kamēr CSS pārejas tiks pabeigtas). Ja to izraisījis klikšķis, noklikšķinātais elements ir pieejams kā relatedTarget notikuma īpašums. |
slēpt.bs.modal | Šis notikums tiek aktivizēts nekavējoties, kad hide ir izsaukta instances metode. |
slēpts.bs.modal | Šis notikums tiek aktivizēts, kad modāls ir beidzis slēpt no lietotāja (pagaidīs, līdz CSS pārejas tiks pabeigtas). |
loaded.bs.modal | Šis notikums tiek aktivizēts, kad modāls ir ielādējis saturu, izmantojot remote opciju. |
Pievienojiet nolaižamās izvēlnes gandrīz jebkam, izmantojot šo vienkāršo spraudni, tostarp navigācijas joslu, cilnes un tabletes.
Izmantojot datu atribūtus vai JavaScript, nolaižamais spraudnis pārslēdz slēpto saturu (nolaižamās izvēlnes), pārslēdzot .open
klasi vecāksaraksta vienumā.
Mobilajās ierīcēs, atverot nolaižamo izvēlni, tiek pievienots .dropdown-backdrop
kā pieskāriena apgabals nolaižamo izvēlņu aizvēršanai, pieskaroties ārpus izvēlnes, un tas ir prasība pareizam iOS atbalstam. Tas nozīmē, ka, lai pārslēgtos no atvērtas nolaižamās izvēlnes uz citu nolaižamo izvēlni, mobilajā ierīcē ir nepieciešams papildu pieskāriens.
Piezīme. data-toggle="dropdown"
Atribūts tiek izmantots, lai aizvērtu nolaižamās izvēlnes lietojumprogrammas līmenī, tāpēc ieteicams to izmantot vienmēr.
Pievienojiet data-toggle="dropdown"
saitei vai pogai, lai pārslēgtu nolaižamo izvēlni.
Lai saglabātu vietrāžus URL ar saišu pogām, izmantojiet data-target
atribūtu, nevis href="#"
.
Izsauciet nolaižamās izvēlnes, izmantojot JavaScript:
data-toggle="dropdown"
joprojām ir nepieciešamsNeatkarīgi no tā, vai izsaucat nolaižamo izvēlni, izmantojot JavaScript vai tā vietā izmantojat datu api, data-toggle="dropdown"
nolaižamās izvēlnes aktivizētāja elementā vienmēr ir jābūt klāt.
Nav
$().dropdown('toggle')
Pārslēdz noteiktās navigācijas joslas vai cilnes navigācijas nolaižamo izvēlni.
Visi nolaižamā saraksta notikumi tiek aktivizēti .dropdown-menu
vecākelementā.
Visiem nolaižamajiem notikumiem ir relatedTarget
rekvizīts, kura vērtība ir pārslēgšanas enkura elements.
Pasākuma veids | Apraksts |
---|---|
parādīt.bs.nolaižamo izvēlni | Šis notikums tiek aktivizēts nekavējoties, kad tiek izsaukta parādīšanas instances metode. |
parādīts.bs.nolaižamajā izvēlnē | Šis notikums tiek aktivizēts, kad nolaižamā izvēlne ir padarīta redzama lietotājam (tiks gaidīts, līdz CSS pārejas tiks pabeigtas). |
hide.bs.nolaižamajā izvēlnē | Šis notikums tiek aktivizēts nekavējoties, kad tiek izsaukta slēpšanas instances metode. |
slēptās.bs.nolaižamā izvēlne | Šis notikums tiek aktivizēts, kad nolaižamā izvēlne ir paslēpta no lietotāja (tiks gaidīts, kamēr CSS pārejas tiks pabeigtas). |
ScrollSpy spraudnis ir paredzēts automātiskai navigācijas mērķu atjaunināšanai, pamatojoties uz ritināšanas pozīciju. Ritiniet apgabalu zem navigācijas joslas un skatieties, kā mainās aktīvā klase. Tiks izcelti arī nolaižamās izvēlnes apakšvienumi.
Reklāmas legingi keytar, branch id art party dolor labore. Pitchfork yr enim lo-fi, pirms tie tika izpārdoti. Tumblr velosipēdu tiesības no saimniecības līdz galdam neatkarīgi no tā. Anim keffiyeh carles jaka. Velit seitan mcsweeney's foto booth 3 wolf moon irure. Cosby džemperis lomo jean šorti, williamsburg hoodie minim qui jūs droši vien neesat dzirdējuši par tiem un jakas trasta fonds culpa biodiesel wes anderson estētiskā. Nihil tetovēts accusamus, cred ironija biodīzelis keffiyeh artisan ullamco consequat.
Veniam marfa ūsu skeitbords, pievilcīga fugiat velit dakšu bārda. Freegan beard aliqua cupidatat mcsweeney's vero. Cupidatat četras loko nisi, ea helvetica nulla carles. Tetovēts Cosby džemperis food truck, Mcsweeney's quis non-freegan vinila. Lo-fi Vess Andersons +1 sartorial. Carles non-estētiskā vingrošana quis ģentrificēt. Brooklyn adipisicing amatniecības alus vice keytar deserunt.
Occaecat commodo aliqua delectus. Fap craft beer deserunt skeitborda ea. Lomo velosipēdu tiesības adipisicing banh mi, velit ea sunt next level locavore vienas izcelsmes kafija magna veniam. High life ID vinils, echo park consequat quis aliquip banh mi pitchfork. Vero VHS est adipisicing. Consectetur nisi DIY minim kurjera soma. Cred ex in, ilgtspējīgs 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 kurjersoma marfa whatever delectus food truck. Sapiente synth id uzņemties. Locavore sed helvetica klišeja ironija, pērkona kaķi, par kuriem jūs, iespējams, neesat dzirdējuši, consequat hoodie bez lipekļa lo-fi fap aliquip. Labore elit placeat, pirms tās izpārdotas, frotē Ričardsona proidents vēlās brokastis nesciunt quis cosby džemperis pariatur keffiyeh ut helvetica artisan. Cardigan craft alus seitan readymade velit. VHS chambray laboris tempor veniam. Anim mollit minim commodo ullamco thundercats.
Navigācijas joslas saitēm ir jābūt atrisināmiem ID mērķiem. Piemēram, <a href="#home">home</a>
ir jāatbilst kaut kam DOM, piemēram, <div id="home"></div>
.
:visible
, kas nav mērķa elementi, ir ignorētiMērķa elementi, kas neatbilst :visible
jQuery , tiks ignorēti, un tiem atbilstošie navigācijas vienumi nekad netiks izcelti.
Neatkarīgi no ieviešanas metodes, scrollspy pieprasa izmantot position: relative;
elementu, kuru izspiegojat. Vairumā gadījumu tas ir <body>
. Ritinot citus elementus, nevis <body>
, noteikti ir jābūt height
iestatītam un overflow-y: scroll;
lietotam.
Lai augšējās joslas navigācijai viegli pievienotu scrollspy darbību, pievienojiet data-spy="scroll"
elementu, kuru vēlaties izspiegot (parasti tas ir <body>
). Pēc tam pievienojiet atribūtu ar jebkura Bootstrap komponenta data-target
vecākelementa ID vai klasi ..nav
Pēc position: relative;
CSS pievienošanas izsauciet scrollspy, izmantojot JavaScript:
.scrollspy('refresh')
Izmantojot scrollspy kopā ar elementu pievienošanu vai noņemšanu no DOM, jums būs jāizsauc atsvaidzināšanas metode, piemēram:
Opcijas var nodot, izmantojot datu atribūtus vai JavaScript. Datu atribūtiem pievienojiet opcijas nosaukumu data-
, tāpat kā data-offset=""
.
Vārds | veids | noklusējuma | apraksts |
---|---|---|---|
kompensēt | numuru | 10 | Pikseļi, kas jānobīda no augšas, aprēķinot ritināšanas pozīciju. |
Pasākuma veids | Apraksts |
---|---|
activate.bs.scrollspy | Šis notikums tiek aktivizēts ikreiz, kad scrollspy aktivizē jaunu vienumu. |
Pievienojiet ātru, dinamisku ciļņu funkcionalitāti, lai pārietu caur vietējā satura rūtīm, pat izmantojot nolaižamās izvēlnes. Ligzdotas cilnes netiek atbalstītas.
Neapstrādāti džinsi, jūs, iespējams, neesat dzirdējuši par tiem džinsu šorti Austin. Nesciunt tofu stumptown aliqua, retro sintēzes meistara tīrīšana. Ūsas klišeja tempor, williamsburg carles vegan helvetica. Reprehenderit butcher retro keffiyeh Dreamcatcher synth. Cosby džemperis eu banh mi, qui irure terry richardson ex squid. Aliquip placeat Salvia cillum iphone. Seitan aliquip quis kardigāns amerikāņu apģērbs, miesnieks 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.
Šis spraudnis paplašina navigācijas komponentu ar cilnēm , lai pievienotu cilnes apgabalus.
Iespējot cilnes, kurās var izmantot JavaScript (katra cilne ir jāaktivizē atsevišķi):
Atsevišķas cilnes var aktivizēt vairākos veidos:
Varat aktivizēt cilni vai tabletes navigāciju, nerakstot JavaScript, vienkārši norādot elementu data-toggle="tab"
vai data-toggle="pill"
uz tā. Pievienojot cilnei nav
un klases, tiks lietots Bootstrap cilnes stils , savukārt, pievienojot un klases, tiks lietots tablešu stils .nav-tabs
ul
nav
nav-pills
Lai cilnes izzustu, pievienojiet .fade
katrai .tab-pane
. Pirmajā cilnes rūtī ir arī .in
jāpadara redzams sākotnējais saturs.
$().tab
Aktivizē cilnes elementu un satura konteineru. Cilnē DOM ir jābūt vai nu konteinera mezglam, data-target
vai tā mērķauditorijas atlasei. href
Iepriekš minētajos piemēros cilnes ir <a>
s ar data-toggle="tab"
atribūtiem.
.tab('show')
Atlasa doto cilni un parāda ar to saistīto saturu. Visas citas iepriekš atlasītās cilnes tiek atceltas, un ar tām saistītais saturs tiek paslēpts. Atgriežas pie zvanītāja, pirms cilnes rūts ir faktiski parādīta (ti, pirms shown.bs.tab
notikuma).
Rādot jaunu cilni, notikumi tiek aktivizēti šādā secībā:
hide.bs.tab
(pašreizējā aktīvajā cilnē)show.bs.tab
(cilnē, kas jāparāda)hidden.bs.tab
(iepriekšējā aktīvajā cilnē tā pati, kas hide.bs.tab
pasākumam)shown.bs.tab
(jaunaktīvā tikko parādītajā cilnē tā pati, kas show.bs.tab
notikumam)Ja neviena cilne jau nebija aktīva, hide.bs.tab
un hidden.bs.tab
notikumi netiks aktivizēti.
Pasākuma veids | Apraksts |
---|---|
show.bs.tab | Šis notikums tiek aktivizēts cilnes rādīšanas laikā, bet pirms jaunās cilnes parādīšanas. Izmantojiet event.target un event.relatedTarget , lai atlasītu attiecīgi aktīvo cilni un iepriekšējo aktīvo cilni (ja pieejama). |
parādīts.bs.tab | Šis notikums tiek aktivizēts cilnes rādīšanas laikā pēc cilnes parādīšanas. Izmantojiet event.target un event.relatedTarget , lai atlasītu attiecīgi aktīvo cilni un iepriekšējo aktīvo cilni (ja pieejama). |
hide.bs.tab | Šis notikums tiek aktivizēts, kad ir jāparāda jauna cilne (un tādējādi iepriekšējā aktīvā cilne ir jāpaslēpta). Izmantojiet event.target un event.relatedTarget , lai atlasītu attiecīgi pašreizējo aktīvo cilni un jauno cilni, kas drīzumā būs aktīva. |
Hid.bs.tab | Šis notikums tiek aktivizēts pēc jaunas cilnes parādīšanas (un līdz ar to iepriekšējā aktīvā cilne tiek paslēpta). Izmantojiet event.target un event.relatedTarget , lai atlasītu attiecīgi iepriekšējo aktīvo cilni un jauno aktīvo cilni. |
Iedvesmojoties no izcilā spraudņa jQuery.tipsy, ko sarakstījis Džeisons Frame; Rīka padomi ir atjaunināta versija, kas nav atkarīga no attēliem, izmanto CSS3 animācijām un datu atribūtus vietējai nosaukumu glabāšanai.
Rīka padomi ar nulles garuma virsrakstiem nekad netiek rādīti.
Virziet kursoru virs tālāk esošajām saitēm, lai skatītu rīka padomus:
Stingras bikses nākamā līmeņa keffiyeh jūs, iespējams , neesat dzirdējuši par tām. Foto kabīne bārda neapstrādāta džinsa augstspiedes vegāna kurjera soma stumptown. Seitans no lauku saimniecības līdz galdam, Mcsweeney's fixie ilgtspējīgs quinoa 8 bitu amerikāņu apģērbs ar frotē Ričardsona vinila šambreju. Beard stumptown, jakas banh mi lomo thundercats. Tofu biodīzeļdegviela williamsburg marfa, četras loko mcsweeney's cleanse vegan chambray. Patiešām ironisks amatnieks neatkarīgi no keytar , scenester no saimniecības līdz galdam banksy Austin twitter rokturis freegan cred neapstrādāta džinsa vienas izcelsmes kafijas vīruss.
Ir pieejamas četras opcijas: līdzinājums augšā, pa labi, apakšā un pa kreisi.
Veiktspējas apsvērumu dēļ rīka padoms un Popover datu apis ir izvēlēti, kas nozīmē, ka jums tie ir jāinicializē pašam .
Viens veids, kā inicializēt visus rīka padomus lapā, būtu atlasīt tos pēc to data-toggle
atribūta:
Rīkpadomu spraudnis ģenerē saturu un marķējumu pēc pieprasījuma un pēc noklusējuma ievieto rīka padomus aiz to aktivizētāja elementa.
Aktivizējiet rīka padomu, izmantojot JavaScript:
Rīka padomam nepieciešamais marķējums ir tikai data
atribūts title
, un HTML elementā, kuram vēlaties izveidot rīka padomu. Rīka padoma ģenerētais marķējums ir diezgan vienkāršs, lai gan tam ir nepieciešama pozīcija (pēc noklusējuma to iestatījis top
spraudnis).
Dažreiz hipersaitei vēlaties pievienot rīka padomu, kas apvij vairākas rindiņas. Rīkpadomu spraudņa noklusējuma darbība ir centrēt to horizontāli un vertikāli. Pievienojiet white-space: nowrap;
saviem enkuriem, lai no tā izvairītos.
Ja izmantojat rīka padomus elementiem, kas ietverti a .btn-group
vai .input-group
, vai ar tabulu saistītiem elementiem ( <td>
, <th>
, <tr>
, <thead>
, <tbody>
, <tfoot>
), jums būs jānorāda opcija container: 'body'
(dokumentēta tālāk), lai izvairītos no nevēlamām blakusparādībām (piemēram, elementa paplašināšanās un/ vai zaudē noapaļotos stūrus, kad tiek aktivizēts rīka padoms).
Lietotājiem, kuri pārvietojas ar tastatūru, un jo īpaši palīgtehnoloģiju lietotājiem, rīka padomi jāpievieno tikai uz tastatūru vērstiem elementiem, piemēram, saitēm, veidlapas vadīklām vai jebkuram patvaļīgam elementam ar tabindex="0"
atribūtu.
disabled
Lai elementam vai elementam pievienotu rīka padomu .disabled
, ievietojiet elementu a iekšpusē <div>
un tā vietā izmantojiet rīka padomu <div>
.
Opcijas var nodot, izmantojot datu atribūtus vai JavaScript. Datu atribūtiem pievienojiet opcijas nosaukumu data-
, tāpat kā data-animation=""
.
Vārds | Tips | Noklusējums | Apraksts |
---|---|---|---|
animācija | Būla | taisnība | Rīka padomam izmantojiet CSS izbalēšanas pāreju |
konteiners | stīga | viltus | viltus | Pievieno rīka padomu noteiktam elementam. Piemērs: |
kavēšanās | numurs | objektu | 0 | Rīka padoma rādīšanas un slēpšanas aizkave (ms) — neattiecas uz manuālo palaišanas veidu Ja tiek norādīts numurs, aizkave tiek piemērota gan slēpšanai/rādīšanai Objekta struktūra ir šāda: |
html | Būla | viltus | Rīka padomā ievietojiet HTML. text Ja tas ir nepatiess, satura ievietošanai DOM tiks izmantota jQuery metode. Izmantojiet tekstu, ja uztraucaties par XSS uzbrukumiem. |
izvietojumu | stīga | funkciju | 'tops' | Kā novietot rīka padomu — uz augšu | apakšā | pa kreisi | pa labi | auto. Ja funkcija tiek izmantota, lai noteiktu izvietojumu, tā tiek izsaukta ar rīka padoma DOM mezglu kā pirmo argumentu un trigerēšanas elementu DOM mezglu kā otro. Konteksts |
atlasītājs | stīga | viltus | Ja ir nodrošināts atlasītājs, rīka padomu objekti tiks deleģēti norādītajiem mērķiem. Praksē to izmanto, lai iespējotu dinamiskā HTML satura rīka padomu pievienošanu. Skatiet šo un informatīvo piemēru . |
veidne | stīga | '<div class="tooltip" role="tooltip"><div class="tooltip-arrow"></div><div class="tooltip-inner"></div></div>' |
Pamata HTML, kas jāizmanto, veidojot rīka padomu. Rīka padoms
Vistālākajam iesaiņojuma elementam jābūt |
virsraksts | stīga | funkciju | '' | Noklusējuma nosaukuma vērtība, ja Ja funkcija ir norādīta, tā tiks izsaukta ar |
sprūda | stīga | "fokuss virs kursora" | Kā tiek aktivizēts rīka padoms — noklikšķiniet uz | lidināties | fokuss | rokasgrāmata. Jūs varat nodot vairākus trigerus; atdaliet tos ar atstarpi. manual nevar kombinēt ar kādu citu aktivizētāju. |
skata logs | stīga | objekts | funkciju | { selektors: 'body', polsterējums: 0 } | Saglabā rīka padomu šī elementa robežās. Piemērs: Ja funkcija ir dota, tā tiek izsaukta ar trigerēšanas elementu DOM mezglu kā vienīgo argumentu. Konteksts |
Atsevišķu rīka padomu opcijas var arī norādīt, izmantojot datu atribūtus, kā paskaidrots iepriekš.
$().tooltip(options)
Elementu kolekcijai pievieno rīku padomu apdarinātāju.
.tooltip('show')
Parāda elementa rīka padomu. Atgriežas pie zvanītāja, pirms rīka padoms ir faktiski parādīts (ti, pirms shown.bs.tooltip
notikuma). To uzskata par rīka padoma "manuālu" aktivizēšanu. Rīka padomi ar nulles garuma virsrakstiem nekad netiek rādīti.
.tooltip('hide')
Paslēpj elementa rīka padomu. Atgriežas pie zvanītāja, pirms rīka padoms faktiski ir paslēpts (ti, pirms hidden.bs.tooltip
notikuma). To uzskata par rīka padoma "manuālu" aktivizēšanu.
.tooltip('toggle')
Pārslēdz elementa rīka padomu. Atgriežas pie zvanītāja, pirms rīka padoms ir faktiski parādīts vai paslēpts (ti, pirms shown.bs.tooltip
vai hidden.bs.tooltip
notikuma). To uzskata par rīka padoma "manuālu" aktivizēšanu.
.tooltip('destroy')
Paslēpj un iznīcina elementa rīka padomu. Rīka padomus, kuros tiek izmantota deleģēšana (kas tiek izveidoti, izmantojot opciju selector
) , nevar atsevišķi iznīcināt pēcnācēju aktivizētāja elementiem.
Pasākuma veids | Apraksts |
---|---|
parādīt.bs.rīka padoms | Šis notikums tiek aktivizēts nekavējoties, kad show tiek izsaukta instances metode. |
parādīts.bs.rīka padoms | Šis notikums tiek aktivizēts, kad rīka padoms ir padarīts redzams lietotājam (pagaidīs, kamēr CSS pārejas tiks pabeigtas). |
slēpt.bs.rīka padoms | Šis notikums tiek aktivizēts nekavējoties, kad hide ir izsaukta instances metode. |
slēptās.bs.rīka padoms | Šis notikums tiek aktivizēts, kad rīka padoms ir beidzies paslēpt no lietotāja (tiks gaidīts, līdz tiks pabeigtas CSS pārejas). |
ievietots.bs.rīka padoms | Šis notikums tiek aktivizēts pēc show.bs.tooltip notikuma, kad rīka padoma veidne ir pievienota DOM. |
Pievienojiet mazus satura pārklājumus, piemēram, iPad, jebkuram elementam, lai ievietotu sekundāro informāciju.
Uznirstošie elementi, kuru nosaukumam un saturam ir nulles garums, nekad netiek rādīti.
Uznirstošajiem ekrāniem ir nepieciešams, lai jūsu Bootstrap versijā būtu iekļauts rīka padoma spraudnis .
Veiktspējas apsvērumu dēļ rīka padoms un Popover datu apis ir izvēlēti, kas nozīmē, ka jums tie ir jāinicializē pašam .
Viens veids, kā inicializēt visus uznirstošos logus lapā, būtu atlasīt tos pēc to data-toggle
atribūta:
Izmantojot uznirstošos logus elementos a .btn-group
vai .input-group
, vai ar tabulu saistītiem elementiem ( <td>
, <th>
, <tr>
, <thead>
, <tbody>
, <tfoot>
), jums būs jānorāda opcija container: 'body'
(dokumentēta tālāk), lai izvairītos no nevēlamām blakusparādībām (piemēram, elementa paplašināšanās un/ vai zaudē noapaļotos stūrus, kad tiek aktivizēts popover).
disabled
Lai elementam vai elementam pievienotu uznirstošo logu .disabled
, ievietojiet elementu a iekšpusē <div>
un tā vietā izmantojiet uznirstošo logu <div>
.
Dažreiz hipersaitei vēlaties pievienot uznirstošo logu, kas apvij vairākas rindiņas. Uznirstošā spraudņa noklusējuma darbība ir centrēt to horizontāli un vertikāli. Pievienojiet white-space: nowrap;
saviem enkuriem, lai no tā izvairītos.
Ir pieejamas četras opcijas: līdzinājums augšā, pa labi, apakšā un pa kreisi.
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.
Izmantojiet focus
trigeri, lai noraidītu uznirstošos logus nākamajā lietotāja klikšķinā.
Lai nodrošinātu pareizu darbību starp pārlūkprogrammām un platformām, ir jāizmanto <a>
tags, nevis tags, kā <button>
arī jāiekļauj atribūti role="button"
un .tabindex
Iespējot uznirstošos logus, izmantojot JavaScript:
Opcijas var nodot, izmantojot datu atribūtus vai JavaScript. Datu atribūtiem pievienojiet opcijas nosaukumu data-
, tāpat kā data-animation=""
.
Vārds | Tips | Noklusējums | Apraksts |
---|---|---|---|
animācija | Būla | taisnība | Uznirstošajam logam izmantojiet CSS izbalēšanas pāreju |
konteiners | stīga | viltus | viltus | Pievieno uznirstošo logu konkrētam elementam. Piemērs: |
saturu | stīga | funkciju | '' | Noklusējuma satura vērtība, ja Ja funkcija ir dota, tā tiks izsaukta ar |
kavēšanās | numurs | objektu | 0 | Uznirstošā loga rādīšanas un slēpšanas aizkave (ms) — neattiecas uz manuālo palaišanas veidu Ja tiek norādīts numurs, aizkave tiek piemērota gan slēpšanai/rādīšanai Objekta struktūra ir šāda: |
html | Būla | viltus | Ievietojiet HTML uznirstošajā logā. text Ja tas ir nepatiess, satura ievietošanai DOM tiks izmantota jQuery metode. Izmantojiet tekstu, ja uztraucaties par XSS uzbrukumiem. |
izvietojumu | stīga | funkciju | 'pa labi' | Kā novietot uznirstošo logu — augšpusē | apakšā | pa kreisi | pa labi | auto. Ja funkcija tiek izmantota, lai noteiktu izvietojumu, tā tiek izsaukta ar uznirstošo DOM mezglu kā pirmo argumentu un izraisošo elementu DOM mezglu kā otro. Konteksts |
atlasītājs | stīga | viltus | Ja ir nodrošināts atlasītājs, uznirstošie objekti tiks deleģēti norādītajiem mērķiem. Praksē to izmanto, lai dinamiskam HTML saturam iespējotu uznirstošo logu pievienošanu. Skatiet šo un informatīvo piemēru . |
veidne | stīga | '<div class="popover" role="tooltip"><div class="arrow"></div><h3 class="popover-title"></h3><div class="popover-content"></div></div>' |
Pamata HTML, kas jāizmanto, veidojot uznirstošo logu. Popover's Popover's
Vistālākajam iesaiņojuma elementam jābūt |
virsraksts | stīga | funkciju | '' | Noklusējuma nosaukuma vērtība, ja Ja funkcija ir dota, tā tiks izsaukta ar |
sprūda | stīga | 'klikšķis' | Kā tiek aktivizēts popover — noklikšķiniet uz | lidināties | fokuss | rokasgrāmata. Jūs varat nodot vairākus trigerus; atdaliet tos ar atstarpi. manual nevar kombinēt ar kādu citu aktivizētāju. |
skata logs | stīga | objekts | funkciju | { selektors: 'body', polsterējums: 0 } | Saglabā uznirstošo logu šī elementa robežās. Piemērs: Ja funkcija ir dota, tā tiek izsaukta ar trigerēšanas elementu DOM mezglu kā vienīgo argumentu. Konteksts |
Atsevišķu uznirstošo logu opcijas var norādīt, izmantojot datu atribūtus, kā paskaidrots iepriekš.
$().popover(options)
Inicializē elementu kolekcijas uznirstošos logus.
.popover('show')
Atklāj elementa popover. Atgriežas pie zvanītāja, pirms faktiski ir parādīts uznirstošais logs (ti, pirms shown.bs.popover
notikuma). Tas tiek uzskatīts par "manuālu" uznirstošā ekrāna aktivizēšanu. Uznirstošie elementi, kuru nosaukumam un saturam ir nulles garums, nekad netiek rādīti.
.popover('hide')
Paslēpj elementa uznirstošo logu. Atgriežas pie zvanītāja, pirms uznirstošais logs ir faktiski paslēpts (ti, pirms hidden.bs.popover
notikuma). Tas tiek uzskatīts par "manuālu" uznirstošā ekrāna aktivizēšanu.
.popover('toggle')
Pārslēdz elementa uznirstošo logu. Atgriežas pie zvanītāja, pirms uznirstošais logs ir faktiski parādīts vai paslēpts (ti, pirms shown.bs.popover
vai hidden.bs.popover
notikuma). Tas tiek uzskatīts par "manuālu" uznirstošā ekrāna aktivizēšanu.
.popover('destroy')
Paslēpj un iznīcina elementa uznirstošo logu. Uznirstošos logus, kuros tiek izmantota deleģēšana (kas tiek izveidoti, izmantojot opciju selector
) , nevar atsevišķi iznīcināt pēcnācēju trigera elementiem.
Pasākuma veids | Apraksts |
---|---|
show.bs.popover | Šis notikums tiek aktivizēts nekavējoties, kad show tiek izsaukta instances metode. |
parādīts.bs.popover | Šis notikums tiek aktivizēts, kad uznirstošais logs ir padarīts redzams lietotājam (pagaidīs, līdz tiks pabeigtas CSS pārejas). |
hide.bs.popover | Šis notikums tiek aktivizēts nekavējoties, kad hide ir izsaukta instances metode. |
paslēpts.bs.popover | Šis notikums tiek aktivizēts, kad uznirstošais logs ir paslēpts no lietotāja (gaidīs, kamēr CSS pārejas tiks pabeigtas). |
ievietots.bs.popover | Šis notikums tiek aktivizēts pēc show.bs.popover notikuma, kad uznirstošā veidne ir pievienota DOM. |
Pievienojiet noraidīšanas funkcionalitāti visiem brīdinājuma ziņojumiem, izmantojot šo spraudni.
Lietojot .close
pogu, tai ir jābūt pirmajai .alert-dismissible
atzīmei, un marķējumā pirms tās nedrīkst būt teksta saturs.
Mainiet to un to un mēģiniet vēlreiz. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.
Vienkārši pievienojiet data-dismiss="alert"
savai aizvēršanas pogai, lai automātiski piešķirtu brīdinājuma aizvēršanas funkcionalitāti. Aizverot brīdinājumu, tas tiek noņemts no DOM.
Lai brīdinājumos tiktu izmantota animācija, aizverot, pārliecinieties, vai tiem jau ir piemērotas .fade
un .in
klases.
$().alert()
Liek brīdinājuma signālam noklausīties klikšķu notikumus pēcnācēju elementos, kuriem ir data-dismiss="alert"
atribūts. (Nav nepieciešams, ja tiek izmantota datu api automātiskā inicializēšana.)
$().alert('close')
Aizver brīdinājumu, noņemot to no DOM. Ja elementā ir .fade
un .in
klases, brīdinājums pazudīs pirms tā noņemšanas.
Bootstrap brīdinājumu spraudnis atklāj dažus notikumus, lai piesaistītu brīdinājuma funkcionalitāti.
Pasākuma veids | Apraksts |
---|---|
aizvērt.bs.alert | Šis notikums tiek aktivizēts nekavējoties, kad close tiek izsaukta instances metode. |
slēgts.bs.alert | Šis notikums tiek aktivizēts, kad brīdinājums ir aizvērts (pagaidīs, kamēr CSS pārejas tiks pabeigtas). |
Padariet vairāk ar pogām. Vadības pogu stāvokļi vai izveidot pogu grupas citiem komponentiem, piemēram, rīkjoslām.
Firefox saglabā formas kontroles stāvokļus (invaliditāti un pārbaudītību) visā lapas ielādes laikā . Risinājums tam ir izmantot autocomplete="off"
. Skatiet Mozilla kļūdu #654072 .
Pievienot data-loading-text="Loading..."
, lai izmantotu pogas ielādes stāvokli.
Šī funkcija ir novecojusi kopš v3.3.5 un ir noņemta versijā 4.
Šīs demonstrācijas nolūkos mēs izmantojam data-loading-text
un $().button('loading')
, taču tas nav vienīgais stāvoklis, ko varat izmantot. Vairāk par to skatiet tālāk $().button(string)
dokumentācijā .
Pievienot data-toggle="button"
, lai aktivizētu pārslēgšanu uz vienas pogas.
.active
unaria-pressed="true"
Iepriekš pārslēgtām pogām ir jāpievieno .active
klase un aria-pressed="true"
atribūts button
sev.
Pievienojiet data-toggle="buttons"
to .btn-group
saturošai izvēles rūtiņai vai radio ievadiem, lai iespējotu to attiecīgo stilu pārslēgšanu.
.active
Iepriekš atlasītajām opcijām klase ir jāpievieno .active
ievadei label
pašam.
Ja izvēles rūtiņas pogas atzīmētais stāvoklis tiek atjaunināts, neaktivizējot click
notikumu uz pogas (piemēram, izmantojot <input type="reset">
vai izmantojot checked
ievades rekvizītu iestatīšanu), jums pašam būs jāpārslēdz .active
klase uz ievades label
.
$().button('toggle')
Pārslēdz push stāvokli. Piešķir pogai tādu izskatu, ka tā ir aktivizēta.
$().button('reset')
Atiestata pogas stāvokli — apmaina tekstu ar sākotnējo tekstu. Šī metode ir asinhrona un atgriežas pirms atiestatīšanas ir faktiski pabeigta.
$().button(string)
Apmaina tekstu ar jebkuru datu definētu teksta stāvokli.
Elastīgs spraudnis, kas izmanto dažas klases, lai viegli pārslēgtos.
Lai sakļautu, jūsu Bootstrap versijā ir jāiekļauj pāreju spraudnis .
Noklikšķiniet uz tālāk esošajām pogām, lai parādītu un paslēptu citu elementu, veicot klases izmaiņas:
.collapse
slēpj saturu.collapsing
tiek izmantots pāreju laikā.collapse.in
parāda saturuVarat izmantot saiti ar href
atribūtu vai pogu ar data-target
atribūtu. Abos gadījumos data-toggle="collapse"
ir nepieciešams.
Paplašiniet noklusējuma sabrukšanas darbību, lai izveidotu akordeonu ar paneļa komponentu.
Ir iespējams arī apmainīt .panel-body
s ar .list-group
s.
Noteikti pievienojiet aria-expanded
vadības elementu. Šis atribūts skaidri definē ekrāna lasītāju un līdzīgu palīgtehnoloģiju saliekamā elementa pašreizējo stāvokli. Ja saliekamais elements pēc noklusējuma ir aizvērts, tā vērtībai ir jābūt aria-expanded="false"
. in
Ja, izmantojot klasi, pēc noklusējuma esat iestatījis saliekamo elementu atvērtu, aria-expanded="true"
tā vietā iestatiet vadīklu. Spraudnis automātiski pārslēgs šo atribūtu atkarībā no tā, vai saliekamais elements ir atvērts vai aizvērts.
Turklāt, ja jūsu vadības elements ir vērsts uz vienu saliekamo elementu, ti, data-target
atribūts norāda uz id
atlasītāju, jūs varat pievienot papildu aria-controls
atribūtu vadības elementam, kas satur id
saliekamā elementa atribūtu. Mūsdienu ekrāna lasītāji un līdzīgas palīgtehnoloģijas izmanto šo atribūtu, lai nodrošinātu lietotājiem papildu īsceļus, kas ļauj pāriet tieši uz saliekamo elementu.
Sakšanas spraudnis izmanto dažas klases, lai apstrādātu smagumu:
.collapse
slēpj saturu.collapse.in
parāda saturu.collapsing
tiek pievienots, kad sākas pāreja, un noņemts, kad tā beidzasŠīs nodarbības var atrast component-animations.less
.
Vienkārši pievienojiet elementam data-toggle="collapse"
un a data-target
, lai automātiski piešķirtu saliekamā elementa vadību. Atribūts data-target
akceptē CSS atlasītāju, kam lietot sakļauto. Noteikti pievienojiet klasi collapse
saliekamajam elementam. Ja vēlaties, lai tas tiktu atvērts pēc noklusējuma, pievienojiet papildu klasi in
.
Lai saliekamai vadīklai pievienotu akordeonam līdzīgu grupu pārvaldību, pievienojiet datu atribūtu data-parent="#selector"
. Skatiet demonstrāciju, lai redzētu to darbībā.
Iespējot manuāli, izmantojot:
Opcijas var nodot, izmantojot datu atribūtus vai JavaScript. Datu atribūtiem pievienojiet opcijas nosaukumu data-
, tāpat kā data-parent=""
.
Vārds | veids | noklusējuma | apraksts |
---|---|---|---|
vecāks | atlasītājs | viltus | Ja ir nodrošināts atlasītājs, visi sakļaujamie elementi zem norādītā vecāka tiks aizvērti, kad tiek parādīts šis saliekamais vienums. (līdzīgi tradicionālajai akordeona uzvedībai - tas ir atkarīgs no panel klases) |
pārslēgt | Būla | taisnība | Pārslēdz saliekamo elementu izsaukšanas laikā |
.collapse(options)
Aktivizē jūsu saturu kā saliekamu elementu. Pieņem izvēles opcijas object
.
.collapse('toggle')
Pārslēdz saliekamo elementu uz parādīto vai paslēpto. Atgriežas pie zvanītāja, pirms saliekamais elements ir faktiski parādīts vai paslēpts (ti, pirms notiek notikums shown.bs.collapse
vai ).hidden.bs.collapse
.collapse('show')
Parāda saliekamu elementu. Atgriežas pie zvanītāja, pirms saliekamais elements ir faktiski parādīts (ti, pirms shown.bs.collapse
notikuma).
.collapse('hide')
Paslēpj saliekamu elementu. Atgriežas pie zvanītāja, pirms saliekamais elements ir faktiski paslēpts (ti, pirms hidden.bs.collapse
notikuma).
Bootstrap sabrukšanas klase atklāj dažus notikumus, lai piesaistītu sabrukšanas funkcionalitāti.
Pasākuma veids | Apraksts |
---|---|
parādīt.bs.sabrukt | Šis notikums tiek aktivizēts nekavējoties, kad show tiek izsaukta instances metode. |
parādīts.bs.sabrukums | Šis notikums tiek aktivizēts, kad sakļautais elements ir padarīts redzams lietotājam (pagaidīs, kamēr CSS pārejas tiks pabeigtas). |
hide.bs.collapse | Šis notikums tiek aktivizēts nekavējoties, kad hide metode ir izsaukta. |
paslēpts.bs.sabrukums | Šis notikums tiek aktivizēts, kad sakļautais elements ir paslēpts no lietotāja (tiks gaidīts, kamēr CSS pārejas tiks pabeigtas). |
Slaidrādes komponents, lai pārvietotos pa elementiem, piemēram, karuselis. Ligzdotie karuseļi netiek atbalstīti.
Karuseļa komponents parasti neatbilst pieejamības standartiem. Ja jums ir jānodrošina atbilstība, lūdzu, apsveriet citas satura prezentēšanas iespējas.
Bootstrap savām animācijām izmanto tikai CSS3, taču pārlūkprogrammas Internet Explorer 8 un 9 neatbalsta nepieciešamos CSS rekvizītus. Tādējādi, izmantojot šīs pārlūkprogrammas, nav slaidu pārejas animācijas. Mēs apzināti esam nolēmuši pārejām neiekļaut uz jQuery balstītus atkāpšanās variantus.
Klase .active
jāpievieno vienam no slaidiem. Pretējā gadījumā karuselis nebūs redzams.
Klases .glyphicon .glyphicon-chevron-left
un .glyphicon .glyphicon-chevron-right
nav obligāti nepieciešamas vadīklām. Bootstrap nodrošina .icon-prev
un .icon-next
kā vienkāršas unikoda alternatīvas.
Vienkārši pievienojiet parakstus saviem slaidiem, izmantojot .carousel-caption
elementu jebkurā .item
. Ievietojiet tajā gandrīz jebkuru izvēles HTML, un tas tiks automātiski līdzināts un formatēts.
Lai karuseļi darbotos pareizi , ir id
jāizmanto vistālākajā konteinerā ( ). .carousel
Pievienojot vairākus karuseļus vai mainot karuseļus id
, noteikti atjauniniet atbilstošās vadīklas.
Izmantojiet datu atribūtus, lai viegli kontrolētu karuseļa pozīciju. data-slide
pieņem atslēgvārdus prev
vai next
, kas maina slaida pozīciju attiecībā pret tā pašreizējo pozīciju. Varat arī izmantot, data-slide-to
lai nodotu neapstrādātu slaidu indeksu karuselim data-slide-to="2"
, kas maina slaida pozīciju uz noteiktu indeksu, kas sākas ar 0
.
Atribūts data-ride="carousel"
tiek izmantots, lai atzīmētu karuseli kā animētu, sākot ar lapas ielādi. To nevar izmantot kopā ar (lieku un nevajadzīgu) nepārprotamu tā paša karuseļa JavaScript inicializēšanu.
Manuāli izsaukt karuseļu, izmantojot:
Opcijas var nodot, izmantojot datu atribūtus vai JavaScript. Datu atribūtiem pievienojiet opcijas nosaukumu data-
, tāpat kā data-interval=""
.
Vārds | veids | noklusējuma | apraksts |
---|---|---|---|
intervāls | numuru | 5000 | Laiks, kas jāpavada starp vienuma automātisku pārvietošanu. Ja tas ir nepatiess, karuselis automātiski nedarbosies. |
pauze | stīga | null | "lidināt" | Ja iestatīts uz "hover" , tiek apturēta karuseļa mouseenter braukšana un tiek atsākta karuseļa braukšana mouseleave . Ja iestatīts uz null , virzot kursoru virs karuseļa, tas netiks apturēts. |
iesaiņojums | Būla | taisnība | Neatkarīgi no tā, vai karuselim ir jāpārvietojas nepārtraukti, vai tam ir jābūt stingriem apstāšanās gadījumiem. |
tastatūra | Būla | taisnība | Vai karuselim jāreaģē uz tastatūras notikumiem. |
.carousel(options)
Inicializē karuseli ar papildu opcijām object
un sāk pārvietoties pa vienumiem.
.carousel('cycle')
Pārvietojas pa karuseļa vienumiem no kreisās puses uz labo.
.carousel('pause')
Neļauj karuselim pārvietoties pa priekšmetiem.
.carousel(number)
Pārvieto karuseli uz noteiktu kadru (0, kas ir līdzīgs masīvam).
.carousel('prev')
Pāriet uz iepriekšējo vienumu.
.carousel('next')
Pāriet uz nākamo vienumu.
Bootstrap karuseļa klase atklāj divus notikumus, lai pievienotos karuseļa funkcionalitātei.
Abiem notikumiem ir šādas papildu īpašības:
direction
: virziens, kurā karuselis slīd (vai nu "left"
) "right"
.relatedTarget
: DOM elements, kas tiek bīdīts vietā kā aktīvais vienums.Visi karuseļa notikumi tiek aktivizēti pašā karuselī (ti, uz <div class="carousel">
).
Pasākuma veids | Apraksts |
---|---|
slide.bs.carousel | Šis notikums tiek aktivizēts nekavējoties, kad slide tiek izsaukta instances metode. |
slid.bs.karuselis | Šis notikums tiek aktivizēts, kad karuselis ir pabeidzis slaida pāreju. |
Afiksa spraudnis ieslēdzas position: fixed;
un izslēdzas, atdarinot efektu, kas atrodams ar position: sticky;
. Apakšnavigācija labajā pusē ir afiksa spraudņa tiešraides demonstrācija.
Izmantojiet afiksa spraudni, izmantojot datu atribūtus vai manuāli ar savu JavaScript. Abos gadījumos jums ir jānodrošina CSS, lai noteiktu pievienotā satura izvietojumu un platumu.
Piezīme. Safari renderēšanas kļūdas dēļ neizmantojiet afiksa spraudni elementam, kas atrodas relatīvi novietotā elementā, piemēram, izvilktā vai nospiestā kolonnā .
Afiksa spraudnis pārslēdzas starp trim klasēm, no kurām katra apzīmē noteiktu stāvokli: .affix
, .affix-top
, un .affix-bottom
. Lai apstrādātu faktiskās pozīcijas, jums pašam (neatkarīgi no šī spraudņa) ir jānodrošina šo klašu stili, izņemot position: fixed;
on ..affix
Lūk, kā darbojas afiksa spraudnis:
.affix-top
, lai norādītu, ka elements atrodas visaugstākajā pozīcijā. Šajā brīdī CSS pozicionēšana nav nepieciešama..affix
aizstāti .affix-top
un iestatīti position: fixed;
(nodrošina Bootstrap CSS)..affix
ar .affix-bottom
. Tā kā nobīdes nav obligātas, tās iestatīšanai ir jāiestata atbilstošs CSS. Šādā gadījumā pievienojiet position: absolute;
, kad nepieciešams. Spraudnis izmanto datu atribūtu vai JavaScript opciju, lai noteiktu, kur no turienes novietot elementu.Veiciet iepriekš norādītās darbības, lai iestatītu CSS savienojumu kādai no tālāk norādītajām lietošanas opcijām.
Lai jebkuram elementam viegli pievienotu afiksa darbību, vienkārši pievienojiet data-spy="affix"
elementam, kuru vēlaties izspiegot. Izmantojiet nobīdes, lai noteiktu, kad pārslēgt elementa piespraušanu.
Izsauciet afiksa spraudni, izmantojot JavaScript:
Opcijas var nodot, izmantojot datu atribūtus vai JavaScript. Datu atribūtiem pievienojiet opcijas nosaukumu data-
, tāpat kā data-offset-top="200"
.
Vārds | veids | noklusējuma | apraksts |
---|---|---|---|
kompensēt | numurs | funkcija | objektu | 10 | Pikseļi, kas jānobīda no ekrāna, aprēķinot ritināšanas pozīciju. Ja tiek norādīts viens skaitlis, nobīde tiks piemērota gan augšējā, gan apakšējā virzienā. Lai nodrošinātu unikālu, apakšējo un augšējo nobīdi, vienkārši norādiet objektu offset: { top: 10 } vai offset: { top: 10, bottom: 5 } . Izmantojiet funkciju, ja nepieciešams dinamiski aprēķināt nobīdi. |
mērķis | atlasītājs | mezgls | jQuery elements | window objektu _ |
Norāda afiksa mērķa elementu. |
.affix(options)
Aktivizē jūsu saturu kā pievienotu saturu. Pieņem izvēles opcijas object
.
.affix('checkPosition')
Pārrēķina afiksa stāvokli, pamatojoties uz attiecīgo elementu izmēriem, novietojumu un ritināšanas pozīciju. Klases .affix
, .affix-top
, un .affix-bottom
tiek pievienotas pievienotajam saturam vai noņemtas no tā atbilstoši jaunajam stāvoklim. Šī metode ir jāizsauc ikreiz, kad tiek mainīti pievienotā satura vai mērķa elementa izmēri, lai nodrošinātu pareizu pievienotā satura novietojumu.
Bootstrap afiksa spraudnis atklāj dažus notikumus, lai piesaistītu pielikumu funkcionalitāti.
Pasākuma veids | Apraksts |
---|---|
affix.bs.affix | Šis notikums tiek aktivizēts tieši pirms elementa piestiprināšanas. |
piestiprināts.bs.pielikums | Šis notikums tiek aktivizēts pēc tam, kad elements ir piestiprināts. |
affix-top.bs.affix | Šis notikums tiek aktivizēts tieši pirms elementa piestiprināšanas augšpusē. |
affixed-top.bs.affix | Šis notikums tiek aktivizēts pēc tam, kad elements ir piestiprināts augšpusē. |
affix-bottom.bs.affix | Šis notikums tiek aktivizēts tieši pirms elementa piestiprināšanas apakšā. |
affixed-bottom.bs.affix | Šis notikums tiek aktivizēts pēc tam, kad elements ir piestiprināts apakšā. |