Gysgaça syn

Şahsy ýa-da düzülen

Plaginler aýratynlykda (Bootstrap-yň aýratyn *.jsfaýllaryny ulanyp) ýa-da birbada (ulanylyp bootstrap.jsýa-da kiçeldilip bootstrap.min.js) girizilip bilner.

Toplanan JavaScript-i ulanmak

Bularyň ikisinde bootstrap.js- bootstrap.min.jsde bir faýldaky ähli pluginler bar. Diňe birini goşuň.

Plugine baglylyk

Käbir pluginler we CSS komponentleri beýleki pluginlere baglydyr. Plaginleri aýratynlykda goşsaňyz, resminamalarda bu baglylyklary barlaň. Şeýle hem, ähli pluginleriň jQuery-a baglydygyny ýadyňyzdan çykarmaň (bu jQuery plugin faýllaryndan öň goşulmalydyr ). JQuery-iň haýsy wersiýalarynyň goldanýandygyny görmek üçin biziň bilen maslahatlaşyň .bower.json

Maglumat atributlary

Bootstrap plaginleriniň hemmesini JavaScript-iň bir setirini ýazman diňe bellik API arkaly ulanyp bilersiňiz. Bu “Bootstrap” -yň birinji derejeli API-si we bir plugin ulananyňyzda ilkinji üns bermeli.

Saidagny, käbir ýagdaýlarda bu funksiýany öçürmek islenip bilner. Şol sebäpden, resminamanyň atlary bilen ýazylan ähli hadysalary birleşdirip, maglumat atributy API-ni öçürmek mümkinçiligini berýäris data-api. Bu meňzeýär:

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

Ativea-da bolmasa, belli bir plagini nyşana almak üçin, plugin-iň adyny at giňişligi hökmünde maglumat-api at giňişligi bilen birlikde goşuň:

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

Maglumat atributlary arkaly elemente diňe bir plugin

Bir elementdäki birnäçe pluginlerden maglumat atributlaryny ulanmaň. Mysal üçin, bir düwmäniň ikisinde hem gurallar maslahaty bolup bilmez we modaly üýtgedip bolmaz. Muny amala aşyrmak üçin, örtük elementini ulanyň.

Programmatiki API

Şeýle hem, ähli Bootstrap pluginlerini diňe JavaScript API arkaly ulanyp biljekdigiňize ynanýarys. Publichli köpçülige açyk API-ler ýeke-täk, zynjyrly usullardyr we ýerine ýetirilen kolleksiýany yzyna gaýtaryp berýär.

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

Methodshli usullar goşmaça opsiýa obýektini, belli bir usuly nyşana alýan setiri ýa-da hiç zady kabul etmeli däldir (başlangyç hereketi bilen bir plugin açýar):

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

Her bir plugin, çig konstruktoryny bir Constructoremläkde açýar : $.fn.popover.Constructor. Belli bir plugin mysalyny almak isleseňiz, göni bir elementden alyň : $('[rel="popover"]').data('popover').

Bellenen sazlamalar

Bir plugin üçin deslapky sazlamalary üýtgedip bilersiňiz Constructor.DEFAULTS:

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

Dawa ýok

Käwagt beýleki UI çarçuwalary bilen Bootstrap plaginlerini ulanmaly bolýar. Bu ýagdaýlarda at giňişliginde wagtal-wagtal çaknyşyklar bolup biler. .noConflictŞeýle ýagdaý ýüze çyksa, bahasyny yzyna öwürmek isleýän pluginiňize jaň edip bilersiňiz.

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

Wakalar

“Bootstrap”, pluginleriň özboluşly hereketleri üçin ýörite wakalary üpjün edýär. Umuman aýdylanda, bular infinitif we geçmiş gatnaşyjy görnüşinde bolýar - bu ýerde showbir hadysanyň başynda infinitif (mysal üçin shown) ýüze çykýar we bir iş gutarandan soň öňki gatnaşygy görnüşi (mysal üçin) ýüze çykýar.

3.0.0-a çenli, “Bootstrap” wakalarynyň hemmesi at giňişliginde.

Infhli infinitif hadysalar preventDefaultişlemegi üpjün edýär. Bu, bir hereketiň başlamazdan ozal ýerine ýetirilmegini togtatmak ukybyny üpjün edýär.

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

Arassalaýjy

Gurallar we popovers, HTML-ni kabul edýän wariantlary arassalamak üçin gurlan sanitizatorymyzy ulanýarlar.

Bellenen whiteListbaha aşakdakylar:

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: []
}

Bu başlangyç üçin täze bahalar goşmak isleseňiz whiteList, aşakdakylary edip bilersiňiz:

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)

Sanitizatorymyzdan aýlanyp geçmek isleseňiz, aýratyn kitaphanany, mysal üçin DOMPurify ulanmagy makul bilýän bolsaňyz, aşakdakylary etmeli:

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

Brauzersizdocument.implementation.createHTMLDocument

Internet Explorer 8 ýaly goldamaýan brauzerler bar bolsa document.implementation.createHTMLDocument, gurlan arassaçylyk funksiýasy HTML-ni bolşy ýaly yzyna berýär.

Bu ýagdaýda arassaçylyk işini geçirmek isleseňiz, DOMPurifysanitizeFn ýaly daşarky kitaphanany görkeziň we ulanyň .

Wersiýa belgileri

VERSION“Bootstrap” -yň jQuery pluginleriniň hersiniň wersiýasyna plugin konstruktorynyň eýeçiligi arkaly girip bolýar . Mysal üçin, gurallar üçin plugin üçin:

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

JavaScript ýapylanda aýratyn ýalňyşlyklar ýok

“JavaScript” ýapylanda “Bootstrap” -yň pluginleri aýratyn yza çekilmeýär. Bu ýagdaýda ulanyjynyň tejribesi barada alada edýän bolsaňyz, ulanyjylaryňyza <noscript>ýagdaýy (we JavaScript-i nädip täzeden işletmelidigini) düşündirmek we / ýa-da öz ýalňyşlaryňyzy goşmak üçin ulanyň.

Üçünji tarap kitaphanalary

Bootstrap, Prototype ýa-da jQuery UI ýaly üçünji tarap JavaScript kitaphanalaryny resmi taýdan goldamaýar . Wakalara we at giňişligine garamazdan .noConflict, özbaşdak düzetmeli utgaşyklyk problemalary bolup biler.

Geçiş geçiş.js

Geçişler hakda

Simpleönekeý geçiş effektleri transition.jsüçin beýleki JS faýllary bilen bir gezek goşuň. Eger düzülen (ýa-da kiçeldilen) ulanýan bolsaňyz, bootstrap.jsmuny goşmagyň zerurlygy ýok - ol eýýäm bar.

Içindäki zatlar

transitionEndTransition.js wakalar üçin esasy kömekçi , CSS geçiş emulýatorydyr. Beýleki pluginler tarapyndan CSS geçiş goldawyny barlamak we asylan geçişleri tutmak üçin ulanylýar.

Geçişleri öçürmek

transition.jsGeçişler (ýa bootstrap.js-da bootstrap.min.jsýagdaýyna görä) ýüklenenden soň gelmeli aşakdaky JavaScript parçasyny ulanyp, bütin dünýäde ýapylyp bilner :

$.support.transition = false

Modal.js _

Modallar tertipli, ýöne çeýe, iň az talap edilýän işleýiş we akylly defoltlar bilen gepleşik teklip edýär.

Birnäçe açyk modal goldanylmaýar

Başga biri görünýän mahaly modal açmaň. Bir wagtyň özünde birden köp modal görkezmek, ýörite kod talap edýär.

Modal belligi ýerleşdirmek

Modalyň daşky görnüşine we / ýa-da işleýşine täsir edýän beýleki komponentlerden gaça durmak üçin mydama modalyň HTML koduny resminamanyňyzyň iň ýokary derejesinde goýmaga synanyşyň.

Jübi enjamy

Jübi enjamlarynda modallary ulanmak bilen baglanyşykly käbir gowaklar bar. Jikme-jiklikler üçin brauzer goldaw resminamalarymyza serediň.

HTML5 semantikasyny nädip kesgitleýändigi sebäpli, autofocusHTML atributynyň Bootstrap modallarynda täsiri ýok. Şol bir effekt gazanmak üçin käbir adaty JavaScript ulanyň:

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

Mysallar

Statik mysal

Aşakdaky sözbaşy, göwre we hereketler toplumy bilen görkezilen modal.

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

Göni görkeziş

Aşakdaky düwmä basyp, JavaScript arkaly modal çalşyň. Aşakdan süýşer we sahypanyň ýokarsyndan pese gaçar.

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

Modallary elýeterli ediň

Modal adyna, özüne role="dialog"we özüne goşuň .aria-labelledby="...".modalrole="document".modal-dialog

Mundan başga-da, modal gepleşikleriňiziň düşündirişini berip aria-describedbybilersiňiz .modal.

“YouTube” wideolaryny ýerleşdirmek

YouTube wideolaryny modallara ornaşdyrmak, Bootstrap-da däl, goşmaça JavaScript-i oýnamagy we başga-da köp zady talap edýär. Has giňişleýin maglumat üçin bu peýdaly “Stack overflow” ýazgysyna serediň .

Meýletin ululyklar

Modallarda iki sany goşmaça ululyk bar, a-da goýuljak üýtgediji synplar arkaly .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>

Animasiýany aýyryň

Görmek üçin öçmek däl-de, ýönekeý görünýän modallar üçin .fadesynpy modal belligiňizden aýyryň.

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

Tor ulgamyny ulanmak

“Bootstrap” grid ulgamyndan modalyň içinde peýdalanmak üçin diňe höwürtge dörediň, .rowsoňra .modal-bodyadaty gözenek ulgamy sapaklaryny ulanyň.

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

Birneme üýtgeşik mazmun bilen birmeňzeş modaly herekete getirýän bir topar düwme barmy? Modalyň mazmunyny haýsy düwmä basylandygyna görä üýtgetmek üçin event.relatedTargetHTML atributlaryny data-*( ähtimal jQuery arkaly ) ulanyň . Jikme-jiklikler üçin Modal wakalar resminamalaryna serediň relatedTarget,

... has köp düwme ...
<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)
})

Ulanylyşy

Modal plugin, gizlin mazmunyňyzy maglumat atributlary ýa-da JavaScript arkaly islege görä üýtgedýär. Şeýle hem , deslapky aýlanyş häsiýetini ýok etmek .modal-openüçin goşant goşýar we modalyň daşyna basanyňyzda görkezilen modallary <body>ýatyrmak üçin basmak meýdançasyny döredýär..modal-backdrop

Maglumat atributlary arkaly

JavaScript ýazman modaly işjeňleşdiriň. Dolandyryjy data-toggle="modal"elementi, düwme ýaly, data-target="#foo"ýa-da href="#foo"üýtgetmek üçin belli bir modaly nyşana alyň.

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

JavaScript arkaly

myModalJavaScript-iň bir setiri bolan idli modala jaň ediň :

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

Görnüş

Opsiýalar maglumat atributlary ýa-da JavaScript arkaly geçirilip bilner. Maglumat atributlary üçin, opsiýanyň adyny data-bolşy ýaly goşuň data-backdrop="".

Ady görnüşi gaýybana beýany
fon bulean ýa-da setir'static' dogry Modal-fon elementini öz içine alýar. staticAtivea- da bolmasa, basylanda modaly ýapmaýan fon üçin kesgitläň .
klawiatura boolean dogry Gaçmak düwmesi basylanda modaly ýapýar
görkezmek boolean dogry Başlanylanda modaly görkezýär.
uzakdan ýol ýalan

Bu opsiýa v3.3.0-den bäri köne we v4-de aýryldy. Muňa derek müşderi tarapyndaky şablony ýa-da maglumatlary baglanyşdyrýan çarçuwany ulanmagy ýa-da jQuery.load -a jaň etmegi maslahat berýäris .

Uzakdan URL berilse, mazmun jQuery usuly bilen bir gezek ýüklenerload we diwa sanjym ediler .modal-content. Maglumat-api ulanýan bolsaňyz href, uzakdaky çeşmäni kesgitlemek üçin atributdan peýdalanyp bilersiňiz. Munuň mysaly aşakda görkezilýär:

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

Usullar

Mazmunyňyzy modal hökmünde işjeňleşdirýär. Goşmaça wariantlary kabul edýär object.

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

Modal bilen el bilen çalşyň. Modal hakykatdanam görkezilmän ýa-da gizlenmänkä (ýagny waka shown.bs.modalýa-da hidden.bs.modalwaka ýüze çykmazdan ozal) jaň edýän adama gaýdyp gelýär.

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

Modal bilen el bilen açýar. Modal görkezilmänkä (ýagny shown.bs.modalwaka ýüze çykmazdan ozal) jaň edýän adama gaýdyp gelýär.

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

Modaly el bilen gizleýär. Modal aslynda gizlenmänkä (ýagny waka ýüze çykmazdan ozal) jaň edýän adama gaýdyp gelýär .hidden.bs.modal

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

Modalyň çepe bökmegine sebäp boljak bir ýagdaý ýüze çyksa, aýlaw paneline garşy durmak üçin modalyň ýerleşişini sazlaň.

Diňe modalyň beýikligi açyk wagty üýtgän mahaly zerur.

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

Wakalar

“Bootstrap” -yň modal synpy modal işleýşi üçin birnäçe wakany paş edýär.

Modhli modal wakalar modalyň özünde (ýagny <div class="modal">).

Çäräniň görnüşi Düşündiriş
show.bs.modal showBu waka mysal usuly çagyrylanda derrew ýanýar . Bir gezek basmak bilen ýüze çykan bolsa, basylan element relatedTargetwakanyň häsiýeti hökmünde elýeterlidir.
görkezilen.bs.modal Bu waka modal ulanyja görünen mahaly atylýar (CSS geçişleriniň tamamlanmagyna garaşýar). Bir gezek basmak bilen ýüze çykan bolsa, basylan element relatedTargetwakanyň häsiýeti hökmünde elýeterlidir.
hide.bs.modal Bu waka hidemysal usuly çagyrylanda derrew atylýar.
gizlenen.bs.modal Bu waka, modal ulanyjydan gizlenip gutarandan soň atylýar (CSS geçişleriniň tamamlanmagyna garaşýar).
ýüklenen.bs.modal remoteBu waka, modal opsiýany ulanyp mazmun ýüklän mahaly atylýar .
$('#myModal').on('hidden.bs.modal', function (e) {
  // do something...
})

Açylýan damjalar.js

Bu ýönekeý plugin, deňiz paneli, goýmalar we dermanlar ýaly islendik zada diýen ýaly açylýan menýulary goşuň.

Gämi duralgasynyň içinde

Dermanlaryň içinde

.openMaglumat atributlary ýa-da JavaScript arkaly, açylan plugin ene mazmuny sanawynda synpy üýtgedip gizlin mazmuny (açylýan menýular) üýtgedýär .

.dropdown-backdropJübi enjamlarynda, açylýan menýuny ýapmak üçin menýusyň daşyna degeninde ýapylýan menýulary ýapmak üçin bir ýer goşýar, bu iOS goldawynyň talaby. Diýmek, açyk açylýan menýudan başga açylýan menýuda geçmek, ykjam telefonda goşmaça kran talap edýär.

Bellik: data-toggle="dropdown"Sypat, programma derejesinde açylýan menýulary ýapmak üçin esaslanýar, şonuň üçin ony hemişe ulanmak gowy zat.

Maglumat atributlary arkaly

data-toggle="dropdown"Açylýan zady üýtgetmek üçin baglanyşyk ýa-da düwme goşuň .

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

URL-leri baglanyşyk düwmeleri bilen saklamazlyk üçin, data-targetýerine atribut ulanyň 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>

JavaScript arkaly

JavaScript arkaly açylanlara jaň ediň:

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

data-toggle="dropdown"henizem talap edilýär

Açylýan ýere JavaScript-e jaň edýändigiňize ýa-da ýerine maglumat-api ulanýandygyňyza garamazdan, data-toggle="dropdown"açylan trigger elementinde elmydama bolmaly.

Hiç

Berlen deňiz paneliniň ýa-da bellikli nawigasiýanyň açylan menýusyny üýtgedýär.

.dropdown-menuDownhli açylan wakalar ene-atanyň elementine atylýar .

Downhli açylýan hadysalaryň relatedTargetgymmaty üýtgeýän labyr elementi bolan bir häsiýet bar.

Çäräniň görnüşi Düşündiriş
show.bs.dropdown Bu waka görkeziş usuly çagyrylanda derrew ýanýar.
görkezilen.bs.dropdown Bu waka ulanyja açyk görkezilende (CSS geçişleriniň garaşmagyna garaşýar) atylýar.
hide.bs.dropdown Gizlin mysal usuly çagyrylanda bu waka derrew atylýar.
gizlenen.bs.dropdown Bu waka ulanyjydan gizlenip gutarandan soň (CSS geçişlerine garaşar) atylýar.
$('#myDropdown').on('show.bs.dropdown', function () {
  // do something…
})

ScrollSpy scrollspy.js

Deňiz panelinde mysal

“ScrollSpy” plugin, aýlaw pozisiýasyna esaslanyp nav nyşanlaryny awtomatiki täzelemek üçin. Deňiz paneliniň aşagyndaky meýdany aýlaň we işjeň synp üýtgemegine tomaşa ediň. Açylýan aşaky elementler hem görkeziler.

@fat

Mahabat leggings açary, ertirlik nahary sungat partiýasy dolor zähmeti. “Pitchfork yr enim lo-fi” kwi satmazdan ozal. “Tumblr” ferma-stoluň üstünde welosiped hukugy näme bolsa-da. Anim keffiyeh kardigan. Velit seitan mcsweeney surat stendinde 3 möjek aýy irure. Cosby switer lomo jean şortikleri, williamsburg hoodie minim qui, belki-de siz olar hakda eşitmedik bolsaňyz we kardigan ynam gaznasy culpa biodiesel wes anderson estetiki. Nihil tatuirovka eden akusamus, krediti biodiesel keffiyeh senetçi ullamco netijesi.

@mdo

Weniam marfa murtly skeytbord, fugiat velit pitchfork sakgalyny özüne çekýär. Freegan sakgal aliqua cupidatat mcsweeney's vero. “Cupidatat dört loko nisi”, “helvetica nulla carles”. Tatuirovka edilen kosbi switer iýmit maşyny, mcsweeney's freegan winil. Lo-fi wes anderson +1 bölüm. Karles estetiki däl maşklary ýuwaşlaşdyrýar. Bruklin senetçilik piwo wise keytar deserunt.

biri

Occaecat commodo aliqua delectus. Fap senet piwo deserunt skateboard ea. “Lomo” welosiped hukuklary, banna mi, velit ea sunt indiki derejeli magna weniýamda ýeke-täk kofe. Lifeokary durmuş id vinil, echo park netijesi alikip banh mi pitchfork. Vero VHS est adipisising. “Consectetur nisi DIY” minimal habarçy sumkasy. “Cred ex”, dowamly “delectus consectetur fanny pack iphone”.

iki

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” blogy, nahar ýük maşyny näme bolsa-da. Sapiente synth id çaklama. “Locavore sed helvetica cliche irony”, ýyldyrym çakmalary, belki-de, “glýutensiz lo-fi fap alikipi” sebäpli eşitmediňiz. Satylmanka zähmet çekiň, terri Riçardson proident ertirlik nahary neskiunt quis cosby switer pariatur keffiyeh ut helvetica senetçisi. Kardigan senet piwo seitan taýýar mahmal. VHS chambray laboris tempor veniam. Anim mollit minim commodo ullamco ýyldyrymlary.

Ulanylyşy

Bootstrap nav talap edýär

Scrollspy häzirki wagtda işjeň baglanyşyklary dogry görkezmek üçin Bootstrap nav komponentiniň ulanylmagyny talap edýär .

Çözülip bilinýän ID nyşanlary

Navbar baglanyşyklarynda çözülip bilinýän ID nyşanlary bolmaly. Mysal üçin, <a href="#home">home</a>DOM-daky ýaly bir zada laýyk bolmaly <div id="home"></div>.

Maksat däl :visibleelementler hasaba alynmady

:visibleJQuery-a laýyk gelmeýän nyşan elementleri hasaba alynmaz we degişli deňiz elementleri hiç haçan tapawutlandyrylmaz.

Otnositel ýerleşişini talap edýär

Geçiriş usulyna garamazdan, scrollspy position: relative;içalyçylyk edýän elementiňizde ulanylmagyny talap edýär. Köp halatlarda bu <body>. Ondan başga elementleri aýlanyňyzda, toplumyň we ulanyljakdygyna <body>göz ýetiriň .heightoverflow-y: scroll;

Maglumat atributlary arkaly

Topbar nawigasiýaňyza skrollspy häsiýetini aňsatlyk bilen goşmak data-spy="scroll"üçin içaly bolmak isleýän elementiňize goşuň (köplenç bu şeýle bolar <body>). Soňra islendik Bootstrap komponentiniň data-targetesasy elementiniň ID ýa-da synpy bilen atribut goşuň..nav

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>

JavaScript arkaly

CSS-ä goşanyňyzdan soň position: relative;, JavaScript arkaly scrollspy jaň ediň:

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

Usullar

.scrollspy('refresh')

DOM-dan elementleri goşmak ýa-da aýyrmak bilen bilelikde scrollspy ulananyňyzda, täzeleniş usulyna şeýle jaň etmeli bolarsyňyz:

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

Görnüş

Opsiýalar maglumat atributlary ýa-da JavaScript arkaly geçirilip bilner. Maglumat atributlary üçin, opsiýanyň adyny data-bolşy ýaly goşuň data-offset="".

Ady görnüşi gaýybana beýany
ofset sany 10 Aýlanyş ýagdaýyny hasaplanyňyzda ýokardan ýapyljak pikseller.

Wakalar

Çäräniň görnüşi Düşündiriş
işjeňleşdirmek.bs.scrollspy Scrolllspy tarapyndan täze bir zat işjeňleşdirilende bu waka ýanýar.
$('#myScrollspy').on('activate.bs.scrollspy', function () {
  // do something…
})

Çekip bolýan tablar tab.js

Mysal bellikleri

Contenterli mazmun panellerinden, hatda aşak düşýän menýulardan geçmek üçin çalt, dinamiki tab funksiýasyny goşuň. Içerki goýmalar goldanylmaýar.

Çig denim, Ostin jeans şortikleri hakda eşitmedik bolsaňyz gerek. Nesciunt tofu stumptown aliqua, retro synth master arassalamak. Murtuň gysylmagy, williamsburg carles vegan helvetica. Reprehenderit gassap retro keffiyeh dreamcatcher synth. Cosby switer eu banh mi, qui irure terry richardson ex squid. “Aliquip placeat salvia cillum iphone”. Seitan aliquip quis cardigan amerikan eşigi, gassap 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.

Salgylanan nawigasiýany giňeldýär

Bu plugin, tablisa meýdançalaryny goşmak üçin goýlan nawigasiýa komponentini giňeldýär.

Ulanylyşy

JavaScript arkaly tablisa tablisalaryny açyň (her tab aýratynlykda işjeňleşdirilmeli):

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

Aýry-aýry bellikleri birnäçe usul bilen işjeňleşdirip bilersiňiz:

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

Bellik

data-toggle="tab"Diňe bir elementi ýa-da bir elementi görkezip, hiç hili JavaScript ýazmazdan bir tab ýa-da tablet nawigasiýasyny işjeňleşdirip bilersiňiz data-toggle="pill". navSalgylary we nav-tabssapaklary goşmak, ul“Bootstrap ” goýmasynyň stilini ulanar , şol bir wagtyň özünde sapaklary goşmak bilen navtabletka stilini ulanar .nav-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>

Öçürilen effekt

Salgylaryň ýitmegi .fadeüçin hersine goşuň .tab-pane. Ilkinji goýma paneli hem .inbaşlangyç mazmuny görünmeli.

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

Usullar

$().tab

Salgy elementini we mazmun gapyny işjeňleşdirýär. Salgyda ýa data-target-da hrefDOM-da konteýner düwünini nyşana alýan bolmaly. Aboveokardaky mysallarda, bellikler atributlary bolan <a>s .data-toggle="tab"

.tab('show')

Berlen goýmany saýlaýar we baglanyşykly mazmuny görkezýär. Öň saýlanan başga bir tab saýlanmaýar we oňa bagly mazmun gizlenýär. Salgy paneli hakykatdanam görkezilmänkä (ýagny shown.bs.tabwaka ýüze çykmazdan ozal) jaň edijä gaýdyp gelýär.

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

Wakalar

Täze tab görkezilende wakalar aşakdaky tertipde ýanýar:

  1. hide.bs.tab(häzirki işjeň goýmada)
  2. show.bs.tab(görkezilmeli goýmada)
  3. hidden.bs.tabhide.bs.tab(öňki işjeň goýmada, waka bilen birmeňzeş )
  4. shown.bs.tabshow.bs.tab(täze işjeň görkezilen ýaňy görkezilen goýmada, waka bilen birmeňzeş )

Hiç bir tab goýmasy işjeň bolmadyk bolsa, wakalar hide.bs.tabwe hidden.bs.tabwakalar atylmaz.

Çäräniň görnüşi Düşündiriş
show.bs.tab Bu waka tab goýmasynda ýanýar, ýöne täze goýma görkezilmezden ozal. Işjeň goýmany we öňki işjeň goýmany (bar bolsa) ulanyň event.targetwe nyşana alyň.event.relatedTarget
görkezilen.bs.tab Bu waka, görkezme görkezilenden soň tab goýmasynda ýanýar. Işjeň goýmany we öňki işjeň goýmany (bar bolsa) ulanyň event.targetwe nyşana alyň.event.relatedTarget
hide.bs.tab Bu waka täze goýma görkezilmeli bolanda ýanýar (we şeýlelik bilen öňki işjeň goýma gizlenmeli). Häzirki işjeň goýmany we ýakyn wagtda işjeň boljak täze goýmany ulanyň event.targetwe nyşana alyň.event.relatedTarget
gizlenen.bs.tab Bu waka täze goýma görkezilenden soň ýanýar (we şeýlelik bilen öňki işjeň goýma gizlenýär). Öňki işjeň goýmany we täze işjeň goýmany degişlilikde ulanyň event.targetwe nyşana alyň.event.relatedTarget
$('a[data-toggle="tab"]').on('shown.bs.tab', function (e) {
  e.target // newly activated tab
  e.relatedTarget // previous active tab
})

Gurallar gurallary.js

Jeýson Frame tarapyndan ýazylan ajaýyp jQuery.tipsy plugininden ylham aldy; Gurallar maslahatlary, şekillere bil baglamaýan, animasiýa üçin CSS3 we ýerli at saklamak üçin maglumat atributlaryny ulanýan täzelenen wersiýa.

Nol uzynlykly atlar bilen gurallar hiç haçan görkezilmeýär.

Mysallar

Gural görkezmelerini görmek üçin aşakdaky baglanyşyklara basyň:

Indiki derejeli berk balak , belki , olar hakda eşitmediňiz. Surat stendiniň sakgal çig denim harpy, wegetarian habarçy sumkasy. Fermer-stol stoly, mcsweeney-iň durnukly kwinoa 8 bitli amerikan eşiginde terri Riçardson winil çembraýy bar . Sakgal saklanýar, kardiganlar banh mi lomo ýyldyrym çakýar. Tofu biodizel williamsburg marfa, dört loko msweeniniň arassa wegetarian kamerasy. Hakykatdanam gülkünç bir ussat , haýsy açar, sahna fermasy-stol banksy Austin twitter , freegan kredit denim ýeke-täk kofe wirusly.

Statik gurallar

Dört wariant bar: ýokarky, sag, aşaky we çep deňleşdirilen.

Dört ugur

<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 funksiýasy

Öndürijilik sebäplerine görä, Tooltip we Popover data-apis saýlanýar, ýagny olary özüňiz başlamalysyňyz .

Sahypadaky ähli gural görkezmelerini başlamagyň bir usuly, olary data-toggleatributlary boýunça saýlamak bolar:

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

Ulanylyşy

Gurallar maslahatynyň plugin islege görä mazmun we bellik döredýär we adaty ýagdaýda gural elementlerini trigger elementinden soň ýerleşdirýär.

Gurallar maslahatyny JavaScript arkaly işlediň:

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

Bellik

Gurallar üçin zerur bellik diňe bir dataatributdyr we titleHTML elementinde gurallar maslahatyny almak isleýärsiňiz. Gurallar maslahatynyň döredilen belligi gaty ýönekeý, ýöne bir pozisiýa talap edýär (deslapky görnüşde, topplugin tarapyndan kesgitlenýär).

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

Birnäçe setirli baglanyşyklar

Käwagt birnäçe setiri gurşap alýan giperlinkä gural görkezmesini goşmak isleýärsiňiz. Gural gurallarynyň plugininiň adaty hereketi, ony keseligine we dikligine merkezleşdirmekdir. Munuň öňüni almak üçin labyrlaryňyza goşuň white-space: nowrap;.

Düwme toparlarynda, giriş toparlarynda we tablisalarda gurallar ýörite sazlamany talap edýär

.btn-groupA ýa-da içindäki elementlere ýa .input-group-da stol bilen baglanyşykly elementlere ( ,,,,,) gurallar ulanylanda <td>, islenilmeýän täsirlerden gaça durmak üçin (aşakda resminamalaşdyrylan) opsiýany görkezmeli bolarsyňyz (meselem, element has giňelýär we <th>/ ýa-da gurallar görkezilende tegelek burçlaryny ýitirmek).<tr><thead><tbody><tfoot>container: 'body'

Gizlin elementlerde gural görkezmelerini görkezmäge synanyşmaň

Maksat $(...).tooltip('show')elementi bolanda ýüz tutmak, display: none;gurallar maslahatynyň nädogry ýerleşmegine sebäp bolar.

Klawiatura we kömekçi tehnologiýa ulanyjylary üçin elýeterli gurallar

tabindex="0"Klawiatura bilen gezýän ulanyjylar we esasanam kömekçi tehnologiýalary ulanýanlar üçin diňe baglanyşyklar, forma dolandyryşlary ýa-da atributly islendik özbaşdak element ýaly klawiatura gönükdirilen elementlere gural görkezmelerini goşmaly .

Maýyp elementler boýunça gurallar, örtük elementlerini talap edýär

disabledBir gural ýa-da elemente gural goşmak üçin .disabledelementi içerde goýuň <div>we ýerine gural görkezmesini ulanyň <div>.

Görnüş

Opsiýalar maglumat atributlary ýa-da JavaScript arkaly geçirilip bilner. Maglumat atributlary üçin, opsiýanyň adyny data-bolşy ýaly goşuň data-animation="".

Howpsuzlyk sebäpli sanitize, sanitizeFnwe whiteListatributlary maglumat atributlary bilen üpjün edip bolmaýandygyny unutmaň.

Ady Görnüşi Bellenen Düşündiriş
animasiýa boolean dogry Gurallar maslahatyna CSS solgun geçişini ulanyň
gap setir | ýalan ýalan

Gurallar maslahatyny belli bir elemente goşýar. Mysal : container: 'body'. Bu opsiýa, gural görkezijisini resminamanyň akymynda hereketlendiriji elementiň ýanynda ýerleşdirmäge mümkinçilik berýänligi üçin peýdalydyr - bu penjiräniň ölçegi üýtgän mahaly gural görkezijisiniň hereketlendiriji elementden uzaklaşmagynyň öňüni alar.

gijikdirmek sany | obýekt 0

Gural görkezmesini görkezmek we gizlemek (ms) - el bilen işleýän trigger görnüşine degişli däl

San berilse, gizlemek / görkezmek üçin gijikdirme ulanylýar

Obýektiň gurluşy:delay: { "show": 500, "hide": 100 }

html boolean ýalan Gurallar maslahatyna HTML salyň. Falsealňyş bolsa, jQuery textusuly DOM-a mazmun girizmek üçin ulanylar. XSS hüjümleri barada alada edýän bolsaňyz, tekst ulanyň.
ýerleşdirmek setir | funksiýasy 'ýokarky'

Gurallar maslahatyny nädip ýerleşdirmeli - ýokarky | aşagy | çep | dogry | awtoulag.
"Awto" görkezilende, gural görkezijisini dinamiki üýtgeder. Mysal üçin, ýerleşdirmek "awtomatik çep" bolsa, gural görkezmesi mümkin boldugyça çepe görkeziler, ýogsam sag görkeziler.

Locationerleşişi kesgitlemek üçin bir funksiýa ulanylanda, ilkinji argument hökmünde gurallar DOM düwünine, ikinjisi hökmünde hereketlendiriji element DOM düwünine diýilýär. Kontekst thisgurallar maslahatyna düzüldi.

saýlaýjy setir ýalan Eger saýlaýjy üpjün edilse, gurallar obýektleri görkezilen nyşanlara berler. Iş ýüzünde, bu dinamiki goşulan DOM elementlerine ( jQuery.ongoldaw) gural görkezmelerini ulanmak üçin hem ulanylýar. Muny we maglumat beriji mysaly görüň .
şablon setir '<div class="tooltip" role="tooltip"><div class="tooltip-arrow"></div><div class="tooltip-inner"></div></div>'

Gurallar maslahatyny döredeniňizde ulanmak üçin HTML-i esaslaň.

Gurallar maslahatyna titlesanjym ediler .tooltip-inner.

.tooltip-arrowgurallaryň oky bolar.

Daşky örtük elementi .tooltipsynp bolmaly.

ady setir | funksiýasy ''

Sypat ýok bolsa, deslapky at bahasy title.

Eger bir funksiýa berilse, thisgurallar toplumynyň birikdirilen elementine salgylanma toplumy bilen çagyrylar.

trigger setir 'ünsi jemlemek' Gurallar maslahatynyň nädip döredilendigi - basyň | aýlanmak | fokus | gollanma. Birnäçe trigger geçirip bilersiňiz; boşluk bilen bölüň. manualbaşga bir trigger bilen birleşdirip bolmaz.
görnüş setir | obýekt | funksiýasy {saýlaýjy: 'beden', padding: 0}

Gurallar maslahatyny bu elementiň çäginde saklaýar. Mysal: viewport: '#viewport'ýa-da{ "selector": "#viewport", "padding": 0 }

Eger bir funksiýa berilse, ýeke-täk argument hökmünde hereketlendiriji element DOM düwün bilen atlandyrylýar. Kontekst thisgurallar maslahatyna düzüldi.

arassaçylyk boolean dogry Arassaçylygy işletmek ýa-da öçürmek. Işledilen 'template'bolsa 'content'we 'title'opsiýalar arassalanar.
ak sanaw obýekt Bellenen baha Rugsat berlen atributlary we bellikleri öz içine alýan obýekt
sanitizeFn null | funksiýasy null Bu ýerde öz arassaçylyk funksiýaňyzy üpjün edip bilersiňiz. Arassaçylyk işini geçirmek üçin ýörite kitaphanany ulanmagy makul bilýän bolsaňyz, bu peýdaly bolup biler.

Aýry-aýry gurallar üçin maglumatlar atributlary

Aýry-aýry gurallar üçin opsiýalar, ýokarda düşündirilişi ýaly maglumat atributlaryny ulanmak arkaly kesgitlenip bilner.

Usullar

$().tooltip(options)

Gurallar işleýjisini elementler ýygyndysyna dakýar.

.tooltip('show')

Bir elementiň gural görkezmesini açýar. Gural görkezmesi hakykatdanam görkezilmänkä (ýagny shown.bs.tooltipwaka ýüze çykmazdan ozal) jaň edijä gaýdyp gelýär. Bu gurallar maslahatynyň "gollanma" başlangyjy hasaplanýar. Nol uzynlykdaky atlar bilen gurallar hiç haçan görkezilmeýär.

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

.tooltip('hide')

Bir elementiň gural görkezmesini gizleýär. Gurallar maslahaty hakykatdanam gizlenmänkä (ýagny hidden.bs.tooltipwaka ýüze çykmazdan ozal) jaň edýän adama gaýdyp gelýär. Bu gurallar maslahatynyň "gollanma" başlangyjy hasaplanýar.

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

.tooltip('toggle')

Bir elementiň gurallar maslahatyny üýtgedýär. Gurallar görkezmesi hakykatdanam görkezilmän ýa-da gizlenmänkä (ýagny waka shown.bs.tooltipýa-da hidden.bs.tooltipwaka ýüze çykmazdan ozal) jaň edýän adama gaýdyp gelýär. Bu gurallar maslahatynyň "gollanma" başlangyjy hasaplanýar.

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

.tooltip('destroy')

Bir elementiň gural görkezmesini gizleýär we ýok edýär. Delegasiýany ulanýan gurallar (opsiýany ulanyp döredilýär ) selectornesil trigger elementlerinde aýratyn ýok edilip bilinmez.

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

Wakalar

Çäräniň görnüşi Düşündiriş
show.bs.tooltip showBu waka mysal usuly çagyrylanda derrew ýanýar .
görkezildi.bs.tooltip Bu waka gural görkezijisi ulanyja görünen mahaly atylýar (CSS geçişleriniň tamamlanmagyna garaşýar).
hide.bs.tooltip Bu waka hidemysal usuly çagyrylanda derrew atylýar.
gizlenen.bs.tooltip Bu waka, gural görkezmesi ulanyjydan gizlenenden soň (CSS geçişleriniň tamamlanmagyna garaşýar) atylýar.
insert.bs.tooltip show.bs.tooltipBu waka , gurallar şablony DOM-a goşulandan soň atylýar .
$('#myTooltip').on('hidden.bs.tooltip', function () {
  // do something…
})

Popover popover.js

Ikinji derejeli maglumat üçin islendik elemente, “iPad” -daky ýaly mazmunyň kiçi gatlaklaryny goşuň.

Iki ady we mazmuny nol uzynlykdaky popovers hiç haçan görkezilmeýär.

Plugine baglylyk

“Popovers” gurallar plugininiň “Bootstrap” wersiýasyna goşulmagyny talap edýär.

Opt-in funksiýasy

Öndürijilik sebäplerine görä, Tooltip we Popover data-apis saýlanýar, ýagny olary özüňiz başlamalysyňyz .

Sahypadaky ähli açyjylary başlamagyň bir usuly, olary data-toggleatributlary boýunça saýlamak bolar:

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

Düwme toparlarynda, giriş toparlarynda we tablisalarda çykýanlar ýörite sazlamany talap edýär

.btn-groupA ýa-da içindäki elementlerde ýa .input-group-da stol bilen baglanyşykly elementlerde ( ,,,,, ) açylýan ýerleri ulananyňyzda , <td>islenilmeýän täsirlerden (meselem, elementiň has giňelmegi we <th>/ ýa-da açylanda tegelek burçlaryny ýitirmek).<tr><thead><tbody><tfoot>container: 'body'

Gizlin elementlerde popovers görkezmäge synanyşmaň

Maksat $(...).popover('show')elementiniň haçan bolandygyny soramak display: none;, çykýan ýeriň nädogry ýerleşmegine sebäp bolar.

Maýyp elementleriň üstündäki ýazgylar, örtük elementlerini talap edýär

disabledA ýa-da .disabledelemente popover goşmak üçin elementi a-nyň içine goýuň we ýerine <div>popover-i ulanyň <div>.

Birnäçe setirli baglanyşyklar

Käwagt birnäçe setiri gurşap alýan giperlinkä popover goşmak isleýärsiňiz. Açylýan pluginiň adaty hereketi, ony keseligine we dikligine merkezleşdirmekdir. Munuň öňüni almak üçin labyrlaryňyza goşuň white-space: nowrap;.

Mysallar

Statik popover

Dört wariant bar: ýokarky, sag, aşaky we çep deňleşdirilen.

Iň ýokary

Lobortisdäki “posuere consectetur est”. Aenean eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

Popover dogry

Lobortisdäki “posuere consectetur est”. Aenean eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

Aşakdaky ýazgy

Lobortisdäki “posuere consectetur est”. Aenean eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

Popover gitdi

Lobortisdäki “posuere consectetur est”. Aenean eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

Göni görkeziş

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

Dört ugur

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

Indiki gezek basyň

focusUlanyjynyň indiki basan ýerinde açylanlary işden çykarmak üçin trigger ulanyň .

Işden çykarmak üçin indiki basmak üçin zerur bellik

Dogry kross-brauzer we platforma häsiýeti üçin bellik däl -de, <a>belligi ulanmaly, şeýle hem atributlary goşmaly .<button>role="button"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>

Ulanylyşy

JavaScript arkaly açylýan ýerleri açyň:

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

Görnüş

Opsiýalar maglumat atributlary ýa-da JavaScript arkaly geçirilip bilner. Maglumat atributlary üçin, opsiýanyň adyny data-bolşy ýaly goşuň data-animation="".

Howpsuzlyk sebäpli sanitize, sanitizeFnwe whiteListatributlary maglumat atributlary bilen üpjün edip bolmaýandygyny unutmaň.

Ady Görnüşi Bellenen Düşündiriş
animasiýa boolean dogry Açylýan ýerine CSS solgun geçişini ulanyň
gap setir | ýalan ýalan

Açylýan ýeri belli bir elemente goşýar. Mysal : container: 'body'. Bu opsiýa, esasanam, açylýan resminamany hereketlendiriji elementiň ýanynda resminamanyň akymynda ýerleşdirmäge mümkinçilik berýänligi sebäpli peýdalydyr - bu penjiräniň ölçegi üýtgän mahaly açylýan elementiň daşlaşmagynyň öňüni alar.

mazmuny setir | funksiýasy ''

Sypat ýok bolsa, deslapky mazmun bahasy data-content.

Eger bir funksiýa berilse, thisaçylan elemente salgylanma toplumy bilen çagyrylar.

gijikdirmek sany | obýekt 0

Açylýan ýeri (ms) görkezmek we gizlemek - el bilen trigger görnüşine degişli däl

San berilse, gizlemek / görkezmek üçin gijikdirme ulanylýar

Obýektiň gurluşy:delay: { "show": 500, "hide": 100 }

html boolean ýalan Açylýan ýere HTML salyň. Falsealňyş bolsa, jQuery textusuly DOM-a mazmun girizmek üçin ulanylar. XSS hüjümleri barada alada edýän bolsaňyz, tekst ulanyň.
ýerleşdirmek setir | funksiýasy 'dogry'

Açylýan ýeri nädip ýerleşdirmeli - ýokarky | aşagy | çep | dogry | awtoulag.
"Awto" görkezilende, çykýan ýeri dinamiki taýdan üýtgeder. Mysal üçin, ýerleşdirmek "awtomatik çep" bolsa, çykýan ýer mümkin boldugyça çepe görkeziler, ýogsam sag görkeziler.

Locationerleşişi kesgitlemek üçin bir funksiýa ulanylanda, ilkinji argumenti hökmünde çykýan DOM düwünine, ikinjisi hökmünde hereketlendiriji element DOM düwünine diýilýär. Kontekst thisaçylan meselä düzüldi.

saýlaýjy setir ýalan Eger saýlaýjy üpjün edilse, açylan obýektler görkezilen nyşanlara berler. Iş ýüzünde, dinamiki HTML mazmunyny açýanlary goşmak üçin ulanylýar. Muny we maglumat beriji mysaly görüň .
şablon setir '<div class="popover" role="tooltip"><div class="arrow"></div><h3 class="popover-title"></h3><div class="popover-content"></div></div>'

Açylýan ýer döredilende ulanjak HTML-i esaslaň.

Açylanlaryň titleiçine sanjym ediler .popover-title.

Açylanlaryň contentiçine sanjym ediler .popover-content.

.arrowaçylýan ok bolar.

Daşky örtük elementi .popoversynp bolmaly.

ady setir | funksiýasy ''

Sypat ýok bolsa, deslapky at bahasy title.

Eger bir funksiýa berilse, thisaçylan elemente salgylanma toplumy bilen çagyrylar.

trigger setir 'basyň' Nädip açylýandygy - basyň | aýlanmak | fokus | gollanma. Birnäçe trigger geçirip bilersiňiz; boşluk bilen bölüň. manualbaşga bir trigger bilen birleşdirip bolmaz.
görnüş setir | obýekt | funksiýasy {saýlaýjy: 'beden', padding: 0}

Açylýan ýeri bu elementiň çäginde saklaýar. Mysal: viewport: '#viewport'ýa-da{ "selector": "#viewport", "padding": 0 }

Eger bir funksiýa berilse, ýeke-täk argument hökmünde hereketlendiriji element DOM düwün bilen atlandyrylýar. Kontekst thisaçylan meselä düzüldi.

arassaçylyk boolean dogry Arassaçylygy işletmek ýa-da öçürmek. Işledilen 'template'bolsa 'content'we 'title'opsiýalar arassalanar.
ak sanaw obýekt Bellenen baha Rugsat berlen atributlary we bellikleri öz içine alýan obýekt
sanitizeFn null | funksiýasy null Bu ýerde öz arassaçylyk funksiýaňyzy üpjün edip bilersiňiz. Arassaçylyk işini geçirmek üçin ýörite kitaphanany ulanmagy makul bilýän bolsaňyz, bu peýdaly bolup biler.

Aýry-aýry açyjylar üçin maglumatlar atributlary

Aýry-aýry açyjylar üçin opsiýalar, ýokarda düşündirilişi ýaly maglumat atributlaryny ulanmak arkaly kesgitlenip bilner.

Usullar

$().popover(options)

Element ýygnamak üçin açylanlary başlaýar.

.popover('show')

Bir elementiň açylýan ýerini açýar. Açylýan ýer görkezilmänkä (ýagny shown.bs.popoverwaka ýüze çykmazdan ozal) jaň edýän adama gaýdyp gelýär. Bu açylýan ýeriň "el bilen" başlamagy hasaplanýar. Iki ady we mazmuny nol uzynlykdaky popovers hiç haçan görkezilmeýär.

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

.popover('hide')

Bir elementiň açylýan ýerini gizleýär. Açylýan ýer hakykatdanam gizlenmänkä (ýagny hidden.bs.popoverwaka ýüze çykmazdan ozal) jaň edýän adama gaýdyp gelýär. Bu açylýan ýeriň "el bilen" başlamagy hasaplanýar.

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

.popover('toggle')

Bir elementiň açylýan ýerini üýtgedýär. Açylýan ýer görkezilmän ýa-da gizlenmänkä (ýagny waka shown.bs.popoverýa-da hidden.bs.popoverwaka ýüze çykmazdan ozal) jaň edýän adama gaýdyp gelýär. Bu açylýan ýeriň "el bilen" başlamagy hasaplanýar.

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

.popover('destroy')

Bir elementiň açylýan ýerini gizleýär we ýok edýär. Delegasiýany ulanýan poplar (opsiýany ulanyp döredilýär ) selectornesil trigger elementlerinde aýratyn ýok edilip bilinmez.

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

Wakalar

Çäräniň görnüşi Düşündiriş
show.bs.popover showBu waka mysal usuly çagyrylanda derrew ýanýar .
görkezilen.bs.popover Bu waka, ulanyjynyň adyna açyk görkezilende (CSS geçişleriniň tamamlanmagyna garaşýar) atylýar.
hide.bs.popover Bu waka hidemysal usuly çagyrylanda derrew atylýar.
gizlenen.bs.popover Bu waka, ulanyjydan gizlenenden soň (CSS geçişleriniň tamamlanmagyna garaşýar) atylýar.
insert.bs.popover show.bs.popoverBu waka , DOM-a popover şablony goşulandan soň atylýar .
$('#myPopover').on('hidden.bs.popover', function () {
  // do something…
})

Duýduryş habarlary alert.js

Mysal duýduryşlary

Bu plugin bilen ähli duýduryş habarlaryna işden çykarmak funksiýasyny goşuň.

Bir .closedüwme ulanylanda, ol ilkinji çagasy bolmaly .alert-dismissiblewe bellikde hiç hili tekst mazmuny gelip bilmez.

Ulanylyşy

data-dismiss="alert"Duýduryşyň ýakyn işlemegini awtomatiki bermek üçin diňe ýakyn düwmäňize goşuň . Duýduryşy ýapmak ony DOM-dan aýyrýar.

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

.fadeIngapylanda duýduryşlaryňyzy animasiýa ulanmagy üçin, eýýäm olara we .insapaklara degişlidigine göz ýetiriň .

Usullar

$().alert()

Aýratynlygy bolan nesil elementlerine basmak hadysalaryny duýduryş diňleýär data-dismiss="alert". (Data-api-iň awtomatiki başlangyjy ulanylanda hökman däl.)

$().alert('close')

DOM-dan aýyrmak bilen duýduryşy ýapýar. Eger elementde .fadewe .insynplar bar bolsa, duýduryş aýrylmazdan ozal öçer.

Wakalar

“Bootstrap” -yň duýduryş plugin, duýduryş funksiýasyna girmek üçin birnäçe wakany paş edýär.

Çäräniň görnüşi Düşündiriş
close.bs.alert closeBu waka mysal usuly çagyrylanda derrew ýanýar .
ýapyk.bs.alert Bu waka duýduryş ýapylanda atylýar (CSS geçişleriniň tamamlanmagyna garaşýar).
$('#myAlert').on('closed.bs.alert', function () {
  // do something…
})

Düwmeler düwmesi.js

Düwmeler bilen has köp iş ediň. Dolandyryş düwmesi gurallar paneli ýaly has köp komponentler üçin düwmeler toparyny görkezýär ýa-da döredýär.

Brauzeriň gabat gelmegi

“Firefox” sahypa ýükleriniň arasynda dolandyryş ýagdaýlaryny (maýyplyk we barlamak) dowam edýär . Munuň üçin bir çözgüt ulanmak autocomplete="off". Mozilla bug # 654072 serediň .

Döwlet

data-loading-text="Loading..."Bir düwmä ýükleme ýagdaýyny ulanmak üçin goşuň .

Bu aýratynlyk v3.3.5-den bäri köneldi we v4-de aýryldy.

Haýsy ştaty halaýan bolsaňyz ulanyň!

Bu demonstrasiýa üçin ulanýarys data-loading-textwe ulanýarys $().button('loading'), ýöne bu ulanyp boljak ýeke-täk döwlet däl. Aşakda $().button(string)resminamalarda has giňişleýin serediň .

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

Leeke üýtgetmek

data-toggle="button"Bir düwmä basmagy işjeňleşdirmek üçin goşuň .

Öňünden üýtgedilen düwmeler gerek .activewearia-pressed="true"

.activeÖňünden üýtgedilen düwmeler üçin synpy we aria-pressed="true"häsiýeti özüňize goşmaly button.

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

Bellik gutusy / Radio

Degişli stilde üýtgetmek mümkinçiligini öz içine alýan gutujyga ýa-da radio girişlerine data-toggle="buttons"goşuň ..btn-group

Saýlanan saýlawlar zerur.active

.activeÖňünden saýlanan wariantlar üçin synpy girişiň özüne goşmaly label.

Wizual barlanan ýagdaý diňe basylanda täzelenýär

Bellik gutusynyň barlanylan ýagdaýy düwmä clickhadysany atmazdan (meselem , giriş emlägini kesgitlemek <input type="reset">arkaly ) täzelenen bolsa, girişiň üstünde synpy üýtgetmeli bolarsyňyz.checked.activelabel

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

Usullar

$().button('toggle')

Toggles ýagdaýy basýar. Düwmä işjeňleşdirilen görnüşini berýär.

$().button('reset')

Düwme ýagdaýyny täzeden düzýär - teksti asyl tekste çalyşýar. Bu usul asynkron bolup, täzeden düzmek gutarmanka gaýdyp gelýär.

$().button(string)

Teksti kesgitlenen islendik maglumat ýagdaýyna çalyşýar.

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

Apseykylmak.js _

Özüňi alyp barşyňy aňsatlaşdyrmak üçin sanlyja synpy ulanýan çeýe plugin.

Plugine baglylyk

Apseykylmak, geçiş plagininiň Bootstrap wersiýaňyza goşulmagyny talap edýär .

Mysal

Synp üýtgeşmeleri arkaly başga bir elementi görkezmek we gizlemek üçin aşakdaky düwmelere basyň:

  • .collapsemazmuny gizleýär
  • .collapsinggeçiş döwründe ulanylýar
  • .collapse.inmazmunyny görkezýär

Sypat bilen hrefbaglanyşyk ýa-da atributly düwme ulanyp bilersiňiz data-target. Iki ýagdaýda-da data-toggle="collapse"talap edilýär.

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>

Akkordeon mysaly

Panel komponenti bilen akkordeon döretmek üçin deslapky çöküş häsiýetini giňeldiň.

Anim pariatur cliche reprehenderit, enim eiusmod ýokary durmuş accusamus terry richardson ad squid. 3 möjek aýy officia aute, cupidatat däl skateboard dolor ertirlik. Azyk ýük maşyny quinoa nesciunt laborum eiusmod. Ertirlik nahary 3 möjek aý tempor, sunt aliqua bir guş kofe nulla assomenda shoreditch we ş.m. Nihil anim keffiyeh helvetica, piwo zähmeti wes anderson kredit nesciunt sapiente ea proident. Mahabat wegetarian aýratyn gassap wise-lomo. “Leggings occaecat senet” piwo fermasy-stol, çig denim estetiki synth nesciunt, belki-de, olaryň “VHS” işini dowam etdirýändigini eşitmediňiz.
Anim pariatur cliche reprehenderit, enim eiusmod ýokary durmuş accusamus terry richardson ad squid. 3 möjek aýy officia aute, cupidatat däl skateboard dolor ertirlik. Azyk ýük maşyny quinoa nesciunt laborum eiusmod. Ertirlik nahary 3 möjek aý tempor, sunt aliqua bir guş kofe nulla assomenda shoreditch we ş.m. Nihil anim keffiyeh helvetica, piwo zähmeti wes anderson kredit nesciunt sapiente ea proident. Mahabat wegetarian aýratyn gassap wise-lomo. “Leggings occaecat senet” piwo fermasy-stol, çig denim estetiki synth nesciunt, belki-de, olaryň “VHS” işini dowam etdirýändigini eşitmediňiz.
Anim pariatur cliche reprehenderit, enim eiusmod ýokary durmuş accusamus terry richardson ad squid. 3 möjek aýy officia aute, cupidatat däl skateboard dolor ertirlik. Azyk ýük maşyny quinoa nesciunt laborum eiusmod. Ertirlik nahary 3 möjek aý tempor, sunt aliqua bir guş kofe nulla assomenda shoreditch we ş.m. Nihil anim keffiyeh helvetica, piwo zähmeti wes anderson kredit nesciunt sapiente ea proident. Mahabat wegetarian aýratyn gassap wise-lomo. “Leggings occaecat senet” piwo fermasy-stol, çig denim estetiki synth nesciunt, belki-de, olaryň “VHS” işini dowam etdirýändigini eşitmediňiz.
<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>

.panel-bodyS bilen s -leri çalyşmak hem mümkin .list-group.

  • Bootply
  • Bir itmus ac facilin
  • Ikinji eros

Giňeltmek / ýykmak dolandyryşlaryny elýeterli ediň

aria-expandedDolandyryş elementine hökman goşuň . Bu aýratynlyk, okyjylary ekrana çykarmak we şuňa meňzeş kömekçi tehnologiýalar üçin çöküp bilýän elementiň häzirki ýagdaýyny aç-açan kesgitleýär. Apsykylýan element deslapky ýagdaýda ýapylan bolsa, onuň bahasy bolmaly aria-expanded="false". Apsykylýan elementi insynpy ulanyp, açyk diýip kesgitlän bolsaňyz aria-expanded="true", ýerine dolandyryşda goýuň. Plagin, ýykylýan elementiň açylandygyna ýa-da ýapylmagyna esaslanyp, bu atributy awtomatiki usulda üýtgeder.

Mundan başga-da, dolandyryş elementiňiz ýekeje çöküp bilýän elementi nyşana alýan bolsa, ýagny data-targetatribut saýlaýjyny görkezýän bolsa - ýykylýan elementiň düzümini öz içine alýan dolandyryş elementine idgoşmaça atribut goşup bilersiňiz . Döwrebap ekran okaýjylary we şuňa meňzeş kömekçi tehnologiýalar, ulanyjylary ýykylýan elementiň özüne gönüden-göni geçmek üçin goşmaça gysga ýollar bilen üpjün etmek üçin bu atributdan peýdalanýarlar.aria-controlsid

Ulanylyşy

Apseykylýan plugin agyr götermek üçin birnäçe synp ulanýar:

  • .collapsemazmuny gizleýär
  • .collapse.inmazmunyny görkezýär
  • .collapsinggeçiş başlanda goşulýar we gutarandan soň aýrylýar

Bu sapaklary tapyp bilersiňiz component-animations.less.

Maglumat atributlary arkaly

Aykylýan elementiň gözegçiligini awtomatiki bellemek üçin elemente data-toggle="collapse"we a goşuň . data-targetAýratynlyk data-target, çökmegi ulanmak üçin CSS saýlaýjysyny kabul edýär. Synpy collapseýykylýan elemente goşuň. Adaty açylmagyny isleseňiz, goşmaça synp goşuň in.

Apsykylýan dolandyryşa akkordeona meňzeş topar dolandyryşyny goşmak üçin maglumat atributyny goşuň data-parent="#selector". Muny hereketde görmek üçin demo serediň.

JavaScript arkaly

El bilen işlediň:

$('.collapse').collapse()

Görnüş

Opsiýalar maglumat atributlary ýa-da JavaScript arkaly geçirilip bilner. Maglumat atributlary üçin, opsiýanyň adyny data-bolşy ýaly goşuň data-parent="".

Ady görnüşi gaýybana beýany
ene-atasy saýlaýjy ýalan Eger saýlaýjy üpjün edilen bolsa, bu ýykylýan element görkezilende görkezilen ene-atanyň aşagyndaky ähli çöküp bilýän elementler ýapylar. (adaty akkordeon häsiýetine meňzeýär - bu panelsynpa bagly)
üýtgetmek boolean dogry Apykylýan elementi çakylyk bilen üýtgedýär

Usullar

.collapse(options)

Mazmunyňyzy çökýän element hökmünde işjeňleşdirýär. Goşmaça wariantlary kabul edýär object.

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

.collapse('toggle')

Görkezilýän ýa-da gizlenýän elementi çalyşýar. Apsykylýan element hakykatdanam görkezilmän ýa-da gizlenmänkä (ýagny waka shown.bs.collapseýa-da hidden.bs.collapsewaka ýüze çykmazdan ozal) jaň edijä gaýdyp gelýär.

.collapse('show')

Apsykylýan elementi görkezýär. Apsykylýan element hakykatdanam görkezilmänkä (ýagny shown.bs.collapsewaka ýüze çykmazdan ozal) jaň edijä gaýdyp gelýär.

.collapse('hide')

Apsykylýan elementi gizleýär. Apsykylýan element aslynda gizlenmänkä (ýagny hidden.bs.collapsewaka ýüze çykmazdan ozal) jaň edijä gaýdyp gelýär.

Wakalar

“Bootstrap” -yň çökmegi synpy, çökmek funksiýasyna girmek üçin birnäçe wakany paş edýär.

Çäräniň görnüşi Düşündiriş
show.bs.collapse showBu waka mysal usuly çagyrylanda derrew ýanýar .
görkezildi.bs.collapse Bu hadysa, çöküş elementi ulanyja görünen mahaly atylýar (CSS geçişleriniň tamamlanmagyna garaşýar).
hide.bs.collapse hideBu waka usul çagyrylanda derrew atylýar .
gizlenen.bs.collapse Bu waka ulanyjydan çökmek elementi gizlenende (CSS geçişleriniň tamamlanmagyna garaşýar) atylýar.
$('#myCollapsible').on('hidden.bs.collapse', function () {
  // do something…
})

Karusel karusel.js

Karusel ýaly elementleriň üsti bilen tigir sürmek üçin slaýdşow komponenti. Höwürtgelenen karuseller goldanylmaýar.

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

Meýletin ýazgylar

Slaýdlaryňyza ýazgylary .carousel-captionislendik element bilen aňsatlyk bilen goşuň .item. Islendik goşmaça HTML-i şol ýerde ýerleşdiriň we awtomatiki usulda düzüler we formatlanar.

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

Birnäçe karusel

Karuseller , karusel dolandyryşlarynyň kadaly işlemegi üçin iddaşarky gapda ( ) ulanylmagyny talap edýär . .carouselBirnäçe karusel goşanyňyzda ýa-da karuseliň çalşylanda id, degişli dolandyryşlary täzeläň.

Maglumat atributlary arkaly

Karuseliň ýagdaýyny aňsatlyk bilen dolandyrmak üçin maglumat atributlaryny ulanyň. data-slideaçar sözleri kabul edýär prevýa-da nextslaýd ýagdaýyny häzirki ýagdaýyna görä üýtgedýär. Ativea- da bolmasa, slaýd ýagdaýyny başlaýan belli bir görkezijä geçirýän data-slide-toçig slaýd indeksini karusele geçirmek üçin ulanyň .data-slide-to="2"0

Bu data-ride="carousel"atribut, karuseli sahypa ýükünden başlap janlandyryjy hökmünde bellemek üçin ulanylýar. Şol bir karuseliň aç-açan JavaScript başlangyjy bilen (artykmaç we gereksiz) bilelikde ulanylyp bilinmez.

JavaScript arkaly

Karusel bilen el bilen jaň ediň:

$('.carousel').carousel()

Opsiýalar maglumat atributlary ýa-da JavaScript arkaly geçirilip bilner. Maglumat atributlary üçin, opsiýanyň adyny data-bolşy ýaly goşuň data-interval="".

Ady görnüşi gaýybana beýany
aralyk sany 5000 Bir elementi awtomatiki tigir sürmek arasynda gijä galmagyň wagty. Falsealan bolsa, karusel awtomatiki usulda aýlanmaz.
pauza setir | null "aýlaw" Gurnalan bolsa "hover", karuseliň tigir sürmegini duruzýar we karuseliň mouseentertigir sürmegini dowam etdirýär mouseleave. Eger sazlanan bolsa null, karuseliň üstünde gezmek ony saklamaz.
örtmek boolean dogry Karuseliň yzygiderli aýlanmalydygy ýa-da gaty duralgalary bolmaly.
klawiatura boolean dogry Karuseliň klawiatura hadysalaryna reaksiýa bermelimi.

Karuseli islege bagly görnüşler objectbilen başlaýar we zatlaryň üsti bilen tigir sürüp başlaýar.

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

Karusel önümleriniň çepden saga aýlanmagy.

Karuseliň zatlaryň üsti bilen tigir sürmegini bes edýär.

Karuseli belli bir ramka aýlaýar (massiwlere meňzeş 0 esasly).

Öňki elemente aýlawlar.

Indiki elemente aýlawlar.

“Bootstrap” -yň karusel synpy karuseliň işlemegi üçin iki hadysany paş edýär.

Iki wakanyň hem aşakdaky goşmaça aýratynlyklary bar:

  • direction: Karuseliň süýşýän ugry (ýa "left"-da "right").
  • relatedTarget: Işjeň element hökmünde ýerine süýşürilýän DOM elementi.

Karusel hadysalarynyň hemmesi karuseliň özüne (ýagny <div class="carousel">).

Çäräniň görnüşi Düşündiriş
slaýd.bs.carousel slideBu waka mysal usuly ulanylanda derrew ýanýar.
slid.bs.carousel Bu waka karusel slaýd geçişini tamamlandan soň atylýar.
$('#myCarousel').on('slide.bs.carousel', function () {
  // do something…
})

Affix affix.js

Mysal

Affiks plugin position: fixed;, tapylan effekti öýkünip, ýapýar position: sticky;. Sag tarapdaky subnawigasiýa affiks plagininiň göni ýaýlymydyr.


Ulanylyşy

Affiks pluginini maglumat atributlary ýa-da öz JavaScript bilen el bilen ulanyň. Iki ýagdaýda-da berkidilen mazmunyň ýerleşişi we giňligi üçin CSS-i üpjün etmeli.

Bellik: Safari hödürlemek ýalňyşlygy sebäpli çekilen ýa-da iteklenen sütün ýaly birneme ýerleşen elementdäki affiks pluginini ulanmaň .

CSS arkaly ýerleşiş

Affiks plugin üç synpyň arasynda üýtgeýär, hersi belli bir ýagdaýy görkezýär : .affix, .affix-topwe .affix-bottom. position: fixed;Hakyky pozisiýalary .affixdolandyrmak üçin bu synplar üçin özüňiz (bu plugin garaşsyz) stilleri üpjün etmeli .

Affiks plugininiň işleýşi:

  1. Başlamak üçin, plugin .affix-topelementiň iň ýokary derejededigini görkezýär. Bu pursatda hiç hili CSS ýerleşişi talap edilmeýär.
  2. Berkidilen elementiň öňünden aýlanmak, hakyky goşulmany döretmeli. Bu ýer .affixçalyşýar .affix-topwe sazlanýar position: fixed;(Bootstrap's CSS tarapyndan üpjün edilýär).
  3. Aşakdaky ofset kesgitlenen bolsa, geçmişini aýlamak .affixbilen çalşmaly .affix-bottom. Ofsetler hökmany bolansoň, birini düzmek size degişli CSS-i bellemegi talap edýär. Bu ýagdaýda position: absolute;zerur bolanda goşuň. Plagin, elementi nireden ýerleşdirmelidigini kesgitlemek üçin maglumat atributyny ýa-da JavaScript opsiýasyny ulanýar.

Aşakdaky ulanyş opsiýalarynyň ikisi üçin CSS-ni bellemek üçin ýokardaky ädimleri ýerine ýetiriň.

Maglumat atributlary arkaly

Islendik elemente aňsatlyk bilen affiksi alyp barmak data-spy="affix"üçin içalyçylyk etmek isleýän elementiňize goşuň. Bir elementiň haçan dakyljakdygyny kesgitlemek üçin ofsetleri ulanyň.

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

JavaScript arkaly

JavaScript arkaly affiks plaginine jaň ediň:

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

Görnüş

Opsiýalar maglumat atributlary ýa-da JavaScript arkaly geçirilip bilner. Maglumat atributlary üçin, opsiýanyň adyny data-bolşy ýaly goşuň data-offset-top="200".

Ady görnüşi gaýybana beýany
ofset sany | funksiýa | obýekt 10 Aýlanyş ýagdaýyny hasaplanyňyzda ekrandan ýapyljak pikseller. Singleekeje san berilse, ofset ýokarky we aşaky ugurlarda ulanylar. Üýtgeşik, aşaky we ýokarky ofset bilen üpjün etmek üçin diňe bir obýekt offset: { top: 10 }ýa-da offset: { top: 10, bottom: 5 }. Ofseti dinamiki hasaplamaly bolanda bir funksiýa ulanyň.
nyşana saýlaýjy | düwün | jQuery elementi windowobýekt _ Affiksiň maksat elementini kesgitleýär.

Usullar

.affix(options)

Mazmunyňyzy goşulan mazmun hökmünde işjeňleşdirýär. Goşmaça wariantlary kabul edýär object.

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

.affix('checkPosition')

Affiksiň ýagdaýyny degişli elementleriň ölçeglerine, ýerleşişine we aýlaw ýagdaýyna görä täzeden hasaplaýar. , We synplar täze ýagdaýa .affixgörä goşulan mazmuna goşulýar ýa-da aýrylýar. Goşulan mazmunyň dogry ýerleşdirilmegini üpjün etmek üçin, goşulan mazmunyň ölçegleri ýa-da maksat elementi üýtgedilende bu usul çagyrylmalydyr..affix-top.affix-bottom

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

Wakalar

“Bootstrap” -yň affiks plagini, affiks funksiýasyna girmek üçin birnäçe wakany paş edýär.

Çäräniň görnüşi Düşündiriş
affix.bs.affix Bu waka, element dakylmanka derrew ot alýar.
affixed.bs.affix Bu hadysa, element berkidilenden soň atylýar.
affix-top.bs.affix Bu waka elementiň üstünde goýulmanka derrew ýanýar.
affixed-top.bs.affix Bu waka elementiň üstünde goýlandan soň atylýar.
affix-bottom.bs.affix Bu waka elementiň aşagy berkidilmänkä derrew ýanýar.
affixed-bottom.bs.affix Bu hadysa, elementiň aşagy berkidilenden soň atylýar.