JavaScript

Lífgaðu íhlutum Bootstrap til lífsins - nú með 13 sérsniðnum jQuery viðbótum.

Höfuð upp! Þessi skjöl eru fyrir v2.3.2, sem er ekki lengur opinberlega studd. Skoðaðu nýjustu útgáfuna af Bootstrap!

Einstök eða samsett

Hægt er að fylgja með viðbætur hver fyrir sig (þó sum hafi nauðsynlegar ósjálfstæði), eða allt í einu. Bæði bootstrap.js og bootstrap.min.js innihalda öll viðbætur í einni skrá.

Gagnaeiginleikar

Þú getur notað allar Bootstrap viðbætur eingöngu í gegnum markup API án þess að skrifa eina línu af JavaScript. Þetta er fyrsta flokks API frá Bootstrap og ætti að vera fyrsta íhugun þín þegar þú notar viðbót.

Sem sagt, í sumum tilfellum getur verið æskilegt að slökkva á þessari virkni. Þess vegna bjóðum við einnig upp á möguleikann á að slökkva á gagnaeigininni API með því að aftengja alla atburði í meginmálinu með nafnabili með ``data-api``. Þetta lítur svona út:

  1. $ ( 'líkami' ). slökkt ( '.data-api' )

Að öðrum kosti, til að miða á ákveðna viðbót, skaltu bara láta nafn viðbótarinnar fylgja með sem nafnrými ásamt data-api nafnrýminu eins og þetta:

  1. $ ( 'líkami' ). slökkt ( '.alert.data-api' )

Forritað API

Við teljum líka að þú ættir að geta notað öll Bootstrap viðbætur eingöngu í gegnum JavaScript API. Öll opinber API eru stakar, keðjanlegar aðferðir og skila söfnuninni sem brugðist hefur verið við.

  1. $ ( ".btn.danger" ). hnappur ( „skipta“ ). addClass ( "fita" )

Allar aðferðir ættu að samþykkja valfrjálsan valmöguleikahlut, streng sem miðar á tiltekna aðferð eða ekkert (sem kemur af stað viðbót með sjálfgefna hegðun):

  1. $ ( "#myModal" ). modal () // frumstillt með sjálfgefnum stillingum
  2. $ ( "#myModal" ). modal ({ keyboard : false }) // frumstillt án lyklaborðs
  3. $ ( "#myModal" ). modal ( 'show' ) // frumstillir og kallar show strax

Hver tappi afhjúpar einnig hráa smiðinn sinn á 'Constructor' eign: $.fn.popover.Constructor. Ef þú vilt fá tiltekið viðbótatilvik skaltu sækja það beint úr frumefni: $('[rel=popover]').data('popover').

Engir átök

Stundum er nauðsynlegt að nota Bootstrap viðbætur með öðrum UI ramma. Við þessar aðstæður geta árekstrar í nafnrými átt sér stað einstaka sinnum. Ef þetta gerist geturðu hringt .noConflictí viðbótina sem þú vilt breyta gildinu á.

  1. var bootstrapButton = $ . fn . hnappinn . noConflict () // skila $.fn.button í áður úthlutað gildi
  2. $ . fn . bootstrapBtn = bootstrapButton // gefðu $().bootstrapBtn bootstrap virknina

Viðburðir

Bootstrap býður upp á sérsniðna atburði fyrir flestar einstöku aðgerðir viðbætur. Yfirleitt koma þær í óendanlegu formi og þátíð - þar sem óendanlegur (til dæmis show) er ræstur í upphafi atburðar og þátíðarháttur (til dæmis shown) er kveikt þegar aðgerð er lokið.

Allir óendanlegir atburðir veita preventDefault virkni. Þetta veitir möguleika á að stöðva framkvæmd aðgerða áður en hún hefst.

  1. $ ( '#myModal' ). á ( 'sýna' , fall ( e ) {
  2. ef (! gögn ) skila e . preventDefault () // kemur í veg fyrir að modal sé sýnt
  3. })

Um umskipti

Til að fá einföld umbreytingaráhrif skaltu setja bootstrap-transition.js einu sinni ásamt öðrum JS skrám. Ef þú ert að nota samansetta (eða minnkaða) bootstrap.js , það er engin þörf á að hafa þetta með – það er nú þegar til staðar.

Notkunartilvik

Nokkur dæmi um umbreytingarviðbótina:

  • Renna eða dofna í formum
  • Flipar fölna út
  • Að dofna út viðvaranir
  • Rennibrautarrúður

Dæmi

Modals eru straumlínulagaðar, en sveigjanlegar, svarglugga með lágmarks virkni og snjöllum sjálfgefnum stillingum.

Statískt dæmi

Útgjört form með haus, meginmáli og aðgerðasetti í síðufæti.

  1. <div class = "modal hide fade" >
  2. <div class = "modal-header" >
  3. <button type = "button" class = "close" data-dismiss = "modal" aria-hidden = "true" > × </hnappur>
  4. <h3> Modal haus </h3>
  5. </div>
  6. <div class = "modal-body" >
  7. <p> Einn fínn líkami… </p>
  8. </div>
  9. <div class = "modal-footer" >
  10. <a href = "#" class = "btn" > Loka </a>
  11. <a href = "#" class = "btn btn-primary" > Vista breytingar </a>
  12. </div>
  13. </div>

Sýning í beinni

Skiptu um form í gegnum JavaScript með því að smella á hnappinn hér að neðan. Það mun renna niður og hverfa inn efst á síðunni.

  1. <!-- Hnappur til að kveikja á modal -->
  2. <a href = "#myModal" role = "button" class = "btn" data-toggle = "modal" > Ræsa kynningu modal </a>
  3.  
  4. <!-- Modal -->
  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" > Modal haus </h3>
  9. </div>
  10. <div class = "modal-body" >
  11. <p> Einn fínn líkami… </p>
  12. </div>
  13. <div class = "modal-footer" >
  14. <button class = "btn" data-dismiss = "modal" aria-hidden = "true" > Loka </button>
  15. <button class = "btn btn-primary" > Vista breytingar </button>
  16. </div>
  17. </div>

Notkun

Í gegnum gagnaeiginleika

Virkjaðu form án þess að skrifa JavaScript. Stillt data-toggle="modal"á stjórnunareiningu, eins og hnapp, ásamt a data-target="#foo"eða href="#foo"til að miða á ákveðna aðferð til að skipta.

  1. <button type = "button" data-toggle = "modal" data-target = "#myModal" > Ræsa modal </button>

Með JavaScript

Hringdu í modal með auðkenni myModalmeð einni línu af JavaScript:

  1. $ ( '#myModal' ). modal ( valkostir )

Valmöguleikar

Hægt er að senda valkosti í gegnum gagnaeiginleika eða JavaScript. Fyrir gagnaeiginleika skaltu bæta heiti valkostsins við data-, eins og í data-backdrop="".

Nafn tegund sjálfgefið lýsingu
bakgrunn Boolean satt Inniheldur modal-bakgrunnsþátt. Að öðrum kosti, tilgreindu staticfyrir bakgrunn sem lokar ekki forminu þegar smellt er.
lyklaborð Boolean satt Lokar forminu þegar ýtt er á escape takkann
sýna Boolean satt Sýnir aðferðina þegar hann er frumstilltur.
fjarlægur leið rangt

Ef ytri vefslóð er gefin upp verður efni hlaðið með loadaðferð jQuery og sprautað inn í .modal-body. Ef þú ert að nota gagnaforritið geturðu notað hrefmerkið til að tilgreina ytri uppsprettu. Dæmi um þetta er sýnt hér að neðan:

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

Aðferðir

.modal(valkostir)

Virkjar efnið þitt sem form. Samþykkir valfrjálsa valkosti object.

  1. $ ( '#myModal' ). módel ({
  2. lyklaborð : rangt
  3. })

.modal('toggle')

Skiptir handvirkt um form.

  1. $ ( '#myModal' ). modal ( 'skipta' )

.modal('sýning')

Opnar form handvirkt.

  1. $ ( '#myModal' ). modal ( 'sýning' )

.modal('fela')

Felur form handvirkt.

  1. $ ( '#myModal' ). modal ( 'fela' )

Viðburðir

Modal flokkur Bootstrap afhjúpar nokkra atburði til að tengja við formlega virkni.

Viðburður Lýsing
sýna Þessi atburður ræsir strax þegar showtilviksaðferðin er kölluð.
Sýnt Þessi atburður er ræstur þegar modal hefur verið gert sýnilegt notanda (mun bíða eftir að css umbreytingum ljúki).
fela sig Þessi atburður er ræstur strax þegar hidetilviksaðferðin hefur verið kölluð.
falið Þessi atburður er ræstur þegar modal hefur lokið við að vera falið fyrir notanda (mun bíða eftir að css umbreytingum ljúki).
  1. $ ( '#myModal' ). á ( 'falinn' , fall () {
  2. // gera eitthvað…
  3. })

Dæmi í navbar

ScrollSpy viðbótin er til að uppfæra siglingamarkmið sjálfkrafa á grundvelli skrunstöðu. Skrunaðu svæðið fyrir neðan siglingastikuna og horfðu á virka bekkinn breytast. Undirliðir í fellilistanum verða einnig auðkenndir.

@feiti

Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi áður en þeir seldust upp qui. Tumblr reiðhjólaréttindi frá bænum til borðs hvað sem er. Anim keffiyeh carles peysa. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby peysa lomo gallabuxur, Williamsburg hettupeysa lágmark qui þú hefur líklega ekki heyrt um þær og cardigan trust fund culpa biodiesel wes anderson fagurfræðilegu. Nihil húðflúrað accusamus, cred kaldhæðni lífdísil keffiyeh handverksmaður ullamco consequat.

@mdo

Veniam Marfa yfirvaraskeggs hjólabretti, fitandi fugiat velit hágaffelskegg. Freegan skegg aliqua cupidatat mcsweeney's vero. Cupidatat fjögur loko nisi, ea helvetica nulla carles. Tattooed cosby peysu matarbíll, Mcsweeney's quis non freegan vínyl. Lo-fi wes anderson +1 sartorial. Carles ekki fagurfræðileg æfing quis gentrify. Brooklyn fóðrandi föndurbjór vara keytar eyðimerkur.

einn

Occaecat commodo aliqua delectus. Fap craft beer deserunt hjólabretti ea. Lomo bicycle rights adipisicing banh mi, velit ea sunt next level locavore single-origin coffee in magna veniam. High life id vinyl, echo park consequat quis aliquip banh mi pitchfork. Vero VHS er adipisicing. Consectetur nisi DIY minim senditaska. Cred fyrrverandi í, sjálfbær delectus consectetur fanny pack iphone.

tveir

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 blogg, culpa messenger bag marfa whatever delectus food truck. Sapiente synth id assumenda. Locavore sed helvetica klisja kaldhæðni, thundercats þú hefur líklega ekki heyrt um þá consequat hettupeysa glútenlaus lo-fi fap aliquip. Labor elit placeat áður en þeir seldust upp, Terry richardson proident brunch nesciunt quis cosby peysa pariatur keffiyeh ut helvetica artisan. Cardigan handverksbjór seitan tilbúinn velit. VHS chambray laboris tempor veniam. Anim mollit minim commodo ullamco thundercats.


Notkun

Í gegnum gagnaeiginleika

Til að bæta scrollspy hegðun auðveldlega við toppstikuna þína skaltu bara bæta data-spy="scroll"við þættinum sem þú vilt njósna um (oftast væri þetta líkaminn) og data-target=".navbar"til að velja hvaða nav þú vilt nota. Þú munt vilja nota scrollspy með .navíhlut.

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

Með JavaScript

Hringdu í scrollspy í gegnum JavaScript:

  1. $ ( '#navbar' ). scrollspy ()
Höfuð upp! Navbar tenglar verða að hafa leysanleg auðkennismarkmið. Til dæmis, a <a href="#home">home</a>verður að samsvara einhverju í dom eins og <div id="home"></div>.

Aðferðir

.scrollspy('refresh')

Þegar þú notar scrollspy í tengslum við að bæta við eða fjarlægja þætti úr DOM þarftu að kalla á endurnýjunaraðferðina svona:

  1. $ ( '[data-spy="scroll"]' ). hver ( fall () {
  2. var $njósnari = $ ( þetta ). scrollspy ( 'hressa' )
  3. });

Valmöguleikar

Hægt er að senda valkosti í gegnum gagnaeiginleika eða JavaScript. Fyrir gagnaeiginleika skaltu bæta heiti valkostsins við data-, eins og í data-offset="".

Nafn tegund sjálfgefið lýsingu
á móti númer 10 Dílar til að vega upp frá toppi þegar reiknað er út stöðu flettu.

Viðburðir

Viðburður Lýsing
virkja Þessi atburður ræsir í hvert sinn sem nýr hlutur verður virkjaður af scrollspy.

Dæmi flipar

Bættu við skjótum, kraftmiklum flipavirkni til að skipta í gegnum svæðisrúður, jafnvel með fellivalmyndum.

Hrátt denim þú hefur líklega ekki heyrt um þær gallabuxur Austin. Nesciunt tofu stumptown aliqua, retro synth master hreinsun. Mustache cliche tempor, williamsburg carles vegan helvetica. Reprehenderit Butcher Retro Keffiyeh draumafangari synth. Cosby peysa eu banh mi, qui irure Terry Richardson fyrrverandi smokkfiskur. Aliquip placeat salvia cillum iphone. Seitan aliquip quis cardigan amerískur fatnaður, slátrari 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.


Notkun

Virkjaðu flipa sem hægt er að nota með JavaScript (hvern flipa þarf að virkja fyrir sig):

  1. $ ( '#myTab a' ). smelltu ( fall ( e ) {
  2. e . koma í veg fyrir Sjálfgefið ();
  3. $ ( þetta ). tab ( 'sýna' );
  4. })

Þú getur virkjað einstaka flipa á nokkra vegu:

  1. $ ( '#myTab a[href="#profile"]' ). tab ( 'sýna' ); // Veldu flipa eftir nafni
  2. $ ( '#myTab a:first' ). tab ( 'sýna' ); // Veldu fyrsta flipa
  3. $ ( '#myTab a:last' ). tab ( 'sýna' ); // Veldu síðasta flipa
  4. $ ( '#myTab li:eq(2) a' ). tab ( 'sýna' ); // Veldu þriðja flipa (0-tryggður)

Markup

Þú getur virkjað flipa eða pilluleiðsögn án þess að skrifa JavaScript með því einfaldlega að tilgreina data-toggle="tab"eða data-toggle="pill"á frumefni. Með því að bæta navog nav-tabsflokkunum við flipann ulverður stíll Bootstrap flipans beitt.

  1. <ul class = "nav nav-tabs" >
  2. <li><a href = "#home" data-toggle = "tab" > Heim </a></li>
  3. <li><a href = "#profile" data-toggle = "tab" > Prófíll </a></li>
  4. <li><a href = "#messages" data-toggle = "tab" > Skilaboð </a></li>
  5. <li><a href = "#settings" data-toggle = "tab" > Stillingar </a></li>
  6. </ul>

Aðferðir

$().flipi

Virkjar flipaþátt og innihaldsílát. Tab ætti að hafa annað hvort a data-targeteða hrefmiða á gámahnút í DOM.

  1. <ul class = "nav nav-tabs" id = "myTab" >
  2. <li class = "active" ><a href = "#home" > Heim </a></li>
  3. <li><a href = "#profile" > Prófíll </a></li>
  4. <li><a href = "#messages" > Skilaboð </a></li>
  5. <li><a href = "#settings" > Stillingar </a></li>
  6. </ul>
  7.  
  8. <div class = "tab-content" >
  9. <div class = "tab-pane active" id = "heima" > ... </div>
  10. <div class = "tab-pane" id = "prófíl" > ... </div>
  11. <div class = "tab-pane" id = "skilaboð" > ... </div>
  12. <div class = "tab-pane" id = "stillingar" > ... </div>
  13. </div>
  14.  
  15. <handrit>
  16. $ ( fall () {
  17. $ ( '#myTab a:last' ). tab ( 'sýna' );
  18. })
  19. </script>

Viðburðir

Viðburður Lýsing
sýna Þessi atburður ræsir á flipasýningu, en áður en nýi flipi hefur verið sýndur. Notaðu event.targetog event.relatedTargettil að miða á virka flipann og fyrri virka flipann (ef tiltækur) í sömu röð.
Sýnt Þessi atburður ræsir á flipasýningu eftir að flipi hefur verið sýndur. Notaðu event.targetog event.relatedTargettil að miða á virka flipann og fyrri virka flipann (ef tiltækur) í sömu röð.
  1. $ ( 'a[data-toggle="tab"]' ). á ( 'sýnt' , fall ( e ) {
  2. e . target // virkjaður flipi
  3. e . relatedTarget // fyrri flipi
  4. })

Dæmi

Innblásin af frábæru jQuery.tipsy viðbótinni skrifað af Jason Frame; Verkfæraráð eru uppfærð útgáfa, sem treystir ekki á myndir, notar CSS3 fyrir hreyfimyndir og gagnaeiginleika fyrir staðbundna titlageymslu.

Af frammistöðuástæðum eru tólabendingin og popover gagnaforritin valin, sem þýðir að þú verður að frumstilla þau sjálfur .

Farðu yfir tenglana hér að neðan til að sjá verkfæraleiðbeiningar:

Þröngar buxur næsta stig keffiyeh þú hefur líklega ekki heyrt um þær. Ljósmyndabás skegg hrár denim bókprentun vegan senditaska stumptown. Seitan frá bænum til borðs, mcsweeney's fixie sjálfbær quinoa 8 bita amerískur fatnaður er með terry richardson vinyl chambray. Beard stumptown, cardigans banh mi lomo thundercats. Tofu lífdísill Williamsburg Marfa, fjögurra loko mcsweeney's cleanse vegan chambray. Virkilega kaldhæðnislegur handverksmaður hvað sem er keytar , scenester bæ-til-borð banksy Austin twitter höndla freegan cred raw denim einuppruna kaffi veiru.

Fjórar áttir

Verkfæraráð í inntakshópum

Þegar þú notar verkfæraábendingar og sprettiglugga með Bootstrap inntakshópunum þarftu að stilla containervalkostinn (skráð hér að neðan) til að forðast óæskilegar aukaverkanir.


Notkun

Kveiktu á tóli í gegnum JavaScript:

  1. $ ( '#dæmi' ). verkfæraráð ( valkostir )

Valmöguleikar

Hægt er að senda valkosti í gegnum gagnaeiginleika eða JavaScript. Fyrir gagnaeiginleika skaltu bæta heiti valkostsins við data-, eins og í data-animation="".

Nafn tegund sjálfgefið lýsingu
fjör Boolean satt notaðu css fade umskipti á tólabendinguna
html Boolean rangt Settu html inn í tólið. Ef það er rangt verður textaðferð jquery notuð til að setja efni inn í dom. Notaðu texta ef þú hefur áhyggjur af XSS árásum.
staðsetningu strengur | virka 'topp' hvernig á að staðsetja tólið - efst | botn | vinstri | rétt
veljara strengur rangt Ef valkostur er til staðar verður verkfæravísahlutum úthlutað til tilgreindra skotmarka.
titill strengur | virka '' sjálfgefið titilgildi ef `title` tag er ekki til staðar
kveikja strengur 'sveima fókus' hvernig ábending er sett af stað - smelltu á | sveima | fókus | handbók. Athugaðu að þú framhjá kveikjum fjölbreytileg, bil aðskilin, kveikjugerðir.
seinkun númer | mótmæla 0

seinkun á að sýna og fela tólið (ms) - á ekki við um handvirka kveikjugerð

Ef númer er gefið upp er seinkun beitt á bæði fela/sýna

Uppbygging hlutar er:delay: { show: 500, hide: 100 }

ílát strengur | rangt rangt

Bætir ábendingunni við ákveðinn þáttcontainer: 'body'

Höfuð upp! Að öðrum kosti er hægt að tilgreina valkosti fyrir einstakar verkfæraábendingar með því að nota gagnaeiginleika.

Markup

  1. <a href = "#" data-toggle = "tooltip" title = "fyrsta verkfæraráð" > sveima yfir mig </a>

Aðferðir

$().tooltip(valkostir)

Hengir verkfæraleiðbeiningum við einingarsafn.

.tooltip('sýna')

Sýnir verkfæraábendingu frumefnis.

  1. $ ( '#þáttur' ). tooltip ( 'sýna' )

.tooltip('fela')

Felur ábendingu frumefnis.

  1. $ ( '#þáttur' ). tooltip ( 'fela' )

.tooltip('toggle')

Breytir ábendingum frumefnis.

  1. $ ( '#þáttur' ). tooltip ( 'skipta' )

.tooltip('eyðileggja')

Felur og eyðileggur verkfæraábendingu frumefnis.

  1. $ ( '#þáttur' ). tooltip ( 'eyðileggja' )

Dæmi

Bættu litlum yfirlagi af efni, eins og á iPad, við hvaða þátt sem er til að hýsa aukaupplýsingar. Færðu bendilinn yfir hnappinn til að kveikja á popover. Krefst þess að Tooltip sé innifalið.

Static popover

Fjórir valkostir eru í boði: efst, hægri, neðst og vinstri stillt.

Popover toppur

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

Popover rétt

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

Popover botn

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

Popover eftir

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

Engin álagning sem sýnd er sem sprettigluggar eru búnar til úr JavaScript og efni innan dataeigindar.

Sýning í beinni

Fjórar áttir


Notkun

Virkja popover í gegnum JavaScript:

  1. $ ( '#dæmi' ). popover ( valkostir )

Valmöguleikar

Hægt er að senda valkosti í gegnum gagnaeiginleika eða JavaScript. Fyrir gagnaeiginleika skaltu bæta heiti valkostsins við data-, eins og í data-animation="".

Nafn tegund sjálfgefið lýsingu
fjör Boolean satt notaðu css fade umskipti á tólabendinguna
html Boolean rangt Settu html inn í popover. Ef það er rangt verður textaðferð jquery notuð til að setja efni inn í dom. Notaðu texta ef þú hefur áhyggjur af XSS árásum.
staðsetningu strengur | virka 'rétt' hvernig á að staðsetja popover - efst | botn | vinstri | rétt
veljara strengur rangt ef veljari er til staðar, verða verkfærishlutir framseldir til tilgreindra miða
kveikja strengur 'smellur' hvernig popover er kveikt - smelltu á | sveima | fókus | handbók
titill strengur | virka '' sjálfgefið titilgildi ef „title“ eigind er ekki til staðar
efni strengur | virka '' sjálfgefið innihaldsgildi ef eigind „data-content“ er ekki til staðar
seinkun númer | mótmæla 0

seinkun á að sýna og fela sprettigluggann (ms) - á ekki við um handvirka kveikjugerð

Ef númer er gefið upp er seinkun beitt á bæði fela/sýna

Uppbygging hlutar er:delay: { show: 500, hide: 100 }

ílát strengur | rangt rangt

Bætir sprettiglugganum við ákveðinn þáttcontainer: 'body'

Höfuð upp! Að öðrum kosti er hægt að tilgreina valkosti fyrir einstaka sprettiglugga með því að nota gagnaeiginleika.

Markup

Af frammistöðuástæðum eru Tooltip og Popover gagnaforritin valin. Ef þú vilt nota þá skaltu bara tilgreina valmöguleika.

Aðferðir

$().popover(valkostir)

Frumstillir sprettiglugga fyrir þáttasafn.

.popover('sýna')

Afhjúpar þætti sem birtist.

  1. $ ( '#þáttur' ). popover ( 'sýning' )

.popover('fela')

Felur frumefnisskjá.

  1. $ ( '#þáttur' ). popover ( 'fela' )

.popover('toggle')

Breytir yfirlit yfir þætti.

  1. $ ( '#þáttur' ). popover ( 'skipta' )

.popover('eyðileggja')

Felur og eyðileggur popover frumefnis.

  1. $ ( '#þáttur' ). popover ( 'eyðileggja' )

Dæmi um viðvaranir

Bættu við að hafna virkni við öll viðvörunarskilaboð með þessari viðbót.

Heilagur guacamole! Best að athuga sjálfan þig, þú lítur ekki of vel út.

Ó snappið! Þú fékkst villu!

Breyttu hinu og þessu og reyndu aftur. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.

Taktu þessa aðgerð Eða gerðu þetta


Notkun

Virkjaðu frávísun á viðvörun með JavaScript:

  1. $ ( ".viðvörun" ). viðvörun ()

Markup

Bættu bara við data-dismiss="alert"lokunarhnappinn þinn til að gefa sjálfkrafa viðvörunarlokunarvirkni.

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

Aðferðir

$().alert()

Umlykur allar viðvaranir með náinni virkni. Til að láta tilkynningar þínar birtast þegar þær eru lokaðar skaltu ganga úr skugga um að þær hafi .fadeog .inflokkinn þegar notaður fyrir þær.

.alert('loka')

Lokar viðvörun.

  1. $ ( ".viðvörun" ). viðvörun ( 'loka' )

Viðburðir

Viðvörunarflokkur Bootstrap afhjúpar nokkra atburði til að tengjast viðvörunarvirkni.

Viðburður Lýsing
loka Þessi atburður ræsir strax þegar closetilviksaðferðin er kölluð.
lokað Þessi atburður er ræstur þegar viðvöruninni hefur verið lokað (bíður eftir að CSS-breytingum ljúki).
  1. $ ( '#mín-viðvörun' ). binda ( 'lokað' , fall () {
  2. // gera eitthvað…
  3. })

Dæmi um notkun

Gerðu meira með hnöppum. Stjórna hnappastöður eða búa til hópa af hnöppum fyrir fleiri hluti eins og tækjastikur.

Staðhæft

Bæta við data-loading-text="Loading..."til að nota hleðsluástand á hnapp.

  1. <button type = "button" class = "btn btn-primary" data-loading-text = "Hleður..." > Hleðsla staða </button>

Einn rofi

Bættu við data-toggle="button"til að virkja kveikt á einum hnappi.

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

Gátreitur

Bæta við data-toggle="buttons-checkbox"til að skipta um gátreitastíl á btn-group.

  1. <div class = "btn-group" data-toggle = "buttons-checkbox" >
  2. <button type = "button" class = "btn btn-primary" > Vinstri </button>
  3. <button type = "button" class = "btn btn-primary" > Mið </button>
  4. <button type = "button" class = "btn btn-primary" > Hægri </button>
  5. </div>

Útvarp

Bættu við data-toggle="buttons-radio"til að skipta um útvarpsstíl á btn-group.

  1. <div class = "btn-group" data-toggle = "buttons-radio" >
  2. <button type = "button" class = "btn btn-primary" > Vinstri </button>
  3. <button type = "button" class = "btn btn-primary" > Mið </button>
  4. <button type = "button" class = "btn btn-primary" > Hægri </button>
  5. </div>

Notkun

Virkja hnappa með JavaScript:

  1. $ ( '.nav-tabs' ). hnappur ()

Markup

Gagnaeiginleikar eru óaðskiljanlegur í hnappaviðbótinni. Skoðaðu dæmikóðann hér að neðan fyrir hinar ýmsu álagningargerðir.

Valmöguleikar

Enginn

Aðferðir

$().button('skipta')

Skiptir á ýtastöðu. Gefur hnappinum það útlit að hann hafi verið virkjaður.

Höfuð upp! Þú getur virkjað sjálfvirka skiptingu á hnappi með því að nota data-toggleeigindina.
  1. <button type = "button" class = "btn" data-toggle = "button" > </button>

$().button('hleðsla')

Stillir stöðu hnapps á hleðslu - slekkur á hnappi og breytir texta yfir í hleðslutexta. Hleðslutexti ætti að vera skilgreindur á hnappahlutanum með því að nota gagnaeiginleikann data-loading-text.

  1. <button type = "button" class = "btn" data-loading-text = "hleður efni..." > ... </button>
Höfuð upp! Firefox heldur áfram óvirku ástandi yfir síðuhleðslu . Lausn fyrir þessu er að nota autocomplete="off".

$().button('endurstilla')

Endurstillir stöðu hnapps - skiptir texta yfir í upprunalegan texta.

$().hnappur(strengur)

Endurstillir hnappastöðu - skiptir um texta í hvaða gagnaskilgreinda textastöðu sem er.

  1. <button type = "button" class = "btn" data-complete-text = "lokið!" > ... </hnappur>
  2. <handrit>
  3. $ ( '.btn' ). hnappur ( 'lokið' )
  4. </script>

Um

Fáðu grunnstíl og sveigjanlegan stuðning fyrir samanbrjótanlega hluti eins og harmonikkur og siglingar.

* Krefst þess að Transitions viðbótin sé innifalin.

Dæmi um harmonikku

Með því að nota samrunaviðbótina bjuggum við til einfalda harmonikkustílgræju:

Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad smokkfiski. 3 Wolf moon officia aut, non cupidatat hjólabretti dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua setja fugl á það smokkfiskur einn uppruna kaffi nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur Butcher Vice Lomo. Leggings occaecat handverksbjór frá bæ til borðs, hrár denim fagurfræðilegur synth nesciunt þú hefur líklega ekki heyrt um þá accusamus labore sjálfbær VHS.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad smokkfiski. 3 Wolf moon officia aut, non cupidatat hjólabretti dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua setja fugl á það smokkfiskur einn uppruna kaffi nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur Butcher Vice Lomo. Leggings occaecat handverksbjór frá bæ til borðs, hrár denim fagurfræðilegur synth nesciunt þú hefur líklega ekki heyrt um þá accusamus labore sjálfbær VHS.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad smokkfiski. 3 Wolf moon officia aut, non cupidatat hjólabretti dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua setja fugl á það smokkfiskur einn uppruna kaffi nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur Butcher Vice Lomo. Leggings occaecat handverksbjór frá bæ til borðs, hrár denim fagurfræðilegur synth nesciunt þú hefur líklega ekki heyrt um þá accusamus labore sjálfbær VHS.
  1. <div class = "harmonika" id = "harmonika2" >
  2. <div class = "harmonikkuhópur" >
  3. <div class = "harmonika-heading" >
  4. <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseOne" >
  5. Samanbrjótanlegt hópatriði #1
  6. </a>
  7. </div>
  8. <div id = "collapseOne" class = "harmonikku-líkami hrynur inn" >
  9. <div class = "harmonikku-innri" >
  10. Lífræn klisja...
  11. </div>
  12. </div>
  13. </div>
  14. <div class = "harmonikkuhópur" >
  15. <div class = "harmonika-heading" >
  16. <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseTwo" >
  17. Samanbrjótanlegt hópatriði #2
  18. </a>
  19. </div>
  20. <div id = "collapseTwo" class = "harmonikku-líkamshrun" >
  21. <div class = "harmonikku-innri" >
  22. Lífræn klisja...
  23. </div>
  24. </div>
  25. </div>
  26. </div>
  27. ...

Þú getur líka notað viðbótina án harmonikkumerkingar. Gerðu hnapp til að skipta um stækka og hrun annars þáttar.

  1. <button type = "button" class = "btn btn-danger" data-toggle = "collapse" data-target = "#demo" >
  2. einfalt samanbrjótanlegt
  3. </hnappur>
  4.  
  5. <div id = "demo" class = "hrynja inn" > </div>

Notkun

Í gegnum gagnaeiginleika

Bættu bara við data-toggle="collapse"og a data-targettil þáttur til að úthluta sjálfkrafa stjórn á fellanlegum þætti. Eigindin data-targetsamþykkir css val til að beita samdrættinum á. Vertu viss um að bæta bekknum collapsevið samanbrjótanlega þáttinn. Ef þú vilt að það opni sjálfgefið skaltu bæta við viðbótarflokknum in.

Til að bæta harmónikkulíkri hópstjórnun við samanbrjótanlega stýringu skaltu bæta við gagnaeigindinni data-parent="#selector". Skoðaðu kynninguna til að sjá þetta í aðgerð.

Með JavaScript

Virkja handvirkt með:

  1. $ ( ".collapse" ). hrynja ()

Valmöguleikar

Hægt er að senda valkosti í gegnum gagnaeiginleika eða JavaScript. Fyrir gagnaeiginleika skaltu bæta heiti valkostsins við data-, eins og í data-parent="".

Nafn tegund sjálfgefið lýsingu
foreldri veljara rangt Ef veljara verður öllum samanbrjótanlegum þáttum undir tilgreindu foreldri lokað þegar þetta samanbrjótanlega atriði er sýnt. (svipað og hefðbundin harmonikkuhegðun)
skipta Boolean satt Kveikir á samanbrjótanlegu þættinum við ákall

Aðferðir

.collapse(valkostir)

Virkjar efnið þitt sem samanbrjótanlegan þátt. Samþykkir valfrjálsa valkosti object.

  1. $ ( '#my Collapsible' ). hrynja ({
  2. skipta : rangt
  3. })

.collapse('toggle')

Skiptir um að fellanlegur þáttur sé sýndur eða falinn.

.collapse('show')

Sýnir samanbrjótanlegan þátt.

.collapse('fela')

Felur samanbrjótanlegt frumefni.

Viðburðir

Hrunflokkur Bootstrap afhjúpar nokkra atburði til að tengja sig við hrunvirkni.

Viðburður Lýsing
sýna Þessi atburður ræsir strax þegar showtilviksaðferðin er kölluð.
Sýnt Þessi atburður er ræstur þegar hrunþáttur hefur verið gerður sýnilegur notanda (mun bíða eftir að css umbreytingum ljúki).
fela sig Þessi atburður er ræstur strax þegar hideaðferðin hefur verið kölluð.
falið Þessi atburður er ræstur þegar hrunþáttur hefur verið falinn fyrir notandanum (bíður eftir að css umbreytingum ljúki).
  1. $ ( '#my Collapsible' ). á ( 'falinn' , fall () {
  2. // gera eitthvað…
  3. })

Dæmi

Grunnviðbót, sem auðvelt er að útvíkka, til að búa til glæsilega innslátt á fljótlegan hátt með hvaða textainnslátt sem er.

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

Þú vilt stilla autocomplete="off"til að koma í veg fyrir að sjálfgefna vafravalmyndir birtist yfir Bootstrap typeahead fellilistanum.


Notkun

Í gegnum gagnaeiginleika

Bættu við gagnaeiginleikum til að skrá einingu með typeahead virkni eins og sýnt er í dæminu hér að ofan.

Með JavaScript

Hringdu handvirkt í innsláttinn með:

  1. $ ( '.typeahead' ). slá fram ()

Valmöguleikar

Hægt er að senda valkosti í gegnum gagnaeiginleika eða JavaScript. Fyrir gagnaeiginleika skaltu bæta heiti valkostsins við data-, eins og í data-source="".

Nafn tegund sjálfgefið lýsingu
heimild fylki, virka [ ] Gagnagjafinn til að spyrjast fyrir á móti. Getur verið fylki strengja eða fall. Fallið fær tvö rök, querygildið í innsláttarreitnum og processsvarhringingin. Hægt er að nota aðgerðina samstillt með því að skila gagnagjafanum beint eða ósamstillt með processeinni rifrildi svarhringingarinnar.
hlutir númer 8 Hámarksfjöldi hluta til að birta í fellilistanum.
mínLengd númer 1 Lágmarksstafalengd sem þarf áður en uppástungur um sjálfvirka útfyllingu koma af stað
samsvarandi virka dæmalaus Aðferðin sem notuð er til að ákvarða hvort fyrirspurn passi við hlut. Tekur við einni röksemd, itemsem á að prófa fyrirspurnina gegn. Fáðu aðgang að núverandi fyrirspurn með this.query. Skilaðu boolean trueef fyrirspurn er samsvörun.
flokkari virka nákvæm samsvörun,
hástafaviðkvæm,
hástafanæmi
Aðferð notuð til að flokka niðurstöður sjálfvirkrar útfyllingar. Tekur við einni röksemdafærslu itemsog hefur umfang typeahead tilviksins. Tilvísaðu núverandi fyrirspurn með this.query.
uppfærslur virka skilar völdum hlut Aðferðin sem notuð er til að skila völdum hlut. Samþykkir eina röksemdafærslu, itemog hefur umfang typeahead tilviksins.
hápunktur virka undirstrikar allar sjálfgefnar samsvörun Aðferð notuð til að auðkenna niðurstöður sjálfvirkrar útfyllingar. Tekur við einni röksemdafærslu itemog hefur umfang typeahead tilviksins. Ætti að skila html.

Aðferðir

.typeahead(valkostir)

Frumstillir inntak með innslátt.

Dæmi

Undirleiðsögnin til vinstri er lifandi kynning á affix viðbótinni.


Notkun

Í gegnum gagnaeiginleika

Til að bæta við festuhegðun auðveldlega við hvaða þátt sem er, bættu bara við data-spy="affix"þáttinn sem þú vilt njósna um. Notaðu síðan frávik til að skilgreina hvenær á að kveikja og slökkva á festingu einingar.

  1. <div data-spy = "affix" data-offset-top = "200" > ... </div>
Höfuð upp! Þú verður að stjórna stöðu fests þáttar og hegðun nánasta foreldris hans. Staða er stjórnað af affix, affix-top, og affix-bottom. Mundu að athuga hvort foreldri sé hugsanlega hrunið þegar viðmiðið kemur inn þar sem það er að fjarlægja efni úr venjulegu flæði síðunnar.

Með JavaScript

Hringdu í affix viðbótina í gegnum JavaScript:

  1. $ ( '#navbar' ). festa ()

Valmöguleikar

Hægt er að senda valkosti í gegnum gagnaeiginleika eða JavaScript. Fyrir gagnaeiginleika skaltu bæta heiti valkostsins við data-, eins og í data-offset-top="200".

Nafn tegund sjálfgefið lýsingu
á móti númer | fall | mótmæla 10 Dílar til að vega á móti frá skjánum þegar reiknað er út stöðu skrununar. Ef ein tala er gefin upp verður offsetið beitt bæði efst og til vinstri. Til að hlusta eftir einni stefnu, eða mörgum einstökum frávikum, gefðu bara upp hlut offset: { x: 10 }. Notaðu aðgerð þegar þú þarft að gefa kraftmikinn uppjöfnun (gagnlegt fyrir suma móttækilega hönnun).