JavaScript

Atdzīviniet Bootstrap komponentus — tagad ar 13 pielāgotiem jQuery spraudņiem.

Uzmanību! Šie dokumenti ir paredzēti v2.3.2, kas vairs netiek oficiāli atbalstīts. Apskatiet jaunāko Bootstrap versiju!

Individuāli vai apkopoti

Spraudņus var iekļaut atsevišķi (lai gan dažiem ir nepieciešamas atkarības) vai visus vienlaikus. Gan bootstrap.js , gan bootstrap.min.js satur visus spraudņus vienā failā.

Datu atribūti

Varat izmantot visus Bootstrap spraudņus, izmantojot tikai iezīmēšanas API, neierakstot nevienu JavaScript rindiņu. Šī ir Bootstrap pirmās klases API, un, izmantojot spraudni, tam vajadzētu būt pirmajam apsvērumam.

Tomēr dažās situācijās var būt vēlams šo funkcionalitāti izslēgt. Tāpēc mēs arī nodrošinām iespēju atspējot datu atribūta API, atsaistot visus notikumus pamattekstā, kas atrodas nosaukumvietā ar “data-api”. Tas izskatās šādi:

$('body').off('.data-api')

Alternatīvi, lai atlasītu konkrētu spraudni, vienkārši iekļaujiet spraudņa nosaukumu kā nosaukumvietu kopā ar datu api nosaukumvietu, piemēram:

$('body').off('.alert.data-api')

Programmatiskā API

Mēs arī uzskatām, ka jums vajadzētu būt iespējai izmantot visus Bootstrap spraudņus, tikai izmantojot JavaScript API. Visas publiskās API ir atsevišķas, ķēdējamas metodes, un tās atgriež kolekciju, uz kuru ir veikta darbība.

$(.btn.danger").button("toggle").addClass("tauki")

Visām metodēm ir jāpieņem neobligāto opciju objekts, virkne, kuras mērķis ir noteikta metode, vai nekas (kas iniciē spraudni ar noklusējuma darbību):

$("#myModal").modal() // inicializēts ar noklusējuma iestatījumiem
$("#myModal").modal({ keyboard: false }) // inicializēts bez tastatūras
$("#myModal").modal('show') // nekavējoties inicializē un izsauc šovu

Katrs spraudnis arī parāda savu neapstrādāto konstruktoru īpašumā Constructor: $.fn.popover.Constructor. Ja vēlaties iegūt konkrētu spraudņa instanci, izgūstiet to tieši no elementa: $('[rel=popover]').data('popover').

Bez konflikta

Dažreiz ir nepieciešams izmantot Bootstrap spraudņus ar citiem lietotāja interfeisa ietvariem. Šādos apstākļos dažkārt var rasties nosaukumtelpas sadursmes. Ja tā notiek, varat izsaukt .noConflictspraudni, kura vērtību vēlaties atjaunot.

var bootstrapButton = $.fn.button.noConflict() // atgriež $.fn.button iepriekš piešķirto vērtību
$.fn.bootstrapBtn = bootstrapButton // dod $().bootstrapBtn sāknēšanas funkcionalitāti

Pasākumi

Bootstrap nodrošina pielāgotus notikumus lielākajai daļai spraudņa unikālo darbību. Parasti tie ir infinitīva un pagātnes divdabja formā — kur infinitīvs (piem. show) tiek aktivizēts notikuma sākumā, bet tā pagātnes divdabja forma (piem. shown) tiek aktivizēta, kad darbība ir pabeigta.

Visi infinitīvie notikumi nodrošina preventīvo noklusējuma funkcionalitāti. Tas nodrošina iespēju apturēt darbības izpildi pirms tās sākšanas.

$('#myModal').on('show', function (e) {
    if (!data) return e.preventDefault() // aptur modāla rādīšanu
})

Par pārejām

Lai iegūtu vienkāršus pārejas efektus, vienreiz iekļaujiet bootstrap-transition.js kopā ar citiem JS failiem. Ja izmantojat kompilēto (vai samazināto) bootstrap.js , tas nav jāiekļauj — tas jau ir tur.

Lietošanas gadījumi

Daži pārejas spraudņa piemēri:

  • Slīdēšana vai izbalēšana modālos
  • Cilņu izzušana
  • Brīdinājumu izzušana
  • Bīdāmās karuseļa rūtis

Piemēri

Modāļi ir racionalizēti, bet elastīgi dialoga uzvednes ar minimālo nepieciešamo funkcionalitāti un viedajiem noklusējuma iestatījumiem.

Statisks piemērs

Renderēts modāls ar galveni, pamattekstu un darbību kopu kājenē.

<div class="modal hide fade">
  <div class="modal-header">
    <button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button>
    <h3>Modālā galvene</h3>
  </div>
  <div class="modal-body">
    <p>Viens smalks ķermenis...</p>
  </div>
  <div class="modal-footer">
    <a href="#" class="btn">Aizvērt</a>
    <a href="#" class="btn btn-primary">Saglabājiet izmaiņas</a>
  </div>
</div>

Demo tiešraidē

Pārslēdziet modālu, izmantojot JavaScript, noklikšķinot uz tālāk esošās pogas. Tas noslīdēs uz leju un pazudīs no lapas augšdaļas.

<!-- Modāla aktivizēšanas poga -->
<a href="#myModal" role="button" class="btn" data-toggle="modal">Palaist demonstrācijas modālu</a>

<!-- Modāls -->
<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ālā galvene</h3>
  </div>
  <div class="modal-body">
    <p>Viens smalks ķermenis...</p>
  </div>
  <div class="modal-footer">
    <button class="btn" data-dismiss="modal" aria-hidden="true">Aizvērt</button>
    <button class="btn btn-primary">Saglabāt izmaiņas</button>
  </div>
</div>

Lietošana

Izmantojot datu atribūtus

Aktivizējiet modālu, neierakstot JavaScript. Iestatiet data-toggle="modal"kontroliera elementu, piemēram, pogu, kopā ar data-target="#foo"vai href="#foo", lai atlasītu konkrētu modālu, lai pārslēgtu.

<button type="button" data-toggle="modal" data-target="#myModal">Palaist modālu</button>

Izmantojot JavaScript

Izsauciet modālu ar ID myModalar vienu JavaScript rindiņu:

$('#myModal').modal(options)

Iespējas

Opcijas var nodot, izmantojot datu atribūtus vai JavaScript. Datu atribūtiem pievienojiet opcijas nosaukumu data-, tāpat kā data-backdrop="".

Vārds veids noklusējuma apraksts
fons Būla taisnība Ietver modāla fona elementu. Vai arī norādiet staticfona kolāžu, kas neaizver modālu, noklikšķinot.
tastatūra Būla taisnība Aizver modālu, kad tiek nospiests evakuācijas taustiņš
parādīt Būla taisnība Parāda modālu inicializācijas laikā.
tālvadības pults ceļš viltus

Ja tiek nodrošināts attālais URL, saturs tiks ielādēts, izmantojot jQuery loadmetodi, un ievadīts .modal-body. Ja izmantojat datu api, varat arī izmantot hreftagu, lai norādītu attālo avotu. Piemērs tam ir parādīts zemāk:

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

Metodes

.modal(options)

Aktivizē jūsu saturu kā modālu. Pieņem izvēles opcijas object.

$('#myModal').modal({
  tastatūra: viltus
})

.modal('toggle')

Manuāli pārslēdz modālu.

$('#myModal').modal('toggle')

.modal('show')

Manuāli atver modālu.

$('#myModal').modal('show')

.modal('hide')

Manuāli slēpj modālu.

$('#myModal').modal('slēpt')

Pasākumi

Bootstrap modālā klase atklāj dažus notikumus, lai piesaistītu modālo funkcionalitāti.

Pasākums Apraksts
parādīt Šis notikums tiek aktivizēts nekavējoties, kad showtiek izsaukta instances metode.
parādīts Šis notikums tiek aktivizēts, kad modāls ir padarīts redzams lietotājam (tiks gaidīts, līdz tiks pabeigtas css pārejas).
paslēpties Šis notikums tiek aktivizēts nekavējoties, kad hideir izsaukta instances metode.
paslēptas Šis notikums tiek aktivizēts, kad modāls ir beidzis slēpt no lietotāja (tiks gaidīts, līdz tiks pabeigtas css pārejas).
$('#myModal').on('hidden', function () {
  // dari kaut ko…
})

Piemērs navigācijas joslā

ScrollSpy spraudnis ir paredzēts automātiskai navigācijas mērķu atjaunināšanai, pamatojoties uz ritināšanas pozīciju. Ritiniet apgabalu zem navigācijas joslas un skatieties, kā mainās aktīvā klase. Tiks izcelti arī nolaižamās izvēlnes apakšvienumi.

@resns

Reklāmas legingi keytar, branch id art party dolor labore. Pitchfork yr enim lo-fi, pirms tie tika izpārdoti. Tumblr velosipēdu tiesības no saimniecības līdz galdam neatkarīgi no tā. Anim keffiyeh carles jaka. Velit seitan mcsweeney's foto booth 3 wolf moon irure. Cosby džemperis lomo jean šorti, williamsburg hoodie minim qui jūs droši vien neesat dzirdējuši par tiem un jakas trasta fonds culpa biodiesel wes anderson estētiskā. Nihil tetovēts accusamus, cred ironija biodīzelis keffiyeh artisan ullamco consequat.

@mdo

Veniam marfa ūsu skeitbords, pievilcīga fugiat velit dakšu bārda. Freegan beard aliqua cupidatat mcsweeney's vero. Cupidatat četras loko nisi, ea helvetica nulla carles. Tetovēts Cosby džemperis food truck, Mcsweeney's quis non-freegan vinila. Lo-fi Vess Andersons +1 sartorial. Carles non-estētiskā vingrošana quis ģentrificēt. Brooklyn adipisicing amatniecības alus vice keytar deserunt.

viens

Occaecat commodo aliqua delectus. Fap craft beer deserunt skeitborda ea. Lomo velosipēdu tiesības adipisicing banh mi, velit ea sunt next level locavore vienas izcelsmes kafija magna veniam. High life ID vinils, echo park consequat quis aliquip banh mi pitchfork. Vero VHS est adipisicing. Consectetur nisi DIY minim kurjera soma. Cred ex in, ilgtspējīgs delectus consectetur fanny pack iphone.

divi

Atbalss parkā officia deserunt McVīnija izcilais meistars attīra pērkona kaķus sapiente veniam. Excepteur VHS elit, proidents shoreditch +1 biodīzeļdegvielas laborum craft alus. Vienas izcelsmes kafija wayfarers irure four loko, cupidatat terry richardson master cleanse. Pieņemsim, ka jūs, iespējams, neesat dzirdējuši par tiem art party fanny pack, tetovēts nulla jakas tempor ad. Proident wolf nesciunt sartorial keffiyeh eu banh mi ilgtspējīga. Elit wolf voluptate, lo-fi ea Portland, pirms tie izpārdeva četrus loko. Locavore enim nostrud mlkshk Brooklyn nesciunt.

trīs

Reklāmas legingi keytar, branch id art party dolor labore. Pitchfork yr enim lo-fi, pirms tie tika izpārdoti. Tumblr velosipēdu tiesības no saimniecības līdz galdam neatkarīgi no tā. Anim keffiyeh carles jaka. Velit seitan mcsweeney's foto booth 3 wolf moon irure. Cosby džemperis lomo jean šorti, williamsburg hoodie minim qui jūs droši vien neesat dzirdējuši par tiem un jakas trasta fonds culpa biodiesel wes anderson estētiskā. Nihil tetovēts accusamus, cred ironija biodīzelis keffiyeh artisan ullamco consequat.

Keytar twee blog, culpa kurjersoma marfa whatever delectus food truck. Sapiente synth id uzņemties. Locavore sed helvetica klišeja ironija, pērkona kaķi, par kuriem jūs, iespējams, neesat dzirdējuši, consequat hoodie bez lipekļa lo-fi fap aliquip. Labore elit placeat, pirms tās izpārdotas, frotē Ričardsona proidents vēlās brokastis nesciunt quis cosby džemperis pariatur keffiyeh ut helvetica artisan. Cardigan craft alus seitan readymade velit. VHS chambray laboris tempor veniam. Anim mollit minim commodo ullamco thundercats.


Lietošana

Izmantojot datu atribūtus

Lai augšējās joslas navigācijai viegli pievienotu scrollspy darbību, vienkārši pievienojiet data-spy="scroll"elementu, kuru vēlaties izspiegot (parasti tas ir pamatteksts) data-target=".navbar", un atlasiet, kuru navigāciju izmantot. Jūs vēlaties izmantot scrollspy ar .navkomponentu.

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

Izmantojot JavaScript

Izsauciet scrollspy, izmantojot JavaScript:

$('#navbar').scrollspy()
Uzmanību! Navigācijas joslas saitēm ir jābūt atrisināmiem ID mērķiem. Piemēram, <a href="#home">home</a>ir jāatbilst kaut kam domēnā, piemēram, <div id="home"></div>.

Metodes

.scrollspy('refresh')

Izmantojot scrollspy kopā ar elementu pievienošanu vai noņemšanu no DOM, jums būs jāizsauc atsvaidzināšanas metode, piemēram:

$('[data-spy="scroll"]').each(function () {
  var $spy = $(this).scrollspy('atsvaidzināt')
});

Iespējas

Opcijas var nodot, izmantojot datu atribūtus vai JavaScript. Datu atribūtiem pievienojiet opcijas nosaukumu data-, tāpat kā data-offset="".

Vārds veids noklusējuma apraksts
kompensēt numuru 10 Pikseļi, kas jānobīda no augšas, aprēķinot ritināšanas pozīciju.

Pasākumi

Pasākums Apraksts
aktivizēt Šis notikums tiek aktivizēts ikreiz, kad scrollspy aktivizē jaunu vienumu.

Cilņu piemēri

Pievienojiet ātru, dinamisku ciļņu funkcionalitāti, lai pārietu caur vietējā satura rūtīm, pat izmantojot nolaižamās izvēlnes.

Neapstrādāti džinsi, jūs, iespējams, neesat dzirdējuši par tiem džinsu šorti Austin. Nesciunt tofu stumptown aliqua, retro sintēzes meistara tīrīšana. Ūsas klišeja tempor, williamsburg carles vegan helvetica. Reprehenderit butcher retro keffiyeh Dreamcatcher synth. Cosby džemperis eu banh mi, qui irure terry richardson ex squid. Aliquip placeat Salvia cillum iphone. Seitan aliquip quis kardigāns amerikāņu apģērbs, miesnieks voluptate nisi qui.

Food truck fixie locavore, accusamus mcsweeney's marfa nulla vienas izcelsmes kafijas kalmārs. Exercitation +1 labore velit, blog sartorial PBR legingi next level wes anderson artisan four loko farm-to-table craft beer twee. Qui photo booth augstspiede, commodo enim amatniecības alus mlkshk aliquip džinsu šorti ullamco ad vinyl cillum PBR. Homo nostrud organisks, uzņemts darba estētiskais magna delectus mollit. Keytar helvetica VHS salvia yr, vero magna velit sapiente labore stumptown. Vegan fanny pack odio cillum wes anderson 8-bit, ilgtspējīgi džinsu šorti ar bārdu un DIY ētiski culpa Terry richardson biodīzeli. Mākslas ballīšu scenester stumptown, tumblr miesnieks vero sint qui sapiente accusamus tetovēts echo parks.


Lietošana

Iespējot cilnes, kurās var izmantot JavaScript (katra cilne ir jāaktivizē atsevišķi):

$('#myTab a').click(function (e) {
  e.preventDefault();
  $(this).tab('show');
})

Atsevišķas cilnes var aktivizēt vairākos veidos:

$('#myTab a[href="#profile"]').tab('show'); // Atlasiet cilni pēc nosaukuma
$('#myTab a:first').tab('show'); // Atlasiet pirmo cilni
$('#myTab a:last').tab('show'); // Atlasīt pēdējo cilni
$('#myTab li:eq(2) a').tab('show'); // Atlasīt trešo cilni (indeksēts ar 0)

Atzīmes

Varat aktivizēt cilni vai tabletes navigāciju, nerakstot JavaScript, vienkārši norādot elementu data-toggle="tab"vai data-toggle="pill"uz tā. Pievienojot cilnei navun nav-tabsklases, ultiks lietots Bootstrap cilnes stils.

<ul class="nav nav-tabs">
  <li><a href="#home" data-toggle="tab">Sākums</a></li>
  <li><a href="#profile" data-toggle="tab">Profils</a></li>
  <li><a href="#messages" data-toggle="tab">Ziņojumi</a></li>
  <li><a href="#settings" data-toggle="tab">Iestatījumi</a></li>
</ul>

Metodes

$().tab

Aktivizē cilnes elementu un satura konteineru. Cilnē DOM ir jābūt vai nu konteinera mezglam, data-targetvai tā mērķauditorijas atlasei.href

<ul class="nav nav-tabs" id="myTab">
  <li class="active"><a href="#home">Sākums</a></li>
  <li><a href="#profile">Profils</a></li>
  <li><a href="#messages">Ziņojumi</a></li>
  <li><a href="#settings">Iestatījumi</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>

<skripts>
  $(funkcija () {
    $('#myTab a:last').tab('show');
  })
</script>

Pasākumi

Pasākums Apraksts
parādīt Šis notikums tiek aktivizēts cilnes rādīšanas laikā, bet pirms jaunās cilnes parādīšanas. Izmantojiet event.targetun event.relatedTarget, lai atlasītu attiecīgi aktīvo cilni un iepriekšējo aktīvo cilni (ja pieejama).
parādīts Šis notikums tiek aktivizēts cilnes rādīšanas laikā pēc cilnes parādīšanas. Izmantojiet event.targetun event.relatedTarget, lai atlasītu attiecīgi aktīvo cilni un iepriekšējo aktīvo cilni (ja pieejama).
$('a[data-toggle="tab"]').on('shown', function (e) {
  e.target // aktivizēta cilne
  e.relatedTarget // iepriekšējā cilne
})

Piemēri

Iedvesmojoties no izcilā spraudņa jQuery.tipsy, ko sarakstījis Džeisons Frame; Rīka padomi ir atjaunināta versija, kas nav atkarīga no attēliem, izmanto CSS3 animācijām un datu atribūtus vietējai nosaukumu glabāšanai.

Veiktspējas nolūkos tiek izvēlēts rīka padoms un uznirstošās datu apis, kas nozīmē, ka jums tie ir jāinicializē pašam .

Virziet kursoru virs tālāk esošajām saitēm, lai skatītu rīka padomus:

Stingras bikses nākamā līmeņa keffiyeh jūs, iespējams , neesat dzirdējuši par tām. Foto kabīne bārda neapstrādāta džinsa augstspiedes vegāna kurjera soma stumptown. Seitans no lauku saimniecības līdz galdam, Mcsweeney's fixie ilgtspējīgs quinoa 8 bitu amerikāņu apģērbs ar frotē Ričardsona vinila šambreju. Beard stumptown, jakas banh mi lomo thundercats. Tofu biodīzeļdegviela williamsburg marfa, četras loko mcsweeney's cleanse vegan chambray. Patiešām ironisks amatnieks neatkarīgi no keytar , scenester no saimniecības līdz galdam banksy Austin twitter rokturis freegan cred neapstrādāta džinsa vienas izcelsmes kafijas vīruss.

Četri virzieni

Rīka padomi ievades grupās

Izmantojot rīka padomus un uznirstošos logus ar Bootstrap ievades grupām, jums ir jāiestata containeropcija (dokumentēta tālāk), lai izvairītos no nevēlamām blakusparādībām.


Lietošana

Aktivizējiet rīka padomu, izmantojot JavaScript:

$('#example').rīka padoms(opcijas)

Iespējas

Opcijas var nodot, izmantojot datu atribūtus vai JavaScript. Datu atribūtiem pievienojiet opcijas nosaukumu data-, tāpat kā data-animation="".

Vārds veids noklusējuma apraksts
animācija Būla taisnība lietot css izbalēšanas pāreju uz rīka padomu
html Būla viltus Rīka padomā ievietojiet html. Ja tā ir nepatiesa, jquery textmetode tiks izmantota, lai ievietotu saturu dom. Izmantojiet tekstu, ja uztraucaties par XSS uzbrukumiem.
izvietojumu stīga | funkciju 'tops' kā novietot rīka padomu — augšpusē | apakšā | pa kreisi | pa labi
atlasītājs stīga viltus Ja ir nodrošināts atlasītājs, rīka padomu objekti tiks deleģēti norādītajiem mērķiem.
virsraksts stīga | funkciju '' noklusējuma nosaukuma vērtība, ja nav taga "title".
sprūda stīga "fokuss virs kursora" kā tiek aktivizēts rīka padoms — noklikšķiniet uz | lidināties | fokuss | rokasgrāmata. Ņemiet vērā, ka reģistra pārsūtīšanas trigeri ir vairāki, atdalīti ar atstarpi, trigeru veidi.
kavēšanās numurs | objektu 0

rīka padoma rādīšanas un slēpšanas aizkave (ms) — neattiecas uz manuālo palaišanas veidu

Ja tiek norādīts numurs, aizkave tiek piemērota gan slēpšanai/rādīšanai

Objekta struktūra ir šāda:delay: { show: 500, hide: 100 }

konteiners stīga | viltus viltus

Pievieno rīka padomu noteiktam elementamcontainer: 'body'

Uzmanību!Atsevišķu rīka padomu opcijas var norādīt arī, izmantojot datu atribūtus.

Atzīmes

<a href="#" data-toggle="tooltip" title="first tooltip">virziet kursoru virs manis</a>

Metodes

$().rīka padoms(opcijas)

Elementu kolekcijai pievieno rīku padomu apdarinātāju.

.tooltip('show')

Parāda elementa rīka padomu.

$('#element').tooltip('show')

.tooltip('hide')

Paslēpj elementa rīka padomu.

$('#element').tooltip('slēpt')

.tooltip('toggle')

Pārslēdz elementa rīka padomu.

$('#element').tooltip('toggle')

.tooltip('iznīcināt')

Paslēpj un iznīcina elementa rīka padomu.

$('#element').tooltip('iznīcināt')

Piemēri

Pievienojiet mazus satura pārklājumus, piemēram, iPad, jebkuram elementam, lai ievietotu sekundāro informāciju. Virziet kursoru virs pogas, lai aktivizētu uznirstošo logu. Nepieciešams iekļaut rīka padomu .

Statisks popover

Ir pieejamas četras opcijas: līdzinājums augšā, pa labi, apakšā un pa kreisi.

Popover tops

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

Popover tiesības

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

Popover apakšā

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

Popovers aizgāja

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

Neviens marķējums, kas tiek rādīts kā uznirstošais logs, netiek ģenerēts no JavaScript un satura dataatribūtā.

Demo tiešraidē

Četri virzieni


Lietošana

Iespējot uznirstošos logus, izmantojot JavaScript:

$('#example').popover(options)

Iespējas

Opcijas var nodot, izmantojot datu atribūtus vai JavaScript. Datu atribūtiem pievienojiet opcijas nosaukumu data-, tāpat kā data-animation="".

Vārds veids noklusējuma apraksts
animācija Būla taisnība lietot css izbalēšanas pāreju uz rīka padomu
html Būla viltus Ievietojiet html uznirstošajā logā. Ja tā ir nepatiesa, jquery textmetode tiks izmantota, lai ievietotu saturu dom. Izmantojiet tekstu, ja uztraucaties par XSS uzbrukumiem.
izvietojumu stīga | funkciju 'pa labi' kā novietot uznirstošo logu - augšdaļa | apakšā | pa kreisi | pa labi
atlasītājs stīga viltus ja ir nodrošināts atlasītājs, rīka padomu objekti tiks deleģēti norādītajiem mērķiem
sprūda stīga 'klikšķis' kā tiek aktivizēts popover — noklikšķiniet uz | lidināties | fokuss | rokasgrāmata
virsraksts stīga | funkciju '' noklusējuma nosaukuma vērtība, ja nav atribūta "title".
saturu stīga | funkciju '' noklusējuma satura vērtība, ja nav atribūta "data-content".
kavēšanās numurs | objektu 0

uznirstošā loga rādīšanas un slēpšanas aizkave (ms) — neattiecas uz manuālo palaišanas veidu

Ja tiek norādīts numurs, aizkave tiek piemērota gan slēpšanai/rādīšanai

Objekta struktūra ir šāda:delay: { show: 500, hide: 100 }

konteiners stīga | viltus viltus

Pievieno uznirstošo logu konkrētam elementamcontainer: 'body'

Uzmanību!Atsevišķu uznirstošo logu opcijas var norādīt, izmantojot datu atribūtus.

Atzīmes

Veiktspējas iemeslu dēļ ir izvēlēti rīka padoms un Popover datu apis. Ja vēlaties tos izmantot, vienkārši norādiet atlasītāja opciju.

Metodes

$().popover(options)

Inicializē elementu kolekcijas uznirstošos logus.

.popover('show')

Atklāj elementu popover.

$('#element').popover('show')

.popover('hide')

Slēp elementu uznirstošo logu.

$('#element').popover('slēpt')

.popover('toggle')

Pārslēdz elementu uznirstošo logu.

$('#element').popover('toggle')

.popover('iznīcināt')

Paslēpj un iznīcina elementa uznirstošo logu.

$('#element').popover('iznīcināt')

Brīdinājumu piemēri

Pievienojiet noraidīšanas funkcionalitāti visiem brīdinājuma ziņojumiem, izmantojot šo spraudni.

Svētais gvakamole! Labāk pārbaudiet sevi, jūs neizskatāties pārāk labi.

Ak! Jums radās kļūda!

Mainiet to un to un mēģiniet vēlreiz. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.

Veiciet šo darbību vai dariet to


Lietošana

Iespējot brīdinājuma noraidīšanu, izmantojot JavaScript:

$(".alert").alert()

Atzīmes

Vienkārši pievienojiet data-dismiss="alert"savai aizvēršanas pogai, lai automātiski piešķirtu brīdinājuma aizvēršanas funkcionalitāti.

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

Metodes

$().alert()

Apkopo visus brīdinājumus ar ciešu funkcionalitāti. Lai brīdinājumi tiktu aktivizēti, kad tie ir aizvērti, pārliecinieties, vai tiem ir .fadeun.in jau ir piemērotas kategorijas un

.alert('close')

Aizver brīdinājumu.

$(".alert").alert('close')

Pasākumi

Bootstrap brīdinājumu klase atklāj dažus notikumus, lai piesaistītu brīdinājuma funkcionalitāti.

Pasākums Apraksts
aizveriet Šis notikums tiek aktivizēts nekavējoties, kad closetiek izsaukta instances metode.
slēgts Šis notikums tiek aktivizēts, kad brīdinājums ir aizvērts (gaidīs, līdz tiks pabeigtas css pārejas).
$('#my-alert').bind('closed', function () {
  // dari kaut ko…
})

Izmantošanas piemēri

Padariet vairāk ar pogām. Vadības pogu stāvokļi vai izveidot pogu grupas citiem komponentiem, piemēram, rīkjoslām.

Stateful

Pievienot data-loading-text="Loading...", lai izmantotu pogas ielādes stāvokli.

<button type="button" class="btn btn-primary" data-loading-text="Loading...">Ielādes stāvoklis</button>

Viens pārslēgs

Pievienot data-toggle="button", lai aktivizētu pārslēgšanu uz vienas pogas.

<button type="button" class="btn btn-primary" data-toggle="button">Viena pārslēgšanās</button>

Izvēles rūtiņa

Pievienot data-toggle="buttons-checkbox"izvēles rūtiņas stila pārslēgšanai uz btn-group.

<div class="btn-group" data-toggle="buttons-checkbox">
  <button type="button" class="btn btn-primary">Pa kreisi</button>
  <button type="button" class="btn btn-primary">Vidējā</button>
  <button type="button" class="btn btn-primary">Pa labi</button>
</div>

Radio

Pievienot data-toggle="buttons-radio"radio stila pārslēgšanai btn-grupā.

<div class="btn-group" data-toggle="buttons-radio">
  <button type="button" class="btn btn-primary">Pa kreisi</button>
  <button type="button" class="btn btn-primary">Vidējā</button>
  <button type="button" class="btn btn-primary">Pa labi</button>
</div>

Lietošana

Iespējot pogas, izmantojot JavaScript:

$('.nav-tabs').button()

Atzīmes

Datu atribūti ir pogas spraudņa sastāvdaļa. Apskatiet tālāk sniegto koda piemēru dažādiem iezīmēšanas veidiem.

Iespējas

Nav

Metodes

$().button('toggle')

Pārslēdz push stāvokli. Piešķir pogai tādu izskatu, ka tā ir aktivizēta.

Uzmanību! Varat iespējot automātisku pogas pārslēgšanu, izmantojot data-toggleatribūtu.
<button type="button" class="btn" data-toggle="button" >…</button>

$().button('ielādē')

Iestata pogas stāvokli uz ielādi — atspējo pogu un apmaina tekstu ar teksta ielādi. Ielādes teksts ir jādefinē pogas elementā, izmantojot datu atribūtu data-loading-text.

<button type="button" class="btn" data-loading-text="ielādē lietas..." >...</button>
Uzmanību! Firefox saglabā atspējošanas stāvokli visā lapas ielādes laikā . Risinājums tam ir izmantot autocomplete="off".

$().button('atiestatīt')

Atiestata pogas stāvokli — apmaina tekstu ar sākotnējo tekstu.

$().poga(virkne)

Atiestata pogas stāvokli — maina tekstu uz jebkuru datu definēto teksta stāvokli.

<button type="button" class="btn" data-complete-text="pabeigts!" >...</button>
<skripts>
  $('.btn').button('complete')
</script>

Par

Iegūstiet pamata stilus un elastīgu atbalstu saliekamām sastāvdaļām, piemēram, akordeoniem un navigācijai.

* Nepieciešams iekļaut pāreju spraudni.

Akordeona piemērs

Izmantojot sakļautības spraudni, mēs izveidojām vienkāršu akordeona stila logrīku:

Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad kalmārs. 3 wolf moon officia aute, non cupidatat skateboard dolor branch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a put on it kalmārs vienas izcelsmes kafija nulla guessnda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Reklāma vegan izņemoteur miesnieks vice lomo. Legingi occaecat amatniecības alus no saimniecības līdz galdam, neapstrādāta džinsa estētiskā sintēze, iespējams, neesat par tiem dzirdējuši accusamus labore ilgtspējīgu VHS.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad kalmārs. 3 wolf moon officia aute, non cupidatat skateboard dolor branch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a put on it kalmārs vienas izcelsmes kafija nulla guessnda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Reklāma vegan izņemoteur miesnieks vice lomo. Legingi occaecat amatniecības alus no saimniecības līdz galdam, neapstrādāta džinsa estētiskā sintēze, iespējams, neesat par tiem dzirdējuši accusamus labore ilgtspējīgu VHS.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad kalmārs. 3 wolf moon officia aute, non cupidatat skateboard dolor branch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a put on it kalmārs vienas izcelsmes kafija nulla guessnda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Reklāma vegan izņemoteur miesnieks vice lomo. Legingi occaecat amatniecības alus no saimniecības līdz galdam, neapstrādāta džinsa estētiskā sintēze, iespējams, neesat par tiem dzirdējuši accusamus labore ilgtspējīgu VHS.
<div class="accordion" id="accordion2">
  <div class="accordion-group">
    <div class="accordion-heading">
      <a class="accordion-toggle" data-toggle="collapse" data-parent="#accordion2" href="#collapseOne">
        Saliekams grupas vienums Nr. 1
      </a>
    </div>
    <div id="collapseOne" class="accordion-body collapse in">
      <div class="accordion-inner">
        Anim pariatur klišeja...
      </div>
    </div>
  </div>
  <div class="accordion-group">
    <div class="accordion-heading">
      <a class="accordion-toggle" data-toggle="collapse" data-parent="#accordion2" href="#collapseTwo">
        Saliekams grupas vienums Nr. 2
      </a>
    </div>
    <div id="collapseTwo" class="accordion-body collapse">
      <div class="accordion-inner">
        Anim pariatur klišeja...
      </div>
    </div>
  </div>
</div>
...

Varat arī izmantot spraudni bez akordeona marķējuma. Padariet pogu, lai pārslēgtu cita elementa izvēršanu un sakļaušanu.

<button type="button" class="btn btn-danger" data-toggle="collapse" data-target="#demo">
  vienkārši saliekams
</button>

<div id="demo" class="collapse in"> … </div>

Lietošana

Izmantojot datu atribūtus

Vienkārši pievienojiet data-toggle="collapse"un data-targetelementam, lai automātiski piešķirtu saliekamā elementa vadību. Atribūts data-targetakceptē css atlasītāju, kam lietot sakļauto. Noteikti pievienojiet klasi collapsesaliekamajam elementam. Ja vēlaties, lai tas tiktu atvērts pēc noklusējuma, pievienojiet papildu klasi in.

Lai saliekamai vadīklai pievienotu akordeonam līdzīgu grupu pārvaldību, pievienojiet datu atribūtu data-parent="#selector". Skatiet demonstrāciju, lai redzētu to darbībā.

Izmantojot JavaScript

Iespējot manuāli, izmantojot:

$(.collapse").collapse()

Iespējas

Opcijas var nodot, izmantojot datu atribūtus vai JavaScript. Datu atribūtiem pievienojiet opcijas nosaukumu data-, tāpat kā data-parent="".

Vārds veids noklusējuma apraksts
vecāks atlasītājs viltus Ja atlasītājs, tad visi sakļaujamie elementi zem norādītā vecāka tiks aizvērti, kad tiek parādīts šis saliekamais vienums. (līdzīgi tradicionālajai akordeona uzvedībai)
pārslēgt Būla taisnība Pārslēdz saliekamo elementu izsaukšanas laikā

Metodes

.collapse(options)

Aktivizē jūsu saturu kā saliekamu elementu. Pieņem izvēles opcijas object.

$('#myCollapsible').collapse({
  pārslēgt: viltus
})

.collapse('toggle')

Pārslēdz saliekamo elementu uz parādīto vai paslēpto.

.collapse('show')

Parāda saliekamu elementu.

.collapse('slēpt')

Slēpj saliekamu elementu.

Pasākumi

Bootstrap sabrukšanas klase atklāj dažus notikumus, lai piesaistītu sabrukšanas funkcionalitāti.

Pasākums Apraksts
parādīt Šis notikums tiek aktivizēts nekavējoties, kad showtiek izsaukta instances metode.
parādīts Šis notikums tiek aktivizēts, kad sakļautais elements ir padarīts redzams lietotājam (tiks gaidīts, līdz tiks pabeigtas css pārejas).
paslēpties Šis notikums tiek aktivizēts nekavējoties, kad hidemetode ir izsaukta.
paslēptas Šis notikums tiek aktivizēts, kad lietotājam ir paslēpts sakļautais elements (tiks gaidīts, līdz tiks pabeigtas css pārejas).
$('#myCollapsible').on('hidden', function () {
  // dari kaut ko…
})

Piemērs

Vienkāršs, viegli paplašināms spraudnis, lai ātri izveidotu elegantas veidlapas ar jebkura veida teksta ievadi.

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

Vēlaties iestatīt autocomplete="off", lai noklusējuma pārlūkprogrammas izvēlnes netiktu rādītas nolaižamajā izvēlnē Bootstrap typeahead.


Lietošana

Izmantojot datu atribūtus

Pievienojiet datu atribūtus, lai reģistrētu elementu ar priekšraksta funkcionalitāti, kā parādīts iepriekš minētajā piemērā.

Izmantojot JavaScript

Manuāli izsauciet veidlapu, izmantojot:

$('.typeahead').typeahead()

Iespējas

Opcijas var nodot, izmantojot datu atribūtus vai JavaScript. Datu atribūtiem pievienojiet opcijas nosaukumu data-, tāpat kā data-source="".

Vārds veids noklusējuma apraksts
avots masīvs, funkcija [ ] Datu avots, pret kuru veikt vaicājumu. Var būt virkņu masīvs vai funkcija. Funkcijai tiek nodoti divi argumenti: queryvērtība ievades laukā un processatzvanīšana. Funkciju var izmantot sinhroni, tieši vai asinhroni atgriežot datu avotu, izmantojot processatzvanīšanas vienu argumentu.
preces numuru 8 Maksimālais vienumu skaits, kas jāparāda nolaižamajā izvēlnē.
minLength numuru 1 Minimālais rakstzīmju garums, kas nepieciešams pirms automātiskās pabeigšanas ieteikumu aktivizēšanas
saskaņotājs funkciju reģistrjutīgs Metode, ko izmanto, lai noteiktu, vai vaicājums atbilst vienumam. Pieņem vienu argumentu, itempret kuru pārbaudīt vaicājumu. Piekļūstiet pašreizējam vaicājumam, izmantojot this.query. Atgriež Būla vērtību, trueja vaicājums atbilst.
šķirotājs funkciju precīza atbilstība,
reģistrjutīgs,
reģistrjutīgs
Automātiskās pabeigšanas rezultātu kārtošanai izmantotā metode. Pieņem vienu argumentu items, un tam ir priekšraksta instances darbības joma. Atsauci uz pašreizējo vaicājumu ar this.query.
atjauninātājs funkciju atgriež atlasīto vienumu Metode, kas tiek izmantota atlasītās preces atgriešanai. Pieņem vienu argumentu un, itemkam ir priekšraksta instances darbības joma.
marķieris funkciju izceļ visas noklusējuma atbilstības Metode, ko izmanto, lai izceltu automātiskās pabeigšanas rezultātus. Pieņem vienu argumentu item, un tam ir priekšraksta instances darbības joma. Jāatgriež html.

Metodes

.typeahead(options)

Inicializē ievadi ar ievadrakstu.

Piemērs

Kreisajā pusē esošā apakšnavigācija ir afiksa spraudņa tiešraides demonstrācija.


Lietošana

Izmantojot datu atribūtus

Lai jebkuram elementam viegli pievienotu piedēkļu darbību, vienkārši pievienojietdata-spy="affix" elementam, kuru vēlaties izspiegot. Pēc tam izmantojiet nobīdes, lai noteiktu, kad jāieslēdz un jāizslēdz elementa piespraušana.

<div data-spy="affix" data-offset-top="200">...</div>
Uzmanību! Jums ir jāpārvalda piespraustā elementa pozīcija un tā tiešā vecāka uzvedība. Pozīciju kontrolē affix, affix-top, un affix-bottom. Neaizmirstiet pārbaudīt, vai nav potenciāli sakļauts vecāks, kad pielikums tiek aktivizēts, jo tas noņem saturu no parastās lapas plūsmas.

Izmantojot JavaScript

Izsauciet afiksa spraudni, izmantojot JavaScript:

$('#navbar').affix()

Iespējas

Opcijas var nodot, izmantojot datu atribūtus vai JavaScript. Datu atribūtiem pievienojiet opcijas nosaukumu data-, tāpat kā data-offset-top="200".

Vārds veids noklusējuma apraksts
kompensēt numurs | funkcija | objektu 10 Pikseļi, kas jānobīda no ekrāna, aprēķinot ritināšanas pozīciju. Ja tiek norādīts viens skaitlis, nobīde tiks piemērota gan augšējā, gan kreisā virzienā. Lai noklausītos vienu virzienu vai vairākas unikālas nobīdes, vienkārši norādiet objektu offset: { x: 10 }. Izmantojiet funkciju, ja nepieciešams dinamiski nodrošināt nobīdi (noderīga dažiem adaptīviem dizainiem).