Oživte komponenty Bootstrapu – teraz s 13 vlastnými zásuvnými modulmi jQuery.
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.
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:
- $ ( '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:
- $ ( 'telo' ). vypnuté ( '.alert.data-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á.
- $ ( ".btn.nebezpečenstvo" ). 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):
- $ ( "#myModal" ). modal () // inicializovaný s predvolenými hodnotami
- $ ( "#myModal" ). modálny ({ keyboard : false }) // inicializovaný bez klávesnice
- $ ( "#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')
.
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ť .noConflict
na doplnok, ktorého hodnotu chcete vrátiť.
- var bootstrapButton = $ . fn . tlačidlo . noConflict () // vráti $.fn.button na predtým priradenú hodnotu
- $ . fn . bootstrapBtn = bootstrapButton // dá $().bootstrapBtn funkciu bootstrap
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.
- $ ( '#myModal' ). on ( 'show' , function ( e ) {
- ak (! údaje ) vráti e . preventDefault () // zastaví zobrazovanie modalu
- })
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.
Niekoľko príkladov prechodového doplnku:
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.
Vykreslený modál s hlavičkou, telom a množinou akcií v päte.
Jedno pekné telo…
- <div class = "modal hide fade" >
- <div class = "modal-header" >
- < typ tlačidla = "tlačidlo" class = "zavrieť" data-dismiss = "modálne" aria-hidden = "pravda" > × </button>
- <h3> Modálna hlavička </h3>
- </div>
- <div class = "modal-body" >
- <p> Jedno jemné telo… </p>
- </div>
- <div class = "modal-footer" >
- <a href = "#" class = "btn" > Zavrieť </a>
- <a href = "#" class = "btn btn-primary" > Uložiť zmeny </a>
- </div>
- </div>
Prepnite modal cez JavaScript kliknutím na tlačidlo nižšie. Posunie sa nadol a bude miznúť z hornej časti stránky.
- <!-- Tlačidlo na spustenie modálneho režimu -->
- <a href = "#myModal" role = "button" class = "btn" data-toggle = "modal" > Spustiť demo modal </a>
- <!-- Modálny -->
- <div id = "myModal" class = "modal hide fade" tabindex = "-1" role = "dialog" aria-labelledby = "myModalLabel" aria-hidden = "true" >
- <div class = "modal-header" >
- <button type = "button" class = "close" data-dismiss = "modal" aria-hidden = "true" > × </button>
- <h3 id = "myModalLabel" > Modálna hlavička </h3>
- </div>
- <div class = "modal-body" >
- <p> Jedno jemné telo… </p>
- </div>
- <div class = "modal-footer" >
- <button class = "btn" data-dismiss = "modal" aria-hidden = "true" > Zavrieť </button>
- <button class = "btn btn-primary" > Uložiť zmeny </button>
- </div>
- </div>
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.
- <button type = "button" data-toggle = "modal" data-target = "#myModal" > Spustiť modálne </button>
Zavolajte modal s ID myModal
s jedným riadkom JavaScriptu:
- $ ( '#myModal' ). modálny ( 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 static pozadie, ktoré nezatvorí modál po kliknutí. |
klávesnica | boolovská hodnota | pravda | Zatvorí modal 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
|
Aktivuje váš obsah ako modálny. Prijíma voliteľné možnosti object
.
- $ ( '#myModal' ). modálny ({
- klávesnica : nepravda
- })
Manuálne prepína modal.
- $ ( '#myModal' ). modálny ( 'prepnúť' )
Manuálne otvorí modál.
- $ ( '#myModal' ). modálny ( 'zobraziť' )
Manuálne skryje modal.
- $ ( '#myModal' ). modálny ( 'skryť' )
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 pri show volaní 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 hide zavolaní 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). |
- $ ( '#myModal' ). on ( 'skryté' , funkcia () {
- // urob niečo…
- })
Pomocou tohto jednoduchého doplnku môžete pridať rozbaľovacie ponuky takmer ku všetkému, vrátane navigačného panela, kariet a tabliet.
Pridať data-toggle="dropdown"
k odkazu alebo tlačidlu na prepnutie rozbaľovacej ponuky.
- <div class = "dropdown" >
- <a class = "dropdown-toggle" data-toggle = "dropdown" href = "#" > Spúšťač rozbaľovacej ponuky </a>
- <ul class = "dropdown-menu" role = "menu" aria-labelledby = "dLabel" >
- ...
- </ul>
- </div>
Ak chcete zachovať adresy URL nedotknuté, použite data-target
atribút namiesto atribútu href="#"
.
- <div class = "dropdown" >
- <a class = "dropdown-toggle" id = "dLabel" role = "button" data-toggle = "dropdown" data-target = "#" href = "/page.html" >
- Rozbaľovacia ponuka
- <b class = "caret" </b>
- </a>
- <ul class = "dropdown-menu" role = "menu" aria-labelledby = "dLabel" >
- ...
- </ul>
- </div>
Zavolajte rozbaľovacie ponuky pomocou JavaScriptu:
- $ ( '.dropdown-toggle' ). rozbaľovacia ponuka ()
žiadne
Programové rozhranie API na prepínanie ponúk pre danú navigačnú lištu alebo navigáciu s kartami.
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é.
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.
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.
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.
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 č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 elite placeat pred vypredanim, 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.
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 .nav
komponentom.
- <body data-spy = "scroll" data-target = ".navbar" > ... </body>
Zavolajte scrollspy cez JavaScript:
- $ ( '#navbar' ). scrollspy ()
<a href="#home">home</a>
musí zodpovedať niečomu v dome ako
<div id="home"></div>
.
Keď používate scrollspy v spojení s pridávaním alebo odstraňovaním prvkov z DOM, budete musieť zavolať metódu refresh takto:
- $ ( '[data-spy="scroll"]' ). každý ( function () {
- var $spy = $ ( toto ). scrollspy ( 'obnoviť' )
- });
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. |
Udalosť | Popis |
---|---|
Aktivovať | Táto udalosť sa spustí vždy, keď scrollspy aktivuje novú položku. |
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.
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.
Povoliť karty s tabuľkami cez JavaScript (každá karta musí byť aktivovaná samostatne):
- $ ( '#myTab a' ). klikni ( funkcia ( e ) {
- e . zabrániťPredvolené ();
- $ ( toto ). karta ( 'zobraziť' );
- })
Jednotlivé karty môžete aktivovať niekoľkými spôsobmi:
- $ ( '#myTab a[href="#profile"]' ). karta ( 'zobraziť' ); // Vyberte kartu podľa názvu
- $ ( '#myTab a:first' ). karta ( 'zobraziť' ); // Vyberte prvú kartu
- $ ( '#myTab a:last' ). karta ( 'zobraziť' ); // Vyberte poslednú kartu
- $ ( '#myTab li:eq(2) a' ). karta ( 'zobraziť' ); // Vyberte tretiu kartu (indexovaná 0)
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 nav
a nav-tabs
na kartu ul
sa použije štýl karty Bootstrap.
- <ul class = "nav nav-tabs" >
- <li><a href = "#home" data-toggle = "tab" > Domov </a></li>
- <li><a href = "#profile" data-toggle = "tab" > Profil </a></li>
- <li><a href = "#messages" data-toggle = "tab" > Správy </a></li>
- <li><a href = "#settings" data-toggle = "tab" > Nastavenia </a></li>
- </ul>
Aktivuje prvok karty a kontajner obsahu. Karta by mala mať buď a data-target
alebo href
zacielenie na kontajnerový uzol v DOM.
- <ul class = "nav nav-tabs" id = "myTab" >
- <li class = "active" ><a href = "#home" > Domov </a></li>
- <li><a href = "#profile" > Profil </a></li>
- <li><a href = "#messages" > Správy </a></li>
- <li><a href = "#settings" > Nastavenia </a></li>
- </ul>
- <div class = "tab-content" >
- <div class = "tab-pane active" id = "home" > ... </div>
- <div class = "tab-pane" id = "profile" > ... </div>
- <div class = "tab-pane" id = "messages" > ... </div>
- <div class = "tab-pane" id = "settings" > ... </div>
- </div>
- <script>
- $ ( funkcia () {
- $ ( '#myTab a:last' ). karta ( 'zobraziť' );
- })
- </script>
Udalosť | Popis |
---|---|
šou | Táto udalosť sa spustí pri zobrazení kariet, ale predtým, než sa zobrazí nová karta. Pomocou event.target a event.relatedTarget zacielite 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.target a event.relatedTarget zacielite na aktívnu kartu a predchádzajúcu aktívnu kartu (ak je k dispozícii). |
- $ ( 'a[data-toggle="tab"]' ). on ( 'zobrazené' , funkcia ( e ) {
- e . target // aktivovaná karta
- e . relatedTarget // predchádzajúca karta
- })
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 má 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ádnuť freegan cred raw denim single-origin coffee viral.
Keď používate popisky a kontextové okná so vstupnými skupinami Bootstrap, budete musieť nastaviť možnosť container
(dokumentovaná nižšie), aby ste sa vyhli nežiaducim vedľajším účinkom.
Spustite popis pomocou JavaScriptu:
- $ ( '#príklad' ). popis ( 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žite prechod css miznutia na popis |
html | boolovská hodnota | falošné | Vložte html do popisku. text Ak 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 | 'hover focus' | 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: |
kontajner | reťazec | falošné | falošné | Pridá popis ku konkrétnemu prvku |
- <a href = "#" data-toggle = "tooltip" title = "first tooltip" > umiestnite kurzor myši na mňa </a>
Ku kolekcii prvkov pripojí popisovač.
Zobrazí popis prvku.
- $ ( '#element' ). popis ( 'zobraziť' )
Skryje popis prvku.
- $ ( '#element' ). popis ( 'skryť' )
Prepína popis prvku.
- $ ( '#element' ). popis ( 'prepnúť' )
Skryje a zničí popis prvku.
- $ ( '#element' ). popis ( 'zničiť' )
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 .
K dispozícii sú štyri možnosti: zarovnané hore, vpravo, dole a vľavo.
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.
Z JavaScriptu a obsahu v rámci atribútu sa negenerujú žiadne značky zobrazené ako kontextové okná data
.
Povoliť vyskakovacie okná prostredníctvom JavaScriptu:
- $ ( '#príklad' ). vyskakovacie okno ( 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žite prechod css miznutia na popis |
html | boolovská hodnota | falošné | Vložte html do kontextového okna. text Ak 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: |
kontajner | reťazec | falošné | falošné | Pripojí kontextové okno ku konkrétnemu prvku |
Z výkonnostných dôvodov sú povolené Tooltip a Popover data-apis. Ak ich chcete použiť, stačí zadať možnosť výberu.
Inicializuje vyskakovacie okná pre kolekciu prvkov.
Odhaľuje kontextové okno prvkov.
- $ ( '#element' ). vyskakovacie okno ( 'zobraziť' )
Skryje vyskakovacie okno prvkov.
- $ ( '#element' ). vyskakovacie okno ( 'skryť' )
Prepína vyskakovacie okno prvkov.
- $ ( '#element' ). vyskakovacie okno ( 'prepnúť' )
Skryje a zničí popover prvku.
- $ ( '#element' ). vyskakovacie okno ( 'zničiť' )
Pomocou tohto doplnku pridajte do všetkých výstražných správ funkciu odmietnutia.
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.
Povoliť zrušenie upozornenia prostredníctvom JavaScriptu:
- $ ( ".upozornenie" ). upozornenie ()
Stačí pridať data-dismiss="alert"
tlačidlo na zatvorenie, aby sa automaticky aktivovala funkcia zatvorenia upozornenia.
- <a class = "close" data-dismiss = "alert" href = "#" > × </a>
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 .fade
a ..in
Zatvorí upozornenie.
- $ ( ".upozornenie" ). upozornenie ( 'zavrieť' )
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 pri close volaní metódy inštancie. |
ZATVORENÉ | Táto udalosť sa spustí po zatvorení upozornenia (bude čakať na dokončenie prechodov css). |
- $ ( '#my-upozornenie' ). bind ( 'zatvorené' , funkcia () {
- // urob nieč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.
Pomocou doplnku na zbalenie sme vytvorili jednoduchý widget v štýle akordeónu:
- <div class = "akordeón" id = "akordeón2" >
- <div class = "akordeónová skupina" >
- <div class = "akordeón-hlavička" >
- <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseOne" >
- Skladacia skupinová položka č. 1
- </a>
- </div>
- <div id = "collapseOne" class = "zrútenie tela harmoniky v" >
- <div class = "akordeón-vnútorná" >
- Anim pariatur klišé...
- </div>
- </div>
- </div>
- <div class = "akordeónová skupina" >
- <div class = "akordeón-hlavička" >
- <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseTwo" >
- Skladacia skupinová položka č. 2
- </a>
- </div>
- <div id = "collapseTwo" class = "kolaps tela harmoniky" >
- <div class = "akordeón-vnútorná" >
- Anim pariatur klišé...
- </div>
- </div>
- </div>
- </div>
- ...
Doplnok môžete použiť aj bez označenia akordeónu. Vytvoriť tlačidlo na prepínanie rozbalenia a zbalenia iného prvku.
- <button type = "button" class = "btn btn-danger" data-toggle = "collapse" data-target = "#demo" >
- jednoduchý skladací
- </button>
- <div id = "demo" class = "collapse in" > … </div>
Stačí pridať data-toggle="collapse"
a data-target
do prvku, aby ste automaticky priradili kontrolu nad skladacím prvkom. Atribút data-target
akceptuje selektor css, na ktorý sa má použiť zbalenie. Nezabudnite pridať triedu collapse
do 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.
Povoliť manuálne pomocou:
- $ ( ".collapse" ). kolaps ()
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 nadradeným prvkom. (podobné tradičnému správaniu na akordeóne) |
prepnúť | boolovská hodnota | pravda | Prepína zbaliteľný prvok pri vyvolaní |
Aktivuje váš obsah ako skladací prvok. Prijíma voliteľné možnosti object
.
- $ ( '#myCollapsible' ). kolaps ({
- prepnúť : nepravda
- })
Prepne zbaliteľný prvok na zobrazený alebo skrytý.
Zobrazuje skladací prvok.
Skryje skladací prvok.
Trieda zbalenia Bootstrapu odhaľuje niekoľko udalostí na pripojenie k funkcii zbalenia.
Udalosť | Popis |
---|---|
šou | Táto udalosť sa spustí okamžite pri show volaní 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 hide zavolaní metódy. |
skryté | Táto udalosť sa spustí, keď bol prvok zbalenia skrytý pred používateľom (bude čakať na dokončenie prechodov css). |
- $ ( '#myCollapsible' ). on ( 'skryté' , funkcia () {
- // urob niečo…
- })
Nižšie uvedená prezentácia zobrazuje všeobecný doplnok a komponent na prepínanie medzi prvkami, ako je kolotoč.
- <div id = "myCarousel" class = "carousel slide" >
- <ol class = "carusel-indicators" >
- <li data-target = "#myCarousel" data-slide-to = "0" class = "active" ></li>
- <li data-target = "#myCarousel" data-slide-to = "1" ></li>
- <li data-target = "#myCarousel" data-slide-to = "2" ></li>
- </ol>
- <!-- Položky karuselu -->
- <div class = "carousel-inner" >
- <div class = "active item" > … </div>
- <div class = "item" > … </div>
- <div class = "item" > … </div>
- </div>
- <!-- Carousel nav -->
- <a class = "carousel-control left" href = "#myCarousel" data-slide = "prev" > ‹ </a>
- <a class = "carousel-control right" href = "#myCarousel" data-slide = "next" > › </a>
- </div>
Pomocou atribútov údajov môžete jednoducho ovládať polohu karuselu. data-slide
akceptuje kľúčové slová prev
alebo next
, ktoré zmenia pozíciu snímky vzhľadom na jej aktuálnu pozíciu. Prípadne použite data-slide-to
na odovzdanie nespracovaného indexu snímky do karuselu data-slide-to="2"
, ktorý preskočí na pozíciu snímky na konkrétny index začínajúci na 0
.
Zavolajte karusel manuálne pomocou:
- $ ( '.kolotoč' ). kolotoč ()
Možnosti môžu byť odovzdané prostredníctvom dátových atribútov alebo JavaScriptz. Pre atribúty údajov pripojte názov voľby k data-
, ako v data-interval=""
.
názov | typu | predvolená | popis |
---|---|---|---|
interval | číslo | 5000 | Čas oneskorenia medzi automatickým cyklovaním položky. Ak je hodnota false, karusel sa nebude automaticky cyklovať. |
pauza | reťazec | "vznášať sa" | Pozastaví cyklovanie kolotoča na mouseenter a obnoví cyklovanie kolotoča na mouseleave. |
Inicializuje kolotoč s voliteľnými možnosťami object
a začne cyklicky prechádzať položkami.
- $ ( '.kolotoč' ). kolotoč ({
- interval : 2000
- })
Prechádza položkami kolotoča zľava doprava.
Zastaví kolotoč prechádzať položkami.
Cyklizuje karusel na konkrétny rámec (na základe 0, podobne ako pole).
Prejde na predchádzajúcu položku.
Prejde na ďalšiu položku.
Trieda karuselu Bootstrap odhaľuje dve udalosti na pripojenie k funkcii karuselu.
Udalosť | Popis |
---|---|
šmykľavka | Táto udalosť sa spustí okamžite pri slide vyvolaní metódy inštancie. |
skĺzol | Táto udalosť sa spustí, keď karusel dokončí svoj posuvný prechod. |
Základný, ľahko rozšírený plugin na rýchle vytváranie elegantných hlások s ľubovoľným zadávaním textu z formulára.
- <input type = "text" data- provide = "typeahead" >
Budete chcieť nastaviť autocomplete="off"
, aby sa predvolené ponuky prehliadača nezobrazovali v rozbaľovacom zozname typu Bootstrap.
Pridajte atribúty údajov na registráciu prvku s funkciou prepisu, ako je uvedené v príklade vyššie.
Zavolajte prepis manuálne pomocou:
- $ ( '.typeahead' ). písať dopredu ()
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, query hodnota vo vstupnom poli a process spätné volanie. Funkciu možno použiť synchrónne vrátením zdroja údajov priamo alebo asynchrónne prostredníctvom process jediné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, item proti ktorému sa má test otestovať. Prístup k aktuálnemu dotazu získate pomocou this.query . true Ak 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 items a 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, item a 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 item a má rozsah typovej inštancie. Mal by vrátiť html. |
Inicializuje vstup písaním dopredu.
Subnavigácia vľavo je živá ukážka doplnku afix.
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.
- <div data-spy = "affix" data-offset-top = "200" > ... </div>
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.
Zavolajte doplnok na pripojenie cez JavaScript:
- $ ( '#navbar' ). pripojiť ()
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). |