Muhtasari

Ya mtu binafsi au iliyokusanywa

Programu-jalizi zinaweza kujumuishwa kibinafsi (kwa kutumia *.jsfaili za kibinafsi za Bootstrap), au zote mara moja (kwa kutumia bootstrap.jsau minified bootstrap.min.js).

Kwa kutumia JavaScript iliyokusanywa

Zote mbili bootstrap.jsna bootstrap.min.jszina programu-jalizi zote kwenye faili moja. Jumuisha moja tu.

Vitegemezi vya programu-jalizi

Baadhi ya programu-jalizi na vipengele vya CSS hutegemea programu-jalizi zingine. Ikiwa utajumuisha programu-jalizi kibinafsi, hakikisha kuwa umeangalia tegemezi hizi kwenye hati. Pia kumbuka kuwa programu-jalizi zote hutegemea jQuery (hii inamaanisha jQuery lazima ijumuishwe kabla ya faili za programu-jalizi). Wasiliana nasibower.json ili kuona ni matoleo gani ya jQuery yanatumika.

Sifa za data

Unaweza kutumia programu-jalizi zote za Bootstrap kupitia API ya ghafi bila kuandika safu moja ya JavaScript. Hii ni API ya daraja la kwanza ya Bootstrap na inapaswa kuwa fikira yako ya kwanza unapotumia programu-jalizi.

Hiyo ilisema, katika hali zingine inaweza kuhitajika kuzima utendakazi huu. Kwa hivyo, tunatoa pia uwezo wa kuzima API ya sifa ya data kwa kufungia matukio yote kwenye hati iliyo na nafasi ya majina data-api. Hii inaonekana kama hii:

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

Vinginevyo, ili kulenga programu-jalizi maalum, jumuisha tu jina la programu-jalizi kama nafasi ya majina pamoja na nafasi ya majina ya data-api kama hii:

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

Programu-jalizi moja pekee kwa kila kipengele kupitia sifa za data

Usitumie sifa za data kutoka kwa programu-jalizi nyingi kwenye kipengele kimoja. Kwa mfano, kitufe hakiwezi kuwa na ncha ya zana na kugeuza modali. Ili kufanya hivyo, tumia kipengee cha kufunga.

Programu ya API

Pia tunaamini kuwa unapaswa kutumia programu jalizi zote za Bootstrap kupitia JavaScript API. API zote za umma ni njia moja, zinazoweza kuunganishwa, na hurejesha mkusanyiko uliochukuliwa hatua.

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

Mbinu zote zinapaswa kukubali chaguo la chaguo la chaguo, mfuatano ambao unalenga mbinu fulani, au chochote (ambacho huanzisha programu-jalizi yenye tabia chaguo-msingi):

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

Kila programu-jalizi pia inafichua mjenzi wake mbichi kwenye Constructormali: $.fn.popover.Constructor. Ikiwa ungependa kupata mfano fulani wa programu-jalizi, irejeshe moja kwa moja kutoka kwa kipengele: $('[rel="popover"]').data('popover').

Mipangilio chaguomsingi

Unaweza kubadilisha mipangilio chaguomsingi ya programu-jalizi kwa kurekebisha kipengee cha programu-jalizi Constructor.DEFAULTS:

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

Hakuna mgongano

Wakati mwingine ni muhimu kutumia programu-jalizi za Bootstrap na mifumo mingine ya UI. Katika hali hizi, migongano ya nafasi ya majina inaweza kutokea mara kwa mara. Hili likitokea, unaweza kupiga simu .noConflictkwenye programu-jalizi unayotaka kurejesha thamani yake.

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

Matukio

Bootstrap hutoa matukio maalum kwa vitendo vingi vya kipekee vya programu-jalizi. Kwa ujumla, hizi huja katika umbo lisilo na kikomo na la wakati uliopita - ambapo hali isiyo na kikomo (mf. show) huanzishwa mwanzoni mwa tukio, na umbo lake la zamani la kishirikishi (mf. shown) huanzishwa wakati kitendo kinapokamilika.

Kufikia 3.0.0, matukio yote ya Bootstrap yamewekwa kwa majina.

Matukio yote yasiyo na mwisho hutoa preventDefaultutendaji. Hii hutoa uwezo wa kusimamisha utekelezaji wa kitendo kabla ya kuanza.

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

Nambari za toleo

Toleo la kila programu jalizi ya jQuery ya Bootstrap linaweza kufikiwa kupitia sifa ya VERSIONkijenzi cha programu-jalizi. Kwa mfano, kwa programu-jalizi ya zana:

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

Hakuna njia mbadala maalum wakati JavaScript imezimwa

Programu-jalizi za Bootstrap hazirudi nyuma kwa uzuri haswa wakati JavaScript imezimwa. Iwapo unajali kuhusu matumizi ya mtumiaji katika kesi hii, tumia <noscript>kueleza hali (na jinsi ya kuwezesha tena JavaScript) kwa watumiaji wako, na/au ongeza vikwazo vyako maalum.

Maktaba za watu wengine

Bootstrap haitumii rasmi maktaba za JavaScript za wahusika wengine kama Prototype au jQuery UI. Licha .noConflictya matukio na yaliyowekwa katika nafasi ya majina, kunaweza kuwa na matatizo ya uoanifu ambayo unahitaji kurekebisha peke yako.

Transitions transition.js

Kuhusu mabadiliko

Kwa athari rahisi za mpito, jumuisha transition.jsmara moja pamoja na faili zingine za JS. Ikiwa unatumia compiled (au minified) bootstrap.js, hakuna haja ya kujumuisha hii - tayari iko.

Kuna nini ndani

Transition.js ni msaidizi wa kimsingi wa transitionEndmatukio na vile vile emulator ya mpito ya CSS. Inatumiwa na programu-jalizi zingine kuangalia usaidizi wa mpito wa CSS na kupata mabadiliko yanayoning'inia.

Inalemaza mabadiliko

Mabadiliko yanaweza kuzimwa duniani kote kwa kutumia kijisehemu kifuatacho cha JavaScript, ambacho lazima kije baada ya transition.js( bootstrap.jsau bootstrap.min.js, kama itakavyokuwa) kupakiwa:

$.support.transition = false

Modals modal.js

Miundo imeratibiwa, lakini rahisi, vidokezo vya mazungumzo na utendakazi wa chini unaohitajika na chaguomsingi mahiri.

Miundo mingi ya wazi haitumiki

Hakikisha haufungui modali wakati nyingine bado inaonekana. Kuonyesha zaidi ya modali moja kwa wakati mmoja kunahitaji msimbo maalum.

Uwekaji wa alama za modal

Jaribu kila wakati kuweka msimbo wa HTML wa modali katika nafasi ya kiwango cha juu katika hati yako ili kuepuka vipengele vingine vinavyoathiri mwonekano na/au utendakazi wa modali.

Vidokezo vya kifaa cha rununu

Kuna baadhi ya tahadhari kuhusu kutumia moduli kwenye vifaa vya rununu. Tazama hati zetu za usaidizi wa kivinjari kwa maelezo.

Kutokana na jinsi HTML5 inavyofafanua semantiki zake, autofocussifa ya HTML haina athari katika miundo ya Bootstrap. Ili kufikia athari sawa, tumia JavaScript maalum:

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

Mifano

Mfano tuli

Modali inayotekelezwa yenye kichwa, mwili, na seti ya vitendo katika kijachini.

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

Onyesho la moja kwa moja

Geuza modali kupitia JavaScript kwa kubofya kitufe kilicho hapa chini. Itateleza chini na kufifia kutoka juu ya ukurasa.

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

Fanya moduli zipatikane

Hakikisha kuongeza role="dialog"na aria-labelledby="...", ukirejelea kichwa cha modali, kwa .modal, na role="document"yenyewe .modal-dialog.

Zaidi ya hayo, unaweza kutoa maelezo ya kidadisi chako cha modal na aria-describedbyon .modal.

Inapachika video za YouTube

Kupachika video za YouTube katika miundo kunahitaji JavaScript ya ziada si kwenye Bootstrap ili kusimamisha uchezaji kiotomatiki na zaidi. Tazama chapisho hili muhimu la Stack Overflow kwa maelezo zaidi.

Ukubwa wa hiari

Moduli zina saizi mbili za hiari, zinapatikana kupitia madarasa ya kurekebisha kuwekwa kwenye .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>

Ondoa uhuishaji

Kwa moduli zinazoonekana tu badala ya kufifia ili kutazamwa, ondoa .fadedarasa kutoka kwa alama yako ya modal.

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

Kutumia mfumo wa gridi ya taifa

Ili kuchukua fursa ya mfumo wa gridi ya Bootstrap ndani ya modali, nest .rows ndani ya .modal-bodykisha utumie madarasa ya mfumo wa gridi ya kawaida.

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

Je! una vifungo vingi ambavyo vyote huanzisha muundo sawa, na yaliyomo tofauti kidogo tu? Tumia event.relatedTargetna sifa za HTMLdata-* (labda kupitia jQuery ) ili kubadilisha yaliyomo kwenye modali kulingana na kitufe kilichobofya. Tazama hati za Matukio ya Modal kwa maelezo kuhusu relatedTarget,

...vifungo zaidi...
<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)
})

Matumizi

Programu-jalizi ya modal hugeuza maudhui yako yaliyofichwa inapohitajika, kupitia sifa za data au JavaScript. Pia huongeza .modal-openkwa <body>kubatilisha tabia ya kusogeza chaguo-msingi na hutoa a .modal-backdropkutoa eneo la kubofya kwa ajili ya kuondoa miundo iliyoonyeshwa unapobofya nje ya modali.

Kupitia sifa za data

Washa modali bila kuandika JavaScript. Weka data-toggle="modal"kwenye kipengele cha kidhibiti, kama kitufe, pamoja na data-target="#foo"au href="#foo"kulenga modi mahususi ya kugeuza.

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

Kupitia JavaScript

Piga modali na kitambulisho myModalna safu moja ya JavaScript:

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

Chaguo

Chaguzi zinaweza kupitishwa kupitia sifa za data au JavaScript. Kwa sifa za data, ongeza jina la chaguo kwa data-, kama katika data-backdrop="".

Jina aina chaguo-msingi maelezo
mandhari boolean au kamba'static' kweli Inajumuisha kipengele cha mandharinyuma ya modal. Vinginevyo, bainisha statickwa mandhari ambayo haifungi muundo wa kubofya.
kibodi boolean kweli Hufunga modali wakati kitufe cha Escape kinapobozwa
onyesha boolean kweli Inaonyesha moduli inapoanzishwa.
kijijini njia uongo

Chaguo hili limeacha kutumika tangu v3.3.0 na limeondolewa katika v4. Tunapendekeza badala yake utumie kiolezo cha upande wa mteja au mfumo wa kuunganisha data, au kupiga simu jQuery.load mwenyewe.

Ikiwa URL ya mbali itatolewa, maudhui yatapakiwa mara moja kupitia mbinu ya jQuery loadna kuingizwa kwenye .modal-contentdiv. Ikiwa unatumia data-api, unaweza kutumia hrefsifa kwa njia nyingine kubainisha chanzo cha mbali. Mfano wa hii umeonyeshwa hapa chini:

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

Mbinu

Huwasha maudhui yako kama modali. Inakubali chaguo za hiari object.

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

Hugeuza modali mwenyewe. Hurejesha kwa mpigaji simu kabla modali haijaonyeshwa au kufichwa (yaani kabla ya tukio shown.bs.modalau hidden.bs.modaltukio).

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

Hufungua modali mwenyewe. Hurejesha kwa mpigaji simu kabla modali haijaonyeshwa (yaani kabla ya shown.bs.modaltukio kutokea).

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

Huficha modali mwenyewe. Hurejesha kwa mpigaji simu kabla modali haijafichwa (yaani kabla ya hidden.bs.modaltukio kutokea).

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

Hurekebisha mkao wa modali ili kukabiliana na upau wa kusogeza iwapo mtu atatokea, jambo ambalo lingefanya modali kuruka upande wa kushoto.

Inahitajika tu wakati urefu wa modal unabadilika wakati imefunguliwa.

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

Matukio

Darasa la modali la Bootstrap linafichua matukio machache ya kuunganisha kwenye utendakazi wa modal.

Matukio yote ya modal yanarushwa kwa modali yenyewe (yaani kwenye <div class="modal">).

Aina ya Tukio Maelezo
onyesha.bs.modal Tukio hili huwaka mara moja wakati shownjia ya mfano inaitwa. Ikisababishwa na kubofya, kipengele kilichobofya kinapatikana kama sifa relatedTargetya tukio.
mfano.bs.ulioonyeshwa Tukio hili linafutwa wakati modali imefanywa kuonekana kwa mtumiaji (itasubiri mabadiliko ya CSS kukamilika). Ikisababishwa na kubofya, kipengele kilichobofya kinapatikana kama sifa relatedTargetya tukio.
ficha.bs.modal Tukio hili linafutwa mara moja wakati hidenjia ya mfano imeitwa.
fiche.bs.modal Tukio hili litafutwa wakati modali imekamilika kufichwa kutoka kwa mtumiaji (itasubiri mabadiliko ya CSS kukamilika).
loaded.bs.modali Tukio hili linafutwa wakati modali imepakia maudhui kwa kutumia remotechaguo.
$('#myModal').on('hidden.bs.modal', function (e) {
  // do something...
})

Dropdowns dropdown.js

Ongeza menyu kunjuzi kwa karibu chochote ukitumia programu-jalizi hii rahisi, ikijumuisha upau wa uelekezaji, vichupo na vidonge.

Ndani ya upau wa urambazaji

Ndani ya vidonge

Kupitia sifa za data au JavaScript, programu-jalizi kunjuzi hugeuza maudhui yaliyofichwa (menu kunjuzi) kwa kugeuza .opendarasa kwenye kipengee cha orodha kuu.

Kwenye vifaa vya mkononi, kufungua menyu kunjuzi huongeza .dropdown-backdropkama eneo la kugonga kwa ajili ya kufunga menyu kunjuzi unapogonga nje ya menyu, hitaji la usaidizi sahihi wa iOS. Hii inamaanisha kuwa kubadili menyu kunjuzi iliyo wazi hadi menyu kunjuzi tofauti kunahitaji mguso wa ziada kwenye simu ya mkononi.

Kumbuka: data-toggle="dropdown"Sifa hiyo inategemewa kwa kufunga menyu kunjuzi katika kiwango cha programu, kwa hivyo ni wazo nzuri kuitumia kila wakati.

Kupitia sifa za data

Ongeza data-toggle="dropdown"kwenye kiungo au kitufe ili kugeuza menyu kunjuzi.

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

Ili kuweka URLs zikiwa na vitufe vya viungo, tumia data-targetsifa badala ya 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>

Kupitia JavaScript

Piga kushuka kupitia JavaScript:

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

data-toggle="dropdown"bado inahitajika

Bila kujali ikiwa unapiga simu kunjuzi yako kupitia JavaScript au badala yake utumie data-api, data-toggle="dropdown"inahitajika kila wakati kuwepo kwenye kichochezi cha menyu kunjuzi.

Hakuna

Hugeuza menyu kunjuzi ya upau wa urambazaji au urambazaji wa kichupo.

Matukio yote kunjuzi yametupwa kwenye .dropdown-menukipengele cha mzazi.

Matukio yote kunjuzi yana sifa relatedTarget, ambayo thamani yake ni kipengee cha kugeuza nanga.

Aina ya Tukio Maelezo
onyesha.bs.kunjuzi Tukio hili huwaka mara moja mbinu ya onyesho inapoitwa.
imeonyeshwa.bs.kunjuzi Tukio hili huwashwa wakati menyu kunjuzi imefanywa kuonekana kwa mtumiaji (itasubiri mabadiliko ya CSS, kukamilika).
ficha.bs.kunjuzi Tukio hili linafutwa mara moja wakati mbinu ya mfano wa kujificha imeitwa.
kunjuzi.bs.fiche Tukio hili huwashwa wakati menyu kunjuzi imekamilika kufichwa kutoka kwa mtumiaji (itasubiri mabadiliko ya CSS, kukamilika).
$('#myDropdown').on('show.bs.dropdown', function () {
  // do something…
})

ScrollSpy scrollspy.js

Mfano katika navbar

Programu-jalizi ya ScrollSpy ni ya kusasisha kiotomatiki malengo ya nav kulingana na nafasi ya kusogeza. Tembeza eneo chini ya upau wa urambazaji na utazame mabadiliko ya darasa amilifu. Vipengee vidogo vya kunjuzi vitaangaziwa pia.

@mafuta

Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi kabla ya kuuza qui. Haki za baiskeli za kilimo kwa meza za Tumblr chochote. Anim keffiyeh carles cardigan. kibanda cha picha cha Velit seitan mcsweeney 3 wolf moon irure. Cosby sweta la lomo jean kaptula, williamsburg hoodie minim qui pengine hujasikia kuzihusu na cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil aliandika tattoo accusamus, cred irony biodiesel keffiyeh artisan ullamco consequat.

@mdo

Veniam marfa masharubu skateboard, adipisicing fugiat velit pitchfork ndevu. Freegan ndevu aliqua cupidatat vero mcsweeney. Cupidatat nne loko nisi, ea helvetica nulla carles. Lori la chakula la sweta la cosby lililowekwa alama za tattoo, vinyl ya mcsweeney's non freegan. Lo-fi wes anderson +1 sartorial. Carles mazoezi yasiyo ya urembo quis gentrify. Brooklyn adipisicing craft beer vice keytar deserunt.

moja

Occaecat commodo aliqua deelectus. Fap craft bia deserunt skateboard 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 est adipisicing. Consectetur nisi DIY minim messenger mfuko. Cred ex in, iphone endelevu deelectus consectetur fanny pack.

mbili

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

three

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

Keytar twee blog, culpa messenger bag marfa whatever deelectus food truck. Sapiente synth id id kudhani. Locavore sed helvetica cliche kejeli, thundercats pengine hujasikia kuwahusu consequat hoodie gluten-free lo-fi fap aliquip. Labore elit placeat kabla hazijauzwa, terry richardson proident brunch nesciunt quis cosby sweater pariatur keffiyeh ut helvetica artisan. Cardigan hila bia seitan readymade velit. VHS chambray laboris tempor veniam. Anim mollit minim commodo ullamco thundercats.

Matumizi

Inahitaji Bootstrap nav

Scrollspy kwa sasa inahitaji matumizi ya kijenzi cha Bootstrap nav kwa kuangazia vizuri kwa viungo vinavyotumika.

Vitambulisho vinavyoweza kutatuliwa vinahitajika

Viungo vya Upau wa Uelekezaji lazima viwe na malengo ya vitambulisho vinavyoweza kutatuliwa. Kwa mfano, <a href="#home">home</a>lazima ilingane na kitu kwenye DOM kama <div id="home"></div>.

:visibleVipengele visivyolengwa vimepuuzwa

Vipengele vinavyolengwa ambavyo havilingani :visiblena jQuery vitapuuzwa na vipengee vyake vya nav vinavyolingana havitaangaziwa kamwe.

Inahitaji nafasi ya jamaa

Haijalishi njia ya utekelezaji, scrollspy inahitaji utumiaji wa position: relative;kitu unachopeleleza. Katika hali nyingi hii ni <body>. Wakati wa kusogeza kwenye vipengee vingine isipokuwa <body>, hakikisha kuwa una heightseti na overflow-y: scroll;kutumika.

Kupitia sifa za data

Ili kuongeza kwa urahisi tabia ya kusongesha kwenye urambazaji wa upau wako wa juu, ongeza data-spy="scroll"kwenye kipengee unachotaka kupeleleza (kawaida hii itakuwa <body>). Kisha ongeza data-targetsifa na kitambulisho au darasa la kipengele kikuu cha kipengele chochote cha Bootstrap .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>

Kupitia JavaScript

Baada ya kuongeza position: relative;katika CSS yako, piga scrollspy kupitia JavaScript:

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

Mbinu

.scrollspy('refresh')

Unapotumia scrollspy kwa kushirikiana na kuongeza au kuondoa vitu kutoka kwa DOM, utahitaji kupiga njia ya kuburudisha kama hivyo:

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

Chaguo

Chaguzi zinaweza kupitishwa kupitia sifa za data au JavaScript. Kwa sifa za data, ongeza jina la chaguo kwa data-, kama katika data-offset="".

Jina aina chaguo-msingi maelezo
kukabiliana nambari 10 Pikseli za kurekebisha kutoka juu wakati wa kukokotoa nafasi ya kusogeza.

Matukio

Aina ya Tukio Maelezo
amilisha.bs.scrollspy Tukio hili huwaka wakati kipengee kipya kinapowezeshwa na scrollspy.
$('#myScrollspy').on('activate.bs.scrollspy', function () {
  // do something…
})

Vichupo vinavyoweza kugeuzwa tab.js

Vichupo vya mfano

Ongeza utendakazi wa kichupo cha haraka na unaobadilika ili kubadilisha vidirisha vya maudhui ya ndani, hata kupitia menyu kunjuzi. Vichupo vilivyowekwa havitumiki.

Jeans mbichi labda haujazisikia kaptula za jeans Austin. Nesciunt tofu stumptown aliqua, retro synth master cleanse. Muda mfupi wa masharubu, williamsburg carles vegan helvetica. Reprehenderit butcher retro keffiyeh dreamcatcher synth. Cosby sweta eu banh mi, qui irure terry richardson ex ngisi. Aliquip placeat salvia cillum iphone. Seitan aliquip quis cardigan american apparel, butcher 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.

Hupanua urambazaji wa vichupo

Programu-jalizi hii huongeza sehemu ya kusogeza yenye kichupo ili kuongeza maeneo yanayoweza kutekelezeka.

Matumizi

Washa vichupo vinavyoweza kutekelezeka kupitia JavaScript (kila kichupo kinahitaji kuamilishwa kivyake):

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

Unaweza kuwezesha tabo binafsi kwa njia kadhaa:

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

Alama

Unaweza kuwezesha urambazaji wa kichupo au kidonge bila kuandika JavaScript yoyote kwa kubainisha data-toggle="tab"au data-toggle="pill"kwa kipengee. Kuongeza navna nav-tabsmadarasa kwenye kichupo kutatumia mtindo wa kichupoul cha Bootstrap , huku kuongeza na madarasa kutatumika mtindo wa kidonge .navnav-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>

Fifisha athari

Ili kufanya vichupo kufifia, ongeza .fadekwa kila .tab-pane. Kidirisha cha kichupo cha kwanza lazima pia kiwe na .inmaudhui ya awali kuonekana.

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

Mbinu

$().tab

Huwasha kipengele cha kichupo na kontena ya maudhui. Kichupo kinapaswa kuwa na nodi ya chombo data-targetau inayolenga kwenye DOM. hrefKatika mifano iliyo hapo juu, tabo ni <a>s zilizo na data-toggle="tab"sifa.

.tab('show')

Huchagua kichupo kilichotolewa na kuonyesha maudhui yake yanayohusiana. Kichupo kingine chochote ambacho kilichaguliwa hapo awali kitaacha kuchaguliwa na maudhui yake yanayohusiana yanafichwa. Hurejesha kwa mpigaji kabla kidirisha cha kichupo hakijaonyeshwa (yaani kabla ya shown.bs.tabtukio kutokea).

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

Matukio

Wakati wa kuonyesha kichupo kipya, matukio huwaka kwa mpangilio ufuatao:

  1. hide.bs.tab(kwenye kichupo kinachotumika sasa)
  2. show.bs.tab(kwenye kichupo cha-kuonyeshwa)
  3. hidden.bs.tab(kwenye kichupo amilifu kilichotangulia, sawa na cha hide.bs.tabtukio)
  4. shown.bs.tab(kwenye kichupo kipya-kilichoonyeshwa, sawa na cha show.bs.tabtukio)

Ikiwa hakuna kichupo kilichokuwa tayari kinatumika, basi matukio hide.bs.tabna hidden.bs.tabmatukio hayatafutwa.

Aina ya Tukio Maelezo
kichupo cha.bs Tukio hili linawaka kwenye onyesho la kichupo, lakini kabla ya kichupo kipya kuonyeshwa. Tumia event.targetna event.relatedTargetkulenga kichupo kinachotumika na kichupo amilifu cha awali (kama kinapatikana) mtawalia.
kichupo.cha.bs Tukio hili linawaka kwenye onyesho la kichupo baada ya kichupo kuonyeshwa. Tumia event.targetna event.relatedTargetkulenga kichupo kinachotumika na kichupo amilifu cha awali (kama kinapatikana) mtawalia.
Ficha.bs.kichupo Tukio hili huwaka wakati kichupo kipya kitaonyeshwa (na kwa hivyo kichupo amilifu cha hapo awali kitafichwa). Tumia event.targetna event.relatedTargetkulenga kichupo kinachotumika sasa na kichupo kipya kitakachotumika hivi karibuni, mtawalia.
kichupo.bs.fiche Tukio hili huwaka baada ya kichupo kipya kuonyeshwa (na kwa hivyo kichupo amilifu cha awali kimefichwa). Tumia event.targetna event.relatedTargetkulenga kichupo amilifu cha awali na kichupo kipya kinachotumika, mtawalia.
$('a[data-toggle="tab"]').on('shown.bs.tab', function (e) {
  e.target // newly activated tab
  e.relatedTarget // previous active tab
})

Vidokezo vya zana tip.js

Imehamasishwa na programu-jalizi bora ya jQuery.tipsy iliyoandikwa na Jason Frame; Vidokezo vya zana ni toleo lililosasishwa, ambalo halitegemei picha, tumia CSS3 kwa uhuishaji, na sifa za data kwa hifadhi ya mada ya ndani.

Vidokezo vya zana vyenye vichwa vya urefu sifuri havionyeshwi kamwe.

Mifano

Elea juu ya viungo vilivyo hapa chini ili kuona vidokezo vya zana:

Suruali za kubana ngazi ya pili keffiyeh pengine hujazisikia . Picha kibanda ndevu mbichi shoes letterpress vegan messenger mfuko stumptown. Mavazi ya aina ya seitan ya shamba hadi meza, vazi la mcsweeney endelevu la quinoa 8-bit lina chambray ya terry richardson vinyl. Ndevu stumptown, cardigans banh mi lomo thundercats. Tofu biodiesel williamsburg marfa, four loko mcsweeney's cleanse vegan chambray. Fundi wa kejeli sana whatever keytar , scenester farm-to-table banksy Austin twitter kushughulikia freegan cred ghafi denim single-origin kahawa.

Kidokezo tuli

Chaguzi nne zinapatikana: juu, kulia, chini, na kushoto iliyokaa.

Maelekezo manne

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

Utendaji wa kujijumuisha

Kwa sababu za utendakazi, Kidokezo cha data na Popover data-apis ni kuchagua kuingia, kumaanisha kwamba lazima uanzishe wewe mwenyewe .

Njia moja ya kuanzisha vidokezo vyote kwenye ukurasa itakuwa kuvichagua kulingana na data-togglesifa zao:

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

Matumizi

Programu-jalizi ya kidokezo huzalisha maudhui na uwekaji alama inapohitajika, na kwa chaguo-msingi vidokezo vya mahali baada ya kipengee cha vianzishaji.

Anzisha kidokezo cha zana kupitia JavaScript:

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

Alama

Alama inayohitajika ya kidokezo ni datasifa tu na titlekwenye kipengee cha HTML ungependa kuwa na kidokezo. Alama inayozalishwa ya kidokezo ni rahisi, ingawa inahitaji nafasi (kwa chaguo-msingi, iliyowekwa topna programu-jalizi).

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

Viungo vya mistari mingi

Wakati mwingine unataka kuongeza kidokezo kwenye kiungo kinachofunga mistari mingi. Tabia chaguo-msingi ya programu-jalizi ya kidokezo ni kuiweka katikati kwa usawa na wima. Ongeza white-space: nowrap;kwenye nanga zako ili kuepuka hili.

Vidokezo vya zana katika vikundi vya vitufe, vikundi vya ingizo na majedwali vinahitaji mpangilio maalum

Unapotumia vidokezo vya vipengee ndani ya a .btn-groupau .input-group, au kwenye vipengele vinavyohusiana na jedwali ( <td>, <th>, <tr>, <thead>, <tbody>, <tfoot>), itabidi ubainishe chaguo container: 'body'(lililoandikwa hapa chini) ili kuepuka athari zisizohitajika (kama vile kipengele kukua zaidi na/ au kupoteza pembe zake zenye mviringo wakati ncha ya zana inapoanzishwa).

Usijaribu kuonyesha vidokezo kwenye vipengele vilivyofichwa

Kuomba $(...).tooltip('show')wakati kipengele kinacholengwa kipo display: none;kutasababisha kidokezo cha vidhibiti kuwekwa vibaya.

Vidokezo vya zana vinavyoweza kufikiwa kwa watumiaji wa kibodi na teknolojia saidizi

Kwa watumiaji wanaoabiri kwa kutumia kibodi, na hasa watumiaji wa teknolojia saidizi, unapaswa kuongeza vidokezo vya zana kwenye vipengele vinavyoangazia kibodi kama vile viungo, vidhibiti vya fomu, au kipengele chochote kiholela chenye tabindex="0"sifa.

Vidokezo vya zana kwenye vipengee vilivyozimwa huhitaji vipengee vya kanga

Ili kuongeza kidokezo kwa kipengele disabledau .disabledkipengele, weka kipengele ndani ya a <div>na <div>badala yake uweke kidokezo cha zana.

Chaguo

Chaguzi zinaweza kupitishwa kupitia sifa za data au JavaScript. Kwa sifa za data, ongeza jina la chaguo kwa data-, kama katika data-animation="".

Jina Aina Chaguomsingi Maelezo
uhuishaji boolean kweli Tumia mpito wa kufifisha wa CSS kwenye kidokezo cha zana
chombo kamba | uongo uongo

Huweka kidokezo kwa kipengele maalum. Mfano container: 'body':. Chaguo hili ni muhimu sana kwa kuwa hukuruhusu kuweka ncha ya zana katika mtiririko wa hati karibu na kipengee cha kuamsha - ambayo itazuia ncha ya zana kuelea kutoka kwa kipengee cha kuchochea wakati wa kubadilisha ukubwa wa dirisha.

kuchelewa nambari | kitu 0

Kuchelewa kuonyesha na kuficha kidokezo cha zana (ms) - haitumiki kwa aina ya kichochezi cha mwongozo

Nambari ikitolewa, ucheleweshaji unatumika kwa Ficha/onyesho zote mbili

Muundo wa kitu ni:delay: { "show": 500, "hide": 100 }

html boolean uongo Ingiza HTML kwenye kidokezo cha zana. Ikiwa sivyo, textmbinu ya jQuery itatumika kuingiza maudhui kwenye DOM. Tumia maandishi ikiwa una wasiwasi kuhusu mashambulizi ya XSS.
uwekaji kamba | kazi 'juu'

Jinsi ya kuweka ncha ya zana - juu | chini | kushoto | kulia | kiotomatiki.
Wakati "otomatiki" imebainishwa, itaelekeza upya kidokezo cha zana. Kwa mfano, ikiwa uwekaji ni "kushoto otomatiki", ncha ya zana itaonyeshwa upande wa kushoto inapowezekana, vinginevyo itaonyeshwa kulia.

Wakati kipengele cha chaguo za kukokotoa kinapotumiwa kubainisha uwekaji, huitwa kifundo cha kifundo cha DOM kama hoja yake ya kwanza na kipengee cha kuanzisha nodi ya DOM kama ya pili. thisMuktadha umewekwa kwa mfano wa kidokezo .

kiteuzi kamba uongo Iwapo kiteuzi kitatolewa, vipengee vya vidokezo vitakabidhiwa kwa walengwa maalum. Kwa vitendo, hii inatumika kuwezesha maudhui ya HTML yanayobadilika kuwa na vidokezo vya kuongezwa. Tazama hii na mfano wa kuelimisha .
kiolezo kamba '<div class="tooltip" role="tooltip"><div class="tooltip-arrow"></div><div class="tooltip-inner"></div></div>'

HTML msingi ya kutumia wakati wa kuunda kidokezo.

Vidokezo vya zana titlevitadungwa kwenye .tooltip-inner.

.tooltip-arrowitakuwa mshale wa kidokezo.

Kipengele cha kanga cha nje kinapaswa kuwa na .tooltipdarasa.

kichwa kamba | kazi ''

Thamani chaguo-msingi ya kichwa ikiwa titlesifa haipo.

Ikiwa kipengele cha kukokotoa kitatolewa, kitaitwa kikiwa na thismarejeleo yake yaliyowekwa kwa kipengele ambacho kidokezo cha zana kimeambatishwa.

kichochezi kamba 'hover focus' Jinsi kidokezo kinavyoanzishwa - bofya | tembea | kuzingatia | mwongozo. Unaweza kupitisha vichochezi vingi; kuwatenganisha na nafasi. manualhaiwezi kuunganishwa na kichochezi kingine chochote.
kituo cha kutazama kamba | kitu | kazi { kichaguzi: 'mwili', padding: 0}

Huweka kidokezo ndani ya mipaka ya kipengele hiki. Mfano: viewport: '#viewport'au{ "selector": "#viewport", "padding": 0 }

Ikiwa chaguo la kukokotoa limetolewa, inaitwa na kipengee cha kuzindua nodi ya DOM kama hoja yake pekee. thisMuktadha umewekwa kwa mfano wa kidokezo .

Sifa za data za vidokezo vya mtu binafsi

Chaguzi za vidokezo vya mtu binafsi zinaweza kubainishwa kwa matumizi ya sifa za data, kama ilivyoelezwa hapo juu.

Mbinu

$().tooltip(options)

Huambatisha kidhibiti kidokezo kwenye mkusanyiko wa vipengele.

.tooltip('show')

Hufichua kidokezo cha kipengele. Hurejesha kwa mpigaji simu kabla ya kidokezo cha zana kuonyeshwa (yaani kabla ya shown.bs.tooltiptukio kutokea). Hii inachukuliwa kuwa "mwongozo" wa kuchochea wa kidokezo cha zana. Vidokezo vya zana vyenye vichwa vya urefu sifuri havionyeshwi kamwe.

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

.tooltip('hide')

Huficha kidokezo cha kipengele. Hurejesha kwa mpigaji simu kabla ya kidokezo cha zana kufichwa (yaani kabla ya hidden.bs.tooltiptukio kutokea). Hii inachukuliwa kuwa "mwongozo" wa kuchochea wa kidokezo cha zana.

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

.tooltip('toggle')

Hugeuza kidokezo cha kipengee. Hurejesha kwa mpigaji simu kabla ya kidokezo cha zana kuonyeshwa au kufichwa (yaani kabla ya tukio shown.bs.tooltipau hidden.bs.tooltiptukio). Hii inachukuliwa kuwa "mwongozo" wa kuchochea wa kidokezo cha zana.

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

.tooltip('destroy')

Huficha na kuharibu ncha ya zana ya kipengele. Vidokezo vya zana vinavyotumia ugawaji madaraka (ambavyo vimeundwa kwa kutumia chaguo )selector haviwezi kuharibiwa kibinafsi kwenye vipengele vya vichochezi vya kizazi.

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

Matukio

Aina ya Tukio Maelezo
onyesha.bs.kidokezo Tukio hili huwaka mara moja wakati shownjia ya mfano inaitwa.
iliyoonyeshwa.bs.kidokezo Tukio hili huwashwa wakati kidokezo cha zana kimefanywa kuonekana kwa mtumiaji (itasubiri mabadiliko ya CSS kukamilika).
ficha.bs.kidokezo Tukio hili linafutwa mara moja wakati hidenjia ya mfano imeitwa.
siri.bs.kidokezo Tukio hili hutupwa wakati kidokezo kimekamilika kufichwa kutoka kwa mtumiaji (itasubiri mabadiliko ya CSS kukamilika).
kidokezo.cha.bs Tukio hili linafutwa baada ya show.bs.tooltiptukio wakati kiolezo cha kidokezo kimeongezwa kwenye DOM.
$('#myTooltip').on('hidden.bs.tooltip', function () {
  // do something…
})

Popovers popover.js

Ongeza viwekeleo vidogo vya maudhui, kama vile vilivyo kwenye iPad, kwa kipengele chochote kwa maelezo ya upili.

Popovers ambao mada na maudhui yao ni sifuri kamwe hawaonyeshwi.

Utegemezi wa programu-jalizi

Popover zinahitaji programu- jalizi ya kidokezo kujumuishwa katika toleo lako la Bootstrap.

Utendaji wa kujijumuisha

Kwa sababu za utendakazi, Kidokezo cha data na Popover data-apis ni kuchagua kuingia, kumaanisha kwamba lazima uanzishe wewe mwenyewe .

Njia moja ya kuanzisha popover zote kwenye ukurasa itakuwa kuzichagua kulingana na data-togglesifa zao:

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

Popovers katika vikundi vya vitufe, vikundi vya ingizo, na jedwali zinahitaji mpangilio maalum

Unapotumia popovers kwenye vipengee vilivyo ndani ya a .btn-groupau .input-group, au kwenye vipengele vinavyohusiana na jedwali ( <td>, <th>, <tr>, <thead>, <tbody>, <tfoot>), itabidi ubainishe chaguo container: 'body'(lililoandikwa hapa chini) ili kuepuka athari zisizohitajika (kama vile kipengele kukua zaidi na/ au kupoteza pembe zake za mviringo wakati popover inapoanzishwa).

Usijaribu kuonyesha popovers kwenye vipengele vilivyofichwa

Kuomba $(...).popover('show')wakati kipengele display: none;kinacholengwa kitasababisha popover kuwa katika nafasi isiyo sahihi.

Popovers kwenye vipengee vilivyozimwa huhitaji vipengee vya kufunika

Ili kuongeza popover kwa kipengele disabledau .disabledkipengele, weka kipengele ndani ya a na badala yake <div>utumie popover kwa hiyo .<div>

Viungo vya mistari mingi

Wakati mwingine unataka kuongeza popover kwenye kiungo kinachofunga mistari mingi. Tabia chaguo-msingi ya programu-jalizi ya popover ni kuiweka katikati kwa usawa na wima. Ongeza white-space: nowrap;kwenye nanga zako ili kuepuka hili.

Mifano

Pover tuli

Chaguzi nne zinapatikana: juu, kulia, chini, na kushoto iliyokaa.

Popover juu

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

Popover kulia

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

Popover chini

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

Popover kushoto

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

Onyesho la moja kwa moja

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

Maelekezo manne

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

Ondoa kwa kubofya ijayo

Tumia focuskichochezi ili kuondoa popover kwenye mbofyo unaofuata ambao mtumiaji hufanya.

Lebo maalum inahitajika kwa ajili ya kuondoa-on-ifuatayo

Kwa tabia sahihi ya kivinjari na jukwaa-msingi, lazima utumie <a>lebo, sio lebo <button>, na pia lazima ujumuishe role="button"na tabindexsifa.

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

Matumizi

Washa popover kupitia JavaScript:

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

Chaguo

Chaguzi zinaweza kupitishwa kupitia sifa za data au JavaScript. Kwa sifa za data, ongeza jina la chaguo kwa data-, kama katika data-animation="".

Jina Aina Chaguomsingi Maelezo
uhuishaji boolean kweli Tumia mpito wa kufifisha wa CSS kwenye popover
chombo kamba | uongo uongo

Huongeza popover kwa kipengele maalum. Mfano container: 'body':. Chaguo hili ni muhimu sana kwa kuwa hukuruhusu kuweka popover katika mtiririko wa hati karibu na kipengee cha kuchochea - ambayo itazuia popover kuelea kutoka kwa kipengele cha kuchochea wakati wa kurekebisha ukubwa wa dirisha.

maudhui kamba | kazi ''

Thamani chaguo-msingi ya maudhui ikiwa data-contentsifa haipo.

Ikiwa kipengele cha kukokotoa kitatolewa, kitaitwa na thismarejeleo yake yamewekwa kwa kipengele ambacho popover imeambatishwa.

kuchelewa nambari | kitu 0

Kuchelewesha kuonyesha na kuficha popover (ms) - haitumiki kwa aina ya kichochezi cha mwongozo

Nambari ikitolewa, ucheleweshaji unatumika kwa Ficha/onyesho zote mbili

Muundo wa kitu ni:delay: { "show": 500, "hide": 100 }

html boolean uongo Ingiza HTML kwenye popover. Ikiwa sivyo, textmbinu ya jQuery itatumika kuingiza maudhui kwenye DOM. Tumia maandishi ikiwa una wasiwasi kuhusu mashambulizi ya XSS.
uwekaji kamba | kazi 'haki'

Jinsi ya kuweka popover - juu | chini | kushoto | kulia | kiotomatiki.
Wakati "otomatiki" imebainishwa, itaelekeza upya popover kwa nguvu. Kwa mfano, ikiwa uwekaji ni "kushoto otomatiki", popover itaonyeshwa upande wa kushoto inapowezekana, vinginevyo itaonyeshwa kulia.

Chaguo za kukokotoa zinapotumiwa kubainisha uwekaji, huitwa na nodi ya popover DOM kama hoja yake ya kwanza na kipengele cha kuanzisha nodi ya DOM kama ya pili. thisMuktadha umewekwa kwa mfano wa popover .

kiteuzi kamba uongo Iwapo kiteuzi kitatolewa, vipengee vya popover vitakabidhiwa kwa malengo yaliyobainishwa. Kwa vitendo, hii inatumika kuwezesha maudhui ya HTML yanayobadilika ili kuongezwa popover. Tazama hii na mfano wa kuelimisha .
kiolezo kamba '<div class="popover" role="tooltip"><div class="arrow"></div><h3 class="popover-title"></h3><div class="popover-content"></div></div>'

HTML msingi ya kutumia wakati wa kuunda popover.

popover's titleitakuwa hudungwa katika .popover-title.

popover's contentitakuwa hudungwa katika .popover-content.

.arrowitakuwa mshale wa popover.

Kipengele cha kanga cha nje kinapaswa kuwa na .popoverdarasa.

kichwa kamba | kazi ''

Thamani chaguo-msingi ya kichwa ikiwa titlesifa haipo.

Ikiwa kipengele cha kukokotoa kitatolewa, kitaitwa na thismarejeleo yake yamewekwa kwa kipengele ambacho popover imeambatishwa.

kichochezi kamba 'bonyeza' Jinsi popover inavyoanzishwa - bofya | tembea | kuzingatia | mwongozo. Unaweza kupitisha vichochezi vingi; kuwatenganisha na nafasi. manualhaiwezi kuunganishwa na kichochezi kingine chochote.
kituo cha kutazama kamba | kitu | kazi { kichaguzi: 'mwili', padding: 0}

Huweka popover ndani ya mipaka ya kipengele hiki. Mfano: viewport: '#viewport'au{ "selector": "#viewport", "padding": 0 }

Ikiwa chaguo la kukokotoa limetolewa, inaitwa na kipengee cha kuzindua nodi ya DOM kama hoja yake pekee. thisMuktadha umewekwa kwa mfano wa popover .

Sifa za data kwa popovers binafsi

Chaguo za popover binafsi zinaweza kubainishwa kwa kutumia sifa za data, kama ilivyoelezwa hapo juu.

Mbinu

$().popover(options)

Huanzisha popover kwa mkusanyiko wa vipengele.

.popover('show')

Hufichua kuongezeka kwa kipengele. Hurejesha kwa mpigaji simu kabla popover haijaonyeshwa (yaani kabla ya shown.bs.popovertukio kutokea). Hii inachukuliwa kuwa "mwongozo" wa kuchochea wa popover. Popovers ambao mada na maudhui yao ni sifuri kamwe hawaonyeshwi.

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

.popover('hide')

Huficha popover ya kipengele. Hurejesha kwa mpigaji simu kabla popover haijafichwa (yaani kabla ya hidden.bs.popovertukio kutokea). Hii inachukuliwa kuwa "mwongozo" wa kuchochea wa popover.

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

.popover('toggle')

Hugeuza popover ya kipengele. Hurejesha kwa mpigaji simu kabla popover haijaonyeshwa au kufichwa (yaani kabla ya tukio shown.bs.popoverau hidden.bs.popovertukio). Hii inachukuliwa kuwa "mwongozo" wa kuchochea wa popover.

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

.popover('destroy')

Huficha na kuharibu popover ya kipengele. Popovers zinazotumia utumaji kaumu (ambazo zinaundwa kwa kutumia chaguo )selector haziwezi kuharibiwa kibinafsi kwa vipengele vya vichochezi vya kizazi.

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

Matukio

Aina ya Tukio Maelezo
onyesha.bs.umasikini Tukio hili huwaka mara moja wakati shownjia ya mfano inaitwa.
imeonyeshwa.bs.umasikini Tukio hili linafutwa wakati popover imefanywa kuonekana kwa mtumiaji (itasubiri mabadiliko ya CSS kukamilika).
ficha.bs.umasikini Tukio hili linafutwa mara moja wakati hidenjia ya mfano imeitwa.
siri.bs. popover Tukio hili linafutwa wakati popover imekamilika kufichwa kutoka kwa mtumiaji (itasubiri mabadiliko ya CSS kukamilika).
imeingizwa.bs.popover Tukio hili limefutwa baada ya show.bs.popovertukio wakati kiolezo cha popover kimeongezwa kwenye DOM.
$('#myPopover').on('hidden.bs.popover', function () {
  // do something…
})

Ujumbe wa arifa alert.js

Arifa za mfano

Ongeza utendakazi wa kukataa kwa ujumbe wote wa tahadhari na programu-jalizi hii.

Unapotumia .closekitufe, lazima kiwe mtoto wa kwanza wa .alert-dismissiblena hakuna maandishi yanayoweza kuja mbele yake kwenye lebo.

Matumizi

Ongeza tu data-dismiss="alert"kwenye kitufe chako cha kufunga ili kutoa kiotomatiki utendakazi wa karibu wa tahadhari. Kufunga arifa huiondoa kwenye DOM.

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

Ili arifa zako zitumie uhuishaji unapofunga, hakikisha kuwa zina .fadena.in madarasa tayari yametumika kwao.

Mbinu

$().alert()

Hufanya arifa ya kusikiliza kwa matukio ya kubofya kwenye vipengele vya kizazi ambavyo vina data-dismiss="alert"sifa. (Sio lazima unapotumia uanzishaji kiotomatiki wa data-api.)

$().alert('close')

Hufunga arifa kwa kuiondoa kwenye DOM. Ikiwa .fadena .indarasa zipo kwenye kipengele, tahadhari itafifia kabla ya kuondolewa.

Matukio

Programu-jalizi ya tahadhari ya Bootstrap inafichua matukio machache ya kuunganisha katika utendaji wa tahadhari.

Aina ya Tukio Maelezo
funga.bs.tahadhari Tukio hili huwaka mara moja wakati closenjia ya mfano inaitwa.
funge.bs.tahadhari Tukio hili linafutwa wakati tahadhari imefungwa (itasubiri mabadiliko ya CSS kukamilika).
$('#myAlert').on('closed.bs.alert', function () {
  // do something…
})

Vifungo _

Fanya zaidi na vifungo. Kitufe cha kudhibiti kinasema au unda vikundi vya vitufe vya vipengee zaidi kama vile upau wa vidhibiti.

Utangamano wa kivinjari

Firefox inaendelea hali ya udhibiti wa fomu (ulemavu na kukaguliwa) kwenye mizigo ya ukurasa . Workaround kwa hii ni kutumia autocomplete="off". Tazama hitilafu ya Mozilla #654072 .

Ya serikali

Ongeza data-loading-text="Loading..."ili kutumia hali ya upakiaji kwenye kitufe.

Kipengele hiki kimeacha kutumika tangu v3.3.5 na kimeondolewa katika v4.

Tumia hali yoyote unayopenda!

Kwa ajili ya onyesho hili, tunatumia data-loading-textna $().button('loading'), lakini hiyo sio hali pekee unayoweza kutumia. Tazama zaidi juu ya hii hapa chini kwenye $().button(string)hati .

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

Kugeuza moja

Ongeza data-toggle="button"ili kuwezesha kugeuza kwenye kitufe kimoja.

Vifungo vilivyogeuzwa awali vinahitaji.active naaria-pressed="true"

Kwa vitufe vilivyogeuzwa awali, lazima uongeze .activedarasa na aria-pressed="true"sifa kwako buttonmwenyewe.

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

Kisanduku cha kuteua / Redio

Ongeza data-toggle="buttons"kwenye kisanduku cha .btn-groupkuteua au pembejeo za redio ili kuwezesha kugeuza katika mitindo husika.

Chaguzi zilizochaguliwa mapema zinahitajika.active

Kwa chaguo zilizochaguliwa mapema, lazima uongeze .activedarasa kwa ingizo labelwewe mwenyewe.

Hali iliyoangaliwa inayoonekana inasasishwa tu kwenye kubofya

Ikiwa hali iliyotiwa alama ya kitufe cha kisanduku cha kuteua itasasishwa bila kurusha clicktukio kwenye kitufe (km kupitia <input type="reset">au kupitia kuweka sifa checkedya ingizo), utahitaji kugeuza .activedarasa kwenye ingizo labelwewe mwenyewe.

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

Mbinu

$().button('toggle')

Hugeuza hali ya kusukuma. Hutoa kitufe mwonekano kwamba kimewashwa.

$().button('reset')

Huweka upya hali ya kitufe - hubadilisha maandishi hadi maandishi asili. Njia hii hailingani na hurudi kabla ya uwekaji upya kukamilika.

$().button(string)

Hubadilisha maandishi kwa hali yoyote ya maandishi iliyoainishwa na data.

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

Kunja collapse.js

Programu-jalizi inayoweza kubadilika ambayo hutumia madarasa machache kwa tabia rahisi ya kugeuza.

Utegemezi wa programu-jalizi

Kunja kunahitaji programu- jalizi ya mpito kujumuishwa katika toleo lako la Bootstrap.

Mfano

Bofya vitufe vilivyo hapa chini ili kuonyesha na kuficha kipengele kingine kupitia mabadiliko ya darasa:

  • .collapsehuficha yaliyomo
  • .collapsinginatumika wakati wa mabadiliko
  • .collapse.ininaonyesha maudhui

Unaweza kutumia kiungo hrefkilicho na sifa, au kitufe kilicho na data-targetsifa. Katika visa vyote viwili, data-toggle="collapse"inahitajika.

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>

Mfano wa accordion

Panua tabia ya kukunja chaguomsingi ili kuunda mfuatano na kijenzi cha paneli.

Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad ngisi. 3 mbwa mwitu mwezi officia aute, non cupidatat skateboard dolor brunch. Lori la chakula quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua weka ndege juu yake ngisi mwenye asili ya kahawa nulla guessnda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur mchinjaji makamu wa lomo. Leggings occaecat craft bia farm-to-table, denim ghafi aesthetic synth nesciunt pengine hujasikia kuwahusu accusamus labour endelevu VHS.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad ngisi. 3 mbwa mwitu mwezi officia aute, non cupidatat skateboard dolor brunch. Lori la chakula quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua weka ndege juu yake ngisi mwenye asili ya kahawa nulla guessnda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur mchinjaji makamu wa lomo. Leggings occaecat craft bia farm-to-table, denim ghafi aesthetic synth nesciunt pengine hujasikia kuwahusu accusamus labour endelevu VHS.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad ngisi. 3 mbwa mwitu mwezi officia aute, non cupidatat skateboard dolor brunch. Lori la chakula quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua weka ndege juu yake ngisi mwenye asili ya kahawa nulla guessnda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur mchinjaji makamu wa lomo. Leggings occaecat craft bia farm-to-table, denim ghafi aesthetic synth nesciunt pengine hujasikia kuwahusu accusamus labour endelevu 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>

Inawezekana pia kubadilisha .panel-bodys na .list-groups.

  • Bootply
  • Moja itmus ac facilin
  • Eros ya pili

Fanya vidhibiti vya kupanua/kunja vipatikane

Hakikisha kuongeza aria-expandedkwenye kipengele cha kudhibiti. Sifa hii inafafanua kwa uwazi hali ya sasa ya kipengele kinachoweza kukunjwa kwa visoma skrini na teknolojia sawa za usaidizi. Ikiwa kipengele kinachoweza kukunjwa kimefungwa kwa chaguo-msingi, kinapaswa kuwa na thamani ya aria-expanded="false". Ikiwa umeweka kipengee kinachoweza kukunjwa kufunguka kwa chaguomsingi kwa kutumia indarasa, aria-expanded="true"badala yake weka kidhibiti. Programu-jalizi itageuza sifa hii kiotomatiki kulingana na ikiwa kipengele kinachoweza kukunjwa kimefunguliwa au kufungwa.

Zaidi ya hayo, ikiwa kipengee chako cha udhibiti kinalenga kipengele kimoja kinachoweza kukunjwa - yaani data-targetsifa inaelekeza kwenye idkiteuzi - unaweza kuongeza aria-controlssifa ya ziada kwa kipengele cha udhibiti, kilicho na idkipengele kinachoweza kukunjwa. Visomaji skrini vya kisasa na teknolojia saidizi kama hizo hutumia sifa hii kuwapa watumiaji njia za mkato za ziada za kusogeza moja kwa moja hadi kwenye kipengele chenyewe kinachoweza kukunjwa.

Matumizi

Programu-jalizi ya kuporomoka hutumia madarasa machache kushughulikia unyanyuaji mzito:

  • .collapsehuficha yaliyomo
  • .collapse.ininaonyesha yaliyomo
  • .collapsinghuongezwa wakati mpito unapoanza, na kuondolewa ukikamilika

Madarasa haya yanaweza kupatikana katika component-animations.less.

Kupitia sifa za data

Ongeza tu data-toggle="collapse"na a data-targetkwa kipengee ili kukabidhi kiotomatiki udhibiti wa kipengele kinachoweza kukunjwa. Sifa data-targetinakubali kiteuzi cha CSS cha kutumia kukunja kwake. Hakikisha umeongeza darasa collapsekwenye kipengele kinachoweza kukunjwa. Ikiwa ungependa ifungue chaguomsingi, ongeza darasa la ziada in.

Ili kuongeza usimamizi wa kikundi kama accordion kwenye kidhibiti kinachoweza kukunjwa, ongeza sifa ya data data-parent="#selector". Rejelea onyesho ili kuona hili likiendelea.

Kupitia JavaScript

Washa wewe mwenyewe na:

$('.collapse').collapse()

Chaguo

Chaguzi zinaweza kupitishwa kupitia sifa za data au JavaScript. Kwa sifa za data, ongeza jina la chaguo kwa data-, kama katika data-parent="".

Jina aina chaguo-msingi maelezo
mzazi kiteuzi uongo Ikiwa kiteuzi kimetolewa, basi vipengele vyote vinavyoweza kukunjwa chini ya mzazi aliyebainishwa vitafungwa wakati kipengee hiki kinachoweza kukunjwa kitaonyeshwa. (sawa na tabia ya kitamaduni ya accordion - hii inategemea paneldarasa)
kugeuza boolean kweli Hugeuza kipengele kinachoweza kukunjwa kwenye ombi

Mbinu

.collapse(options)

Huwasha maudhui yako kama kipengele kinachoweza kukunjwa. Inakubali chaguo za hiari object.

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

.collapse('toggle')

Hugeuza kipengele kinachoweza kukunjwa kuonyeshwa au kufichwa. Hurejesha kwa anayepiga kabla kipengele kinachoweza kukunjwa hakijaonyeshwa au kufichwa (yaani kabla ya tukio shown.bs.collapseau hidden.bs.collapsetukio).

.collapse('show')

Inaonyesha kipengele kinachoweza kukunjwa. Hurejesha kwa mpigaji simu kabla kipengele kinachoweza kukunjwa hakijaonyeshwa (yaani kabla ya shown.bs.collapsetukio kutokea).

.collapse('hide')

Huficha kipengele kinachoweza kukunjwa. Hurejesha kwa anayepiga kabla kipengele kinachoweza kukunjwa hakijafichwa (yaani kabla ya hidden.bs.collapsetukio kutokea).

Matukio

Darasa la kukunja la Bootstrap linafichua matukio machache ya kunasa katika utendakazi wa kukunja.

Aina ya Tukio Maelezo
onyesha.bs.kukunja Tukio hili huwaka mara moja wakati shownjia ya mfano inaitwa.
imeonyeshwa.bs.kukunja Tukio hili huwashwa wakati kipengele cha kukunja kimefanywa kuonekana kwa mtumiaji (itasubiri mabadiliko ya CSS yakamilike).
ficha.bs.kunja Tukio hili linafukuzwa mara moja wakati hidenjia imeitwa.
kufichwa.bs.kukunja Tukio hili huwashwa wakati kipengele cha kukunja kimefichwa kutoka kwa mtumiaji (itasubiri mabadiliko ya CSS yakamilike).
$('#myCollapsible').on('hidden.bs.collapse', function () {
  // do something…
})

Jukwaa la jukwa.js

Kipengele cha onyesho la slaidi cha kuendesha baiskeli kupitia vipengele, kama jukwa. Miduara iliyopachikwa haitumiki.

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

Manukuu ya hiari

Ongeza manukuu kwenye slaidi zako kwa urahisi na .carousel-captionkipengele kilicho ndani ya .item. Weka takriban HTML yoyote ya hiari ndani hapo na itapangiliwa kiotomatiki na kuumbizwa.

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

Majukwaa mengi

Majukwaa yanahitaji matumizi ya chombo idkwenye chombo cha nje (the .carousel) ili vidhibiti vya jukwa kufanya kazi vizuri. Unapoongeza jukwa nyingi, au unapobadilisha jukwa id, hakikisha kuwa umesasisha vidhibiti husika.

Kupitia sifa za data

Tumia sifa za data ili kudhibiti kwa urahisi nafasi ya jukwa. data-slideinakubali manenomsingi prevau next, ambayo hubadilisha nafasi ya slaidi kulingana na nafasi yake ya sasa. Vinginevyo, tumia data-slide-tokupitisha faharasa mbichi ya slaidi kwa carousel data-slide-to="2", ambayo huhamisha nafasi ya slaidi hadi faharasa fulani inayoanza na 0.

Sifa data-ride="carousel"hutumika kutia alama kwenye jukwa kama linalohuisha kuanzia kwenye upakiaji wa ukurasa. Haiwezi kutumika pamoja na (isiyohitajika na isiyo ya lazima) uanzishaji wa JavaScript ya jukwa moja.

Kupitia JavaScript

Piga jukwa mwenyewe na:

$('.carousel').carousel()

Chaguzi zinaweza kupitishwa kupitia sifa za data au JavaScript. Kwa sifa za data, ongeza jina la chaguo kwa data-, kama katika data-interval="".

Jina aina chaguo-msingi maelezo
muda nambari 5000 Muda wa kuchelewa kati ya kuendesha kipengee kiotomatiki. Ikiwa sivyo, jukwa halitazunguka kiotomatiki.
pause kamba | null "elea" Ikiwekwa kuwa "hover", itasitisha uendeshaji wa baiskeli ya jukwa mouseenterna kuanza tena uendeshaji wa baisikeli wa jukwa mouseleave. Ikiwekwa kuwa null, kuelea juu ya jukwa hakutalisitisha.
kanga boolean kweli Iwapo jukwa linapaswa kuzunguka mfululizo au kusimama kwa bidii.
kibodi boolean kweli Ikiwa jukwa linapaswa kuguswa na matukio ya kibodi.

Huanzisha jukwa kwa chaguo za hiari objectna kuanza kuendesha baiskeli kupitia vitu.

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

Huzungusha vitu vya jukwa kutoka kushoto kwenda kulia.

Husimamisha jukwa lisiendeshe baiskeli kupitia vitu.

Huzungusha jukwa hadi fremu fulani (0 msingi, sawa na safu).

Mizunguko ya kipengee kilichotangulia.

Mizunguko hadi kipengee kinachofuata.

Darasa la jukwa la Bootstrap linafichua matukio mawili ya kuunganisha kwenye utendakazi wa jukwa.

Matukio yote mawili yana sifa zifuatazo za ziada:

  • direction: Mwelekeo ambao jukwa linateleza (ama "left"au "right").
  • relatedTarget: Kipengele cha DOM ambacho kinatelezeshwa mahali kama kipengee kinachotumika.

Matukio yote ya jukwa hupigwa risasi kwenye jukwa lenyewe (yaani kwenye <div class="carousel">).

Aina ya Tukio Maelezo
slaidi.bs.jukwa Tukio hili huwaka mara moja slidembinu ya mfano inapotumika.
slid.bs.jukwa Tukio hili huwashwa wakati jukwa limekamilisha mpito wake wa slaidi.
$('#myCarousel').on('slide.bs.carousel', function () {
  // do something…
})

Bandika affix.js

Mfano

Programu-jalizi ya kiambishi huwasha position: fixed;na kuzima, ikiiga athari inayopatikana na position: sticky;. Urambazaji ulio upande wa kulia ni onyesho la moja kwa moja la programu-jalizi ya kiambatisho.


Matumizi

Tumia programu-jalizi ya bandika kupitia sifa za data au wewe mwenyewe na JavaScript yako mwenyewe. Katika hali zote mbili, lazima utoe CSS kwa nafasi na upana wa maudhui yako yaliyobandikwa.

Kumbuka: Usitumie programu-jalizi ya kiambatisho kwenye kipengele kilicho katika kipengele kilichowekwa kwa kiasi, kama vile safu wima iliyovutwa au kusukumwa, kwa sababu ya hitilafu ya uwasilishaji ya Safari .

Nafasi kupitia CSS

Programu-jalizi ya affix hugeuza kati ya aina tatu, kila moja ikiwakilisha hali fulani: .affix, .affix-top, na .affix-bottom. Lazima utoe mitindo, isipokuwa position: fixed;on .affix, kwa madarasa haya mwenyewe (huru ya programu-jalizi hii) ili kushughulikia nafasi halisi.

Hivi ndivyo programu jalizi ya affix inavyofanya kazi:

  1. Kuanza, programu-jalizi inaongeza .affix-topkuashiria kipengele kiko katika nafasi yake ya juu zaidi. Kwa wakati huu hakuna nafasi ya CSS inahitajika.
  2. Kusogeza mbele ya kipengee unachotaka kubandikwa kunapaswa kusababisha upachikaji halisi. Hapa ndipo mahali .affixpa kubadilisha .affix-topna kuweka position: fixed;(zinazotolewa na Bootstrap's CSS).
  3. Ikiwa urekebishaji wa chini umefafanuliwa, kusogeza mbele kunapaswa kuchukua nafasi .affixya .affix-bottom. Kwa kuwa urekebishaji ni wa hiari, kuweka moja kunahitaji uweke CSS inayofaa. Katika kesi hii, ongeza position: absolute;ikiwa ni lazima. Programu-jalizi hutumia sifa ya data au chaguo la JavaScript ili kubainisha mahali pa kuweka kipengele kutoka hapo.

Fuata hatua zilizo hapo juu ili kuweka CSS yako kwa mojawapo ya chaguo za matumizi zilizo hapa chini.

Kupitia sifa za data

Ili kuongeza kwa urahisi tabia ya kubandika kwa kipengele chochote, ongeza tu data-spy="affix"kwenye kipengele unachotaka kupeleleza. Tumia vipunguzio kufafanua wakati wa kugeuza ubandikaji wa kipengele.

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

Kupitia JavaScript

Piga programu-jalizi ya kiambatisho kupitia JavaScript:

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

Chaguo

Chaguzi zinaweza kupitishwa kupitia sifa za data au JavaScript. Kwa sifa za data, ongeza jina la chaguo kwa data-, kama katika data-offset-top="200".

Jina aina chaguo-msingi maelezo
kukabiliana nambari | kazi | kitu 10 Pikseli za kurekebisha kutoka skrini wakati wa kuhesabu nafasi ya kusogeza. Ikiwa nambari moja imetolewa, kurekebisha kutatumika katika pande za juu na chini. Ili kutoa urekebishaji wa kipekee, wa chini na wa juu toa tu kitu offset: { top: 10 }au offset: { top: 10, bottom: 5 }. Tumia chaguo la kukokotoa unapohitaji kukokotoa suluhu kwa nguvu.
lengo kiteuzi | nodi | kipengele cha jQuery windowkitu _ Hubainisha kipengele kinacholengwa cha kiambishi.

Mbinu

.affix(options)

Huwasha maudhui yako kama yaliyobandikwa. Inakubali chaguo za hiari object.

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

.affix('checkPosition')

Hukokotoa upya hali ya kiambishi kulingana na vipimo, nafasi, na nafasi ya kusogeza ya vipengele husika. , .affix, .affix-topna .affix-bottommadarasa huongezwa kwa au kuondolewa kutoka kwa maudhui yaliyobandikwa kulingana na hali mpya. Njia hii inahitaji kuitwa wakati wowote vipimo vya maudhui yaliyobandikwa au kipengele lengwa kinapobadilishwa, ili kuhakikisha uwekaji sahihi wa maudhui yaliyobandikwa.

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

Matukio

Programu-jalizi ya kiambishi cha Bootstrap inafichua matukio machache ya kuunganisha kwenye utendaji wa viambatisho.

Aina ya Tukio Maelezo
bandika.bs.bandika Tukio hili huwaka mara moja kabla kipengele hakijabandikwa.
kibandiko.bs Tukio hili linafutwa baada ya kipengele kubandikwa.
bandika-juu.bs.bandika Tukio hili huwaka mara moja kabla kipengele hakijabandikwa juu.
kibandiko-juu.bs Tukio hili limefutwa baada ya kipengele kubandikwa juu.
bandika-chini.bs.bandika Tukio hili huwaka mara moja kabla kipengele hakijabandikwa chini.
kibandiko.bs.chini Tukio hili limefutwa baada ya kipengele kubandikwa chini.