Pregled

Posamezno ali sestavljeno

Vtičnike je mogoče vključiti posamezno (z uporabo posameznih *.jsdatotek Bootstrapa) ali vse naenkrat (z uporabo bootstrap.jsali pomanjšanim bootstrap.min.js).

Uporaba prevedenega JavaScripta

Oba bootstrap.jsin bootstrap.min.jsvsebujeta vse vtičnike v eni datoteki. Vključi samo eno.

Odvisnosti vtičnikov

Nekateri vtičniki in komponente CSS so odvisni od drugih vtičnikov. Če dodate vtičnike posamezno, preverite te odvisnosti v dokumentih. Upoštevajte tudi, da so vsi vtičniki odvisni od jQuery (to pomeni, da mora biti jQuery vključen pred datotekami vtičnikov). Posvetujte se z našimibower.json , da vidite, katere različice jQuery so podprte.

Atributi podatkov

Vse vtičnike Bootstrap lahko uporabljate izključno prek API-ja za označevanje, ne da bi napisali eno vrstico JavaScripta. To je prvorazredni API Bootstrapa in bi ga morali najprej upoštevati pri uporabi vtičnika.

Kljub temu je v nekaterih situacijah morda zaželeno, da to funkcijo izklopite. Zato nudimo tudi možnost onemogočanja API-ja atributa podatkov tako, da razvežete vse dogodke v imenskem prostoru dokumenta z data-api. To izgleda takole:

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

Druga možnost je, da ciljate na določen vtičnik, samo vključite ime vtičnika kot imenski prostor skupaj z imenskim prostorom data-api, kot je ta:

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

Samo en vtičnik na element prek atributov podatkov

Ne uporabljajte atributov podatkov iz več vtičnikov na istem elementu. Na primer, gumb ne more hkrati imeti namiga za orodje in preklopiti modala. Če želite to narediti, uporabite ovojni element.

Programski API

Prav tako verjamemo, da bi morali imeti možnost uporabljati vse vtičnike Bootstrap zgolj prek JavaScript API-ja. Vsi javni API-ji so enojne metode, ki jih je mogoče verižiti, in vrnejo zbirko, po kateri je ukrepal.

$('.btn.danger').button('toggle').addClass('fat')

Vse metode morajo sprejeti izbirni predmet možnosti, niz, ki cilja na določeno metodo, ali nič (kar sproži vtičnik s privzetim vedenjem):

$('#myModal').modal()                      // initialized with defaults
$('#myModal').modal({ keyboard: false })   // initialized with no keyboard
$('#myModal').modal('show')                // initializes and invokes show immediately

Vsak vtičnik izpostavi tudi svoj neobdelani konstruktor v Constructorlastnosti: $.fn.popover.Constructor. Če želite dobiti določen primerek vtičnika, ga pridobite neposredno iz elementa: $('[rel="popover"]').data('popover').

Privzete nastavitve

Privzete nastavitve za vtičnik lahko spremenite tako, da spremenite predmet vtičnika Constructor.DEFAULTS:

$.fn.modal.Constructor.DEFAULTS.keyboard = false // changes default for the modal plugin's `keyboard` option to false

Brez konflikta

Včasih je treba uporabiti vtičnike Bootstrap z drugimi okviri uporabniškega vmesnika. V teh okoliščinah lahko občasno pride do kolizij imenskega prostora. Če se to zgodi, lahko pokličete .noConflictvtičnik, katerega vrednost želite razveljaviti.

var bootstrapButton = $.fn.button.noConflict() // return $.fn.button to previously assigned value
$.fn.bootstrapBtn = bootstrapButton            // give $().bootstrapBtn the Bootstrap functionality

Dogodki

Bootstrap ponuja dogodke po meri za večino edinstvenih dejanj vtičnikov. Na splošno so ti v obliki nedoločnika in deležnika preteklosti – kjer se nedoločnik (npr. show) sproži na začetku dogodka, njegova oblika deležnika preteklosti (npr. shown) pa se sproži ob zaključku dejanja.

Od 3.0.0 so vsi dogodki Bootstrap v imenskem prostoru.

Vsi nedoločni dogodki zagotavljajo preventDefaultfunkcionalnost. To omogoča, da ustavite izvajanje dejanja, preden se začne.

$('#myModal').on('show.bs.modal', function (e) {
  if (!data) return e.preventDefault() // stops modal from being shown
})

Razkužilo

Namigi orodij in pojavni elementi uporabljajo naš vgrajeni čistilec za čiščenje možnosti, ki sprejemajo HTML.

Privzeta whiteListvrednost je naslednja:

var ARIA_ATTRIBUTE_PATTERN = /^aria-[\w-]*$/i
var DefaultWhitelist = {
  // Global attributes allowed on any supplied element below.
  '*': ['class', 'dir', 'id', 'lang', 'role', ARIA_ATTRIBUTE_PATTERN],
  a: ['target', 'href', 'title', 'rel'],
  area: [],
  b: [],
  br: [],
  col: [],
  code: [],
  div: [],
  em: [],
  hr: [],
  h1: [],
  h2: [],
  h3: [],
  h4: [],
  h5: [],
  h6: [],
  i: [],
  img: ['src', 'alt', 'title', 'width', 'height'],
  li: [],
  ol: [],
  p: [],
  pre: [],
  s: [],
  small: [],
  span: [],
  sub: [],
  sup: [],
  strong: [],
  u: [],
  ul: []
}

Če želite tej privzeti vrednosti dodati nove vrednosti whiteList, lahko storite naslednje:

var myDefaultWhiteList = $.fn.tooltip.Constructor.DEFAULTS.whiteList

// To allow table elements
myDefaultWhiteList.table = []

// To allow td elements and data-option attributes on td elements
myDefaultWhiteList.td = ['data-option']

// You can push your custom regex to validate your attributes.
// Be careful about your regular expressions being too lax
var myCustomRegex = /^data-my-app-[\w-]+/
myDefaultWhiteList['*'].push(myCustomRegex)

Če želite zaobiti naš sanitizer, ker raje uporabljate namensko knjižnico, na primer DOMPurify , storite naslednje:

$('#yourTooltip').tooltip({
  sanitizeFn: function (content) {
    return DOMPurify.sanitize(content)
  }
})

Brskalniki brezdocument.implementation.createHTMLDocument

V primeru brskalnikov, ki ne podpirajo document.implementation.createHTMLDocument, kot je Internet Explorer 8, vgrajena funkcija saniranja vrne HTML, kot je.

Če želite v tem primeru izvesti sanacijo, navedite sanitizeFnin uporabite zunanjo knjižnico, kot je DOMPurify .

Številke različic

Do različice vsakega od Bootstrapovih vtičnikov jQuery je mogoče dostopati prek VERSIONlastnosti konstruktorja vtičnika. Na primer za vtičnik orodnih namigov:

$.fn.tooltip.Constructor.VERSION // => "3.4.1"

Ni posebnih nadomestnih možnosti, ko je JavaScript onemogočen

Bootstrapovi vtičniki se ne vrnejo posebej elegantno, ko je JavaScript onemogočen. Če vam je mar za uporabniško izkušnjo v tem primeru, uporabite, <noscript>da svojim uporabnikom pojasnite situacijo (in kako znova omogočiti JavaScript) in/ali dodajte lastne nadomestne možnosti po meri.

Knjižnice tretjih oseb

Bootstrap uradno ne podpira knjižnic JavaScript tretjih oseb, kot sta Prototype ali jQuery UI. Kljub .noConflictdogodkom in imenskim prostorom lahko pride do težav z združljivostjo, ki jih morate odpraviti sami.

Prehodi conversion.js

O prehodih

Za preproste učinke prehoda vključite transition.jsenkrat poleg drugih datotek JS. Če uporabljate prevedeno (ali zmanjšano) bootstrap.js, tega ni treba vključiti – že je tam.

Kaj je notri

Transition.js je osnovni pomočnik za transitionEnddogodke, pa tudi emulator prehodov CSS. Uporabljajo ga drugi vtičniki za preverjanje podpore za prehode CSS in za lovljenje visečih prehodov.

Onemogočanje prehodov

Prehode je mogoče globalno onemogočiti z naslednjim delčkom JavaScripta, ki mora priti po nalaganju transition.js(ali bootstrap.jsali bootstrap.min.js, odvisno od primera):

$.support.transition = false

Modali modal.js

Modali so poenostavljeni, a prilagodljivi pogovorni pozivi z minimalno zahtevano funkcionalnostjo in pametnimi privzetimi nastavitvami.

Več odprtih načinov ni podprtih

Pazite, da ne odprete modala, medtem ko je drug še viden. Za prikaz več kot enega modala hkrati je potrebna koda po meri.

Postavitev modalne oznake

Kodo HTML modala vedno poskušajte postaviti na najvišji položaj v dokumentu, da preprečite, da bi druge komponente vplivale na videz in/ali funkcionalnost modala.

Opozorila glede mobilnih naprav

Obstaja nekaj opozoril glede uporabe načinov na mobilnih napravah. Za podrobnosti si oglejte naše podporne dokumente za brskalnik .

Zaradi tega, kako HTML5 opredeljuje svojo semantiko, autofocusatribut HTML nima vpliva na modale Bootstrap. Če želite doseči enak učinek, uporabite JavaScript po meri:

$('#myModal').on('shown.bs.modal', function () {
  $('#myInput').focus()
})

Primeri

Statični primer

Upodobljen modal z glavo, telesom in nizom dejanj v nogi.

<div class="modal fade" tabindex="-1" role="dialog">
  <div class="modal-dialog" role="document">
    <div class="modal-content">
      <div class="modal-header">
        <button type="button" class="close" data-dismiss="modal" aria-label="Close"><span aria-hidden="true">&times;</span></button>
        <h4 class="modal-title">Modal title</h4>
      </div>
      <div class="modal-body">
        <p>One fine body&hellip;</p>
      </div>
      <div class="modal-footer">
        <button type="button" class="btn btn-default" data-dismiss="modal">Close</button>
        <button type="button" class="btn btn-primary">Save changes</button>
      </div>
    </div><!-- /.modal-content -->
  </div><!-- /.modal-dialog -->
</div><!-- /.modal -->

Demo v živo

Preklopite modal prek JavaScripta s klikom na spodnji gumb. Zdrsel bo navzdol in zbledel z vrha strani.

<!-- Button trigger modal -->
<button type="button" class="btn btn-primary btn-lg" data-toggle="modal" data-target="#myModal">
  Launch demo modal
</button>

<!-- Modal -->
<div class="modal fade" id="myModal" tabindex="-1" role="dialog" aria-labelledby="myModalLabel">
  <div class="modal-dialog" role="document">
    <div class="modal-content">
      <div class="modal-header">
        <button type="button" class="close" data-dismiss="modal" aria-label="Close"><span aria-hidden="true">&times;</span></button>
        <h4 class="modal-title" id="myModalLabel">Modal title</h4>
      </div>
      <div class="modal-body">
        ...
      </div>
      <div class="modal-footer">
        <button type="button" class="btn btn-default" data-dismiss="modal">Close</button>
        <button type="button" class="btn btn-primary">Save changes</button>
      </div>
    </div>
  </div>
</div>

Naj bodo modali dostopni

Prepričajte se, da ste dodali role="dialog"in aria-labelledby="...", ki se sklicuje na modalni naslov, k .modalin role="document"k .modal-dialogsamemu.

Poleg tega lahko podate opis svojega modalnega pogovornega okna z aria-describedbyon .modal.

Vdelava YouTube videoposnetkov

Vdelava YouTube videoposnetkov v modale zahteva dodaten JavaScript, ki ni v programu Bootstrap, za samodejno zaustavitev predvajanja in več. Za več informacij si oglejte to koristno objavo Stack Overflow .

Izbirne velikosti

Modali imajo dve izbirni velikosti, ki sta na voljo prek modifikatorskih razredov, ki jih je treba postaviti na .modal-dialog.

<!-- Large modal -->
<button type="button" class="btn btn-primary" data-toggle="modal" data-target=".bs-example-modal-lg">Large modal</button>

<div class="modal fade" tabindex="-1" role="dialog" aria-labelledby="myLargeModalLabel">
  <div class="modal-dialog modal-lg" role="document">
    <div class="modal-content">
      ...
    </div>
  </div>
</div>

<!-- Small modal -->
<button type="button" class="btn btn-primary" data-toggle="modal" data-target=".bs-example-modal-sm">Small modal</button>

<div class="modal fade" tabindex="-1" role="dialog" aria-labelledby="mySmallModalLabel">
  <div class="modal-dialog modal-sm" role="document">
    <div class="modal-content">
      ...
    </div>
  </div>
</div>

Odstrani animacijo

Za modale, ki se preprosto prikažejo, namesto da bi zbledeli, odstranite .faderazred iz svoje modalne oznake.

<div class="modal" tabindex="-1" role="dialog" aria-labelledby="...">
  ...
</div>

Uporaba mrežnega sistema

Če želite izkoristiti omrežni sistem Bootstrap znotraj modalnega, samo ugnezdite .rows znotraj .modal-bodyin nato uporabite običajne razrede omrežnega sistema.

<div class="modal fade" tabindex="-1" role="dialog" aria-labelledby="gridSystemModalLabel">
  <div class="modal-dialog" role="document">
    <div class="modal-content">
      <div class="modal-header">
        <button type="button" class="close" data-dismiss="modal" aria-label="Close"><span aria-hidden="true">&times;</span></button>
        <h4 class="modal-title" id="gridSystemModalLabel">Modal title</h4>
      </div>
      <div class="modal-body">
        <div class="row">
          <div class="col-md-4">.col-md-4</div>
          <div class="col-md-4 col-md-offset-4">.col-md-4 .col-md-offset-4</div>
        </div>
        <div class="row">
          <div class="col-md-3 col-md-offset-3">.col-md-3 .col-md-offset-3</div>
          <div class="col-md-2 col-md-offset-4">.col-md-2 .col-md-offset-4</div>
        </div>
        <div class="row">
          <div class="col-md-6 col-md-offset-3">.col-md-6 .col-md-offset-3</div>
        </div>
        <div class="row">
          <div class="col-sm-9">
            Level 1: .col-sm-9
            <div class="row">
              <div class="col-xs-8 col-sm-6">
                Level 2: .col-xs-8 .col-sm-6
              </div>
              <div class="col-xs-4 col-sm-6">
                Level 2: .col-xs-4 .col-sm-6
              </div>
            </div>
          </div>
        </div>
      </div>
      <div class="modal-footer">
        <button type="button" class="btn btn-default" data-dismiss="modal">Close</button>
        <button type="button" class="btn btn-primary">Save changes</button>
      </div>
    </div><!-- /.modal-content -->
  </div><!-- /.modal-dialog -->
</div><!-- /.modal -->

Imate kup gumbov, ki sprožijo isti način, le z nekoliko drugačno vsebino? Uporabite atributeevent.relatedTarget in HTMLdata-* (po možnosti prek jQuery ), da spremenite vsebino modala glede na to, kateri gumb je bil kliknjen. Oglejte si dokumente o modalnih dogodkih za podrobnosti o relatedTarget,

... več gumbov ...
<button type="button" class="btn btn-primary" data-toggle="modal" data-target="#exampleModal" data-whatever="@mdo">Open modal for @mdo</button>
<button type="button" class="btn btn-primary" data-toggle="modal" data-target="#exampleModal" data-whatever="@fat">Open modal for @fat</button>
<button type="button" class="btn btn-primary" data-toggle="modal" data-target="#exampleModal" data-whatever="@getbootstrap">Open modal for @getbootstrap</button>
...more buttons...

<div class="modal fade" id="exampleModal" tabindex="-1" role="dialog" aria-labelledby="exampleModalLabel">
  <div class="modal-dialog" role="document">
    <div class="modal-content">
      <div class="modal-header">
        <button type="button" class="close" data-dismiss="modal" aria-label="Close"><span aria-hidden="true">&times;</span></button>
        <h4 class="modal-title" id="exampleModalLabel">New message</h4>
      </div>
      <div class="modal-body">
        <form>
          <div class="form-group">
            <label for="recipient-name" class="control-label">Recipient:</label>
            <input type="text" class="form-control" id="recipient-name">
          </div>
          <div class="form-group">
            <label for="message-text" class="control-label">Message:</label>
            <textarea class="form-control" id="message-text"></textarea>
          </div>
        </form>
      </div>
      <div class="modal-footer">
        <button type="button" class="btn btn-default" data-dismiss="modal">Close</button>
        <button type="button" class="btn btn-primary">Send message</button>
      </div>
    </div>
  </div>
</div>
$('#exampleModal').on('show.bs.modal', function (event) {
  var button = $(event.relatedTarget) // Button that triggered the modal
  var recipient = button.data('whatever') // Extract info from data-* attributes
  // If necessary, you could initiate an AJAX request here (and then do the updating in a callback).
  // Update the modal's content. We'll use jQuery here, but you could use a data binding library or other methods instead.
  var modal = $(this)
  modal.find('.modal-title').text('New message to ' + recipient)
  modal.find('.modal-body input').val(recipient)
})

Uporaba

Modalni vtičnik preklaplja vašo skrito vsebino na zahtevo prek podatkovnih atributov ali JavaScripta. Doda .modal-opentudi <body>k preglasitvi privzetega vedenja drsenja in ustvari .modal-backdropobmočje za klikanje za opustitev prikazanih modal, ko kliknete zunaj modala.

Preko podatkovnih atributov

Aktivirajte modal brez pisanja JavaScripta. Nastavite data-toggle="modal"na element krmilnika, kot je gumb, skupaj z data-target="#foo"ali href="#foo"za ciljanje določenega načina za preklop.

<button type="button" data-toggle="modal" data-target="#myModal">Launch modal</button>

Prek JavaScripta

Pokličite modal z ID -jem myModalz eno vrstico JavaScripta:

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

Opcije

Možnosti je mogoče posredovati prek podatkovnih atributov ali JavaScripta. Za atribute podatkov pripnite ime možnosti v data-, kot v data-backdrop="".

Ime vrsta privzeto opis
ozadje boolean ali niz'static' prav Vključuje element modalne kulise. Druga možnost je, da določite staticza ozadje, ki ob kliku ne zapre modala.
tipkovnico logično prav Zapre modal, ko pritisnete tipko za izhod
pokazati logično prav Pri inicializaciji prikaže modal.
na daljavo pot lažno

Ta možnost je zastarela od različice 3.3.0 in je bila odstranjena v različici 4. Namesto tega priporočamo uporabo predlog na strani odjemalca ali ogrodje za vezavo podatkov ali pa sami pokličete jQuery.load .

Če je na voljo oddaljeni URL, bo vsebina naložena enkrat prek loadmetode jQuery in vstavljena v .modal-contentdiv. Če uporabljate data-api, lahko alternativno uporabite hrefatribut za določitev oddaljenega vira. Primer tega je prikazan spodaj:

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

Metode

Aktivira vašo vsebino kot modalno. Sprejema neobvezne možnosti object.

$('#myModal').modal({
  keyboard: false
})

Ročno preklopi modal. Vrne se klicatelju, preden je modal dejansko prikazan ali skrit (tj. preden pride do dogodka shown.bs.modalali ).hidden.bs.modal

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

Ročno odpre modal. Vrne se klicatelju, preden je modal dejansko prikazan (tj. preden shown.bs.modalpride do dogodka).

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

Ročno skrije modal. Vrne se klicatelju, preden je bil modal dejansko skrit (tj. preden hidden.bs.modalpride do dogodka).

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

Ponovno prilagodi položaj modala, da prepreči drsni trak, če bi se pojavil, zaradi česar bi modal skočil v levo.

Potreben le, če se višina modala spremeni, ko je odprt.

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

Dogodki

Modalni razred Bootstrapa izpostavlja nekaj dogodkov za priključitev na modalno funkcionalnost.

Vsi modalni dogodki se sprožijo na samem modalu (tj. na <div class="modal">).

Vrsta dogodka Opis
show.bs.modal Ta dogodek se sproži takoj, ko showse pokliče metoda primerka. Če je vzrok klik, je kliknjeni element na voljo kot relatedTargetlastnost dogodka.
prikazano.bs.modal Ta dogodek se sproži, ko je modal viden uporabniku (počakal bo, da se zaključijo prehodi CSS). Če je vzrok klik, je kliknjeni element na voljo kot relatedTargetlastnost dogodka.
hide.bs.modal Ta dogodek se sproži takoj, ko hideje bila poklicana metoda primerka.
skrito.bs.modal Ta dogodek se sproži, ko je modal prenehal biti skrit pred uporabnikom (počakal bo, da se zaključijo prehodi CSS).
loaded.bs.modal Ta dogodek se sproži, ko je modal naložil vsebino z remotemožnostjo.
$('#myModal').on('hidden.bs.modal', function (e) {
  // do something...
})

Spustni meniji dropdown.js

S tem preprostim vtičnikom dodajte spustne menije skoraj vsemu, vključno z navbarom, zavihki in pilulami.

Znotraj vrstice za krmarjenje

Znotraj tablet

Spustni vtičnik prek podatkovnih atributov ali JavaScripta preklopi skrito vsebino (spustne menije) tako, da preklopi .openrazred na nadrejenem elementu seznama.

V mobilnih napravah odpiranje spustnega menija doda .dropdown-backdropkot območje za dotik za zapiranje spustnih menijev, ko tapnete zunaj menija, kar je zahteva za ustrezno podporo za iOS. To pomeni, da preklop z odprtega spustnega menija na drug spustni meni zahteva dodaten dotik na mobilni napravi.

Opomba: data-toggle="dropdown"atribut se uporablja za zapiranje spustnih menijev na ravni aplikacije, zato je dobro, da ga vedno uporabite.

Preko podatkovnih atributov

Dodajte data-toggle="dropdown"na povezavo ali gumb, da preklopite spustni meni.

<div class="dropdown">
  <button id="dLabel" type="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
    Dropdown trigger
    <span class="caret"></span>
  </button>
  <ul class="dropdown-menu" aria-labelledby="dLabel">
    ...
  </ul>
</div>

Če želite URL-je ohraniti nedotaknjene z gumbi povezav, uporabite data-targetatribut namesto href="#".

<div class="dropdown">
  <a id="dLabel" data-target="#" href="http://example.com/" data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">
    Dropdown trigger
    <span class="caret"></span>
  </a>

  <ul class="dropdown-menu" aria-labelledby="dLabel">
    ...
  </ul>
</div>

Prek JavaScripta

Prikličite spustne menije prek JavaScripta:

$('.dropdown-toggle').dropdown()

data-toggle="dropdown"še potrebno

Ne glede na to, ali spustni meni pokličete prek JavaScripta ali namesto tega uporabite data-api, data-toggle="dropdown"mora biti vedno prisoten v sprožilnem elementu spustnega menija.

Noben

Preklopi spustni meni dane navigacijske vrstice ali navigacije z zavihki.

Vsi spustni dogodki se sprožijo pri .dropdown-menunadrejenem elementu.

Vsi spustni dogodki imajo relatedTargetlastnost, katere vrednost je preklopni sidrni element.

Vrsta dogodka Opis
show.bs.dropdown Ta dogodek se sproži takoj, ko se pokliče metoda show instance.
prikazano.bs.spustni meni Ta dogodek se sproži, ko je spustni meni viden uporabniku (čakal bo na prehode CSS, da se dokončajo).
hide.bs.dropdown Ta dogodek se sproži takoj, ko je bila poklicana metoda hide instance.
hidden.bs.dropdown Ta dogodek se sproži, ko spustni meni ni več skrit pred uporabnikom (čakal bo na dokončanje prehodov CSS).
$('#myDropdown').on('show.bs.dropdown', function () {
  // do something…
})

ScrollSpy scrollspy.js

Primer v vrstici za krmarjenje

Vtičnik ScrollSpy je namenjen samodejnemu posodabljanju ciljev navigacije glede na položaj drsenja. Pomaknite se po območju pod vrstico za krmarjenje in opazujte spremembo aktivnega razreda. Označeni bodo tudi spustni podelementi.

@debela

Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi preden so razprodali qui. Pravice za kolesa Tumblr od kmetije do mize. Jopica Anim keffiyeh carles. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby pulover lomo jean kratke hlače, williamsburg hoodie minim qui verjetno še niste slišali zanje in jopica skrbniški sklad culpa biodiesel wes anderson aesthetic. Nihil tetoviran akuzamus, cred ironija biodizel keffiyeh obrtnik ullamco consequat.

@mdo

Veniam marfa brki rolka, adipisicing fugiat velit vile brada. Freegan beard aliqua cupidatat mcsweeney's vero. Cupidatat four loko nisi, ea helvetica nulla carles. Tetoviran cosby pulover s hrano, mcsweeneyjev quis non freegan vinil. Lo-fi wes anderson +1 krojaško. Carles ne estetsko vajo quis gentrify. Brooklyn adipisicing craft beer vice keytar deserunt.

eno

Occaecat commodo aliqua delectus. Fap craft beer deserunt skateboard ea. Lomo kolesarske pravice adipisicing banh mi, velit ea sunt next level locavore single-origin coffee in magna veniam. High life id vinil, echo park consequat quis aliquip banh mi pitchfork. Vero VHS est adipisicing. Consectetur nisi DIY minimalna kurirska torba. Cred ex in, trajnostni delectus consectetur fanny pack iphone.

dva

In incididunt echo park, officia deserunt mcsweeney's proident master cleanse thundercats sapiente veniam. Excepteur VHS elit, proident shoreditch +1 biodiesel laborum craft beer. Single-origin coffee wayfarers irure four loko, cupidatat terry richardson master cleanse. Assumenda you probably haven't heard of them art party fanny pack, tattooed nulla cardigan tempor ad. Proident wolf nesciunt sartorial keffiyeh eu banh mi sustainable. Elit wolf voluptate, lo-fi ea portland before they sold out four loko. Locavore enim nostrud mlkshk brooklyn nesciunt.

three

Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi before they sold out qui. Tumblr farm-to-table bicycle rights whatever. Anim keffiyeh carles cardigan. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby sweater lomo jean shorts, williamsburg hoodie minim qui you probably haven't heard of them et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tattooed accusamus, cred irony biodiesel keffiyeh artisan ullamco consequat.

Keytar twee blog, culpa messenger bag marfa whatever delectus food truck. Sapiente synth id domnevno. Locavore sed helvetica kliše ironija, thundercats verjetno še niste slišali zanje consequat pulover s kapuco brez glutena lo-fi fap aliquip. Labore elit placeat preden so bili razprodani, terry richardson proident brunch nesciunt quis cosby pulover pariatur keffiyeh ut helvetica artisan. Cardigan craft beer seitan readymade velit. VHS chambray laboris tempor veniam. Anim mollit minim commodo ullamco thundercats.

Uporaba

Zahteva Bootstrap nav

Scrollspy trenutno zahteva uporabo navigacijske komponente Bootstrap za pravilno označevanje aktivnih povezav.

Zahtevani so razrešljivi ID cilji

Povezave vrstice za krmarjenje morajo imeti razločljive cilje ID-ja. Na primer, <a href="#home">home</a>mora ustrezati nečemu v DOM, kot je <div id="home"></div>.

Neciljni :visibleelementi so prezrti

Ciljni elementi, ki niso :visiblev skladu z jQuery , bodo prezrti in njihovi ustrezni navigacijski elementi ne bodo nikoli označeni.

Zahteva relativno pozicioniranje

Ne glede na metodo implementacije, scrollspy zahteva uporabo position: relative;na elementu, za katerim vohunite. V večini primerov je to <body>. Pri vohunjenju po elementih, ki niso <body>, se prepričajte, da imate heightnastavljen in overflow-y: scroll;uporabljen.

Preko podatkovnih atributov

Če želite enostavno dodati vohunsko vedenje v svojo zgornjo vrstico, dodajte data-spy="scroll"element, za katerim želite vohuniti (najpogosteje je to <body>). Nato dodajte data-targetatribut z ID-jem ali razredom nadrejenega elementa katere koli .navkomponente Bootstrap.

body {
  position: relative;
}
<body data-spy="scroll" data-target="#navbar-example">
  ...
  <div id="navbar-example">
    <ul class="nav nav-tabs" role="tablist">
      ...
    </ul>
  </div>
  ...
</body>

Prek JavaScripta

Ko dodate position: relative;svoj CSS, pokličite scrollspy prek JavaScripta:

$('body').scrollspy({ target: '#navbar-example' })

Metode

.scrollspy('refresh')

Ko uporabljate scrollspy v povezavi z dodajanjem ali odstranjevanjem elementov iz DOM, boste morali poklicati metodo osveževanja takole:

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

Opcije

Možnosti je mogoče posredovati prek podatkovnih atributov ali JavaScripta. Za atribute podatkov pripnite ime možnosti v data-, kot v data-offset="".

Ime vrsta privzeto opis
odmik število 10 Slikovne pike za zamik od vrha pri izračunu položaja drsenja.

Dogodki

Vrsta dogodka Opis
activate.bs.scrollspy Ta dogodek se sproži vsakič, ko scrollspy aktivira nov element.
$('#myScrollspy').on('activate.bs.scrollspy', function () {
  // do something…
})

Preklopni zavihki tab.js

Primeri zavihkov

Dodajte hitro, dinamično funkcijo zavihkov za prehod med podokni lokalne vsebine, tudi prek spustnih menijev. Ugnezdeni zavihki niso podprti.

Surov denim, za katere verjetno še niste slišali, jeans kratke hlače Austin. Nesciunt tofu stumptown aliqua, retro synth master cleanse. Moustache cliche tempor, williamsburg carles vegan helvetica. Reprehenderit butcher retro keffiyeh dreamcatcher synth. Cosby pulover eu banh mi, qui irure terry richardson ex squid. Aliquip placeat salvia cillum iphone. Seitan aliquip quis kardigan ameriška oblačila, mesar 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.

Razširi navigacijo z zavihki

Ta vtičnik razširja navigacijsko komponento z zavihki za dodajanje območij z zavihki.

Uporaba

Omogoči zavihke z možnostjo zavihkov prek JavaScripta (vsak zavihek je treba aktivirati posebej):

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

Posamezne zavihke lahko aktivirate na več načinov:

$('#myTabs a[href="#profile"]').tab('show') // Select tab by name
$('#myTabs a:first').tab('show') // Select first tab
$('#myTabs a:last').tab('show') // Select last tab
$('#myTabs li:eq(2) a').tab('show') // Select third tab (0-indexed)

Markup

Navigacijo po zavihku ali tabletki lahko aktivirate, ne da bi pisali JavaScript, tako da preprosto določite data-toggle="tab"ali data-toggle="pill"na elementu. Če na zavihek dodate razrede navin , boste uporabili slog zavihka Bootstrap , medtem ko boste dodali razrede in uporabili slog tabletke .nav-tabsulnavnav-pills

<div>

  <!-- Nav tabs -->
  <ul class="nav nav-tabs" role="tablist">
    <li role="presentation" class="active"><a href="#home" aria-controls="home" role="tab" data-toggle="tab">Home</a></li>
    <li role="presentation"><a href="#profile" aria-controls="profile" role="tab" data-toggle="tab">Profile</a></li>
    <li role="presentation"><a href="#messages" aria-controls="messages" role="tab" data-toggle="tab">Messages</a></li>
    <li role="presentation"><a href="#settings" aria-controls="settings" role="tab" data-toggle="tab">Settings</a></li>
  </ul>

  <!-- Tab panes -->
  <div class="tab-content">
    <div role="tabpanel" class="tab-pane active" id="home">...</div>
    <div role="tabpanel" class="tab-pane" id="profile">...</div>
    <div role="tabpanel" class="tab-pane" id="messages">...</div>
    <div role="tabpanel" class="tab-pane" id="settings">...</div>
  </div>

</div>

Učinek bledenja

Če želite, da zavihki zbledijo, dodajte .fadevsakemu .tab-pane. V prvem podoknu z zavihki mora biti .invidna tudi začetna vsebina.

<div class="tab-content">
  <div role="tabpanel" class="tab-pane fade in active" id="home">...</div>
  <div role="tabpanel" class="tab-pane fade" id="profile">...</div>
  <div role="tabpanel" class="tab-pane fade" id="messages">...</div>
  <div role="tabpanel" class="tab-pane fade" id="settings">...</div>
</div>

Metode

$().tab

Aktivira element zavihka in vsebnik vsebine. Zavihek mora imeti bodisi data-targetali hrefciljno usmerjen na vozlišče vsebnika v DOM. V zgornjih primerih so zavihki <a>s z data-toggle="tab"atributi.

.tab('show')

Izbere dani zavihek in prikaže povezano vsebino. Vsi drugi zavihki, ki so bili predhodno izbrani, postanejo neizbrani in njihova povezana vsebina je skrita. Vrne se klicatelju, preden je podokno z zavihki dejansko prikazano (tj. preden shown.bs.tabpride do dogodka).

$('#someTab').tab('show')

Dogodki

Pri prikazu novega zavihka se dogodki sprožijo v naslednjem vrstnem redu:

  1. hide.bs.tab(na trenutno aktivnem zavihku)
  2. show.bs.tab(na zavihku za prikaz)
  3. hidden.bs.tab(na prejšnjem aktivnem zavihku, enak kot za hide.bs.tabdogodek)
  4. shown.bs.tab(na novoaktivnem pravkar prikazanem zavihku, isti kot za show.bs.tabdogodek)

Če noben zavihek še ni bil aktiven, se dogodki hide.bs.tabin hidden.bs.tabne bodo sprožili.

Vrsta dogodka Opis
show.bs.tab Ta dogodek se sproži ob prikazu zavihka, vendar preden je prikazan nov zavihek. Uporabite event.targetin event.relatedTargetza ciljanje na aktivni zavihek oziroma prejšnji aktivni zavihek (če je na voljo).
prikazano.bs.tab Ta dogodek se sproži na prikazu zavihkov po prikazu zavihka. Uporabite event.targetin event.relatedTargetza ciljanje na aktivni zavihek oziroma prejšnji aktivni zavihek (če je na voljo).
hide.bs.tab Ta dogodek se sproži, ko je treba prikazati nov zavihek (in tako naj bi bil prejšnji aktivni zavihek skrit). Uporabite event.targetin event.relatedTargetza ciljanje na trenutni aktivni zavihek oziroma novi zavihek, ki bo kmalu aktiven.
skriti.bs.tab Ta dogodek se sproži, ko je prikazan nov zavihek (in tako je prejšnji aktivni zavihek skrit). Uporabite event.targetin event.relatedTargetza ciljanje prejšnjega aktivnega zavihka oziroma novega aktivnega zavihka.
$('a[data-toggle="tab"]').on('shown.bs.tab', function (e) {
  e.target // newly activated tab
  e.relatedTarget // previous active tab
})

Namigi orodij tooltip.js

Navdih za odličen vtičnik jQuery.tipsy, ki ga je napisal Jason Frame; Namigi orodij so posodobljena različica, ki se ne zanaša na slike, uporablja CSS3 za animacije in podatkovne atribute za lokalno shranjevanje naslovov.

Namigi z naslovi ničelne dolžine niso nikoli prikazani.

Primeri

Premaknite miškin kazalec nad spodnje povezave, da si ogledate opise orodij:

Ozke hlače naslednje stopnje keffiyeh , za katere verjetno še niste slišali. Photo booth beard raw denim letterpress veganska kurirska torba stumptown. Seitan od kmetije do mize, 8-bitna ameriška oblačila mcsweeney's fixie trajnostna kvinoja imajo vinil chambray terryja richardsona. Beard stumptown, kardigani banh mi lomo thundercats. Tofu biodizel williamsburg marfa, štiri loko mcsweeney's cleanse veganski chambray. Resnično ironični rokodelec , karkoli keytar , scenester farm-to-table banksy Austin twitter handle freegan cred raw denim single-origin kava virusna.

Statični opis orodja

Na voljo so štiri možnosti: zgoraj, desno, spodaj in levo poravnano.

Štiri smeri

<button type="button" class="btn btn-default" data-toggle="tooltip" data-placement="left" title="Tooltip on left">Tooltip on left</button>

<button type="button" class="btn btn-default" data-toggle="tooltip" data-placement="top" title="Tooltip on top">Tooltip on top</button>

<button type="button" class="btn btn-default" data-toggle="tooltip" data-placement="bottom" title="Tooltip on bottom">Tooltip on bottom</button>

<button type="button" class="btn btn-default" data-toggle="tooltip" data-placement="right" title="Tooltip on right">Tooltip on right</button>

Funkcionalnost privolitve

Zaradi zmogljivosti sta API-ja Tooltip in Popover data-apis opt-in, kar pomeni, da ju morate inicializirati sami .

Eden od načinov inicializacije vseh namigov orodij na strani bi bil, da jih izberete po njihovem data-toggleatributu:

$(function () {
  $('[data-toggle="tooltip"]').tooltip()
})

Uporaba

Vtičnik orodnih namigov ustvari vsebino in oznake na zahtevo ter privzeto postavi namige orodij za njihov sprožilni element.

Sproži opis orodja prek JavaScripta:

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

Markup

Zahtevana oznaka za opis orodja je le dataatribut in titlena elementu HTML, za katerega želite, da je opis orodja. Ustvarjena oznaka orodnega opisa je precej preprosta, čeprav zahteva položaj (privzeto nastavljen tops strani vtičnika).

<!-- HTML to write -->
<a href="#" data-toggle="tooltip" title="Some tooltip text!">Hover over me</a>

<!-- Generated markup by the plugin -->
<div class="tooltip top" role="tooltip">
  <div class="tooltip-arrow"></div>
  <div class="tooltip-inner">
    Some tooltip text!
  </div>
</div>

Večvrstične povezave

Včasih želite dodati opis orodja hiperpovezavi, ki prekriva več vrstic. Privzeto vedenje vtičnika orodnih namigov je centriranje vodoravno in navpično. Dodajte white-space: nowrap;svojim sidrom, da se temu izognete.

Namigi orodij v skupinah gumbov, vnosnih skupinah in tabelah zahtevajo posebno nastavitev

Ko uporabljate opise orodij na elementih znotraj .btn-groupali .input-group, ali na elementih, povezanih s tabelo ( <td>, <th>, <tr>, <thead>, <tbody>, <tfoot>), boste morali določiti možnost container: 'body'(dokumentirano spodaj), da se izognete neželenim stranskim učinkom (kot je širitev elementa in/ ali izguba zaobljenih vogalov, ko se sproži opis orodja).

Ne poskušajte prikazati namigov orodij na skritih elementih

Če prikličete $(...).tooltip('show'), ko je ciljni element, display: none;bo opis orodja nepravilno postavljen.

Dostopni opisi orodij za uporabnike tipkovnice in podporne tehnologije

Za uporabnike, ki se pomikajo s tipkovnico, in še posebej za uporabnike podpornih tehnologij, dodajte nasvete orodij le elementom, na katere se osredotoči tipkovnica, kot so povezave, kontrolniki obrazcev ali kateri koli poljuben element z tabindex="0"atributom.

Namigi orodij za onemogočene elemente zahtevajo elemente ovoja

Če želite dodati opis orodja elementu disabledali .disabled, postavite element znotraj a <div>in <div>namesto tega uporabite opis orodja zanj.

Opcije

Možnosti je mogoče posredovati prek podatkovnih atributov ali JavaScripta. Za atribute podatkov pripnite ime možnosti v data-, kot v data-animation="".

Upoštevajte, da iz varnostnih razlogov možnosti sanitize, sanitizeFnin whiteListni mogoče zagotoviti z uporabo podatkovnih atributov.

Ime Vrsta Privzeto Opis
animacija logično prav Na opisu orodja uporabite bledeči prehod CSS
posoda niz | lažno lažno

Doda namig orodja določenemu elementu. Primer: container: 'body'. Ta možnost je še posebej uporabna, ker vam omogoča, da namig orodja postavite v tok dokumenta blizu sprožilnega elementa – kar bo preprečilo, da bi namig orodja med spreminjanjem velikosti okna lebdel stran od sprožilnega elementa.

zamuda številka | predmet 0

Zakasnitev prikaza in skrivanja namiga orodja (ms) – ne velja za tip ročnega proženja

Če je navedena številka, se zakasnitev uporabi za skrij/prikaži

Struktura objekta je:delay: { "show": 500, "hide": 100 }

html logično lažno V opis orodja vstavite HTML. Če je nastavljeno na false, textbo za vstavljanje vsebine v DOM uporabljena metoda jQuery. Če vas skrbijo napadi XSS, uporabite besedilo.
umestitev niz | funkcijo 'top'

Kako postaviti opis orodja - vrh | dno | levo | desno | avto.
Ko je določeno "samodejno", bo dinamično preusmerilo opis orodja. Če je na primer umestitev »samodejno levo«, se bo opis orodja prikazal na levi, kadar je to mogoče, sicer pa na desni.

Ko se funkcija uporabi za določitev umestitve, se pokliče z vozliščem DOM z opisom orodja kot prvim argumentom in vozliščem prožilnega elementa DOM kot drugim. Kontekst thisje nastavljen na primer orodnega opisa.

selektor vrvica lažno Če je na voljo izbirnik, bodo predmeti namigov orodja dodeljeni navedenim ciljem. V praksi se to uporablja tudi za uporabo namigov orodij za dinamično dodane elemente DOM ( jQuery.onpodpora). Oglejte si to in informativen primer .
predlogo vrvica '<div class="tooltip" role="tooltip"><div class="tooltip-arrow"></div><div class="tooltip-inner"></div></div>'

Osnovni HTML za uporabo pri ustvarjanju opisa orodja.

Namigi orodij titlebodo vstavljeni v .tooltip-inner.

.tooltip-arrowbo postala puščica opisa orodja.

Zunanji ovojni element mora imeti .tooltiprazred.

naslov niz | funkcijo ''

Privzeta vrednost naslova, če titleatribut ni prisoten.

Če je podana funkcija, bo klicana s thissklicem, nastavljenim na element, na katerega je pritrjen opis orodja.

sprožilec vrvica 'hover focus' Kako se sproži opis orodja - kliknite | lebdi | fokus | priročnik. Lahko prenesete več sprožilcev; ločite jih s presledkom. manualni mogoče kombinirati z nobenim drugim sprožilcem.
vidno polje niz | predmet | funkcijo { izbirnik: 'body', oblazinjenje: 0 }

Ohranja opis orodja v mejah tega elementa. Primer: viewport: '#viewport'oz{ "selector": "#viewport", "padding": 0 }

Če je funkcija podana, se kliče z vozliščem prožilnega elementa DOM kot edinim argumentom. Kontekst thisje nastavljen na primer orodnega opisa.

razkužiti logično prav Omogočite ali onemogočite čiščenje. Če je aktivirano 'template', bodo možnosti 'content'in 'title'možnosti razčiščene.
beli seznam predmet Privzeta vrednost Objekt, ki vsebuje dovoljene atribute in oznake
sanitizeFn nič | funkcijo nič Tukaj lahko zagotovite lastno funkcijo razkuževanja. To je lahko uporabno, če za izvajanje sanacije raje uporabljate namensko knjižnico.

Atributi podatkov za posamezne namige orodij

Možnosti za posamezne namige orodij je mogoče določiti tudi z uporabo atributov podatkov, kot je razloženo zgoraj.

Metode

$().tooltip(options)

Zbirki elementov priloži obravnavo namigov orodij.

.tooltip('show')

Razkrije namig elementa. Vrne se klicatelju, preden se dejansko prikaže opis orodja (tj. preden shown.bs.tooltippride do dogodka). To velja za "ročno" proženje namiga orodja. Namigi z naslovi ničelne dolžine niso nikoli prikazani.

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

.tooltip('hide')

Skrije namig elementa. Vrne se klicatelju, preden je bil opis orodja dejansko skrit (tj. preden se hidden.bs.tooltipzgodi dogodek). To velja za "ročno" proženje namiga orodja.

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

.tooltip('toggle')

Preklopi opis orodja elementa. Vrne se klicatelju, preden je bil opis orodja dejansko prikazan ali skrit (tj. preden pride do dogodka shown.bs.tooltipali ). hidden.bs.tooltipTo velja za "ročno" proženje namiga orodja.

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

.tooltip('destroy')

Skrije in uniči namig elementa. Namigov orodij, ki uporabljajo delegiranje (ki so ustvarjeni z možnostjo selector) , ni mogoče posamično uničiti na podrejenih sprožilnih elementih.

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

Dogodki

Vrsta dogodka Opis
show.bs.tooltip Ta dogodek se sproži takoj, ko showse pokliče metoda primerka.
prikazano.bs.tooltip Ta dogodek se sproži, ko je opis orodja viden uporabniku (počakal bo, da se zaključijo prehodi CSS).
hide.bs.tooltip Ta dogodek se sproži takoj, ko hideje bila poklicana metoda primerka.
hidden.bs.tooltip Ta dogodek se sproži, ko opis orodja ni več skrit pred uporabnikom (počakal bo, da se zaključijo prehodi CSS).
inserted.bs.tooltip Ta dogodek se sproži po show.bs.tooltipdogodku, ko je predloga orodja dodana v DOM.
$('#myTooltip').on('hidden.bs.tooltip', function () {
  // do something…
})

Popovers popover.js

Dodajte majhne prekrivne vsebine, kot so tiste na iPadu, kateremu koli elementu za namestitev sekundarnih informacij.

Popoverji, katerih naslov in vsebina sta ničelne dolžine, niso nikoli prikazani.

Odvisnost od vtičnika

Popovers zahtevajo, da je v vašo različico Bootstrapa vključen vtičnik orodnih namigov.

Funkcionalnost privolitve

Zaradi zmogljivosti sta API-ja Tooltip in Popover data-apis opt-in, kar pomeni, da ju morate inicializirati sami .

Eden od načinov inicializacije vseh pojavnih oken na strani bi bil, da jih izberete po njihovem data-toggleatributu:

$(function () {
  $('[data-toggle="popover"]').popover()
})

Popoverji v skupinah gumbov, vnosnih skupinah in tabelah zahtevajo posebno nastavitev

Ko uporabljate pojavne elemente na elementih znotraj .btn-groupali .input-group, ali na elementih, povezanih s tabelo ( <td>, <th>, <tr>, <thead>, <tbody>, <tfoot>), boste morali določiti možnost container: 'body'(dokumentirano spodaj), da se izognete neželenim stranskim učinkom (kot je širitev elementa in/ ali izguba zaobljenih vogalov, ko se sproži popover).

Ne poskušajte prikazati popoverjev na skritih elementih

Sklicevanje $(...).popover('show'), ko je ciljni element, display: none;bo povzročilo, da bo pojavni element nepravilno postavljen.

Popoverji na onemogočenih elementih zahtevajo ovojne elemente

disabledČe želite elementu ali dodati popover .disabled, postavite element znotraj a <div>in <div>namesto tega uporabite pojavni pojav za to.

Večvrstične povezave

Včasih želite hiperpovezavi, ki ovije več vrstic, dodati pojavni pojav. Privzeto vedenje popover vtičnika je, da ga centrira vodoravno in navpično. Dodajte white-space: nowrap;svojim sidrom, da se temu izognete.

Primeri

Statični popover

Na voljo so štiri možnosti: zgoraj, desno, spodaj in levo poravnano.

Popover top

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

Popover desno

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

Popover dno

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

Popover levo

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

Demo v živo

<button type="button" class="btn btn-lg btn-danger" data-toggle="popover" title="Popover title" data-content="And here's some amazing content. It's very engaging. Right?">Click to toggle popover</button>

Štiri smeri

<button type="button" class="btn btn-default" data-container="body" data-toggle="popover" data-placement="left" data-content="Vivamus sagittis lacus vel augue laoreet rutrum faucibus.">
  Popover on left
</button>

<button type="button" class="btn btn-default" data-container="body" data-toggle="popover" data-placement="top" data-content="Vivamus sagittis lacus vel augue laoreet rutrum faucibus.">
  Popover on top
</button>

<button type="button" class="btn btn-default" data-container="body" data-toggle="popover" data-placement="bottom" data-content="Vivamus
sagittis lacus vel augue laoreet rutrum faucibus.">
  Popover on bottom
</button>

<button type="button" class="btn btn-default" data-container="body" data-toggle="popover" data-placement="right" data-content="Vivamus sagittis lacus vel augue laoreet rutrum faucibus.">
  Popover on right
</button>

Opusti ob naslednjem kliku

Uporabite focussprožilec, da opustite pojavna okna ob naslednjem kliku uporabnika.

Za opustitev ob naslednjem kliku je potrebna posebna oznaka

Za pravilno delovanje med brskalniki in platformami morate uporabiti <a>oznako, ne oznake <button>, vključiti pa morate tudi atributa role="button"in .tabindex

<a tabindex="0" class="btn btn-lg btn-danger" role="button" data-toggle="popover" data-trigger="focus" title="Dismissible popover" data-content="And here's some amazing content. It's very engaging. Right?">Dismissible popover</a>

Uporaba

Omogoči pojavna okna prek JavaScripta:

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

Opcije

Možnosti je mogoče posredovati prek podatkovnih atributov ali JavaScripta. Za atribute podatkov pripnite ime možnosti v data-, kot v data-animation="".

Upoštevajte, da iz varnostnih razlogov možnosti sanitize, sanitizeFnin whiteListni mogoče zagotoviti z uporabo podatkovnih atributov.

Ime Vrsta Privzeto Opis
animacija logično prav Uporabite prehod CSS zbledenja na pojavni element
posoda niz | lažno lažno

Popover doda določenemu elementu. Primer: container: 'body'. Ta možnost je še posebej uporabna, ker vam omogoča, da pojavni element postavite v tok dokumenta blizu sprožilnega elementa – kar bo preprečilo, da bi pojavni element med spreminjanjem velikosti okna lebdel stran od sprožilnega elementa.

vsebino niz | funkcijo ''

Privzeta vrednost vsebine, če data-contentatribut ni prisoten.

Če je podana funkcija, bo klicana s thissklicem, nastavljenim na element, na katerega je pritrjen popover.

zamuda številka | predmet 0

Zakasnitev prikaza in skrivanja pojavnega pojava (ms) - ne velja za tip ročnega proženja

Če je navedena številka, se zakasnitev uporabi za skrij/prikaži

Struktura objekta je:delay: { "show": 500, "hide": 100 }

html logično lažno V pojavno okno vstavite HTML. Če je nastavljeno na false, textbo za vstavljanje vsebine v DOM uporabljena metoda jQuery. Če vas skrbijo napadi XSS, uporabite besedilo.
umestitev niz | funkcijo 'prav'

Kako postaviti popover - zgoraj | dno | levo | desno | avto.
Ko je določeno »samodejno«, bo dinamično preusmeril pojavni element. Če je na primer umestitev »samodejno levo«, bo pojavni pomik prikazan na levi, kadar je to mogoče, sicer bo prikazan na desni.

Ko se funkcija uporabi za določitev umestitve, se pokliče s pojavnim vozliščem DOM kot prvim argumentom in prožilnim elementom DOM vozliščem kot drugim. Kontekst thisje nastavljen na pojavni primerek.

selektor vrvica lažno Če je na voljo izbirnik, bodo pojavni objekti dodeljeni navedenim ciljem. V praksi se to uporablja za omogočanje dodajanja pojavnih oken dinamični vsebini HTML. Oglejte si to in informativen primer .
predlogo vrvica '<div class="popover" role="tooltip"><div class="arrow"></div><h3 class="popover-title"></h3><div class="popover-content"></div></div>'

Osnovni HTML za uporabo pri ustvarjanju pojavnega okna.

Popoverji titlebodo vbrizgani v .popover-title.

Popoverji contentbodo vbrizgani v .popover-content.

.arrowbo postala popoverjeva puščica.

Zunanji ovojni element mora imeti .popoverrazred.

naslov niz | funkcijo ''

Privzeta vrednost naslova, če titleatribut ni prisoten.

Če je podana funkcija, bo klicana s thissklicem, nastavljenim na element, na katerega je pritrjen popover.

sprožilec vrvica 'klik' Kako se sproži popover - kliknite | lebdi | fokus | priročnik. Lahko prenesete več sprožilcev; ločite jih s presledkom. manualni mogoče kombinirati z nobenim drugim sprožilcem.
vidno polje niz | predmet | funkcijo { izbirnik: 'body', oblazinjenje: 0 }

Popover ohranja v mejah tega elementa. Primer: viewport: '#viewport'oz{ "selector": "#viewport", "padding": 0 }

Če je funkcija podana, se kliče z vozliščem prožilnega elementa DOM kot edinim argumentom. Kontekst thisje nastavljen na pojavni primerek.

razkužiti logično prav Omogočite ali onemogočite čiščenje. Če je aktivirano 'template', bodo možnosti 'content'in 'title'možnosti razčiščene.
beli seznam predmet Privzeta vrednost Objekt, ki vsebuje dovoljene atribute in oznake
sanitizeFn nič | funkcijo nič Tukaj lahko zagotovite lastno funkcijo razkuževanja. To je lahko uporabno, če za izvajanje sanacije raje uporabljate namensko knjižnico.

Atributi podatkov za posamezne popoverje

Možnosti za posamezna pojavna okna se lahko določijo tudi z uporabo podatkovnih atributov, kot je razloženo zgoraj.

Metode

$().popover(options)

Inicializira pojavna okna za zbirko elementov.

.popover('show')

Razkrije popover elementa. Vrne se k klicatelju, preden je pojavno okno dejansko prikazano (tj. preden shown.bs.popoverpride do dogodka). To velja za "ročno" sprožitev popoverja. Popoverji, katerih naslov in vsebina sta ničelne dolžine, niso nikoli prikazani.

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

.popover('hide')

Skrije pojavni element elementa. Vrne se k klicatelju, preden je bil popover dejansko skrit (tj. preden hidden.bs.popoverpride do dogodka). To velja za "ročno" sprožitev popoverja.

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

.popover('toggle')

Preklopi pojavni element elementa. Vrne se klicatelju, preden je pojavni element dejansko prikazan ali skrit (tj. preden pride do dogodka shown.bs.popoverali ). hidden.bs.popoverTo velja za "ročno" sprožitev popoverja.

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

.popover('destroy')

Skrije in uniči popover elementa. Popoverjev, ki uporabljajo delegiranje (ki so ustvarjeni z možnostjo selector) , ni mogoče posamično uničiti na podrejenih prožilnih elementih.

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

Dogodki

Vrsta dogodka Opis
show.bs.popover Ta dogodek se sproži takoj, ko showse pokliče metoda primerka.
prikazano.bs.popover Ta dogodek se sproži, ko postane pojavni element viden uporabniku (počakal bo, da se zaključijo prehodi CSS).
hide.bs.popover Ta dogodek se sproži takoj, ko hideje bila poklicana metoda primerka.
hidden.bs.popover Ta dogodek se sproži, ko se pojavni pomik neha skriti pred uporabnikom (počakal bo, da se zaključijo prehodi CSS).
vstavljeno.bs.popover Ta dogodek se sproži po show.bs.popoverdogodku, ko je bila v DOM dodana popover predloga.
$('#myPopover').on('hidden.bs.popover', function () {
  // do something…
})

Opozorilna sporočila alert.js

Primeri opozoril

S tem vtičnikom dodajte funkcijo opustitve vsem opozorilnim sporočilom.

Ko uporabljate .closegumb, mora biti prvi podrejeni gumb .alert-dismissiblein nobena besedilna vsebina ne sme biti pred njim v označevanju.

Uporaba

Preprosto dodajte data-dismiss="alert"svojemu gumbu za zapiranje, da samodejno omogočite funkcijo zapiranja opozorila. Če zaprete opozorilo, ga odstranite iz DOM.

<button type="button" class="close" data-dismiss="alert" aria-label="Close">
  <span aria-hidden="true">&times;</span>
</button>

Če želite, da vaša opozorila ob zapiranju uporabljajo animacijo, se prepričajte, da so zanje že uporabljeni razredi .fadein ..in

Metode

$().alert()

Naredi opozorilo, da posluša dogodke klikov na podrejenih elementih, ki imajo data-dismiss="alert"atribut. (Ni potrebno pri uporabi samodejne inicializacije data-api.)

$().alert('close')

Zapre opozorilo tako, da ga odstrani iz DOM. Če .fadein.in , bo opozorilo zbledelo, preden bo odstranjeno.

Dogodki

Bootstrapov vtičnik za opozorila razkriva nekaj dogodkov za priključitev na funkcijo opozorila.

Vrsta dogodka Opis
close.bs.alert Ta dogodek se sproži takoj, ko closese pokliče metoda primerka.
zaprto.bs.alert Ta dogodek se sproži, ko je bilo opozorilo zaprto (počakal bo, da se zaključijo prehodi CSS).
$('#myAlert').on('closed.bs.alert', function () {
  // do something…
})

Gumbi button.js

Naredite več z gumbi. Nadzorni gumb navaja ali ustvari skupine gumbov za več komponent, kot so orodne vrstice.

Združljivost med brskalniki

Firefox med nalaganjem strani ohranja stanja nadzora obrazca (onemogočenost in preverjanje) . Rešitev za to je uporaba autocomplete="off". Oglejte si napako Mozilla #654072 .

Stalni

Dodajte data-loading-text="Loading..."za uporabo stanja nalaganja na gumbu.

Ta funkcija je zastarela od različice 3.3.5 in je bila odstranjena v različici 4.

Uporabite poljubno stanje!

Zaradi te predstavitve uporabljamo data-loading-textin $().button('loading'), vendar to ni edino stanje, ki ga lahko uporabite. Več o tem si oglejte spodaj v $().button(string)dokumentaciji .

<button type="button" id="myButton" data-loading-text="Loading..." class="btn btn-primary">
  Loading state
</button>

<script>
  $('#myButton').on('click', function () {
    var $btn = $(this).button('loading')
    // business logic...
    $btn.button('reset')
  })
</script>

Enotni preklop

Dodajte data-toggle="button"za aktiviranje preklapljanja na enem gumbu.

Vnaprej preklopljeni gumbi potrebujejo .activeinaria-pressed="true"

Za vnaprej preklopne gumbe morate dodati .activerazred in aria-pressed="true"atribut buttonsebi.

<button type="button" class="btn btn-primary" data-toggle="button" aria-pressed="false">
  Single toggle
</button>

Potrditveno polje / Radio

Dodajte vsebujočemu data-toggle="buttons"potrditvenemu .btn-grouppolju ali radijske vnose, da omogočite preklapljanje v njihovih slogih.

Potrebujete vnaprej izbrane možnosti.active

Za vnaprej izbrane možnosti morate sami dodati .activerazred v vnos label.

Vizualno označeno stanje se posodobi samo ob kliku

Če se potrjeno stanje gumba potrditvenega polja posodobi brez sprožitve clickdogodka na gumbu (npr. prek <input type="reset">ali prek nastavitve checkedlastnosti vnosa), boste morali sami preklopiti .activerazred na vnosu label.

<div class="btn-group" data-toggle="buttons">
  <label class="btn btn-primary active">
    <input type="checkbox" checked> Checkbox 1 (pre-checked)
  </label>
  <label class="btn btn-primary">
    <input type="checkbox"> Checkbox 2
  </label>
  <label class="btn btn-primary">
    <input type="checkbox"> Checkbox 3
  </label>
</div>
<div class="btn-group" data-toggle="buttons">
  <label class="btn btn-primary active">
    <input type="radio" name="options" id="option1" checked> Radio 1 (preselected)
  </label>
  <label class="btn btn-primary">
    <input type="radio" name="options" id="option2"> Radio 2
  </label>
  <label class="btn btn-primary">
    <input type="radio" name="options" id="option3"> Radio 3
  </label>
</div>

Metode

$().button('toggle')

Preklopi potisno stanje. Gumb daje videz, kot da je bil aktiviran.

$().button('reset')

Ponastavi stanje gumba - besedilo zamenja z izvirnim besedilom. Ta metoda je asinhrona in se vrne, preden je ponastavitev dejansko končana.

$().button(string)

Zamenja besedilo v poljubno podatkovno definirano stanje besedila.

<button type="button" id="myStateButton" data-complete-text="finished!" class="btn btn-primary">
  ...
</button>

<script>
  $('#myStateButton').on('click', function () {
    $(this).button('complete') // button text will be "finished!"
  })
</script>

Strni collapse.js

Prilagodljiv vtičnik, ki uporablja peščico razredov za enostavno preklapljanje.

Odvisnost od vtičnika

Strnitev zahteva, da je vtičnik za prehode vključen v vašo različico Bootstrapa.

Primer

Kliknite spodnje gumbe, da prikažete ali skrijete drug element prek sprememb razreda:

  • .collapseskriva vsebino
  • .collapsingse uporablja med prehodi
  • .collapse.inprikazuje vsebino

Uporabite lahko povezavo z hrefatributom ali gumb z data-targetatributom. V obeh primerih data-toggle="collapse"je potrebno.

Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident.
<a class="btn btn-primary" role="button" data-toggle="collapse" href="#collapseExample" aria-expanded="false" aria-controls="collapseExample">
  Link with href
</a>
<button class="btn btn-primary" type="button" data-toggle="collapse" data-target="#collapseExample" aria-expanded="false" aria-controls="collapseExample">
  Button with data-target
</button>
<div class="collapse" id="collapseExample">
  <div class="well">
    ...
  </div>
</div>

Primer harmonike

Razširite privzeto vedenje strnjevanja, da ustvarite harmoniko s komponento plošče.

Animacija pariatnega klišeja, ki ga je preprečevala, eiusmod high life obtožba terry richardson in lignji. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Tovornjak s hrano kvinoja nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it lignji kava z enim poreklom nulla acceptenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Oglas veganski razen mesarja vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt verjetno še niste slišali zanje acusamus labore sustainable VHS.
Animacija pariatnega klišeja, ki ga je preprečevala, eiusmod high life obtožba terry richardson in lignji. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Tovornjak s hrano kvinoja nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it lignji kava z enim poreklom nulla acceptenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Oglas veganski razen mesarja vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt verjetno še niste slišali zanje acusamus labore sustainable VHS.
Animacija pariatnega klišeja, ki ga je preprečevala, eiusmod high life obtožba terry richardson in lignji. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Tovornjak s hrano kvinoja nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it lignji kava z enim poreklom nulla acceptenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Oglas veganski razen mesarja vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt verjetno še niste slišali zanje acusamus labore sustainable VHS.
<div class="panel-group" id="accordion" role="tablist" aria-multiselectable="true">
  <div class="panel panel-default">
    <div class="panel-heading" role="tab" id="headingOne">
      <h4 class="panel-title">
        <a role="button" data-toggle="collapse" data-parent="#accordion" href="#collapseOne" aria-expanded="true" aria-controls="collapseOne">
          Collapsible Group Item #1
        </a>
      </h4>
    </div>
    <div id="collapseOne" class="panel-collapse collapse in" role="tabpanel" aria-labelledby="headingOne">
      <div class="panel-body">
        Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee 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 craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
      </div>
    </div>
  </div>
  <div class="panel panel-default">
    <div class="panel-heading" role="tab" id="headingTwo">
      <h4 class="panel-title">
        <a class="collapsed" role="button" data-toggle="collapse" data-parent="#accordion" href="#collapseTwo" aria-expanded="false" aria-controls="collapseTwo">
          Collapsible Group Item #2
        </a>
      </h4>
    </div>
    <div id="collapseTwo" class="panel-collapse collapse" role="tabpanel" aria-labelledby="headingTwo">
      <div class="panel-body">
        Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee 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 craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
      </div>
    </div>
  </div>
  <div class="panel panel-default">
    <div class="panel-heading" role="tab" id="headingThree">
      <h4 class="panel-title">
        <a class="collapsed" role="button" data-toggle="collapse" data-parent="#accordion" href="#collapseThree" aria-expanded="false" aria-controls="collapseThree">
          Collapsible Group Item #3
        </a>
      </h4>
    </div>
    <div id="collapseThree" class="panel-collapse collapse" role="tabpanel" aria-labelledby="headingThree">
      <div class="panel-body">
        Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee 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 craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
      </div>
    </div>
  </div>
</div>

Možna je tudi zamenjava .panel-bodys s .list-groups.

  • Bootply
  • En itmus ac facilin
  • Drugi eros

Omogoči dostop do kontrolnikov za razširitev/strnitev

Bodite prepričani, da dodate aria-expandedv kontrolni element. Ta atribut izrecno definira trenutno stanje zložljivega elementa za bralnike zaslona in podobne podporne tehnologije. Če je zložljivi element privzeto zaprt, mora imeti vrednost aria-expanded="false". inČe ste z razredom nastavili, da je zložljivi element privzeto odprt, ga aria-expanded="true"namesto tega nastavite na kontrolniku. Vtičnik bo samodejno preklopil ta atribut glede na to, ali je bil zložljivi element odprt ali zaprt.

Poleg tega, če vaš kontrolni element cilja na en sam zložljiv element – ​​tj. data-targetatribut kaže na idizbirnik –, lahko dodate dodaten aria-controlsatribut kontrolnemu elementu, ki vsebuje idelement zložljivega elementa. Sodobni bralniki zaslona in podobne podporne tehnologije uporabljajo ta atribut, da uporabnikom zagotovijo dodatne bližnjice za navigacijo neposredno do samega zložljivega elementa.

Uporaba

Vtičnik Collapse uporablja nekaj razredov za obvladovanje težkega dvigovanja:

  • .collapseskriva vsebino
  • .collapse.inprikazuje vsebino
  • .collapsingse doda, ko se prehod začne, in odstrani, ko se konča

Te razrede lahko najdete v component-animations.less.

Preko podatkovnih atributov

Samo dodajte data-toggle="collapse"in data-targetelementu, da samodejno dodelite nadzor nad zložljivim elementom. Atribut data-targetsprejme izbirnik CSS za uporabo strnjenja. Ne pozabite dodati razreda collapsezložljivemu elementu. Če želite, da se privzeto odpre, dodajte dodatni razred in.

Če želite zložljivemu nadzoru dodati upravljanje skupine, podobno harmoniki, dodajte atribut podatkov data-parent="#selector". Oglejte si predstavitev, da vidite to v akciji.

Prek JavaScripta

Omogoči ročno z:

$('.collapse').collapse()

Opcije

Možnosti je mogoče posredovati prek podatkovnih atributov ali JavaScripta. Za atribute podatkov pripnite ime možnosti v data-, kot v data-parent="".

Ime vrsta privzeto opis
starš selektor lažno Če je na voljo izbirnik, bodo vsi zložljivi elementi pod podanim nadrejenim elementom zaprti, ko je prikazan ta zložljivi element. (podobno kot tradicionalno vedenje harmonike - to je odvisno od panelrazreda)
preklop logično prav Ob klicu preklopi zložljivi element

Metode

.collapse(options)

Aktivira vašo vsebino kot zložljiv element. Sprejema neobvezne možnosti object.

$('#myCollapsible').collapse({
  toggle: false
})

.collapse('toggle')

Preklopi zložljiv element med prikazanim ali skritim. Vrne se klicatelju, preden je zložljivi element dejansko prikazan ali skrit (tj. preden pride do dogodka shown.bs.collapseali ).hidden.bs.collapse

.collapse('show')

Prikazuje zložljiv element. Vrne se klicatelju, preden je zložljivi element dejansko prikazan (tj. preden shown.bs.collapsepride do dogodka).

.collapse('hide')

Skrije zložljiv element. Vrne se klicatelju, preden je bil zložljivi element dejansko skrit (tj. preden hidden.bs.collapsepride do dogodka).

Dogodki

Bootstrapov razred kolapsa razkrije nekaj dogodkov za priključitev na funkcionalnost kolapsa.

Vrsta dogodka Opis
show.bs.collapse Ta dogodek se sproži takoj, ko showse pokliče metoda primerka.
prikazano.bs.zruši Ta dogodek se sproži, ko je element strnjenja viden uporabniku (počakal bo, da se prehodi CSS zaključijo).
hide.bs.collapse Ta dogodek se sproži takoj, ko hideje bila metoda poklicana.
hidden.bs.collapse Ta dogodek se sproži, ko je bil strnjeni element skrit pred uporabnikom (počakal bo, da se zaključijo prehodi CSS).
$('#myCollapsible').on('hidden.bs.collapse', function () {
  // do something…
})

Carousel carousel.js

Komponenta diaprojekcije za kroženje po elementih, kot je vrtiljak. Ugnezdeni vrtiljaki niso podprti.

<div id="carousel-example-generic" class="carousel slide" data-ride="carousel">
  <!-- Indicators -->
  <ol class="carousel-indicators">
    <li data-target="#carousel-example-generic" data-slide-to="0" class="active"></li>
    <li data-target="#carousel-example-generic" data-slide-to="1"></li>
    <li data-target="#carousel-example-generic" data-slide-to="2"></li>
  </ol>

  <!-- Wrapper for slides -->
  <div class="carousel-inner" role="listbox">
    <div class="item active">
      <img src="..." alt="...">
      <div class="carousel-caption">
        ...
      </div>
    </div>
    <div class="item">
      <img src="..." alt="...">
      <div class="carousel-caption">
        ...
      </div>
    </div>
    ...
  </div>

  <!-- Controls -->
  <a class="left carousel-control" href="#carousel-example-generic" role="button" data-slide="prev">
    <span class="glyphicon glyphicon-chevron-left" aria-hidden="true"></span>
    <span class="sr-only">Previous</span>
  </a>
  <a class="right carousel-control" href="#carousel-example-generic" role="button" data-slide="next">
    <span class="glyphicon glyphicon-chevron-right" aria-hidden="true"></span>
    <span class="sr-only">Next</span>
  </a>
</div>

Izbirni napisi

Svojim diapozitivom preprosto dodajte napise z .carousel-captionelementom znotraj katerega koli .item. Vanj vstavite skoraj vsak izbirni HTML in samodejno bo poravnan in oblikovan.

<div class="item">
  <img src="..." alt="...">
  <div class="carousel-caption">
    <h3>...</h3>
    <p>...</p>
  </div>
</div>

Več vrtiljakov

Vrtiljaki zahtevajo uporabo idna skrajni zunanji posodi ( .carousel) za pravilno delovanje krmilnikov vrtiljaka. Ko dodajate več vrtiljakov ali spreminjate vrtiljak id, ne pozabite posodobiti ustreznih kontrolnikov.

Preko podatkovnih atributov

Uporabite atribute podatkov za preprost nadzor položaja vrtiljaka. data-slidesprejme ključne besede prevali next, ki spremenijo položaj diapozitiva glede na trenutni položaj. Druga možnost je, da uporabite data-slide-toza posredovanje neobdelanega indeksa diapozitiva na vrtiljak data-slide-to="2", ki premakne položaj diapozitiva na določen indeks, ki se začne z 0.

Atribut data-ride="carousel"se uporablja za označevanje vrtiljaka kot animiranega, ki se začne ob nalaganju strani. Ni ga mogoče uporabiti v kombinaciji z (odvečno in nepotrebno) eksplicitno inicializacijo JavaScript istega vrtiljaka.

Prek JavaScripta

Ročno pokličite vrtiljak z:

$('.carousel').carousel()

Možnosti je mogoče posredovati prek podatkovnih atributov ali JavaScripta. Za atribute podatkov pripnite ime možnosti v data-, kot v data-interval="".

Ime vrsta privzeto opis
interval število 5000 Količina časa zakasnitve med samodejnim kroženjem elementa. Če je false, se vrtiljak ne bo samodejno vrtel.
pavza niz | nič "lebdeti" Če je nastavljeno na "hover", začasno ustavi kroženje vrtiljaka na mouseenterin nadaljuje s kroženjem vrtiljaka na mouseleave. Če je nastavljeno na null, se s kazalcem miške nad vrtiljakom ne zaustavite.
zaviti logično prav Ali naj vrtiljak kroži neprekinjeno ali se mora močno ustaviti.
tipkovnico logično prav Ali naj se vrtiljak odzove na dogodke na tipkovnici.

Inicializira vrtiljak z izbirnimi možnostmi objectin začne krožiti med elementi.

$('.carousel').carousel({
  interval: 2000
})

Kroži skozi elemente vrtiljaka od leve proti desni.

Prepreči kroženje vrtiljaka med predmeti.

Preklopi vrtiljak na določen okvir (na osnovi 0, podobno matriki).

Preklopi na prejšnji element.

Preklopi na naslednji element.

Bootstrapov razred vrtiljaka izpostavlja dva dogodka za priključitev na funkcijo vrtiljaka.

Oba dogodka imata naslednje dodatne lastnosti:

  • direction: Smer, v katero drsi vrtiljak ( "left"ali "right").
  • relatedTarget: Element DOM, ki je potisnjen na svoje mesto kot aktivni element.

Vsi dogodki vrtiljaka se sprožijo na samem vrtiljaku (tj. na <div class="carousel">).

Vrsta dogodka Opis
slide.bs.carousel Ta dogodek se sproži takoj, ko slideje priklicana metoda primerka.
slid.bs.carousel Ta dogodek se sproži, ko vrtiljak zaključi prehod diapozitivov.
$('#myCarousel').on('slide.bs.carousel', function () {
  // do something…
})

Pritrdite affix.js

Primer

Vtičnik za pritrditev se vklopi position: fixed;in izklopi ter posnema učinek, ki ga najdete z position: sticky;. Podnavigacija na desni je predstavitev vtičnika za pritrditev v živo.


Uporaba

Uporabite vtičnik za pritrditev prek atributov podatkov ali ročno z lastnim JavaScriptom. V obeh primerih morate zagotoviti CSS za položaj in širino vaše pripete vsebine.

Opomba: ne uporabljajte vtičnika za pritrditev na elementu, ki je v sorazmerno postavljenem elementu, kot je vlečeni ali potisnjeni stolpec, zaradi napake pri upodabljanju Safarija .

Pozicioniranje preko CSS

Vtičnik za pritrditev preklaplja med tremi razredi, od katerih vsak predstavlja določeno stanje: .affix, .affix-topin .affix-bottom. Za obdelavo dejanskih položajev morate za te razrede zagotoviti sloge, z izjemo position: fixed;na , sami (neodvisno od tega vtičnika)..affix

Takole deluje vtičnik za pritrditev:

  1. Za začetek vtičnik doda .affix-top, da označi, da je element na skrajnem zgornjem položaju. Na tej točki CSS pozicioniranje ni potrebno.
  2. Pomikanje mimo elementa, ki ga želite pritrditi, bi moralo sprožiti dejansko pritrditev. Tukaj .affixzamenja .affix-topin nastavi position: fixed;(zagotavlja Bootstrapov CSS).
  3. Če je definiran spodnji odmik, mora pomikanje mimo njega nadomestiti .affixz .affix-bottom. Ker odmiki niso obvezni, morate za nastavitev enega nastaviti ustrezen CSS. V tem primeru dodajte position: absolute;po potrebi. Vtičnik uporablja atribut podatkov ali možnost JavaScript, da od tam določi, kam naj postavi element.

Sledite zgornjim korakom, da nastavite svoj CSS za eno od spodnjih možnosti uporabe.

Preko podatkovnih atributov

Če želite preprosto dodati vedenje pritrjevanja kateremu koli elementu, preprosto dodajte data-spy="affix"elementu, za katerim želite vohuniti. Uporabite odmike, da določite, kdaj želite preklopiti pripenjanje elementa.

<div data-spy="affix" data-offset-top="60" data-offset-bottom="200">
  ...
</div>

Prek JavaScripta

Pokličite vtičnik za pritrditev prek JavaScripta:

$('#myAffix').affix({
  offset: {
    top: 100,
    bottom: function () {
      return (this.bottom = $('.footer').outerHeight(true))
    }
  }
})

Opcije

Možnosti je mogoče posredovati prek podatkovnih atributov ali JavaScripta. Za atribute podatkov pripnite ime možnosti v data-, kot v data-offset-top="200".

Ime vrsta privzeto opis
odmik številka | funkcija | predmet 10 Slikovne pike za odmik od zaslona pri izračunu položaja drsenja. Če je navedena ena sama številka, bo odmik uporabljen tako v zgornji kot spodnji smeri. Če želite zagotoviti edinstven, spodnji in zgornji odmik, samo zagotovite predmet offset: { top: 10 }ali offset: { top: 10, bottom: 5 }. Uporabite funkcijo, ko morate dinamično izračunati odmik.
tarča selektor | vozlišče | element jQuery windowpredmet _ Podaja ciljni element pripone.

Metode

.affix(options)

Aktivira vašo vsebino kot priloženo vsebino. Sprejema neobvezne možnostiobject .

$('#myAffix').affix({
  offset: 15
})

.affix('checkPosition')

Ponovno izračuna stanje pritrditve na podlagi dimenzij, položaja in položaja drsenja ustreznih elementov. , .affix, .affix-topin.affix-bottom se dodajo ali odstranijo iz pripete vsebine glede na novo stanje. To metodo je treba poklicati vsakič, ko se spremenijo dimenzije pritrjene vsebine ali ciljnega elementa, da se zagotovi pravilno pozicioniranje pritrjene vsebine.

$('#myAffix').affix('checkPosition')

Dogodki

Bootstrapov vtičnik za pritrditev razkrije nekaj dogodkov za priključitev na funkcionalnost pritrditev.

Vrsta dogodka Opis
affix.bs.affix Ta dogodek se sproži tik preden je element pritrjen.
pritrjen.bs.pritrditev Ta dogodek se sproži, ko je bil element pritrjen.
affix-top.bs.affix Ta dogodek se sproži tik preden je element pritrjen na vrh.
affixed-top.bs.affix Ta dogodek se sproži, ko je element pritrjen na vrh.
affix-bottom.bs.affix Ta dogodek se sproži tik preden je element pritrjen na dno.
pritrjeno-dno.bs.pritrditev Ta dogodek se sproži, ko je element pritrjen na dno.