JavaScript

Oživte komponenty Bootstrapu – teraz s 13 vlastnými zásuvnými modulmi jQuery.

Hlavy hore! Tieto dokumenty sú pre verziu 2.3.2, ktorá už nie je oficiálne podporovaná. Pozrite si najnovšiu verziu Bootstrapu!

Individuálne alebo zostavené

Pluginy môžu byť zahrnuté jednotlivo (hoci niektoré majú požadované závislosti) alebo všetky naraz. Bootstrap.js aj bootstrap.min.js obsahujú všetky pluginy v jednom súbore.

Atribúty údajov

Všetky doplnky Bootstrap môžete používať výlučne prostredníctvom značkovacieho API bez toho, aby ste museli písať jediný riadok JavaScriptu. Toto je API prvej triedy Bootstrapu a pri používaní doplnku by ste ho mali najskôr zvážiť.

To znamená, že v niektorých situáciách môže byť žiaduce túto funkciu vypnúť. Preto poskytujeme aj možnosť deaktivovať API dátových atribútov zrušením väzby všetkých udalostí v tele s priestorom názvov `'data-api'`. Toto vyzerá takto:

  1. $ ( 'telo' ). vypnuté ( '.data-api' )

Ak chcete zacieliť na konkrétny doplnok, stačí zahrnúť názov doplnku ako priestor názvov spolu s priestorom názvov data-api, ako je tento:

  1. $ ( 'telo' ). vypnuté ( '.alert.data-api' )

Programové rozhranie API

Tiež sa domnievame, že by ste mali mať možnosť používať všetky doplnky Bootstrap výhradne cez JavaScript API. Všetky verejné rozhrania API sú jednoduché, reťaziteľné metódy a vracajú kolekciu, podľa ktorej sa koná.

  1. $ ( ".btn.danger" ). tlačidlo ( "prepnúť" ). addClass ( "tuk" )

Všetky metódy by mali akceptovať voliteľný objekt volieb, reťazec, ktorý je zacielený na konkrétnu metódu, alebo nič (čo spustí doplnok s predvoleným správaním):

  1. $ ( "#myModal" ). modal () // inicializovaný s predvolenými hodnotami
  2. $ ( "#myModal" ). modálny ({ keyboard : false }) // inicializovaný bez klávesnice
  3. $ ( "#myModal" ). modal ( 'show' ) // okamžite inicializuje a vyvolá show

Každý doplnok tiež odhaľuje svoj nespracovaný konštruktor na vlastnosti `Constructor`: $.fn.popover.Constructor. Ak chcete získať konkrétnu inštanciu doplnku, získajte ju priamo z prvku: $('[rel=popover]').data('popover').

Žiadny konflikt

Niekedy je potrebné použiť Bootstrap pluginy s inými UI frameworkami. Za týchto okolností môže občas dôjsť ku kolíziám menného priestoru. Ak sa tak stane, môžete zavolať .noConflictna doplnok, ktorého hodnotu chcete vrátiť.

  1. var bootstrapButton = $ . fn _ tlačidlo . noConflict () // návrat $.fn.button na predtým priradenú hodnotu
  2. $ . fn _ bootstrapBtn = bootstrapButton // dá $().bootstrapBtn funkciu bootstrap

Diania

Bootstrap poskytuje vlastné udalosti pre väčšinu jedinečných akcií doplnkov. Vo všeobecnosti sú vo forme infinitívu a minulého príčastia – kde infinitív (napr. show) sa spúšťa na začiatku udalosti a jeho minulá forma príčastia (napr. shown) sa spúšťa pri dokončení akcie.

Všetky nekonečné udalosti poskytujú funkciu preventDefault. To poskytuje možnosť zastaviť vykonávanie akcie pred jej spustením.

  1. $ ( '#myModal' ). on ( 'show' , function ( e ) {
  2. ak (! údaje ) vráti e . preventDefault () // zastaví zobrazovanie modalu
  3. })

O prechodoch

Pre jednoduché prechodové efekty zahrňte bootstrap-transition.js raz spolu s ostatnými súbormi JS. Ak používate skompilovaný (alebo miniifikovaný) bootstrap.js , nie je potrebné ho pridávať – už tam je.

Prípady použitia

Niekoľko príkladov prechodového doplnku:

  • Kĺzanie alebo blednutie v modáloch
  • Zmiznutie kariet
  • Stlmenie upozornení
  • Posuvné karuselové tabule

Príklady

Modály sú zjednodušené, ale flexibilné dialógové výzvy s minimálnou požadovanou funkčnosťou a inteligentnými predvolenými nastaveniami.

Statický príklad

Vykreslený modál s hlavičkou, telom a množinou akcií v päte.

  1. <div class = "modal hide fade" >
  2. <div class = "modal-header" >
  3. < typ tlačidla = "tlačidlo" class = "zavrieť" data-dismiss = "modálne" aria-hidden = "pravda" > × </button>
  4. <h3> Modálna hlavička </h3>
  5. </div>
  6. <div class = "modal-body" >
  7. <p> Jedno jemné telo… </p>
  8. </div>
  9. <div class = "modal-footer" >
  10. <a href = "#" class = "btn" > Zavrieť </a>
  11. <a href = "#" class = "btn btn-primary" > Uložiť zmeny </a>
  12. </div>
  13. </div>

Živá ukážka

Prepnite modal cez JavaScript kliknutím na tlačidlo nižšie. Posunie sa nadol a bude miznúť z hornej časti stránky.

  1. <!-- Tlačidlo na spustenie modálneho režimu -->
  2. <a href = "#myModal" role = "button" class = "btn" data-toggle = "modal" > Spustiť demo modal </a>
  3.  
  4. <!-- Modálny -->
  5. <div id = "myModal" class = "modal hide fade" tabindex = "-1" role = "dialog" aria-labelledby = "myModalLabel" aria-hidden = "true" >
  6. <div class = "modal-header" >
  7. <button type = "button" class = "close" data-dismiss = "modal" aria-hidden = "true" > × </button>
  8. <h3 id = "myModalLabel" > Modálna hlavička </h3>
  9. </div>
  10. <div class = "modal-body" >
  11. <p> Jedno jemné telo… </p>
  12. </div>
  13. <div class = "modal-footer" >
  14. <button class = "btn" data-dismiss = "modal" aria-hidden = "true" > Zavrieť </button>
  15. <button class = "btn btn-primary" > Uložiť zmeny </button>
  16. </div>
  17. </div>

Použitie

Cez dátové atribúty

Aktivujte modál bez písania JavaScriptu. Nastavte data-toggle="modal"na prvku ovládača, ako je tlačidlo, spolu s data-target="#foo"alebo href="#foo"na zacielenie na konkrétny modál na prepínanie.

  1. <button type = "button" data-toggle = "modal" data-target = "#myModal" > Spustiť modálne </button>

Cez JavaScript

Zavolajte modal s ID myModals jedným riadkom JavaScriptu:

  1. $ ( '#myModal' ). modálny ( možnosti )

možnosti

Možnosti môžu byť odovzdané prostredníctvom dátových atribútov alebo JavaScriptu. Pre atribúty údajov pripojte názov voľby k data-, ako v data-backdrop="".

názov typu predvolená popis
pozadie boolovská hodnota pravda Obsahuje prvok modálneho pozadia. Prípadne zadajte staticpozadie, ktoré nezatvorí modál po kliknutí.
klávesnica boolovská hodnota pravda Zatvorí modál po stlačení klávesu Escape
šou boolovská hodnota pravda Po inicializácii zobrazí modal.
diaľkový cesta falošný

Ak je poskytnutá vzdialená adresa URL, obsah sa načíta pomocou loadmetódy jQuery a vloží sa do súboru .modal-body. Ak používate dátové rozhranie API, môžete alternatívne použiť hrefznačku na určenie vzdialeného zdroja. Príklad je uvedený nižšie:

  1. <a data-toggle="modal" href="remote.html" data-target="#modal">click me</a>

Metódy

.modal(options)

Aktivuje váš obsah ako modálny. Prijíma voliteľné možnosti object.

  1. $ ( '#myModal' ). modálny ({
  2. klávesnica : nepravda
  3. })

.modal('toggle')

Manuálne prepína modal.

  1. $ ( '#myModal' ). modálny ( 'prepnúť' )

.modal('show')

Manuálne otvorí modál.

  1. $ ( '#myModal' ). modálny ( 'zobraziť' )

.modal('hide')

Manuálne skryje modal.

  1. $ ( '#myModal' ). modálny ( 'skryť' )

Diania

Modálna trieda Bootstrapu odhaľuje niekoľko udalostí na pripojenie k modálnej funkcii.

Udalosť Popis
šou Táto udalosť sa spustí okamžite po showzavolaní metódy inštancie.
zobrazené Táto udalosť sa spustí, keď bude modal viditeľný pre používateľa (bude čakať na dokončenie prechodov css).
skryť Táto udalosť sa spustí okamžite po hidezavolaní metódy inštancie.
skryté Táto udalosť sa spustí, keď sa dokončí skrytie modálu pred používateľom (bude čakať na dokončenie prechodov css).
  1. $ ( '#myModal' ). on ( 'skryté' , funkcia () {
  2. // urob niečo…
  3. })

Príklad v navigačnom paneli

Doplnok ScrollSpy slúži na automatickú aktualizáciu cieľov navigácie na základe pozície posúvania. Prejdite oblasťou pod navigačnou lištou a sledujte, ako sa aktívna trieda mení. Rozbaľovacie podpoložky budú tiež zvýraznené.

@tuk

Ad legíny keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi predtým, ako vypredali qui. Tumblr práva na bicykel od farmy až po stôl. Anim keffiyeh carles cardigan. Fotka užívateľa Velit seitan mcsweeney 3 wolf moon irure. Cosby sveter lomo jean šortky, williamsburg mikina minim qui pravdepodobne ste o nich nepočuli a kardigan trustový fond culpa biodiesel wes anderson estetický. Nihil vytetovaný accusamus, viera irónia bionafta keffiyeh remeselník ullamco consequat.

@mdo

Skateboard Veniam Marfa fúzy, tuková brada fugiat velit vidly. Freegan beard aliqua cupidatat mcsweeney's vero. Cupidatat štyri loko nisi, ea helvetica nulla carles. Potetovaný cosby sveter food truck, mcsweeney's quis non freegan vinyl. Lo-fi wes anderson +1 kreatíva. Carles neestetické cvičenie quis genrify. Brooklyn adipisicing remeselné pivo vice keytar dezert.

jeden

Occaecat commodo aliqua delectus. Fap craft beer deserunt skateboard ea. Lomo bike rights adipisicing banh mi, velit ea sunt next level locavore single-origin coffee in magna veniam. Vysoká životnosť id vinyl, echo park consequat quis aliquip banh mi vidly. Vero VHS je adipisicing. Minimálna messenger taška Consectetur nisi DIY. Cred ex in, udržateľný delectus consectetur fanny pack iphone.

dva

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.

three

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 čokoľvek delectus food truck. Predpokladá sa, že ID syntetizátora Sapiente. Locavore sed helvetica klišé irónia, thundercats ste o nich pravdepodobne nepočuli consequat hoodie bezlepkový lo-fi fap aliquip. Labore elitné miesto predtým, než sa vypredali, Terry richardson proident brunch nesciunt quis cosby sveter pariatur keffiyeh ut helvetica artisan. Cardigan craft beer seitan readymade velit. VHS chambray laboris tempor veniam. Anim mollit minim commodo ullamco thundercats.


Použitie

Cez dátové atribúty

Ak chcete jednoducho pridať rolovacie správanie do navigácie v hornej lište, jednoducho pridajte data-spy="scroll"prvok, ktorý chcete špehovať (najčastejšie by to bolo telo), a data-target=".navbar"vyberte, ktorú navigáciu chcete použiť. Budete chcieť použiť scrollspy s .navkomponentom.

  1. <body data-spy = "scroll" data-target = ".navbar" > ... </body>

Cez JavaScript

Zavolajte scrollspy cez JavaScript:

  1. $ ( '#navbar' ). scrollspy ()
Hlavy hore! Odkazy na navigačnom paneli musia mať rozlíšiteľné ciele ID. Napríklad <a href="#home">home</a>musí zodpovedať niečomu v dome ako <div id="home"></div>.

Metódy

.scrollspy('refresh')

Keď používate scrollspy v spojení s pridávaním alebo odstraňovaním prvkov z DOM, budete musieť zavolať metódu refresh takto:

  1. $ ( '[data-spy="scroll"]' ). každý ( function () {
  2. var $spy = $ ( toto ). scrollspy ( 'obnoviť' )
  3. });

možnosti

Možnosti môžu byť odovzdané prostredníctvom dátových atribútov alebo JavaScriptu. Pre atribúty údajov pripojte názov voľby k data-, ako v data-offset="".

názov typu predvolená popis
offset číslo 10 Pixely na odsadenie zhora pri výpočte polohy rolovania.

Diania

Udalosť Popis
Aktivovať Táto udalosť sa spustí vždy, keď scrollspy aktivuje novú položku.

Príklady kariet

Pridajte rýchlu, dynamickú funkciu kariet na prechod cez tably miestneho obsahu, dokonca aj cez rozbaľovacie ponuky.

Raw denim ste o nich pravdepodobne ešte nepočuli džínsové šortky Austin. Nesciunt tofu stumptown aliqua, retro synth master cleanse. Moustache cliche tempor, williamsburg carles vegan helvetica. Reprehenderit butcher retro keffiyeh dreamcatcher synth. Cosby sveter eu banh mi, qui irure terry richardson ex squid. Aliquip miesto na salvia cillum iphone. Seitan aliquip quis cardigan americké oblečenie, mäsiar 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.


Použitie

Povoliť karty s tabuľkami cez JavaScript (každá karta musí byť aktivovaná samostatne):

  1. $ ( '#myTab a' ). klikni ( funkcia ( e ) {
  2. e . zabrániťPredvolené ();
  3. $ ( toto ). tab ( 'zobraziť' );
  4. })

Jednotlivé karty môžete aktivovať niekoľkými spôsobmi:

  1. $ ( '#myTab a[href="#profile"]' ). tab ( 'zobraziť' ); // Vyberte kartu podľa názvu
  2. $ ( '#myTab a:first' ). tab ( 'zobraziť' ); // Vyberte prvú kartu
  3. $ ( '#myTab a:last' ). tab ( 'zobraziť' ); // Vyberte poslednú kartu
  4. $ ( '#myTab li:eq(2) a' ). tab ( 'zobraziť' ); // Vyberte tretiu kartu (indexovaná 0)

Označenie

Môžete aktivovať navigáciu na karte alebo tablete bez písania akéhokoľvek JavaScriptu jednoduchým zadaním data-toggle="tab"alebo data-toggle="pill"na prvku. Pridaním tried nava nav-tabsna kartu ulsa použije štýl karty Bootstrap.

  1. <ul class = "nav nav-tabs" >
  2. <li><a href = "#home" data-toggle = "tab" > Domov </a></li>
  3. <li><a href = "#profile" data-toggle = "tab" > Profil </a></li>
  4. <li><a href = "#messages" data-toggle = "tab" > Správy </a></li>
  5. <li><a href = "#settings" data-toggle = "tab" > Nastavenia </a></li>
  6. </ul>

Metódy

$().tab

Aktivuje prvok karty a kontajner obsahu. Karta by mala mať buď a data-targetalebo hrefzacielenie na kontajnerový uzol v DOM.

  1. <ul class = "nav nav-tabs" id = "myTab" >
  2. <li class = "active" ><a href = "#home" > Domov </a></li>
  3. <li><a href = "#profile" > Profil </a></li>
  4. <li><a href = "#messages" > Správy </a></li>
  5. <li><a href = "#settings" > Nastavenia </a></li>
  6. </ul>
  7.  
  8. <div class = "tab-content" >
  9. <div class = "tab-pane active" id = "home" > ... </div>
  10. <div class = "tab-pane" id = "profile" > ... </div>
  11. <div class = "tab-pane" id = "messages" > ... </div>
  12. <div class = "tab-pane" id = "settings" > ... </div>
  13. </div>
  14.  
  15. <script>
  16. $ ( funkcia () {
  17. $ ( '#myTab a:last' ). tab ( 'zobraziť' );
  18. })
  19. </script>

Diania

Udalosť Popis
šou Táto udalosť sa spustí pri zobrazení kariet, ale predtým, než sa zobrazí nová karta. Pomocou event.targeta event.relatedTargetzacielite na aktívnu kartu a predchádzajúcu aktívnu kartu (ak je k dispozícii).
zobrazené Táto udalosť sa spustí pri zobrazení karty po zobrazení karty. Pomocou event.targeta event.relatedTargetzacielite na aktívnu kartu a predchádzajúcu aktívnu kartu (ak je k dispozícii).
  1. $ ( 'a[data-toggle="tab"]' ). on ( 'zobrazené' , funkcia ( e ) {
  2. e . target // aktivovaná tab
  3. e . relatedTarget // predchádzajúca karta
  4. })

Príklady

Inšpirované vynikajúcim doplnkom jQuery.tipsy, ktorý napísal Jason Frame; Popisy sú aktualizovanou verziou, ktorá sa nespolieha na obrázky, používa CSS3 na animácie a dátové atribúty na lokálne ukladanie titulkov.

Z dôvodov výkonu sú popis a popover data-apis aktivované, čo znamená, že ich musíte inicializovať sami .

Umiestnením kurzora myši na odkazy nižšie zobrazíte popisy:

Tesné nohavice ďalšej úrovne keffiyeh , o ktorých ste pravdepodobne ešte nepočuli. Photo booth brada raw denim kníhtlač vegan messenger bag stumptown. 8-bitové americké oblečenie z farmy na stôl seitan, mcsweeney's fixie udržateľná quinoa vinylovú chambray z froté richardson. Beard stumptown, cardigany banh mi lomo thundercats. Tofu biodiesel williamsburg marfa, štyri loko mcsweeney's cleanse vegan chambray. Skutočne ironický remeselník bez ohľadu na klávesnicu, scénár z farmy na stôl Banky Austin twitter zvláda freeganskú cred raw denim single-origin coffee viral.

Štyri smery

Popisy vo vstupných skupinách

Keď používate popisky a kontextové okná so vstupnými skupinami Bootstrap, budete musieť nastaviť možnosť container(zdokumentovaná nižšie), aby ste sa vyhli nežiaducim vedľajším účinkom.


Použitie

Spustite popis pomocou JavaScriptu:

  1. $ ( '#príklad' ). popis ( možnosti )

možnosti

Možnosti môžu byť odovzdané prostredníctvom dátových atribútov alebo JavaScriptu. Pre atribúty údajov pripojte názov voľby k data-, ako v data-animation="".

názov typu predvolená popis
animácie boolovská hodnota pravda použiť prechod css miznutia na popis
html boolovská hodnota falošný Vložte html do popisku. textAk je hodnota false, na vloženie obsahu do dom sa použije metóda jquery . Ak sa obávate útokov XSS, použite text.
umiestnenie reťazec | funkciu 'top' ako umiestniť popis – hore | dole | vľavo | správny
selektor reťazec falošný Ak je k dispozícii selektor, objekty popisov budú delegované na zadané ciele.
titul reťazec | funkciu '' predvolená hodnota názvu, ak značka `title` nie je prítomná
spúšťač reťazec 'ukazovať kurzor' ako sa spúšťa popis – kliknite | vznášať sa | zameranie | Manuálny. Všimnite si, že spúšťate viacnásobné, medzerou oddelené typy spúšťačov.
meškanie číslo | objekt 0

oneskorenie zobrazenia a skrytia tooltipu (ms) – netýka sa manuálneho typu spúšťania

Ak je zadané číslo, oneskorenie sa použije na skrytie/zobrazenie

Štruktúra objektu je:delay: { show: 500, hide: 100 }

kontajner reťazec | falošný falošný

Pridá popis ku konkrétnemu prvkucontainer: 'body'

Hlavy hore! Možnosti pre jednotlivé nápovedy možno alternatívne špecifikovať pomocou atribútov údajov.

Označenie

  1. <a href = "#" data-toggle = "tooltip" title = "first tooltip" > umiestnite kurzor myši na mňa </a>

Metódy

$().tooltip(options)

Ku kolekcii prvkov pripojí popisovač.

.tooltip('show')

Zobrazí popis prvku.

  1. $ ( '#element' ). popis ( 'zobraziť' )

.tooltip('hide')

Skryje popis prvku.

  1. $ ( '#element' ). popis ( 'skryť' )

.tooltip('toggle')

Prepína popis prvku.

  1. $ ( '#element' ). popis ( 'prepnúť' )

.tooltip('destroy')

Skryje a zničí popis prvku.

  1. $ ( '#element' ). popis ( 'zničiť' )

Príklady

Pridajte malé prekryvné vrstvy obsahu, ako sú tie na iPade, do ľubovoľného prvku, aby ste mohli umiestniť sekundárne informácie. Ak chcete spustiť kontextové okno, umiestnite kurzor myši na tlačidlo. Vyžaduje sa zahrnutie popisu .

Statický popover

K dispozícii sú štyri možnosti: zarovnané hore, vpravo, dole a vľavo.

Popover top

Sed posuere consectetur est at lobortis. Aenean eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

Popover vpravo

Sed posuere consectetur est at lobortis. Aenean eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

Popover dno

Sed posuere consectetur est at lobortis. Aenean eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

Popover vľavo

Sed posuere consectetur est at lobortis. Aenean eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

Z JavaScriptu a obsahu v rámci atribútu sa negenerujú žiadne značky zobrazené ako kontextové okná data.

Živá ukážka

Štyri smery


Použitie

Povoliť vyskakovacie okná prostredníctvom JavaScriptu:

  1. $ ( '#príklad' ). vyskakovacie okno ( možnosti )

možnosti

Možnosti môžu byť odovzdané prostredníctvom dátových atribútov alebo JavaScriptu. Pre atribúty údajov pripojte názov voľby k data-, ako v data-animation="".

názov typu predvolená popis
animácie boolovská hodnota pravda použiť prechod css miznutia na popis
html boolovská hodnota falošný Vložte html do kontextového okna. textAk je hodnota false, na vloženie obsahu do dom sa použije metóda jquery . Ak sa obávate útokov XSS, použite text.
umiestnenie reťazec | funkciu 'správny' ako umiestniť popover - hore | dole | vľavo | správny
selektor reťazec falošný ak je poskytnutý selektor, objekty popisku budú delegované na zadané ciele
spúšťač reťazec 'klikni' ako sa spúšťa kontextové okno - kliknite | vznášať sa | zameranie | Manuálny
titul reťazec | funkciu '' predvolená hodnota názvu, ak atribút názov nie je prítomný
obsahu reťazec | funkciu '' predvolená hodnota obsahu, ak atribút „data-content“ nie je prítomný
meškanie číslo | objekt 0

oneskorenie zobrazenia a skrytia popoveru (ms) - netýka sa manuálneho typu spúšťania

Ak je zadané číslo, oneskorenie sa použije na skrytie/zobrazenie

Štruktúra objektu je:delay: { show: 500, hide: 100 }

kontajner reťazec | falošný falošný

Pripojí kontextové okno ku konkrétnemu prvkucontainer: 'body'

Hlavy hore! Voľby pre jednotlivé kontextové okná môžu byť alternatívne špecifikované pomocou dátových atribútov.

Označenie

Z výkonnostných dôvodov sú povolené Tooltip a Popover data-apis. Ak ich chcete použiť, stačí zadať možnosť výberu.

Metódy

$().popover(options)

Inicializuje vyskakovacie okná pre kolekciu prvkov.

.popover('show')

Odhaľuje kontextové okno prvkov.

  1. $ ( '#element' ). vyskakovacie okno ( 'zobraziť' )

.popover('hide')

Skryje vyskakovacie okno prvkov.

  1. $ ( '#element' ). vyskakovacie okno ( 'skryť' )

.popover('toggle')

Prepína vyskakovacie okno prvkov.

  1. $ ( '#element' ). vyskakovacie okno ( 'prepnúť' )

.popover('zničiť')

Skryje a zničí popover prvku.

  1. $ ( '#element' ). vyskakovacie okno ( 'zničiť' )

Príklady upozornení

Pomocou tohto doplnku pridajte do všetkých výstražných správ funkciu odmietnutia.

Sväté guacamole! Najlepšie sa presvedčte, že nevyzeráte príliš dobre.

Och, rýchlo! Máte chybu!

Zmeňte to a to a skúste to znova. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.

Vykonajte túto akciu Alebo urobte toto


Použitie

Povoliť zrušenie upozornenia prostredníctvom JavaScriptu:

  1. $ ( ".upozornenie" ). upozornenie ()

Označenie

Stačí pridať data-dismiss="alert"tlačidlo na zatvorenie, aby sa automaticky aktivovala funkcia zatvorenia upozornenia.

  1. <a class = "close" data-dismiss = "alert" href = "#" > × </a>

Metódy

$().alert()

Zabalí všetky upozornenia do funkcie blízkej. Ak chcete, aby sa vaše upozornenia po zatvorení animovali, uistite sa, že už majú aplikovanú triedu .fadea ..in

.alert('zavrieť')

Zatvorí upozornenie.

  1. $ ( ".upozornenie" ). upozornenie ( 'zavrieť' )

Diania

Výstražná trieda Bootstrapu odhaľuje niekoľko udalostí na pripojenie k funkcii výstrahy.

Udalosť Popis
Zavrieť Táto udalosť sa spustí okamžite po closezavolaní metódy inštancie.
ZATVORENÉ Táto udalosť sa spustí po zatvorení výstrahy (bude čakať na dokončenie prechodov css).
  1. $ ( '#my-upozornenie' ). bind ( 'zatvorené' , funkcia () {
  2. // urob niečo…
  3. })

Príklady použitia

Urobte viac s tlačidlami. Stavy ovládacích tlačidiel alebo vytváranie skupín tlačidiel pre viac komponentov, ako sú panely s nástrojmi.

Štátny

Pridať data-loading-text="Loading...", ak chcete použiť stav načítania na tlačidle.

  1. <button type = "button" class = "btn btn-primary" data-loading-text = "Načítavam..." > Stav načítavania </button>

Jediný prepínač

Pridať data-toggle="button"na aktiváciu prepínania na jednom tlačidle.

  1. <button type = "button" class = "btn btn-primary" data-toggle = "button" > Single Toggle </button>

začiarkavacie políčko

Pridať data-toggle="buttons-checkbox"pre prepínanie štýlu začiarkavacieho políčka na skupine btn.

  1. <div class = "btn-group" data-toggle = "buttons-checkbox" >
  2. <button type = "button" class = "btn btn-primary" > Left </button>
  3. <button type = "button" class = "btn btn-primary" > Middle </button>
  4. <button type = "button" class = "btn btn-primary" > Right </button>
  5. </div>

Rádio

Pridať data-toggle="buttons-radio"pre prepínanie štýlu rádia v skupine btn.

  1. <div class = "btn-group" data-toggle = "buttons-radio" >
  2. <button type = "button" class = "btn btn-primary" > Left </button>
  3. <button type = "button" class = "btn btn-primary" > Middle </button>
  4. <button type = "button" class = "btn btn-primary" > Right </button>
  5. </div>

Použitie

Povoliť tlačidlá cez JavaScript:

  1. $ ( '.nav-tabs' ). tlačidlo ()

Označenie

Atribúty údajov sú neoddeliteľnou súčasťou doplnku tlačidiel. Pozrite si príklad kódu nižšie pre rôzne typy značiek.

možnosti

žiadne

Metódy

$().button('toggle')

Prepína stav push. Dodáva tlačidlu vzhľad, že bolo aktivované.

Hlavy hore! Pomocou data-toggleatribútu môžete povoliť automatické prepínanie tlačidla.
  1. <button type = "button" class = "btn" data-toggle = "button" > </button>

$().button('načítava sa')

Nastaví stav tlačidla na načítanie - deaktivuje tlačidlo a zamení text za načítaný text. Načítavaný text by mal byť definovaný na prvku button pomocou atribútu data data-loading-text.

  1. <button type = "button" class = "btn" data-loading-text = "loading things..." > ... </button>
Hlavy hore! Firefox zotrváva v zakázanom stave počas načítania stránky . Riešením tohto problému je použitie autocomplete="off".

$().button('reset')

Resetuje stav tlačidla - zamení text na pôvodný text.

$().tlačidlo(reťazec)

Resetuje stav tlačidla - prepne text do ľubovoľného stavu textu definovaného údajmi.

  1. < typ tlačidla = "button" class = "btn" data-complete-text = "dokončené!" > ... </button>
  2. <script>
  3. $ ( '.btn' ). tlačidlo ( 'kompletné' )
  4. </script>

O

Získajte základné štýly a flexibilnú podporu pre skladacie komponenty, ako sú akordeóny a navigácia.

* Vyžaduje, aby bol zahrnutý doplnok Transitions.

Príklad akordeónu

Pomocou doplnku na zbalenie sme vytvorili jednoduchý widget v štýle akordeónu:

Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua dať na to vtáka chobotnica single-origin coffee nulla expectnda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan okrem mäsiara vice lomo. Legíny occaecat craft beer farm-to-table, raw denim estetický synth nesciunt asi ste o nich nepočuli accusamus labore udržateľné VHS.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua dať na to vtáka chobotnica single-origin coffee nulla expectnda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan okrem mäsiara vice lomo. Legíny occaecat craft beer farm-to-table, raw denim estetický synth nesciunt asi ste o nich nepočuli accusamus labore udržateľné VHS.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua dať na to vtáka chobotnica single-origin coffee nulla expectnda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan okrem mäsiara vice lomo. Legíny occaecat craft beer farm-to-table, raw denim estetický synth nesciunt asi ste o nich nepočuli accusamus labore udržateľné VHS.
  1. <div class = "akordeón" id = "akordeón2" >
  2. <div class = "akordeónová skupina" >
  3. <div class = "akordeón-hlavička" >
  4. <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseOne" >
  5. Skladacia skupinová položka č. 1
  6. </a>
  7. </div>
  8. <div id = "collapseOne" class = "zrútenie tela harmoniky v" >
  9. <div class = "akordeón-vnútorná" >
  10. Anim pariatur klišé...
  11. </div>
  12. </div>
  13. </div>
  14. <div class = "akordeónová skupina" >
  15. <div class = "akordeón-hlavička" >
  16. <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseTwo" >
  17. Skladacia skupinová položka č. 2
  18. </a>
  19. </div>
  20. <div id = "collapseTwo" class = "kolaps tela harmoniky" >
  21. <div class = "akordeón-vnútorná" >
  22. Anim pariatur klišé...
  23. </div>
  24. </div>
  25. </div>
  26. </div>
  27. ...

Doplnok môžete použiť aj bez označenia akordeónu. Vytvoriť tlačidlo na prepínanie rozbalenia a zbalenia iného prvku.

  1. <button type = "button" class = "btn btn-danger" data-toggle = "collapse" data-target = "#demo" >
  2. jednoduchý skladací
  3. </button>
  4.  
  5. <div id = "demo" class = "collapse in" > </div>

Použitie

Cez dátové atribúty

Stačí pridať data-toggle="collapse"a data-targetdo prvku, aby sa automaticky priradilo ovládanie skladacieho prvku. Atribút data-targetakceptuje selektor css, na ktorý sa má použiť zbalenie. Nezabudnite pridať triedu collapsedo skladacieho prvku. Ak chcete, aby bola predvolene otvorená, pridajte ďalšiu triedu in.

Ak chcete do skladacieho ovládacieho prvku pridať správu skupiny podobnú akordeónu, pridajte atribút data data-parent="#selector". Pozrite si ukážku, aby ste to videli v akcii.

Cez JavaScript

Povoliť manuálne pomocou:

  1. $ ( ".collapse" ). kolaps ()

možnosti

Možnosti môžu byť odovzdané prostredníctvom dátových atribútov alebo JavaScriptu. Pre atribúty údajov pripojte názov voľby k data-, ako v data-parent="".

názov typu predvolená popis
rodič selektor falošný Ak použijete selektor, po zobrazení tejto zbaliteľnej položky sa zatvoria všetky skladacie prvky pod zadaným rodičom. (podobné tradičnému správaniu na akordeóne)
prepnúť boolovská hodnota pravda Prepína zbaliteľný prvok pri vyvolaní

Metódy

.collapse(možnosti)

Aktivuje váš obsah ako skladací prvok. Prijíma voliteľné možnosti object.

  1. $ ( '#myCollapsible' ). kolaps ({
  2. prepnúť : nepravda
  3. })

.collapse('toggle')

Prepne zbaliteľný prvok na zobrazený alebo skrytý.

.collapse('show')

Zobrazuje skladací prvok.

.collapse('skryť')

Skryje skladací prvok.

Diania

Trieda zbalenia Bootstrapu odhaľuje niekoľko udalostí na pripojenie k funkcii zbalenia.

Udalosť Popis
šou Táto udalosť sa spustí okamžite po showzavolaní metódy inštancie.
zobrazené Táto udalosť sa spustí, keď je prvok zbalenia viditeľný pre používateľa (bude čakať na dokončenie prechodov css).
skryť Táto udalosť sa spustí okamžite po hidezavolaní metódy.
skryté Táto udalosť sa spustí, keď bol prvok zbalenia skrytý pred používateľom (bude čakať na dokončenie prechodov css).
  1. $ ( '#myCollapsible' ). on ( 'skryté' , funkcia () {
  2. // urob niečo…
  3. })

Príklad

Základný, jednoducho rozšírený plugin na rýchle vytváranie elegantných hlások s ľubovoľným zadávaním textu z formulára.

  1. <input type = "text" data- provide = "typeahead" >

Budete chcieť nastaviť autocomplete="off", aby sa predvolené ponuky prehliadača nezobrazovali v rozbaľovacom zozname typu Bootstrap.


Použitie

Cez dátové atribúty

Pridajte atribúty údajov na registráciu prvku s funkciou prepisu, ako je uvedené v príklade vyššie.

Cez JavaScript

Zavolajte prepis manuálne pomocou:

  1. $ ( '.typeahead' ). písať dopredu ()

možnosti

Možnosti môžu byť odovzdané prostredníctvom dátových atribútov alebo JavaScriptu. Pre atribúty údajov pripojte názov voľby k data-, ako v data-source="".

názov typu predvolená popis
zdroj pole, funkcia [ ] Zdroj údajov, na ktorý sa má dotazovať. Môže to byť pole reťazcov alebo funkcia. Funkcii sú odovzdané dva argumenty, queryhodnota vo vstupnom poli a processspätné volanie. Funkciu možno použiť synchrónne vrátením zdroja údajov priamo alebo asynchrónne prostredníctvom processjediného argumentu spätného volania.
položky číslo 8 Maximálny počet položiek na zobrazenie v rozbaľovacej ponuke.
minDĺžka číslo 1 Minimálna dĺžka znakov potrebná pred spustením návrhov automatického dopĺňania
dohadzovač funkciu nerozlišuje veľké a malé písmená Metóda použitá na určenie, či sa dotaz zhoduje s položkou. Prijíma jeden argument, itemproti ktorému sa má test otestovať. Prístup k aktuálnemu dotazu získate pomocou this.query. trueAk sa dopyt zhoduje, vráti boolovskú hodnotu.
triedič funkciu presná zhoda, rozlišovať malé a veľké písmená
, nerozlišovať malé a
veľké písmená
Metóda používaná na triedenie výsledkov automatického dopĺňania. Akceptuje jeden argument itemsa má rozsah typovej inštancie. Odkaz na aktuálny dopyt pomocou this.query.
aktualizátor funkciu vráti vybratú položku Metóda použitá na vrátenie vybratej položky. Akceptuje jeden argument, itema má rozsah typovej inštancie.
zvýrazňovač funkciu zvýrazní všetky predvolené zhody Metóda používaná na zvýraznenie výsledkov automatického dopĺňania. Akceptuje jeden argument itema má rozsah typovej inštancie. Mal by vrátiť html.

Metódy

.typeahead(options)

Inicializuje vstup písaním dopredu.

Príklad

Subnavigácia vľavo je živá ukážka doplnku afix.


Použitie

Cez dátové atribúty

Ak chcete jednoducho pridať správanie pri pripájaní k akémukoľvek prvku, stačí pridať data-spy="affix"k prvku, ktorý chcete špehovať. Potom pomocou posunov definujte, kedy zapnúť a vypnúť pripnutie prvku.

  1. <div data-spy = "affix" data-offset-top = "200" > ... </div>
Hlavy hore! Musíte spravovať pozíciu pripnutého prvku a správanie jeho priameho rodiča. Pozícia je riadená pomocou affix, affix-top, a affix-bottom. Nezabudnite skontrolovať potenciálne zbalený rodič, keď sa prípona spustí, pretože odstraňuje obsah z normálneho toku stránky.

Cez JavaScript

Zavolajte doplnok na pripojenie cez JavaScript:

  1. $ ( '#navbar' ). pripojiť ()

možnosti

Možnosti môžu byť odovzdané prostredníctvom dátových atribútov alebo JavaScriptu. Pre atribúty údajov pripojte názov voľby k data-, ako v data-offset-top="200".

názov typu predvolená popis
offset číslo | funkcia | objekt 10 Pixely na odsadenie od obrazovky pri výpočte polohy rolovania. Ak je zadané jedno číslo, posun sa použije v smere hore aj vľavo. Ak chcete počúvať jeden smer alebo viacero jedinečných posunov, stačí zadať objekt offset: { x: 10 }. Použite funkciu, keď potrebujete dynamicky poskytnúť posun (užitočné pre niektoré responzívne návrhy).