Yfirlit

Einstök eða samsett

Viðbætur geta verið innifalin fyrir sig (með því að nota einstakar *.jsskrár Bootstrap), eða allar í einu (með því að nota bootstrap.jseða minnkað bootstrap.min.js).

Með því að nota samsetta JavaScript

Bæði bootstrap.jsog bootstrap.min.jsinnihalda öll viðbætur í einni skrá. Láttu aðeins einn fylgja með.

Viðbætur ósjálfstæði

Sum viðbætur og CSS íhlutir eru háðir öðrum viðbótum. Ef þú lætur viðbætur fylgja með sér, vertu viss um að athuga hvort þessar ósjálfstæði séu í skjölunum. Athugaðu líka að öll viðbætur eru háðar jQuery (þetta þýðir að jQuery verður að vera með á undan viðbótaskránum). Hafðu samband við okkurbower.json til að sjá hvaða útgáfur af jQuery eru studdar.

Gagnaeiginleikar

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

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

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

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

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

Aðeins ein viðbót fyrir hvern þátt í gegnum gagnaeiginleika

Ekki nota gagnaeiginleika frá mörgum viðbótum á sama þáttinn. Til dæmis getur hnappur ekki bæði haft verkfæraleiðbeiningar og skipt um form. Til að ná þessu skaltu nota umbúðir.

Forritað API

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

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

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

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

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

Sjálfgefnar stillingar

Þú getur breytt sjálfgefnum stillingum fyrir viðbót með því að breyta Constructor.DEFAULTShlut viðbótarinnar:

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

Engin átök

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

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

Viðburðir

Bootstrap býður upp á sérsniðna atburði fyrir einstaka aðgerðir flestra viðbætur. Yfirleitt koma þær í óendanlegu formi og þátíð - þar sem óendanlegur (til dæmis show) er ræstur í upphafi atburðar, og þátíðarform hans (til dæmis shown) er ræst þegar aðgerð er lokið.

Frá og með 3.0.0 eru allir Bootstrap viðburðir með nafnabili.

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

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

Útgáfunúmer

Hægt er að nálgast útgáfuna af hverri jQuery viðbót Bootstrap í gegnum VERSIONeign byggingaraðila viðbótarinnar. Til dæmis, fyrir tooltip viðbótina:

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

Engar sérstakar frávik þegar JavaScript er óvirkt

Viðbætur Bootstrap falla ekki sérstaklega tignarlega til baka þegar JavaScript er óvirkt. Ef þér er annt um notendaupplifunina í þessu tilviki, notaðu <noscript>þá til að útskýra aðstæður (og hvernig á að virkja JavaScript aftur) fyrir notendum þínum og/eða bæta við eigin sérsniðnum fallbacks.

Bókasöfn þriðja aðila

Bootstrap styður ekki opinberlega þriðja aðila JavaScript bókasöfn eins og Prototype eða jQuery UI. Þrátt fyrir .noConflictatburði með nafnabili geta komið upp samhæfnisvandamál sem þú þarft að laga á eigin spýtur.

Umskipti transition.js

Um umskipti

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

Hvað er inni

Transition.js er grunnhjálp fyrir transitionEndviðburði sem og CSS umbreytingarhermi. Það er notað af öðrum viðbótum til að athuga hvort stuðningur við CSS umskipti sé og til að ná hangandi umbreytingum.

Slökkva á umskiptum

Hægt er að slökkva á umbreytingum á heimsvísu með því að nota eftirfarandi JavaScript bút, sem verður að koma eftir að transition.js(eða bootstrap.jseða bootstrap.min.js, eftir atvikum) hefur verið hlaðið:

$.support.transition = false

Modals modal.js

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

Margar opnar gerðir eru ekki studdar

Vertu viss um að opna ekki form á meðan annað er enn sýnilegt. Til að sýna fleiri en eina aðferð í einu þarf sérsniðinn kóða.

Formal markup staðsetning

Reyndu alltaf að setja HTML kóða mótals á efstu stigi í skjalinu þínu til að koma í veg fyrir að aðrir þættir hafi áhrif á útlit og/eða virkni formsins.

Fyrirvarar fyrir farsíma

Það eru nokkrir fyrirvarar varðandi notkun forms í farsímum. Skoðaðu stuðningsskjöl vafrans okkar fyrir frekari upplýsingar.

Vegna þess hvernig HTML5 skilgreinir merkingarfræði sína, hefur autofocusHTML eigindin engin áhrif í Bootstrap aðferðum. Til að ná sömu áhrifum skaltu nota sérsniðið JavaScript:

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

Dæmi

Statískt dæmi

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

<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 -->

Sýning í beinni

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

<!-- 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>

Gerðu útfærslur aðgengilegar

Vertu viss um að bæta við role="dialog"og aria-labelledby="...", með vísan í titil formsins, til .modal, og role="document"til .modal-dialogsjálfs.

Að auki geturðu gefið lýsingu á valmyndinni þinni með aria-describedbyá .modal.

Fella inn YouTube myndbönd

Að fella inn YouTube myndbönd í modals krefst viðbótar JavaScript sem er ekki í Bootstrap til að stöðva spilun sjálfkrafa og fleira. Sjá þessa gagnlegu Stack Overflow færslu fyrir frekari upplýsingar.

Valfrjálsar stærðir

Modals hafa tvær valfrjálsar stærðir, fáanlegar í gegnum breytingaflokka til að setja á .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 bs-example-modal-lg" 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 bs-example-modal-sm" tabindex="-1" role="dialog" aria-labelledby="mySmallModalLabel">
  <div class="modal-dialog modal-sm" role="document">
    <div class="modal-content">
      ...
    </div>
  </div>
</div>

Fjarlægðu hreyfimyndir

Fyrir snið sem einfaldlega birtast frekar en að hverfa inn til að skoða, fjarlægðu .fadeflokkinn úr aðferðamerkingunni þinni.

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

Notkun netkerfisins

Til að nýta Bootstrap grid kerfið innan forms, hreiðurðu bara .rows innan .modal-bodyog notaðu síðan venjulega grid kerfisflokkana.

<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 -->

Ertu með fullt af hnöppum sem kveikja allir á sama forminu, bara með aðeins mismunandi innihaldi? Notaðu event.relatedTargetog HTML data-*eiginleika (hugsanlega í gegnum jQuery ) til að breyta innihaldi formsins eftir því hvaða hnapp var smellt á. Sjá Modal Events skjölin fyrir upplýsingar um relatedTarget,

...fleiri hnappar...
<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)
})

Notkun

Modal viðbótin skiptir um falið efni eftir beiðni, með gagnaeiginleikum eða JavaScript. Það bætir einnig við .modal-open<body>hnekkja sjálfgefnum skrunhegðun og býr .modal-backdroptil smellisvæði til að hafna sýndum aðferðum þegar smellt er utan aðferðarinnar.

Í gegnum gagnaeiginleika

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

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

Með JavaScript

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

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

Valmöguleikar

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

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

Þessi valkostur er úreltur frá v3.3.0 og hefur verið fjarlægður í v4. Við mælum með því að nota í staðinn sniðmát fyrir viðskiptavini eða gagnabindingaramma, eða að hringja í jQuery.load sjálfur.

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

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

Aðferðir

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

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

Skiptir handvirkt um form. Snýr aftur til þess sem hringir áður en aðferðin hefur verið sýnd eða falin (þ.e. áður en atburðurinn shown.bs.modaleða hidden.bs.modalá sér stað).

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

Opnar form handvirkt. Snýr aftur til þess sem hringir áður en aðferðin hefur verið sýnd (þ.e. áður en shown.bs.modalatburðurinn á sér stað).

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

Felur form handvirkt. Snýr aftur til þess sem hringir áður en aðferðin hefur verið falin (þ.e. áður en hidden.bs.modalatburðurinn á sér stað).

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

Endurstillir staðsetningu módelsins til að vinna gegn skrunstiku ef einhver ætti að birtast, sem myndi láta aðferðina hoppa til vinstri.

Aðeins þörf þegar hæð mótsins breytist á meðan hún er opin.

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

Viðburðir

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

Öllum mótaviðburðum er skotið á mótalann sjálfan (þ.e. á <div class="modal">).

Tegund atburðar Lýsing
show.bs.modal Þessi atburður ræsir strax þegar showtilviksaðferðin er kölluð. Ef smellt er af völdum er smellt þáttur tiltækur sem relatedTargeteign atburðarins.
sýnd.bs.módel Þessi atburður er ræstur þegar modal hefur verið gert sýnilegt notandanum (bíður eftir að CSS umbreytingum ljúki). Ef smellt er af völdum er smellt þáttur tiltækur sem relatedTargeteign atburðarins.
hide.bs.modal Þessi atburður er ræstur strax þegar hidetilviksaðferðin hefur verið kölluð.
hidden.bs.modal Þessi atburður er ræstur þegar aðferðin hefur lokið við að vera falin fyrir notandanum (mun bíða eftir að CSS umbreytingum ljúki).
loaded.bs.modal Þessi atburður er ræstur þegar modal hefur hlaðið efni með því að nota remotevalkostinn.
$('#myModal').on('hidden.bs.modal', function (e) {
  // do something...
})

Dropdowns dropdown.js

Bættu fellivalmyndum við næstum hvað sem er með þessari einföldu viðbót, þar á meðal navbar, flipa og pillur.

Innan siglingastiku

Innan pilla

Með gagnaeiginleikum eða JavaScript breytir fellivalmyndinni falið efni (fellivalmyndir) með því að skipta um .openbekk á yfirliðinu á listanum.

Í farsímum bætir það við að opna fellivalmynd .dropdown-backdropsem tappasvæði til að loka fellivalmyndum þegar bankað er utan valmyndarinnar, sem er krafa um réttan iOS stuðning. Þetta þýðir að til að skipta úr opinni fellivalmynd yfir í aðra fellivalmynd þarf aukasmellingu á farsíma.

Athugið: data-toggle="dropdown"Stuðst er við eiginleikann til að loka fellivalmyndum á forritastigi, svo það er góð hugmynd að nota hann alltaf.

Í gegnum gagnaeiginleika

Bættu data-toggle="dropdown"við tengil eða hnapp til að skipta um fellilista.

<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>

Til að halda vefslóðum óskertum með tenglahnöppum skaltu nota data-targeteigindina í stað 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>

Með JavaScript

Hringdu í fellilistana í gegnum JavaScript:

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

data-toggle="dropdown"enn krafist

Óháð því hvort þú hringir í fellilistann þinn í gegnum JavaScript eða notar þess í stað gagna-api, data-toggle="dropdown"þarf alltaf að vera til staðar á kveikjuhluta fellilistans.

Enginn

Skiptir á fellivalmynd tiltekinnar siglingastiku eða flipaleiðsögu.

Allir fellilistann atburðir eru ræstir á .dropdown-menu's parent element.

Allir atburðir í fellilistanum eru með relatedTargeteiginleika þar sem gildi hans er kveikjankeri.

Tegund atburðar Lýsing
sýna.bs.fellilista Þessi atburður ræsir strax þegar sýningartilviksaðferðin er kölluð.
sýnd.bs.fellilisti Þessi atburður er ræstur þegar fellivalmyndin hefur verið gerð sýnileg notanda (mun bíða eftir CSS umskiptum til að ljúka).
fela.bs.valmynd Þessi atburður er ræstur strax þegar fela tilviksaðferðin hefur verið kölluð.
falinn.bs.fellilisti Þessi atburður er ræstur þegar fellivalmyndinni hefur verið falið fyrir notandanum (bíður eftir CSS umskiptum til að ljúka).
$('#myDropdown').on('show.bs.dropdown', function () {
  // do something…
})

ScrollSpy scrollspy.js

Dæmi í navbar

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

@feiti

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

@mdo

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

einn

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

tveir

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

three

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

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

Notkun

Krefst Bootstrap nav

Scrollspy krefst þess nú að nota Bootstrap nav íhlut til að auðkenna virka tengla á réttan hátt.

Skiljanleg auðkennismarkmið krafist

Navbar tenglar verða að hafa leysanleg auðkennismarkmið. Til dæmis <a href="#home">home</a>verður að samsvara einhverju í DOM eins og <div id="home"></div>.

Ómarksatriði :visiblehunsuð

Markþættir sem eru ekki :visiblesamkvæmt jQuery verða hunsaðir og samsvarandi nav atriði þeirra verða aldrei auðkennd.

Krefst hlutfallslegrar staðsetningar

Sama innleiðingaraðferðina, scrollspy krefst þess að þú notir position: relative;þáttinn sem þú ert að njósna um. Í flestum tilfellum er þetta <body>. Þegar þú flettir á aðra þætti en <body>, vertu viss um að hafa heightsett og overflow-y: scroll;notað.

Í gegnum gagnaeiginleika

Til að bæta scrollspy hegðun auðveldlega við toppstikuna þína skaltu bæta data-spy="scroll"við þættinum sem þú vilt njósna um (oftast væri þetta <body>). Bættu síðan við data-targeteigindinni með auðkenninu eða flokki móðurþáttar hvers Bootstrap .navíhluta.

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>

Með JavaScript

Eftir að þú hefur bætt position: relative;við CSS skaltu hringja í scrollspy í gegnum JavaScript:

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

Aðferðir

.scrollspy('refresh')

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

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

Valmöguleikar

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

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

Viðburðir

Tegund atburðar Lýsing
active.bs.scrollspy Þessi atburður ræsir í hvert sinn sem nýr hlutur verður virkjaður af scrollspy.
$('#myScrollspy').on('activate.bs.scrollspy', function () {
  // do something…
})

Skiptanlegur flipar tab.js

Dæmi flipar

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

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

Food truck fixie locavore, accusamus mcsweeney's marfa nulla single-origin coffee squid. Exercitation +1 labore velit, blog sartorial PBR leggings next level wes anderson artisan four loko farm-to-table craft beer twee. Qui photo booth letterpress, commodo enim craft beer mlkshk aliquip jean shorts ullamco ad vinyl cillum PBR. Homo nostrud organic, assumenda labore aesthetic magna delectus mollit. Keytar helvetica VHS salvia yr, vero magna velit sapiente labore stumptown. Vegan fanny pack odio cillum wes anderson 8-bit, sustainable jean shorts beard ut DIY ethical culpa terry richardson biodiesel. Art party scenester stumptown, tumblr butcher vero sint qui sapiente accusamus tattooed echo park.

Lengir leiðsögn með flipa

Þessi viðbót eykur flipaleiðsöguhlutann til að bæta við flipasvæðum.

Notkun

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

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

Þú getur virkjað einstaka flipa á nokkra vegu:

$('#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

Þú getur virkjað flipa eða pilluleiðsögn án þess að skrifa JavaScript með því einfaldlega að tilgreina data-toggle="tab"eða data-toggle="pill"á frumefni. Ef þú bætir flokkunum navog nav-tabsvið flipann ulverður Bootstrap flipasniðið notað , en ef þú bætir navog nav-pillsflokkunum verður notað pillusnið .

<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>

Fade áhrif

Til að láta flipa hverfa inn skaltu bæta .fadevið hvern .tab-pane. Fyrsta fliparúðan verður einnig .inað gera upphafsefnið sýnilegt.

<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>

Aðferðir

$().tab

Virkjar flipaþátt og innihaldsílát. Tab ætti að hafa annað hvort a data-targeteða hrefmiða á gámahnút í DOM. Í ofangreindum dæmum eru fliparnir <a>s með data-toggle="tab"eiginleikum.

.tab('show')

Velur tiltekinn flipa og sýnir tengt efni hans. Allir aðrir flipar sem áður voru valdir verða ekki valdir og tengt efni hans er falið. Fer aftur til þess sem hringir áður en flipaglugginn hefur verið sýndur (þ.e. áður en shown.bs.tabatburðurinn á sér stað).

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

Viðburðir

Þegar nýr flipi er sýndur kvikna atburðir í eftirfarandi röð:

  1. hide.bs.tab(á núverandi virka flipa)
  2. show.bs.tab(á flipanum sem á að sýna)
  3. hidden.bs.tab(á fyrri virka flipanum, sá sami og fyrir hide.bs.tabviðburðinn)
  4. shown.bs.tab(á flipanum sem nýlega var sýndur, sá sami og fyrir show.bs.tabviðburðinn)

Ef enginn flipi var þegar virkur, þá verða hide.bs.tabog hidden.bs.tabviðburðir ekki ræstir.

Tegund atburðar Lýsing
sýna.bs.flipa Þessi atburður ræsir á flipasýningu, en áður en nýi flipi hefur verið sýndur. Notaðu event.targetog event.relatedTargettil að miða á virka flipann og fyrri virka flipann (ef tiltækur) í sömu röð.
sýndur.bs.flipi Þessi atburður ræsir á flipasýningu eftir að flipi hefur verið sýndur. Notaðu event.targetog event.relatedTargettil að miða á virka flipann og fyrri virka flipann (ef tiltækur) í sömu röð.
fela.bs.flipa Þessi atburður ræsir þegar nýjan flipa á að sýna (og þar með á að fela fyrri virka flipa). Notaðu event.targetog event.relatedTargettil að miða á núverandi virka flipa og nýja flipa sem bráðum verður virkur, í sömu röð.
falinn.bs.flipi Þessi atburður ræsir eftir að nýr flipi er sýndur (og þar með er fyrri virki flipinn falinn). Notaðu event.targetog event.relatedTargettil að miða á fyrri virka flipann og nýja virka flipann, í sömu röð.
$('a[data-toggle="tab"]').on('shown.bs.tab', function (e) {
  e.target // newly activated tab
  e.relatedTarget // previous active tab
})

Tooltips tooltip.js

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

Verkfæraleiðbeiningar með núlllengdar titlum birtast aldrei.

Dæmi

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

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

Statísk verkfæri

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

Fjórar áttir

<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>

Opt-in virkni

Af frammistöðuástæðum eru Tooltip og Popover data-apis valin, sem þýðir að þú verður að frumstilla þau sjálfur .

Ein leið til að frumstilla allar verkfæraábendingar á síðu væri að velja þær eftir data-toggleeiginleikum þeirra:

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

Notkun

The tooltip tappi býr til efni og álagningu á eftirspurn og setur sjálfgefið verkfæraábendingar á eftir kveikjuhlutanum.

Kveiktu á tóli í gegnum JavaScript:

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

Markup

Nauðsynleg merking fyrir verkfæraleiðbeiningar er aðeins dataeiginleiki og titleá HTML-einingunni viltu hafa verkfæraleiðbeiningar. Mynduð merking tækjaráðs er frekar einföld, þó hún krefjist stöðu (sjálfgefið, stillt á topaf viðbótinni).

<!-- 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>

Marglínu hlekkir

Stundum vilt þú bæta tóli við stiklu sem umlykur margar línur. Sjálfgefin hegðun tólitip viðbótarinnar er að miðja hana lárétt og lóðrétt. Bættu white-space: nowrap;við akkeri til að forðast þetta.

Verkfæri í hnappahópum, inntakshópum og töflum krefjast sérstakrar stillingar

Þegar þú notar verkfæraábendingar á þætti innan .btn-groupeða .input-group, eða á töflutengda þætti ( <td>, <th>, <tr>, <thead>, <tbody>, <tfoot>), þarftu að tilgreina valmöguleikann container: 'body'(skráður hér að neðan) til að forðast óæskilegar aukaverkanir (svo sem að þátturinn stækkar og/ eða missa ávöl hornin þegar tólið er ræst).

Ekki reyna að sýna verkfæraábendingar um falda þætti

Að kalla $(...).tooltip('show')fram þegar markþátturinn er display: none;mun valda því að tólábendingin er rangt staðsett.

Aðgengilegar verkfæraleiðbeiningar fyrir notendur lyklaborðs og hjálpartækja

Fyrir notendur sem flakka með lyklaborði, og sérstaklega notendur hjálpartækni, ættir þú aðeins að bæta tólaábendingum við lyklaborðsfókusa þætti eins og tengla, formstýringar eða hvaða handahófskenndan þátt sem er með tabindex="0"eigind.

Ábendingar um óvirka þætti krefjast umbúðaþátta

Til að bæta tóli við a disabledeða .disabledfrumefni, setjið þáttinn inn í a <div>og notið tólið á það <div>í staðinn.

Valmöguleikar

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

Nafn Tegund Sjálfgefið Lýsing
fjör Boolean satt Notaðu CSS fade umskipti á tólabendinguna
ílát strengur | rangt rangt

Bætir ábendingunni við ákveðinn þátt. Dæmi: container: 'body'. Þessi valkostur er sérstaklega gagnlegur þar sem hann gerir þér kleift að staðsetja tólaskýringuna í flæði skjalsins nálægt kveikjueiningunni - sem kemur í veg fyrir að tólábendingin svífi í burtu frá kveikjueiningunni meðan á stærð gluggans stendur.

seinkun númer | mótmæla 0

Seinkun á að sýna og fela verkfæraábendingu (ms) - á ekki við um handvirka kveikjugerð

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

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

html Boolean rangt Settu HTML inn í tólið. Ef það er rangt verður textaðferð jQuery notuð til að setja efni inn í DOM. Notaðu texta ef þú hefur áhyggjur af XSS árásum.
staðsetningu strengur | virka 'topp'

Hvernig á að staðsetja tólið - efst | botn | vinstri | rétt | sjálfvirkt.
Þegar „sjálfvirk“ er tilgreint mun það breyta tólabendingunni á virkan hátt. Til dæmis, ef staðsetning er „sjálfvirkt vinstri“, mun tólábendingin birtast til vinstri þegar hægt er, annars birtist hún til hægri.

Þegar fall er notað til að ákvarða staðsetninguna er það kallað með tooltip DOM hnútnum sem fyrstu röksemd og kveikjuþáttinn DOM hnút sem seinni. Samhengið thiser stillt á tooltip tilvikið.

veljara strengur rangt Ef valkostur er til staðar verður verkfæravísahlutum úthlutað til tilgreindra skotmarka. Í reynd er þetta notað til að gera kleift að bæta við ábendingum um kvikt HTML efni. Sjá þetta og fróðlegt dæmi .
sniðmát strengur '<div class="tooltip" role="tooltip"><div class="tooltip-arrow"></div><div class="tooltip-inner"></div></div>'

Grunn HTML til að nota þegar þú býrð til verkfæraábendingu.

Verkfæraráðinu titleverður sprautað inn í .tooltip-inner.

.tooltip-arrowverður ör á tóli.

Ysta umbúðaþátturinn ætti að hafa .tooltipflokkinn.

titill strengur | virka ''

Sjálfgefið titilgildi ef titleeigind er ekki til staðar.

Ef fall er gefið upp verður það kallað með thistilvísuninni stillt á þáttinn sem tólið er tengt við.

kveikja strengur 'sveima fókus' Hvernig tólábending er kveikt - smelltu á | sveima | fókus | handbók. Þú gætir farið framhjá mörgum kveikjum; aðskilja þá með bili. manualekki hægt að sameina með neinum öðrum kveikjum.
útsýnissvæði strengur | hlutur | virka { selector: 'body', padding: 0 }

Heldur tóli innan marka þessa þáttar. Dæmi: viewport: '#viewport'eða{ "selector": "#viewport", "padding": 0 }

Ef fall er gefið upp er það kallað með kveikjuþáttinn DOM hnút sem eina röksemd. Samhengið thiser stillt á tooltip tilvikið.

Gagnaeiginleikar fyrir einstakar verkfæraábendingar

Að öðrum kosti er hægt að tilgreina valkosti fyrir einstakar verkfæraábendingar með því að nota gagnaeiginleika, eins og útskýrt er hér að ofan.

Aðferðir

$().tooltip(options)

Hengir verkfæraleiðbeiningum við einingarsafn.

.tooltip('show')

Sýnir verkfæraábendingu frumefnis. Snýr aftur til þess sem hringir áður en verkfæraráðið hefur verið sýnt (þ.e. áður en shown.bs.tooltipatburðurinn á sér stað). Þetta er talið „handvirk“ kveikja á tólabendingunni. Verkfæraleiðbeiningar með núlllengdar titlum birtast aldrei.

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

.tooltip('hide')

Felur ábendingu frumefnis. Snýr aftur til þess sem hringir áður en verkfæraráðið hefur verið falið (þ.e. áður en hidden.bs.tooltipatburðurinn á sér stað). Þetta er talið „handvirk“ kveikja á tólabendingunni.

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

.tooltip('toggle')

Breytir ábendingum frumefnis. Snýr aftur til þess sem hringir áður en verkfæraábendingin hefur verið sýnd eða falin (þ.e. áður en atburðurinn shown.bs.tooltipeða hidden.bs.tooltipá sér stað). Þetta er talið „handvirk“ kveikja á tólabendingunni.

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

.tooltip('destroy')

Felur og eyðileggur ábendingu frumefnis. Verkfæraábendingar sem nota úthlutun (sem eru búnar til með valmöguleikanum selector) er ekki hægt að eyða fyrir sig á afkvæma kveikjuþáttum.

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

Viðburðir

Tegund atburðar Lýsing
sýna.bs.tól Þessi atburður ræsir strax þegar showtilviksaðferðin er kölluð.
sýnd.bs.tákn Þessi atburður er ræstur þegar verkfæraráðið hefur verið gert sýnilegt notandanum (bíður eftir að CSS umbreytingum ljúki).
fela.bs.tól Þessi atburður er ræstur strax þegar hidetilviksaðferðin hefur verið kölluð.
falinn.bs.verkfæraráð Þetta tilvik er ræst þegar tólaábendingin hefur lokið við að vera falin fyrir notandanum (bíður eftir að CSS umbreytingum ljúki).
sett inn.bs.tól Þessi atburður er ræstur eftir show.bs.tooltipatburðinn þegar sniðmát fyrir verkfæraleiðbeiningar hefur verið bætt við DOM.
$('#myTooltip').on('hidden.bs.tooltip', function () {
  // do something…
})

Popovers popover.js

Bættu litlum yfirlagi af efni, eins og á iPad, við hvaða þátt sem er til að hýsa aukaupplýsingar.

Popovers þar sem bæði titill og innihald eru núll lengd birtast aldrei.

Viðbót háð

Popovers krefjast þess að tooltip viðbótin sé innifalin í útgáfunni þinni af Bootstrap.

Opt-in virkni

Af frammistöðuástæðum eru Tooltip og Popover data-apis valin, sem þýðir að þú verður að frumstilla þau sjálfur .

Ein leið til að frumstilla alla sprettiglugga á síðu væri að velja þá eftir data-toggleeiginleikum þeirra:

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

Popovers í hnappahópum, inntakshópum og töflum krefjast sérstakrar stillingar

Þegar þú notar sprettiglugga á þætti innan .btn-groupeða .input-group, eða á töflutengdum þáttum ( <td>, <th>, <tr>, <thead>, <tbody>, <tfoot>), þarftu að tilgreina valmöguleikann container: 'body'(skráð hér að neðan) til að forðast óæskilegar aukaverkanir (svo sem að þátturinn stækkar og/ eða missa ávöl hornin þegar popover er sett af stað).

Ekki reyna að sýna popovers á földum þáttum

Að kalla $(...).popover('show')fram þegar markþátturinn er display: none;mun valda því að popover er rangt staðsettur.

Popovers á óvirkum þáttum krefjast umbúðaþátta

Til að bæta sprettiglugga við a disabledeða .disabledfrumefni, settu frumefnið inn í a <div>og notaðu sprettigluggann á það <div>í staðinn.

Marglínu hlekkir

Stundum vilt þú bæta sprettiglugga við stiklu sem umlykur margar línur. Sjálfgefin hegðun popover viðbótarinnar er að miðja hana lárétt og lóðrétt. Bættu white-space: nowrap;við akkeri til að forðast þetta.

Dæmi

Static popover

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

Popover toppur

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

Popover rétt

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

Popover botn

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

Popover eftir

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

Sýning í beinni

<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>

Fjórar áttir

<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>

Hunsa við næsta smell

Notaðu focuskveikjuna til að hafna sprettiglugga við næsta smell sem notandinn gerir.

Sérstök merking er nauðsynleg til að hafna-við-næsta-smelli

Fyrir rétta hegðun milli vafra og vettvanga verður þú að nota <a>merkið, ekki merkið <button>, og þú verður líka að innihalda role="button"og tabindexeiginleikana.

<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>

Notkun

Virkja popover í gegnum JavaScript:

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

Valmöguleikar

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

Nafn Tegund Sjálfgefið Lýsing
fjör Boolean satt Notaðu CSS fade umskipti á popover
ílát strengur | rangt rangt

Bætir sprettiglugganum við ákveðinn þátt. Dæmi: container: 'body'. Þessi valkostur er sérstaklega gagnlegur þar sem hann gerir þér kleift að staðsetja sprettigluggann í flæði skjalsins nálægt kveikjueiningunni - sem kemur í veg fyrir að sprettigluggan svífi í burtu frá kveikjuhlutanum meðan á stærð gluggans er breytt.

efni strengur | virka ''

Sjálfgefið innihaldsgildi ef data-contenteigind er ekki til staðar.

Ef fall er gefið upp verður það kallað með thistilvísuninni stillt á þáttinn sem popover er tengdur við.

seinkun númer | mótmæla 0

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

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

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

html Boolean rangt Settu HTML inn í popover. Ef það er rangt verður textaðferð jQuery notuð til að setja efni inn í DOM. Notaðu texta ef þú hefur áhyggjur af XSS árásum.
staðsetningu strengur | virka 'rétt'

Hvernig á að staðsetja popover - efst | botn | vinstri | rétt | sjálfvirkt.
Þegar "sjálfvirkt" er tilgreint mun það breyta sprettiglugganum á virkan hátt. Til dæmis, ef staðsetning er „sjálfvirk vinstri“, mun sprettigluggan birtast til vinstri þegar mögulegt er, annars birtist það til hægri.

Þegar fall er notað til að ákvarða staðsetninguna er það kallað með popover DOM hnútinn sem fyrstu röksemd og kveikjuþáttinn DOM hnútinn sem seinni. Samhengið thiser stillt á popover tilvikið.

veljara strengur rangt Ef valkostur er til staðar verða sprettigluggar hlutir framseldir til tilgreindra skotmarka. Í reynd er þetta notað til að gera kviku HTML efni kleift að bæta við sprettigluggum. Sjá þetta og fróðlegt dæmi .
sniðmát strengur '<div class="popover" role="tooltip"><div class="arrow"></div><h3 class="popover-title"></h3><div class="popover-content"></div></div>'

Grunn HTML til að nota þegar þú býrð til popover.

Popoverinu titleverður sprautað inn í .popover-title.

Popoverinu contentverður sprautað inn í .popover-content.

.arrowverður ör popoversins.

Ysta umbúðaþátturinn ætti að hafa .popoverflokkinn.

titill strengur | virka ''

Sjálfgefið titilgildi ef titleeigind er ekki til staðar.

Ef fall er gefið upp verður það kallað með thistilvísuninni stillt á þáttinn sem popover er tengdur við.

kveikja strengur 'smellur' Hvernig popover er kveikt - smelltu á | sveima | fókus | handbók. Þú gætir farið framhjá mörgum kveikjum; aðskilja þá með bili. manualekki hægt að sameina með neinum öðrum kveikjum.
útsýnissvæði strengur | hlutur | virka { selector: 'body', padding: 0 }

Heldur popover innan marka þessa þáttar. Dæmi: viewport: '#viewport'eða{ "selector": "#viewport", "padding": 0 }

Ef fall er gefið upp er það kallað með kveikjuþáttinn DOM hnút sem eina röksemd. Samhengið thiser stillt á popover tilvikið.

Gagnaeiginleikar fyrir einstaka sprettiglugga

Að öðrum kosti er hægt að tilgreina valkosti fyrir einstaka sprettiglugga með því að nota gagnaeiginleika, eins og útskýrt er hér að ofan.

Aðferðir

$().popover(options)

Frumstillir sprettiglugga fyrir þáttasafn.

.popover('show')

Sýnir popover frumefnis. Snýr aftur til þess sem hringir áður en sprettigluggan hefur verið sýnd (þ.e. áður en shown.bs.popoveratburðurinn á sér stað). Þetta er talið „handvirk“ kveikja á popover. Popovers þar sem bæði titill og innihald eru núll lengd birtast aldrei.

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

.popover('hide')

Felur sprettiglugga frumefnis. Snýr aftur til þess sem hringir áður en popover hefur verið falið (þ.e. áður en hidden.bs.popoveratburðurinn á sér stað). Þetta er talið „handvirk“ kveikja á popover.

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

.popover('toggle')

Kveikir á sprettiglugga frumefnis. Snýr aftur til þess sem hringir áður en sprettigluggan hefur verið sýnd eða falin (þ.e. áður en atburðurinn shown.bs.popovereða hidden.bs.popoverá sér stað). Þetta er talið „handvirk“ kveikja á popover.

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

.popover('destroy')

Felur og eyðileggur popover frumefnis. Popovers sem nota úthlutun (sem eru búnar til með valmöguleikanum selector) er ekki hægt að eyða hver fyrir sig á afkvæma kveikjuþáttum.

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

Viðburðir

Tegund atburðar Lýsing
show.bs.poppover Þessi atburður ræsir strax þegar showtilviksaðferðin er kölluð.
sýnd.bs.poppover Þessi atburður er ræstur þegar sprettiglugginn hefur verið gerður sýnilegur notanda (mun bíða eftir að CSS umbreytingum ljúki).
fela.bs.poppover Þessi atburður er ræstur strax þegar hidetilviksaðferðin hefur verið kölluð.
falinn.bs.poppover Þessi atburður er ræstur þegar búið er að fela sprettigluggann fyrir notandanum (bíður eftir að CSS umbreytingum ljúki).
settur.bs.poppover Þessi atburður er rekinn eftir show.bs.popoveratburðinn þegar popover sniðmátinu hefur verið bætt við DOM.
$('#myPopover').on('hidden.bs.popover', function () {
  // do something…
})

Viðvörunarskilaboð alert.js

Dæmi um viðvaranir

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

Þegar .closehnappur er notaður verður hann að vera fyrsta barnið .alert-dismissibleog ekkert textaefni má koma á undan honum í merkingunni.

Notkun

Bættu bara við data-dismiss="alert"lokunarhnappinn þinn til að gefa sjálfkrafa viðvörunarlokunarvirkni. Lokun viðvörunar fjarlægir hana úr DOM.

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

Til að láta tilkynningar þínar nota hreyfimyndir við lokun skaltu ganga úr skugga um að þær hafi .fadeog .inflokkar þegar notaðir fyrir þær.

Aðferðir

$().alert()

Gerir viðvörun til að hlusta eftir smellaviðburðum á afkomandi þáttum sem hafa data-dismiss="alert"eiginleikann. (Ekki nauðsynlegt þegar þú notar sjálfvirka frumstillingu gagnaforritsins.)

$().alert('close')

Lokar viðvörun með því að fjarlægja hana úr DOM. Ef .fadeog .inflokkarnir eru til staðar á frumefninu mun viðvörunin hverfa áður en hún er fjarlægð.

Viðburðir

Viðvörunarviðbót Bootstrap afhjúpar nokkra atburði til að tengjast viðvörunarvirkni.

Tegund atburðar Lýsing
loka.bs.viðvörun Þessi atburður ræsir strax þegar closetilviksaðferðin er kölluð.
lokað.bs.viðvörun Þessi atburður er ræstur þegar viðvöruninni hefur verið lokað (bíður eftir að CSS umskiptum ljúki).
$('#myAlert').on('closed.bs.alert', function () {
  // do something…
})

Hnappar button.js

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

Samhæfni í gegnum vafra

Firefox heldur áfram formstýringarástandi (óvirkt og eftirlit) yfir síðuhleðslu . Lausn fyrir þessu er að nota autocomplete="off". Sjá Mozilla villu #654072 .

Staðhæft

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

Þessi eiginleiki er úreltur frá v3.3.5 og hefur verið fjarlægður í v4.

Notaðu hvaða ástand sem þú vilt!

Vegna þessarar sýnikennslu erum við að nota data-loading-textog $().button('loading'), en það er ekki eina ástandið sem þú getur notað. Sjá nánar um þetta hér að neðan í $().button(string)skjölunum .

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

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

Einn rofi

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

Forstilltir hnappar þurfa .activeogaria-pressed="true"

Fyrir forstillta hnappa verður þú að bæta .activebekknum og aria-pressed="true"eigindinni við buttonsjálfan þig.

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

Gátreitur / útvarp

Bættu data-toggle="buttons"við .btn-groupgátreit sem inniheldur gátreit eða útvarpsinntak til að gera það kleift að skipta í viðkomandi stíl.

Forvalir valkostir þurfa.active

Fyrir forvalna valkosti verður þú að bæta .activebekknum við inntakið labelsjálfur.

Sjónrænt athugað ástand aðeins uppfært við smell

Ef merkt ástand gátreitshnapps er uppfært án þess að kveikja á clickatburði á hnappnum (td með <input type="reset">eða með því að stilla checkedeiginleika inntaksins), þarftu sjálfur að skipta um .activeflokk á inntakinu label.

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

Aðferðir

$().button('toggle')

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

$().button('reset')

Endurstillir stöðu hnapps - skiptir texta yfir í upprunalegan texta. Þessi aðferð er ósamstillt og skilar sér áður en endurstillingunni er í raun lokið.

$().button(string)

Skiptir texta í hvaða gagnaskilgreinda textastöðu sem er.

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

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

Collapse collapse.js

Sveigjanleg viðbót sem notar handfylli af flokkum til að auðvelda skiptahegðun.

Viðbót háð

Collapse krefst þess að umbreytingarviðbótin sé innifalin í útgáfunni þinni af Bootstrap.

Dæmi

Smelltu á hnappana hér að neðan til að sýna og fela annan þátt með bekkjarbreytingum:

  • .collapsefelur efni
  • .collapsinger beitt við umskipti
  • .collapse.insýnir efni

Þú getur notað tengil með hrefeigindinni eða hnapp með data-targeteigindinni. Í báðum tilvikum data-toggle="collapse"er krafist.

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>

Harmonikku dæmi

Framlengdu sjálfgefna fallhegðun til að búa til harmonikku með spjaldíhlutnum.

Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad smokkfiski. 3 Wolf moon officia aut, non cupidatat hjólabretti dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua setja fugl á það smokkfiskur einn uppruna kaffi nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur Butcher Vice Lomo. Leggings occaecat handverksbjór frá bæ til borðs, hrár denim fagurfræðilegur synth nesciunt þú hefur líklega ekki heyrt um þá accusamus labore sjálfbær VHS.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad smokkfiski. 3 Wolf moon officia aut, non cupidatat hjólabretti dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua setja fugl á það smokkfiskur einn uppruna kaffi nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur Butcher Vice Lomo. Leggings occaecat handverksbjór frá bæ til borðs, hrár denim fagurfræðilegur synth nesciunt þú hefur líklega ekki heyrt um þá accusamus labore sjálfbær VHS.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad smokkfiski. 3 Wolf moon officia aut, non cupidatat hjólabretti dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua setja fugl á það smokkfiskur einn uppruna kaffi nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur Butcher Vice Lomo. Leggings occaecat handverksbjór frá bæ til borðs, hrár denim fagurfræðilegur synth nesciunt þú hefur líklega ekki heyrt um þá accusamus labore sjálfbær VHS.
<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>

Það er líka hægt að skipta út .panel-bodys með .list-groups.

  • Bootply
  • Ein itmus ac facilin
  • Annað eros

Gerðu stýringar fyrir stækka/minnka aðgengilegar

Vertu viss um að bæta aria-expandedvið stjórnhlutanum. Þessi eiginleiki skilgreinir beinlínis núverandi stöðu samfellanlegs þáttar fyrir skjálesara og svipaða hjálpartækni. Ef fellanlegur þáttur er lokaður sjálfgefið ætti hann að hafa gildið aria-expanded="false". Ef þú hefur stillt fellanlega þáttinn þannig að hann sé opinn sjálfgefið með því að nota inbekkinn, stilltuaria-expanded="true" þá á stýringuna í staðinn. Viðbótin mun sjálfkrafa skipta um þennan eiginleika út frá því hvort sambrjótanlegur þáttur hefur verið opnaður eða lokaður.

Að auki, ef stjórneiningin þín miðar á einn samanbrjótanlegan þátt – þ.e. data-targeteigindin vísar á idveljara – geturðu bætt viðbótareigind aria-controlsvið stjórneininguna, sem inniheldur idsambrjótanlega eininguna. Nútíma skjálesarar og svipuð hjálpartækni nýta sér þennan eiginleika til að veita notendum viðbótarflýtileiðir til að fletta beint að sjálfum samanbrjótanlegum þættinum.

Notkun

Hrunviðbótin notar nokkra flokka til að takast á við þungar lyftingar:

  • .collapsefelur innihaldið
  • .collapse.insýnir innihaldið
  • .collapsinger bætt við þegar umskiptin hefjast og fjarlægð þegar þeim lýkur

Þessa flokka er að finna í component-animations.less.

Í gegnum gagnaeiginleika

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

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

Með JavaScript

Virkja handvirkt með:

$('.collapse').collapse()

Valmöguleikar

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

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

Aðferðir

.collapse(options)

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

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

.collapse('toggle')

Skiptir um að fellanlegur þáttur sé sýndur eða falinn. Snýr aftur til þess sem hringir áður en fellanlegur þáttur hefur verið sýndur eða falinn (þ.e. áður en atburðurinn shown.bs.collapseeða hidden.bs.collapseá sér stað).

.collapse('show')

Sýnir samanbrjótanlegan þátt. Snýr aftur til þess sem hringir áður en fellanlegur þáttur hefur verið sýndur (þ.e. áður en shown.bs.collapseatburðurinn á sér stað).

.collapse('hide')

Felur samanbrjótanlegt frumefni. Snýr aftur til þess sem hringir áður en fellanlegur þáttur hefur raunverulega verið falinn (þ.e. áður en hidden.bs.collapseatburðurinn á sér stað).

Viðburðir

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

Tegund atburðar Lýsing
sýna.bs.hrun Þessi atburður ræsir strax þegar showtilviksaðferðin er kölluð.
sýnt.bs.hrun Þessi atburður er ræstur þegar hrunþáttur hefur verið gerður sýnilegur notanda (mun bíða eftir að CSS umbreytingum ljúki).
fela.bs.hrynja Þessi atburður er ræstur strax þegar hideaðferðin hefur verið kölluð.
falið.bs.hrun Þessi atburður er ræstur þegar hrunþáttur hefur verið falinn fyrir notandanum (bíður eftir að CSS umbreytingum ljúki).
$('#myCollapsible').on('hidden.bs.collapse', function () {
  // do something…
})

Carousel carousel.js

Skyggnusýningarhluti til að hjóla í gegnum þætti, eins og hringekju. Hreiður hringekjur eru ekki studdar.

<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>

Valfrjáls myndatexti

Bættu texta við skyggnurnar þínar auðveldlega með .carousel-captionþættinum í hvaða .item. Settu næstum hvaða valfrjálsa HTML þar inn og það verður sjálfkrafa stillt og sniðið.

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

Margar hringekjur

Hringekjur krefjast þess að notað sé idysta ílátið ( .carousel) til að stjórntæki hringekjunnar virki rétt. Þegar þú bætir við mörgum hringekjum, eða þegar skipt er um hringekju id, vertu viss um að uppfæra viðeigandi stýringar.

Í gegnum gagnaeiginleika

Notaðu gagnaeiginleika til að stjórna staðsetningu hringekjunnar auðveldlega. data-slidesamþykkir lykilorðin preveða next, sem breytir staðsetningu skyggnunnar miðað við núverandi staðsetningu. Að öðrum kosti er hægt að nota data-slide-totil að senda hráa skyggnuvísitölu í hringekjuna data-slide-to="2", sem færir skyggnustöðuna yfir á tiltekna vísitölu sem byrjar á 0.

Eigindin data-ride="carousel"er notuð til að merkja hringekju sem hreyfimynd frá og með hleðslu síðu. Það er ekki hægt að nota það ásamt (óþarfi og óþarfa) skýrri JavaScript frumstillingu á sömu hringekjunni.

Með JavaScript

Hringdu handvirkt í hringekju með:

$('.carousel').carousel()

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

Nafn tegund sjálfgefið lýsingu
bil númer 5000 Tíminn sem líður á milli þess að hlutur er hjólaður sjálfkrafa. Ef það er rangt mun hringekjan ekki ganga sjálfkrafa.
hlé strengur | núll "sveima" Ef stillt er á "hover", gerir hlé á hjólreiðum hringekjunnar á mouseenterog heldur áfram að hjóla hringekjuna á mouseleave. Ef stillt er á null, mun það ekki gera hlé á hringekjunni með því að sveima yfir hringekjunni.
vefja Boolean satt Hvort hringekjan ætti að hjóla stöðugt eða hafa erfið stopp.
lyklaborð Boolean satt Hvort hringekjan eigi að bregðast við lyklaborðsviðburðum.

Frumstillir hringekjuna með valkvæðum valkostum objectog byrjar að hjóla í gegnum hluti.

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

Hringur í gegnum hringekjuhlutina frá vinstri til hægri.

Kemur í veg fyrir að hringekjan hjóli í gegnum hluti.

Hringir hringekjuna að tilteknum ramma (miðað við 0, svipað og fylki).

Fer að fyrra atriði.

Fer í næsta atriði.

Hringekjuflokkur Bootstrap afhjúpar tvo atburði til að tengjast hringekjuvirkni.

Báðir viðburðir hafa eftirfarandi viðbótareiginleika:

  • direction: Sú átt sem hringekjan rennur í (annaðhvort "left"eða "right").
  • relatedTarget: DOM-einingunni sem verið er að renna á sinn stað sem virki hluturinn.

Allir hringekjuviðburðir eru skotnir á hringekjuna sjálfa (þ.e. á <div class="carousel">).

Tegund atburðar Lýsing
rennibraut.bs.hringekja Þessi atburður ræsir strax þegar slidetilviksaðferðin er kölluð fram.
renna.bs.hringekja Þessi atburður er ræstur þegar hringekjan hefur lokið rennibraut sinni.
$('#myCarousel').on('slide.bs.carousel', function () {
  // do something…
})

Festið affix.js

Dæmi

Kveikt og slökkt er á affix viðbótinni position: fixed;og líkir eftir áhrifunum sem finnast með position: sticky;. Undirleiðsögnin til hægri er lifandi kynning á affix viðbótinni.


Notkun

Notaðu affix viðbótina í gegnum gagnaeiginleika eða handvirkt með þínu eigin JavaScript. Í báðum tilfellum verður þú að gefa upp CSS fyrir staðsetningu og breidd efnis sem þú festir á.

Athugið: Ekki nota festingarviðbótina á einingu sem er í tiltölulega staðsettri einingu, eins og dreginni eða ýttri dálki, vegna villu í Safari flutningi .

Staðsetning í gegnum CSS

Affix viðbótin skiptir á milli þriggja flokka, sem hver táknar tiltekið ástand: .affix, .affix-top, og .affix-bottom. Þú verður að útvega stílana, að undanskildum position: fixed;á .affix, fyrir þessa flokka sjálfur (óháð þessari viðbót) til að sjá um raunverulegar stöður.

Svona virkar affix viðbótin:

  1. Til að byrja, bætir viðbótin við .affix-toptil að gefa til kynna að þátturinn sé í efstu stöðu sinni. Á þessum tímapunkti er ekki krafist CSS staðsetningar.
  2. Að fletta framhjá þættinum sem þú vilt festa ætti að koma af stað raunverulegri festingu. Þetta er þar sem kemur í .affixstað .affix-topog setur position: fixed;(veitt af CSS Bootstrap).
  3. Ef botnjöfnun er skilgreind ætti að fletta framhjá því að skipta .affixút fyrir .affix-bottom. Þar sem mótfærslur eru valfrjálsar, þarf að setja einn upp á að þú stillir viðeigandi CSS. Í þessu tilviki skaltu bæta við position: absolute;þegar þörf krefur. Viðbótin notar gagnaeiginleikann eða JavaScript valkostinn til að ákvarða hvar á að staðsetja frumefnið þaðan.

Fylgdu ofangreindum skrefum til að stilla CSS þinn fyrir annan hvorn af notkunarmöguleikunum hér að neðan.

Í gegnum gagnaeiginleika

Til að bæta við festuhegðun auðveldlega við hvaða þátt sem er, bættu bara við data-spy="affix"þáttinn sem þú vilt njósna um. Notaðu frávik til að skilgreina hvenær á að skipta um festingu á þætti.

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

Með JavaScript

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

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

Valmöguleikar

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

Nafn tegund sjálfgefið lýsingu
á móti númer | fall | mótmæla 10 Dílar til að vega á móti frá skjánum þegar reiknað er út stöðu skrununar. Ef ein tala er gefin upp verður offsetið beitt bæði í efri og neðri átt. Til að bjóða upp á einstakt, botn- og toppjöfnun gefðu bara upp hlut offset: { top: 10 }eða offset: { top: 10, bottom: 5 }. Notaðu aðgerð þegar þú þarft að reikna út offset á virkan hátt.
skotmark veljara | hnútur | jQuery þáttur windowhluturinn _ Tilgreinir markeining áfestingarinnar.

Aðferðir

.affix(options)

Virkjar efnið þitt sem ásætt efni. Samþykkir valfrjálsa valkosti object.

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

.affix('checkPosition')

Endurreiknar stöðu festingarinnar út frá víddum, staðsetningu og skrunstöðu viðkomandi þátta. , .affix, .affix-topog .affix-bottomflokkarnir eru bætt við eða fjarlægðir úr áfestu efninu samkvæmt nýju ástandi. Kalla þarf þessa aðferð í hvert sinn sem víddum áfesta efnisins eða markþáttar er breytt, til að tryggja rétta staðsetningu á áfestu efninu.

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

Viðburðir

Bootstrap's fix tappi afhjúpar nokkra atburði til að tengja við affix virkni.

Tegund atburðar Lýsing
festa.bs.festa Þessi atburður kviknar strax áður en þátturinn hefur verið festur á.
fest.bs.festa Þessi atburður er ræstur eftir að þátturinn hefur verið festur á.
festa-topp.bs.festa Þessi atburður kviknar strax áður en þátturinn hefur verið festur efst.
fest-topp.bs.festa Þessi atburður er ræstur eftir að þátturinn hefur verið festur efst.
festa-botn.bs.festa Þessi atburður kviknar strax áður en þátturinn hefur verið festur-neðst.
fest-botn.bs.áfesta Þessi atburður er rekinn eftir að þátturinn hefur verið festur-neðst.