Ընդհանուր ակնարկ

Անհատական ​​կամ կազմված

Փլագինները կարող են ներառվել առանձին (օգտագործելով Bootstrap-ի անհատական *.js​​ֆայլերը), կամ միանգամից (օգտագործելով bootstrap.jsկամ փոքրացված bootstrap.min.js):

Կազմված JavaScript-ի օգտագործումը

Երկուսն էլ bootstrap.jsև bootstrap.min.jsպարունակում են բոլոր պլագինները մեկ ֆայլում: Ներառեք միայն մեկը:

Plugin-ի կախվածությունը

Որոշ պլագիններ և CSS բաղադրիչներ կախված են այլ պլագիններից: Եթե ​​դուք ներառում եք պլագիններ առանձին-առանձին, համոզվեք, որ ստուգեք այս կախվածությունները փաստաթղթերում: Նկատի ունեցեք նաև, որ բոլոր հավելումները կախված են jQuery-ից (սա նշանակում է, որ jQuery-ն պետք է ներառված լինի plugin ֆայլերից առաջ): Խորհրդակցեք մեզbower.json ՝ տեսնելու, թե jQuery-ի որ տարբերակներն են աջակցվում:

Տվյալների հատկանիշներ

Դուք կարող եք օգտագործել բոլոր Bootstrap հավելվածները զուտ նշագրման API-ի միջոցով՝ առանց JavaScript-ի մեկ տող գրելու: Սա Bootstrap-ի առաջին կարգի API-ն է և պետք է լինի ձեր առաջին ուշադրությունը plugin օգտագործելիս:

Այնուամենայնիվ, որոշ իրավիճակներում կարող է ցանկալի լինել անջատել այս գործառույթը: Հետևաբար, մենք նաև հնարավորություն ենք տալիս անջատել տվյալների հատկանիշը API-ն՝ անջատելով բոլոր իրադարձությունները փաստաթղթի անվանատարածքով data-api: Սա այսպիսի տեսք ունի.

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

Որպես այլընտրանք, հատուկ պլագին թիրախավորելու համար պարզապես ներառեք հավելվածի անունը որպես անվանատարածք տվյալների api անվանատարածքի հետ միասին, ինչպես հետևյալը.

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

Միայն մեկ փլագին յուրաքանչյուր տարրի միջոցով տվյալների ատրիբուտների միջոցով

Մի օգտագործեք տվյալների ատրիբուտները մի քանի պլագիններից միևնույն տարրի վրա: Օրինակ, կոճակը չի կարող և՛ գործիքի հուշում ունենալ, և՛ միացնել մոդալը: Դա անելու համար օգտագործեք փաթաթման տարր:

Ծրագրային API

Մենք նաև կարծում ենք, որ դուք պետք է կարողանաք օգտագործել բոլոր Bootstrap հավելվածները զուտ JavaScript API-ի միջոցով: Բոլոր հանրային API-ները միայնակ, շղթայական մեթոդներ են և վերադարձնում են գործածված հավաքածուն:

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

Բոլոր մեթոդները պետք է ընդունեն կամընտիր ընտրանքների օբյեկտ, տող, որն ուղղված է որոշակի մեթոդին կամ ոչինչ (որը սկսում է լռելյայն վարքագիծ ունեցող պլագին).

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

Յուրաքանչյուր փլագին նաև բացահայտում է իր չմշակված կոնստրուկտորը մի Constructorհատկության վրա՝ $.fn.popover.Constructor. Եթե ​​ցանկանում եք ստանալ հատուկ plugin-ի օրինակ, առբերեք այն անմիջապես տարրից՝ $('[rel="popover"]').data('popover').

Կանխադրված կարգավորումներ

Դուք կարող եք փոխել plugin-ի լռելյայն կարգավորումները՝ փոփոխելով plugin-ի Constructor.DEFAULTSօբյեկտը.

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

Ոչ մի կոնֆլիկտ

Երբեմն անհրաժեշտ է լինում օգտագործել Bootstrap պլագիններ այլ UI շրջանակների հետ: Այս հանգամանքներում երբեմն կարող են տեղի ունենալ անունների տարածության բախումներ: Եթե ​​դա տեղի ունենա, դուք կարող եք զանգահարել .noConflictայն պլագինին, որի արժեքը ցանկանում եք վերադարձնել:

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

Իրադարձություններ

Bootstrap-ն ապահովում է հարմարեցված իրադարձություններ փլագինների մեծ մասի եզակի գործողությունների համար: Ընդհանրապես, դրանք գալիս են ինֆինիտիվ և անցյալ մասնակցային ձևով, որտեղ ինֆինիտիվը (նախ. show) գործարկվում է իրադարձության սկզբում, իսկ նրա անցյալ մասնակցային ձևը ( նախ. shown) գործարկվում է գործողության ավարտից հետո:

3.0.0-ի դրությամբ Bootstrap-ի բոլոր իրադարձությունները անվանատարածված են:

Բոլոր անվերջ իրադարձությունները ապահովում են preventDefaultֆունկցիոնալություն: Սա հնարավորություն է տալիս դադարեցնել գործողությունների կատարումը նախքան այն սկսելը:

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

Տարբերակների համարները

Bootstrap-ի jQuery պլագիններից յուրաքանչյուրի տարբերակը հասանելի VERSIONէ plugin-ի կոնստրուկտորի սեփականության միջոցով: Օրինակ, Tooltip plugin-ի համար.

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

Հատուկ հետադարձ կապ չկա, երբ JavaScript-ն անջատված է

Bootstrap-ի պլագինները առանձնապես նրբագեղորեն չեն զիջում, երբ JavaScript-ն անջատված է: Եթե ​​այս դեպքում ձեզ հետաքրքրում է օգտատերերի փորձը, օգտագործեք <noscript>ձեր օգտատերերին իրավիճակը (և ինչպես կրկին ակտիվացնել JavaScript-ը) բացատրելու համար և/կամ ավելացրեք ձեր սեփական հետադարձ կապերը:

Երրորդ կողմի գրադարաններ

Bootstrap-ը պաշտոնապես չի աջակցում երրորդ կողմի JavaScript գրադարաններին , ինչպիսիք են Prototype-ը կամ jQuery UI-ը: Չնայած .noConflictանվանատարածք ունեցող իրադարձություններին, կարող են լինել համատեղելիության խնդիրներ, որոնք դուք պետք է ինքնուրույն շտկեք:

Transitions transition.js

Անցումների մասին

Պարզ անցումային էֆեկտների համար ներառեք transition.jsմեկ անգամ մյուս JS ֆայլերի կողքին: Եթե ​​դուք օգտագործում եք կազմված (կամ փոքրացված) bootstrap.js, կարիք չկա ներառել սա. այն արդեն կա:

Ինչ կա ներսում

Transition.js-ը իրադարձությունների հիմնական օգնական է, transitionEndինչպես նաև CSS անցումային էմուլյատոր: Այն օգտագործվում է այլ պլագինների կողմից՝ ստուգելու CSS անցումային աջակցությունը և կախված անցումները բռնելու համար:

Անջատում է անցումները

Անցումները կարող են գլոբալ անջատվել՝ օգտագործելով հետևյալ JavaScript հատվածը, որը պետք է գա բեռնվելուց հետո transition.js(կամ bootstrap.jsկամ bootstrap.min.js, ըստ դեպքի).

$.support.transition = false

Մոդալներ modal.js

Մոդալները պարզեցված են, բայց ճկուն, երկխոսության հուշումներ՝ նվազագույն պահանջվող ֆունկցիոնալությամբ և խելացի լռելյայններով:

Բազմաթիվ բաց մոդալներ չեն ապահովվում

Համոզվեք, որ մի բացեք մոդալ, քանի դեռ մյուսը դեռ տեսանելի է: Միաժամանակ մեկից ավելի մոդալ ցուցադրելու համար պահանջվում է հատուկ կոդ:

Մոդալ նշումների տեղադրում

Միշտ փորձեք տեղադրել մոդալի HTML կոդը ձեր փաստաթղթում վերին մակարդակում, որպեսզի խուսափեք այլ բաղադրիչներից, որոնք կազդեն մոդալի տեսքի և/կամ ֆունկցիոնալության վրա:

Բջջային սարքերի նախազգուշացումներ

Բջջային սարքերում մոդալների օգտագործման վերաբերյալ կան որոշ նախազգուշացումներ: Մանրամասների համար տես մեր դիտարկիչի աջակցության փաստաթղթերը :

Քանի որ HTML5-ը սահմանում է իր իմաստաբանությունը, autofocusHTML հատկանիշը որևէ ազդեցություն չունի Bootstrap մոդալներում: Նույն էֆեկտին հասնելու համար օգտագործեք որոշ հատուկ JavaScript.

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

Օրինակներ

Ստատիկ օրինակ

Վերարտադրված մոդալ՝ վերնագրի, հիմնականի և ներքևում գտնվող գործողությունների հավաքածուով:

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

Կենդանի ցուցադրություն

Փոխեք մոդալը JavaScript-ի միջոցով՝ սեղմելով ստորև նշված կոճակը: Այն կսահի ներքև և կխամրի էջի վերևից:

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

Մոդալները մատչելի դարձրեք

Համոզվեք, որ ավելացրեք role="dialog"և aria-labelledby="...", հղում կատարելով մոդալ վերնագրին, դեպի և .modalինքնին :role="document".modal-dialog

Բացի այդ, դուք կարող եք տալ ձեր մոդալ երկխոսության նկարագրությունը aria-describedbyon-ի հետ .modal:

YouTube-ի տեսանյութերի ներկառուցում

YouTube-ի տեսանյութերը մոդալներում զետեղելու համար պահանջվում է լրացուցիչ JavaScript, որը չի Bootstrap-ում՝ ավտոմատ կերպով դադարեցնելու նվագարկումը և ավելին: Լրացուցիչ տեղեկությունների համար տես Stack Overflow-ի այս օգտակար գրառումը :

Ընտրովի չափսեր

Մոդալներն ունեն երկու ընտրովի չափեր, որոնք հասանելի են մոդիֆիկատորների դասերի միջոցով, որոնք տեղադրվելու են .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>

Հեռացնել անիմացիան

Մոդալների համար, որոնք պարզապես հայտնվում են, այլ ոչ թե խամրում, հեռացրեք .fadeդասը ձեր մոդալ նշումից:

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

Օգտագործելով ցանցային համակարգը

Մոդալի շրջանակներում Bootstrap ցանցային համակարգի առավելություններից օգտվելու համար պարզապես տեղադրեք .rows-ը .modal-bodyև այնուհետև օգտագործեք սովորական ցանցային համակարգի դասերը:

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

Ունե՞ք մի փունջ կոճակներ, որոնք բոլորն էլ գործարկում են նույն մոդալը, պարզապես մի փոքր տարբեր բովանդակությամբ: Օգտագործեք event.relatedTargetև HTML data-*ատրիբուտներ (հնարավոր է jQuery-ի միջոցով )՝ մոդալի բովանդակությունը փոխելու համար՝ կախված նրանից, թե որ կոճակն է սեղմված: Մանրամասների համար տե՛ս Modal Events փաստաթղթերը relatedTarget,

... ավելի շատ կոճակներ...
<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)
})

Օգտագործումը

Մոդալ հավելվածը փոխում է ձեր թաքնված բովանդակությունը ըստ պահանջի՝ տվյալների ատրիբուտների կամ JavaScript-ի միջոցով: Այն նաև ավելացնում .modal-openէ <body>լռելյայն ոլորման վարքագիծը վերացնելու համար և առաջացնում է .modal-backdropսեղմման տարածք՝ մոդալից դուրս սեղմելիս ցուցադրված մոդալները հեռացնելու համար:

Տվյալների ատրիբուտների միջոցով

Ակտիվացրեք մոդալ առանց JavaScript գրելու: Սահմանել data-toggle="modal"կարգավորիչի տարրը, ինչպես կոճակը, a-ի հետ մեկտեղ data-target="#foo"կամ href="#foo"թիրախավորել որոշակի մոդալ՝ փոխարկելու համար:

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

JavaScript-ի միջոցով

Զանգահարեք մոդալ id- myModalով JavaScript-ի մեկ տողով.

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

Ընտրանքներ

Ընտրանքները կարող են փոխանցվել տվյալների ատրիբուտների կամ JavaScript-ի միջոցով: Տվյալների ատրիբուտների համար ավելացրեք տարբերակի անունը data-, ինչպես data-backdrop="".

Անուն տիպ լռելյայն նկարագրությունը
ֆոն բուլյան կամ լարային'static' ճիշտ Ներառում է մոդալ-ֆոնային տարր: Որպես այլընտրանք, նշեք staticֆոն, որը չի փակում մոդալը սեղմելով:
ստեղնաշար բուլյան ճիշտ Փակում է մոդալը, երբ սեղմված է escape ստեղնը
ցուցադրում բուլյան ճիշտ Ցույց է տալիս մոդալը, երբ սկզբնավորվում է:
հեռավոր ուղին կեղծ

Այս տարբերակը հնացած է v3.3.0-ից և հեռացվել է v4-ում: Փոխարենը խորհուրդ ենք տալիս օգտագործել հաճախորդի կողմի ձևանմուշը կամ տվյալների պարտադիր շրջանակը կամ ինքներդ զանգահարել jQuery.load :

Եթե ​​տրամադրվի հեռավոր URL, բովանդակությունը մեկ անգամ կբեռնվի jQuery-ի loadմեթոդով և կներարկվի .modal-contentdiv-ում: Եթե ​​դուք օգտագործում եք data-api, կարող եք որպես այլընտրանք օգտագործել hrefհատկանիշը՝ նշելու հեռավոր աղբյուրը: Դրա օրինակը ներկայացված է ստորև.

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

Մեթոդներ

Ակտիվացնում է ձեր բովանդակությունը որպես մոդալ: Ընդունում է ընտրովի տարբերակներ object:

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

Ձեռքով փոխում է մոդալը: Վերադառնում է զանգահարողին մինչև մոդալն իրականում ցուցադրվել կամ թաքցվել է (այսինքն՝ նախքան իրադարձությունը shown.bs.modalկամ hidden.bs.modalիրադարձությունը տեղի ունենալը):

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

Ձեռքով բացում է մոդալ: Վերադառնում է զանգահարողին մինչև մոդալը փաստացի ցուցադրվելը (այսինքն՝ նախքան shown.bs.modalիրադարձությունը տեղի ունենալը):

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

Ձեռքով թաքցնում է մոդալը: Վերադառնում է զանգահարողին նախքան մոդալն իրականում թաքցվել է (այսինքն՝ նախքան hidden.bs.modalիրադարձությունը տեղի ունենալը):

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

Նորից կարգավորում է մոդալի դիրքը, որպեսզի հակադարձի ոլորման տողը, եթե այն հայտնվի, ինչը կստիպի մոդալը ցատկել դեպի ձախ:

Անհրաժեշտ է միայն այն դեպքում, երբ մոդալի բարձրությունը փոխվում է, երբ այն բաց է:

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

Իրադարձություններ

Bootstrap-ի մոդալ դասը բացահայտում է մի քանի իրադարձություն՝ մոդալ ֆունկցիոնալությանը միանալու համար:

Բոլոր մոդալ իրադարձությունները կրակվում են հենց մոդալի վրա (այսինքն ՝ <div class="modal">).

Միջոցառման տեսակը Նկարագրություն
շոու.բս.մոդալ Այս իրադարձությունը գործարկվում է անմիջապես, երբ showկանչվում է օրինակի մեթոդը: Եթե ​​կտտոցով է պայմանավորված, սեղմված տարրը հասանելի է որպես relatedTargetիրադարձության հատկություն:
ցուցադրված.բս.մոդալ Այս իրադարձությունը գործարկվում է, երբ մոդալը տեսանելի է դառնում օգտատիրոջը (կսպասի CSS անցումների ավարտին): Եթե ​​կտտոցով է պայմանավորված, սեղմված տարրը հասանելի է որպես relatedTargetիրադարձության հատկություն:
hide.bs.modal Այս իրադարձությունը գործարկվում է անմիջապես, երբ hideկանչվում է օրինակի մեթոդը:
թաքնված.բս.մոդալ Այս իրադարձությունը գործարկվում է, երբ մոդալն ավարտում է օգտագործողից թաքցված լինելը (կսպասի CSS անցումների ավարտին):
loaded.bs.modal Այս իրադարձությունը գործարկվում է, երբ մոդալը բեռնում է բովանդակությունը՝ օգտագործելով remoteընտրանքը:
$('#myModal').on('hidden.bs.modal', function (e) {
  // do something...
})

Dropdown dropdown.js

Ավելացրեք բացվող ընտրացանկերը գրեթե ցանկացած բանի այս պարզ հավելվածի միջոցով, ներառյալ նավարկղը, ներդիրները և հաբերը:

Navbar-ի շրջանակներում

Հաբերի շրջանակներում

Տվյալների ատրիբուտների կամ JavaScript-ի միջոցով բացվող հավելվածը փոխում է թաքնված բովանդակությունը (բացվող ընտրացանկերը)՝ փոխելով .openդասը մայր ցանկի տարրի վրա:

Բջջային սարքերում բացվող ցանկը բացելով ավելացնում է .dropdown-backdropորպես հպման տարածք՝ մենյուից դուրս սեղմելիս բացվող ընտրացանկերը փակելու համար, ինչը iOS-ի պատշաճ աջակցության պահանջ է: Սա նշանակում է, որ բաց բացվող ընտրացանկից այլ բացվող ընտրացանկից անցնելը պահանջում է լրացուցիչ հպում բջջայինի վրա:

Նշում. data-toggle="dropdown"հատկանիշը հիմնվում է հավելվածի մակարդակով բացվող ընտրացանկերը փակելու համար, ուստի լավ գաղափար է միշտ օգտագործել այն:

Տվյալների ատրիբուտների միջոցով

Ավելացրեք data-toggle="dropdown"հղմանը կամ կոճակին՝ բացվող ցանկը փոխարկելու համար:

<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-ները անձեռնմխելի պահելու համար օգտագործեք data-targetհատկանիշը .-ի փոխարեն 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-ի միջոցով

Զանգահարեք բացվող ցանկերը JavaScript-ի միջոցով.

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

data-toggle="dropdown"դեռ պահանջվում է

Անկախ նրանից՝ դուք կանչում եք ձեր բացվող ցանկը JavaScript-ի միջոցով, թե փոխարենը օգտագործում եք տվյալների api-ն, data-toggle="dropdown"միշտ պահանջվում է ներկա լինել բացվող ցանկի գործարկման տարրում:

Ոչ ոք

Անջատում է տվյալ նավագոտու կամ ներդիրներով նավիգացիայի բացվող ընտրացանկը:

Բոլոր իջնող իրադարձությունները գործարկվում են .dropdown-menuծնողական տարրի վրա:

Բոլոր բացվող իրադարձություններն ունեն relatedTargetհատկություն, որի արժեքը փոխարկվող խարիսխի տարրն է:

Միջոցառման տեսակը Նկարագրություն
show.bs.dropdown Այս իրադարձությունն անմիջապես գործարկվում է, երբ կանչվում է ցուցադրման օրինակի մեթոդը:
ցուցադրված.bs.բացվող պատուհան Այս իրադարձությունը գործարկվում է, երբ բացվող ցանկը տեսանելի է դառնում օգտատիրոջը (կսպասի CSS անցումների ավարտին):
hide.bs.dropdown Այս իրադարձությունը գործարկվում է անմիջապես, երբ կանչվում է թաքցնել օրինակի մեթոդը:
hidden.bs.dropdown Այս իրադարձությունը գործարկվում է, երբ բացվող ցանկն ավարտվում է օգտագործողից թաքցնելու համար (կսպասի CSS անցումների ավարտին):
$('#myDropdown').on('show.bs.dropdown', function () {
  // do something…
})

ScrollSpy scrollspy.js

Օրինակ navbar-ում

ScrollSpy հավելվածը նախատեսված է նավի թիրախների ավտոմատ թարմացման համար՝ հիմնվելով ոլորման դիրքի վրա: Ոլորեք նավագոտի տակ գտնվող տարածքը և դիտեք ակտիվ դասի փոփոխությունը: Բացվող ենթակետերը նույնպես ընդգծված կլինեն:

@ճարպ

Գովազդային սռնապաններ keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi նախքան նրանք վաճառվել են qui. Tumblr ֆերմա-սեղան հեծանիվների իրավունքներն ինչ էլ որ լինեն: Anim keffiyeh carles cardigan. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby սվիտեր Lomo Jean Shorts, Wiliamsburg Hoodie Minim qui, որոնց մասին դուք հավանաբար չեք լսել և բրդե հյուսված բրդե հյուսված ֆոնդ culpa biodiesel Wes Anderson էսթետիկ: Nihil դաջված accusamus, cred հեգնանք biodiesel keffiyeh artisan ullamco consequat.

@mdo

Veniam marfa բեղավոր սքեյթբորդ, դիպչող ֆուգիաթ թավշյա մորուք: Freegan beard aliqua cupidatat mcsweeney's vero. Cupidatat չորս loko nisi, ea helvetica nulla carles. Դաջված Cosby սվիտեր սննդի բեռնատար, mcsweeney's quis non freegan վինիլ: Lo-fi wes anderson +1 sartorial. Կառլեսը ոչ էսթետիկ վարժություն quis gentrify. Brooklyn adipisicing craft beer vice keytar deserunt.

մեկ

Occaecat commodo aliqua delectus. Fap craft գարեջուր deserunt skateboard ea. Lomo հեծանիվների իրավունքները adipisicing banh mi, velit ea sunt հաջորդ մակարդակի locavore մեկ ծագման սուրճ է magna veniam. Բարձր կյանքի id վինիլային, էխո պարկի հետևանքով quis aliquip banh mi pitchfork: Vero VHS-ը դիպչող է: Կառուցեք DIY նվազագույն մեսենջերի պայուսակ: Cred ex in, կայուն ելեկտրական կոնսեկտոր Fanny փաթեթ iPhone.

երկու

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 բլոգ, culpa մեսենջեր պայուսակ marfa, ինչ էլ որ լինի դելեկտուս սննդի մեքենա: Sapiente synth id assumenda. Locavore sed helvetica կլիշե հեգնանք, ամպրոպային կատուներ, որոնց մասին դուք հավանաբար չեք լսել, հետևում են hoodie առանց սնձան lo-fi fap aliquip-ի: Labore elit placeat նախքան նրանք վաճառվել են, Terry richardson proident brunch nesciunt quis cosby սվիտեր pariatur keffiyeh ut helvetica artisan. Cardigan craft գարեջուր seitan պատրաստի թել. VHS chambray laboris tempor veniam. Anim mollit minim commodo ulamco thundercats.

Օգտագործումը

Պահանջում է Bootstrap Navig

Scrollspy-ը ներկայումս պահանջում է Bootstrap nav բաղադրիչի օգտագործումը ակտիվ հղումների պատշաճ ընդգծման համար:

Պահանջվում են լուծելի ID թիրախներ

Navbar-ի հղումները պետք է ունենան լուծելի ID թիրախներ: Օրինակ, a-ն <a href="#home">home</a>պետք է համապատասխանի DOM-ում ինչ-որ բանի, ինչպիսին է <div id="home"></div>.

Ոչ :visibleնպատակային տարրերը անտեսվել են

Թիրախային տարրերը, որոնք չեն :visibleհամապատասխանում jQuery-ին , անտեսվելու են, և դրանց համապատասխան նավային տարրերը երբեք չեն ընդգծվի:

Պահանջում է հարաբերական դիրքավորում

Անկախ իրականացման եղանակից, scrollspy-ը պահանջում է օգտագործել position: relative;այն տարրի վրա, որը դուք լրտեսում եք: Շատ դեպքերում սա է <body>. Երբ պտտվում եք այլ տարրերի վրա, քան <body>, համոզվեք, որ ունեք heightհավաքածու և կիրառեք overflow-y: scroll;:

Տվյալների ատրիբուտների միջոցով

Ձեր վերին տողում նավիգացիայի մեջ հեշտությամբ ավելացնելու սկոլսպի վարքագիծը, ավելացրեք data-spy="scroll"այն տարրին, որը ցանկանում եք լրտեսել (առավել սովորաբար սա կլինի <body>): Այնուհետև ավելացրեք հատկանիշը Bootstrap-ի որևէ բաղադրիչի data-targetծնող տարրի ID-ով կամ դասով :.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-ի միջոցով

Ձեր CSS-ն ավելացնելուց հետո position: relative;զանգահարեք scrollspy-ը JavaScript-ի միջոցով.

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

Մեթոդներ

.scrollspy('refresh')

Երբ օգտագործում եք scrollspy-ը DOM-ից տարրեր ավելացնելու կամ հեռացնելու հետ մեկտեղ, դուք պետք է զանգահարեք թարմացման մեթոդը այսպես.

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

Ընտրանքներ

Ընտրանքները կարող են փոխանցվել տվյալների ատրիբուտների կամ JavaScript-ի միջոցով: Տվյալների ատրիբուտների համար ավելացրեք տարբերակի անունը data-, ինչպես data-offset="".

Անուն տիպ լռելյայն նկարագրությունը
օֆսեթ թիվ 10 Փիքսելներ, որոնք պետք է շրջվեն վերևից՝ ոլորման դիրքը հաշվարկելիս:

Իրադարձություններ

Միջոցառման տեսակը Նկարագրություն
activate.bs.scrollspy Այս իրադարձությունը գործարկվում է, երբ նոր տարր ակտիվանում է scrollspy-ի կողմից:
$('#myScrollspy').on('activate.bs.scrollspy', function () {
  // do something…
})

Փոխարկվող ներդիրներ tab.js

Օրինակ ներդիրներ

Ավելացրեք արագ, դինամիկ ներդիրների ֆունկցիոնալությունը տեղական բովանդակության վահանակների միջով անցնելու համար, նույնիսկ բացվող ընտրացանկերի միջոցով: Ներդիր ներդիրները չեն աջակցվում:

Հում ջինսե, դուք, հավանաբար, չեք լսել դրանց մասին Jean Shorts Austin: Nesciunt tofu stumptown aliqua, ռետրո սինթետիկ վարպետ մաքրում: Բեղերի կլիշե ժամանակավոր, Wiliamsburg carles vegan helvetica. Reprehenderit մսագործ ռետրո keffiyeh Dreamcatcher synth. Cosby սվիտեր eu banh mi, qui irure terry richardson նախկին կաղամար. Այն կարող է օգտագործվել iPhone-ի համար: Seitan aliquip quis cardigan ամերիկյան հագուստ, մսագործ 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.

Ընդլայնում է ներդիրներով նավիգացիան

Այս փլագինը ընդլայնում է ներդիրներով նավիգացիոն բաղադրիչը ՝ ներդիրներով տարածքներ ավելացնելու համար:

Օգտագործումը

Միացնել ներդիրների ներդիրները JavaScript-ի միջոցով (յուրաքանչյուր ներդիր պետք է առանձին ակտիվացվի).

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

Դուք կարող եք ակտիվացնել առանձին ներդիրները մի քանի եղանակով.

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

Նշում

Դուք կարող եք ակտիվացնել ներդիրի կամ հաբերի նավարկությունը՝ առանց որևէ JavaScript գրելու՝ պարզապես նշելով data-toggle="tab"կամ data-toggle="pill"որևէ տարրի վրա: Եթե ​​ավելացնելով navև nav-tabsդասերը ներդիրին ul, կկիրառվի Bootstrap ներդիրի ոճավորումը , մինչդեռ navև 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>

Մարման էֆեկտ

Ներդիրները խամրելու համար ավելացրեք .fadeյուրաքանչյուրին .tab-pane: Առաջին ներդիրի վահանակը նույնպես պետք .inէ տեսանելի դարձնի սկզբնական բովանդակությունը:

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

Մեթոդներ

$().tab

Ակտիվացնում է ներդիրի տարրը և բովանդակության կոնտեյները: Ներդիրը պետք է ունենա DOM-ում կամ a data-targetկամ hrefթիրախավորող կոնտեյներային հանգույց: Վերոնշյալ օրինակներում ներդիրները ատրիբուտներով <a>s են :data-toggle="tab"

.tab('show')

Ընտրում է տվյալ ներդիրը և ցուցադրում դրա հետ կապված բովանդակությունը: Նախկինում ընտրված ցանկացած այլ ներդիր դառնում է չընտրված, և դրա հետ կապված բովանդակությունը թաքցվում է: Վերադառնում է զանգահարողին՝ նախքան ներդիրի վահանակի ցուցադրումը (այսինքն՝ նախքան shown.bs.tabիրադարձությունը տեղի ունենալը):

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

Իրադարձություններ

Նոր ներդիր ցուցադրելիս իրադարձությունները բացվում են հետևյալ հաջորդականությամբ.

  1. hide.bs.tab(ներկայիս ակտիվ ներդիրում)
  2. show.bs.tab(ցուցադրվող ներդիրում)
  3. hidden.bs.tab(նախորդ ակտիվ ներդիրում, նույնը, ինչ hide.bs.tabմիջոցառման համար)
  4. shown.bs.tab(նոր ակտիվ ցուցադրված ներդիրում, նույնը, ինչ show.bs.tabմիջոցառման համար)

Եթե ​​ոչ մի ներդիր արդեն ակտիվ չի եղել, ապա hide.bs.tabև hidden.bs.tabիրադարձությունները չեն գործարկվի:

Միջոցառման տեսակը Նկարագրություն
show.bs.tab Այս իրադարձությունը բացվում է ներդիրների ցուցադրման վրա, բայց մինչ նոր ներդիրը կցուցադրվի: Օգտագործեք event.targetև event.relatedTargetթիրախավորեք համապատասխանաբար ակտիվ ներդիրը և նախորդ ակտիվ ներդիրը (եթե առկա է):
ցուցադրված.bs.ներդիր Այս իրադարձությունը բացվում է ներդիրների ցուցադրումից հետո ներդիրի ցուցադրումից հետո: Օգտագործեք event.targetև event.relatedTargetթիրախավորեք համապատասխանաբար ակտիվ ներդիրը և նախորդ ակտիվ ներդիրը (եթե առկա է):
hide.bs.tab Այս իրադարձությունը բացվում է, երբ պետք է ցուցադրվի նոր ներդիր (և այդպիսով, նախորդ ակտիվ ներդիրը պետք է թաքցվի): Օգտագործեք event.targetև event.relatedTargetթիրախավորեք համապատասխանաբար ընթացիկ ակտիվ ներդիրը և նոր շուտով ակտիվանալու ներդիրը:
hidden.bs.tab Այս իրադարձությունը բացվում է նոր ներդիրի ցուցադրումից հետո (և այդպիսով նախորդ ակտիվ ներդիրը թաքցվում է): Օգտագործեք event.targetև event.relatedTargetթիրախավորեք նախորդ ակտիվ ներդիրը և նոր ակտիվ ներդիրը, համապատասխանաբար:
$('a[data-toggle="tab"]').on('shown.bs.tab', function (e) {
  e.target // newly activated tab
  e.relatedTarget // previous active tab
})

Tooltips tooltip.js

Ոգեշնչված է հիանալի jQuery.tipsy հավելվածով, որը գրվել է Ջեյսոն Ֆրեյմի կողմից; Tooltips-ը թարմացված տարբերակ է, որը չի հիմնվում պատկերների վրա, օգտագործում է CSS3 անիմացիաների համար, իսկ տվյալների ատրիբուտները տեղական վերնագրերի պահպանման համար:

Գործիքների հուշումները զրոյական երկարությամբ վերնագրերով երբեք չեն ցուցադրվում:

Օրինակներ

Գործիքների հուշումները տեսնելու համար սավառնեք ստորև նշված հղումների վրա.

Նիհար տաբատ հաջորդ մակարդակի keffiyeh դուք հավանաբար չեք լսել նրանց մասին: Ֆոտո խցիկ մորուք հում ջինսե տառատեսակ Vegan Messenger պայուսակ stumptown. Ֆերմայից սեղան սեյթան, Mcsweeney's fixie-ի կայուն քինոա 8-բիթանոց ամերիկյան հագուստն ունի Թերի Ռիչարդսոնի վինիլային շամպրե: Մորուքի ստամպթաուն, կարդիգաններ բանհ մի լոմո ամպրոպ. Tofu բիոդիզել Ուիլյամսբուրգ Մարֆա, չորս Loko Mcsweeney's cleanse vegan chambray. Իսկապես հեգնական արհեստավոր , ինչ էլ որ լինի keytar-ը, սկեսնթեր ֆերմայից-սեղան Banksy Austin twitter handle freegan cred raw denim single-origin սուրճ վիրուսային:

Ստատիկ գործիքի հուշում

Հասանելի է չորս տարբերակ՝ վերև, աջ, ներքև և ձախ հավասարեցված:

Չորս ուղղություն

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

Ընտրելու գործառույթ

Արդյունավետության նկատառումներից ելնելով, Tooltip-ը և Popover data-apis-ը միացված են, ինչը նշանակում է, որ դուք պետք է նախաստորագրեք դրանք ինքներդ :

Էջի բոլոր գործիքների հուշումները սկզբնավորելու եղանակներից մեկը կլինի դրանք ընտրելն իրենց data-toggleհատկանիշով.

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

Օգտագործումը

Tooltip plugin-ը ստեղծում է բովանդակություն և նշում ըստ պահանջի, և լռելյայն տեղադրում է գործիքի հուշումները դրանց գործարկիչի տարրից հետո:

Գործարկեք գործիքի հուշումը JavaScript-ի միջոցով.

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

Նշում

Գործիքների հուշման համար անհրաժեշտ նշումը միայն dataհատկանիշ titleէ, և HTML տարրի վրա դուք ցանկանում եք ունենալ գործիքի հուշում: Գործիքների հուշման ստեղծվող նշումը բավականին պարզ է, թեև այն պահանջում է դիրք (լռելյայն սահմանվել է topհավելվածի կողմից):

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

Բազմաթիվ հղումներ

Երբեմն դուք ցանկանում եք գործիքի հուշում ավելացնել հիպերհղմանը, որը փաթաթում է բազմաթիվ տողեր: Tooltip plugin-ի լռելյայն վարքագիծն այն է կենտրոնացնել այն հորիզոնական և ուղղահայաց: Ավելացրեք white-space: nowrap;ձեր խարիսխներին՝ դրանից խուսափելու համար:

Գործիքների հուշումները կոճակների խմբերում, մուտքային խմբերում և աղյուսակներում պահանջում են հատուկ կարգավորում

Գործիքների հուշումներ a-ի .btn-groupկամ an- .input-groupի կամ աղյուսակի հետ կապված տարրերի վրա ( <td>, <th>, <tr>, <thead>, <tbody>, <tfoot>), օգտագործելիս դուք պետք է նշեք տարբերակը container: 'body'(ստորև փաստաթղթավորված)՝ անցանկալի կողմնակի ազդեցություններից խուսափելու համար (օրինակ՝ տարրի լայնացումը և/ կամ կորցնելով իր կլորացված անկյունները, երբ գործարկվում է գործիքի հուշումը):

Մի փորձեք ցուցադրել թաքնված տարրերի վերաբերյալ հուշումներ

Նշանակման $(...).tooltip('show')դեպքում, երբ թիրախ տարրը գտնվում display: none;է, գործիքի հուշումը սխալ կտեղադրվի:

Մատչելի խորհուրդներ ստեղնաշարի և օժանդակ տեխնոլոգիաների օգտագործողների համար

Ստեղնաշարով նավարկող օգտատերերի և, մասնավորապես, օժանդակ տեխնոլոգիաների օգտագործողների համար, դուք պետք է միայն գործիքի հուշումներ ավելացնեք ստեղնաշարի վրա կենտրոնացված տարրերին, ինչպիսիք են հղումները, ձևի կառավարումը կամ tabindex="0"հատկանիշ ունեցող ցանկացած կամայական տարր:

Հաշմանդամ տարրերի վերաբերյալ գործիքների հուշումները պահանջում են փաթաթման տարրեր

a-ին disabledկամ .disabledտարրին գործիքի հուշում ավելացնելու համար տարրը դրեք a-ի ներսում և դրա փոխարեն <div>կիրառեք գործիքի հուշումը :<div>

Ընտրանքներ

Ընտրանքները կարող են փոխանցվել տվյալների ատրիբուտների կամ JavaScript-ի միջոցով: Տվյալների ատրիբուտների համար ավելացրեք տարբերակի անունը data-, ինչպես data-animation="".

Անուն Տիպ Կանխադրված Նկարագրություն
անիմացիա բուլյան ճիշտ Կիրառեք CSS fade անցում դեպի գործիքի հուշում
կոնտեյներ լարային | կեղծ կեղծ

Կցում է գործիքի հուշումը կոնկրետ տարրին: Օրինակ՝ container: 'body'. Այս տարբերակը հատկապես օգտակար է նրանով, որ թույլ է տալիս գործիքի հուշումը տեղադրել փաստաթղթի հոսքի մեջ՝ գործարկող տարրի մոտ, ինչը թույլ չի տա գործիքի հուշումը հեռանալ գործարկող տարրից պատուհանի չափսերի փոփոխման ժամանակ:

ուշացում համարը | օբյեկտ 0

Գործիքների հուշումը (ms) ցուցադրելու և թաքցնելու ուշացում - չի կիրառվում ձեռքով ձգանման տեսակի համար

Եթե ​​համարը տրվում է, ապա ուշացումը կիրառվում է ինչպես թաքցնել/ցուցադրել

Օբյեկտի կառուցվածքը հետևյալն է.delay: { "show": 500, "hide": 100 }

html բուլյան կեղծ Տեղադրեք HTML գործիքի հուշում: Եթե ​​կեղծ է, jQuery-ի textմեթոդը կօգտագործվի DOM-ում բովանդակություն մտցնելու համար: Օգտագործեք տեքստ, եթե ձեզ անհանգստացնում են XSS հարձակումները:
տեղաբաշխում լարային | ֆունկցիան 'գագաթ'

Ինչպես տեղադրել գործիքի հուշումը - վերև | ստորին | ձախ | ճիշտ | ավտո.
Երբ նշված է «ավտո»-ն, այն դինամիկ կերպով կվերակողմնորոշի գործիքի հուշումը: Օրինակ, եթե տեղադրումը «ավտոմատ ձախ» է, գործիքի հուշումը հնարավորության դեպքում կցուցադրվի ձախ կողմում, հակառակ դեպքում՝ աջ:

Երբ ֆունկցիան օգտագործվում է տեղաբաշխումը որոշելու համար, այն կանչվում է գործիքի հուշումով DOM հանգույցը որպես առաջին արգումենտ և գործարկող տարրը՝ DOM հանգույցը որպես երկրորդ: Համատեքստը thisդրված է գործիքի հուշման օրինակին:

ընտրիչ լար կեղծ Եթե ​​ընտրիչ է տրամադրվում, գործիքի հուշման օբյեկտները կփոխանցվեն նշված թիրախներին: Գործնականում սա օգտագործվում է դինամիկ HTML բովանդակության համար գործիքի հուշումներ ավելացնելու համար: Տեսեք սա և տեղեկատվական օրինակ :
կաղապար լար '<div class="tooltip" role="tooltip"><div class="tooltip-arrow"></div><div class="tooltip-inner"></div></div>'

Հիմք HTML-ը, որը պետք է օգտագործվի գործիքի հուշում ստեղծելիս:

Գործիքների հուշումները titleներարկվելու են .tooltip-inner.

.tooltip-arrowկդառնա գործիքի հուշման սլաքը:

Ամենաարտաքին փաթաթման տարրը պետք է ունենա .tooltipդասը:

կոչում լարային | ֆունկցիան ''

Վերնագրի կանխադրված արժեքը, եթե titleհատկանիշը չկա:

Եթե ​​տրված է ֆունկցիա, այն կկանչվի իր thisհղումների հավաքածուով այն տարրին, որին կցված է գործիքի հուշումը:

ձգան լար «սավառել ֆոկուս» Ինչպես է գործարկվում գործիքի հուշումը - սեղմեք | սավառնել | կենտրոնացում | ձեռնարկ. Դուք կարող եք անցնել մի քանի ձգան; առանձնացրեք դրանք բացատով: manualչի կարող համակցվել որևէ այլ ձգանի հետ:
տեսադաշտ լարային | օբյեկտ | ֆունկցիան {ընտրիչ՝ «մարմին», լիցք՝ 0 }

Գործիքների հուշումը պահում է այս տարրի սահմաններում: Օրինակ՝ viewport: '#viewport'կամ{ "selector": "#viewport", "padding": 0 }

Եթե ​​տրված է ֆունկցիա, այն կանչվում է՝ որպես միակ արգումենտ DOM հանգույցի գործարկման տարրը: Համատեքստը thisդրված է գործիքի հուշման օրինակին:

Տվյալների ատրիբուտները առանձին գործիքների հուշումների համար

Գործիքների առանձին հուշումների տարբերակները կարող են այլընտրանքային կերպով սահմանվել տվյալների ատրիբուտների օգտագործման միջոցով, ինչպես բացատրվեց վերևում:

Մեթոդներ

$().tooltip(options)

Կցում է գործիքի հուշման կարգավորիչը տարրերի հավաքածուին:

.tooltip('show')

Բացահայտում է տարրի գործիքի հուշումը: Վերադառնում է զանգահարողին՝ նախքան գործիքի հուշումը փաստացի ցուցադրելը (այսինքն՝ նախքան shown.bs.tooltipիրադարձությունը տեղի ունենալը): Սա համարվում է գործիքի հուշման «ձեռքով» գործարկում: Գործիքների հուշումները զրոյական երկարությամբ վերնագրերով երբեք չեն ցուցադրվում:

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

.tooltip('hide')

Թաքցնում է տարրի գործիքի հուշումը: Վերադառնում է զանգահարողին՝ նախքան գործիքի հուշումը փաստացի թաքցվելը (այսինքն՝ նախքան hidden.bs.tooltipիրադարձությունը տեղի ունենալը): Սա համարվում է գործիքի հուշման «ձեռքով» գործարկում:

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

.tooltip('toggle')

Փոխում է տարրի գործիքի հուշումը: Վերադառնում է զանգահարողին նախքան գործիքի հուշումը իրականում ցուցադրվել կամ թաքցվել է (այսինքն՝ նախքան իրադարձությունը shown.bs.tooltipկամ hidden.bs.tooltipիրադարձությունը տեղի ունենալը): Սա համարվում է գործիքի հուշման «ձեռքով» գործարկում:

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

.tooltip('destroy')

Թաքցնում և ոչնչացնում է տարրի գործիքի հուշումը: Գործիքների հուշումները, որոնք օգտագործում են պատվիրակում (որոնք ստեղծվել են selectorտարբերակի միջոցով ) չեն կարող անհատապես ոչնչացվել հետնորդ ձգան տարրերի վրա:

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

Իրադարձություններ

Միջոցառման տեսակը Նկարագրություն
show.bs.tooltip Այս իրադարձությունը գործարկվում է անմիջապես, երբ showկանչվում է օրինակի մեթոդը:
ցուցադրված.bs.tooltip Այս իրադարձությունը գործարկվում է, երբ գործիքի հուշումը տեսանելի է դառնում օգտատիրոջը (կսպասի CSS անցումների ավարտին):
hide.bs.tooltip Այս իրադարձությունը գործարկվում է անմիջապես, երբ hideկանչվում է օրինակի մեթոդը:
hidden.bs.tooltip Այս իրադարձությունը գործարկվում է, երբ գործիքի հուշումն ավարտվի օգտագործողից թաքցնելու համար (կսպասի CSS-ի անցումների ավարտին):
տեղադրված.bs.tooltip Այս իրադարձությունը գործարկվում է այն show.bs.tooltipիրադարձությունից հետո, երբ գործիքի հուշման ձևանմուշը ավելացվի DOM-ում:
$('#myTooltip').on('hidden.bs.tooltip', function () {
  // do something…
})

Popovers popover.js

Ավելացրեք բովանդակության փոքր ծածկույթներ, ինչպիսիք են iPad-ի բովանդակությունը, ցանկացած տարրի վրա՝ երկրորդական տեղեկատվության պահպանման համար:

Փոփերները, որոնց վերնագիրը և բովանդակությունը զրոյական երկարություն ունեն, երբեք չեն ցուցադրվում:

Plugin-ի կախվածություն

Popover-ները պահանջում են Tooltip plugin- ը ներառել Bootstrap-ի ձեր տարբերակում:

Ընտրելու գործառույթ

Արդյունավետության նկատառումներից ելնելով, Tooltip-ը և Popover data-apis-ը միացված են, ինչը նշանակում է, որ դուք պետք է նախաստորագրեք դրանք ինքներդ :

Էջի բոլոր popover-ները սկզբնավորելու եղանակներից մեկը կլինի դրանք ընտրելն իրենց data-toggleհատկանիշով.

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

Կոճակների խմբերի, մուտքագրման խմբերի և աղյուսակների պովերները պահանջում են հատուկ կարգավորում

.btn-groupa-ի կամ an- ի տարրերի վրա .input-groupկամ աղյուսակի հետ կապված տարրերի վրա ( <td>, <th>, <tr>, <thead>, <tbody>, ) օգտագործելով popovers <tfoot>, դուք պետք է նշեք տարբերակը container: 'body'(ստորև փաստաթղթավորված)՝ խուսափելու համար անցանկալի կողմնակի ազդեցություններից (օրինակ՝ տարրի լայնացումը և/ կամ կորցնելով իր կլորացված անկյունները, երբ պոպովերը գործարկվում է):

Մի փորձեք ցուցադրել թաքնված տարրերի վրա popovers

$(...).popover('show')Նշանակումը , երբ թիրախ տարրը գտնվում է display: none;, կհանգեցնի popover-ի սխալ դիրքավորմանը :

Հաշմանդամ տարրերի վրա պոպովերը պահանջում են փաթաթման տարրեր

disabledA-ին կամ տարրին փոփով ավելացնելու համար .disabledտարրը դրեք a-ի ներսում <div>և դրա փոխարեն կիրառեք popover- <div>ը:

Բազմաթիվ հղումներ

Երբեմն դուք ցանկանում եք ավելացնել popover մի հիպերհղում, որը փաթաթում է բազմաթիվ տողեր: Popover plugin-ի լռելյայն վարքագիծն այն է կենտրոնացնել այն հորիզոնական և ուղղահայաց: Ավելացրեք white-space: nowrap;ձեր խարիսխներին՝ դրանից խուսափելու համար:

Օրինակներ

Ստատիկ պոպովեր

Հասանելի է չորս տարբերակ՝ վերև, աջ, ներքև և ձախ հավասարեցված:

Պոպովեր վերնաշապիկ

Այն կարող է կառուցվել: Aenean eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

Պոպովերի իրավունքը

Այն կարող է կառուցվել: Aenean eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

Պոպովերի հատակը

Այն կարող է կառուցվել: Aenean eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

Պոպովերը հեռացավ

Այն կարող է կառուցվել: Aenean eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

Կենդանի ցուցադրություն

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

Չորս ուղղություն

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

Փակել հաջորդ սեղմումով

Օգտագործեք focusգործարկիչը՝ օգտագործողի կատարած հաջորդ սեղմումով popover-ները հեռացնելու համար:

Հերթական սեղմումով անջատելու համար պահանջվում է հատուկ նշում

Բրաուզերի և միջպլատֆորմի պատշաճ վարքագծի համար դուք պետք է օգտագործեք <a>պիտակը, ոչ թե <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>

Օգտագործումը

Միացնել popover-ները JavaScript-ի միջոցով.

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

Ընտրանքներ

Ընտրանքները կարող են փոխանցվել տվյալների ատրիբուտների կամ JavaScript-ի միջոցով: Տվյալների ատրիբուտների համար ավելացրեք տարբերակի անունը data-, ինչպես data-animation="".

Անուն Տիպ Կանխադրված Նկարագրություն
անիմացիա բուլյան ճիշտ Կիրառեք CSS fade անցում դեպի popover
կոնտեյներ լարային | կեղծ կեղծ

Ավելացնում է popover-ը կոնկրետ տարրի վրա: Օրինակ՝ container: 'body'. Այս տարբերակը հատկապես օգտակար է նրանով, որ այն թույլ է տալիս փաստաթղթի հոսքի մեջ տեղադրել popover-ը գործարկող տարրի մոտ, ինչը թույլ չի տա, որ popover-ը հեռանա գործարկող տարրից պատուհանի չափափոխման ժամանակ:

բովանդակությունը լարային | ֆունկցիան ''

Բովանդակության կանխադրված արժեքը, եթե data-contentհատկանիշը չկա:

Եթե ​​տրված է ֆունկցիա, այն կկանչվի իր thisհղումներով այն տարրին, որին կցված է popover-ը:

ուշացում համարը | օբյեկտ 0

Պոպովերի ցուցադրման և թաքցման հետաձգումը (ms) - չի տարածվում ձեռքով ձգանման տեսակի վրա

Եթե ​​համարը տրվում է, ապա ուշացումը կիրառվում է ինչպես թաքցնել/ցուցադրել

Օբյեկտի կառուցվածքը հետևյալն է.delay: { "show": 500, "hide": 100 }

html բուլյան կեղծ Տեղադրեք HTML-ը popover-ի մեջ: Եթե ​​կեղծ է, jQuery-ի textմեթոդը կօգտագործվի DOM-ում բովանդակություն մտցնելու համար: Օգտագործեք տեքստ, եթե ձեզ անհանգստացնում են XSS հարձակումները:
տեղաբաշխում լարային | ֆունկցիան 'ճիշտ'

Ինչպես տեղադրել popover - վերև | ստորին | ձախ | ճիշտ | ավտո.
Երբ նշված է «ավտո»-ն, այն դինամիկ կերպով կվերակողմնորոշվի փոփովին: Օրինակ, եթե տեղադրումը «ավտոմատ ձախ» է, ապա պոպովերը հնարավորության դեպքում կցուցադրվի ձախ կողմում, հակառակ դեպքում՝ աջ:

Երբ ֆունկցիան օգտագործվում է տեղաբաշխումը որոշելու համար, այն կանչվում է՝ որպես առաջին արգումենտ popover DOM հանգույցը, իսկ երկրորդը՝ DOM հանգույցը՝ գործարկող տարրը: Համատեքստը thisդրված է popover օրինակին:

ընտրիչ լար կեղծ Եթե ​​ընտրիչ է տրամադրվում, popover օբյեկտները կփոխանցվեն նշված թիրախներին: Գործնականում սա օգտագործվում է դինամիկ HTML բովանդակության համար, որպեսզի ավելացվեն popovers: Տեսեք սա և տեղեկատվական օրինակ :
կաղապար լար '<div class="popover" role="tooltip"><div class="arrow"></div><h3 class="popover-title"></h3><div class="popover-content"></div></div>'

Բազային HTML-ն օգտագործելու համար popover-ը ստեղծելիս:

The popover- titleը ներարկվելու է .popover-title.

The popover- contentը ներարկվելու է .popover-content.

.arrowկդառնա պոպովերի նետը:

Ամենաարտաքին փաթաթման տարրը պետք է ունենա .popoverդասը:

կոչում լարային | ֆունկցիան ''

Վերնագրի կանխադրված արժեքը, եթե titleհատկանիշը չկա:

Եթե ​​տրված է ֆունկցիա, այն կկանչվի իր thisհղումներով այն տարրին, որին կցված է popover-ը:

ձգան լար 'սեղմել' Ինչպես է առաջանում popover-ը - սեղմեք | սավառնել | կենտրոնացում | ձեռնարկ. Դուք կարող եք անցնել մի քանի ձգան; առանձնացրեք դրանք բացատով: manualչի կարող համակցվել որևէ այլ ձգանի հետ:
տեսադաշտ լարային | օբյեկտ | ֆունկցիան {ընտրիչ՝ «մարմին», լիցք՝ 0 }

Պոպովերը պահում է այս տարրի սահմաններում: Օրինակ՝ viewport: '#viewport'կամ{ "selector": "#viewport", "padding": 0 }

Եթե ​​տրված է ֆունկցիա, այն կանչվում է՝ որպես միակ արգումենտ DOM հանգույցի գործարկման տարրը: Համատեքստը thisդրված է popover օրինակին:

Տվյալների ատրիբուտներ առանձին պոպովերի համար

Անհատական ​​պոպովերի տարբերակները կարող են այլընտրանքային կերպով սահմանվել տվյալների ատրիբուտների օգտագործման միջոցով, ինչպես բացատրվեց վերևում:

Մեթոդներ

$().popover(options)

Նախաձեռնում է popovers տարրերի հավաքածուի համար:

.popover('show')

Բացահայտում է տարրի պոպովեր: Վերադառնում է զանգահարողին նախքան փոփերի փաստացի ցուցադրումը (այսինքն՝ նախքան shown.bs.popoverիրադարձությունը տեղի ունենալը): Սա համարվում է պոպովերի «ձեռնարկ» հրահրում: Փոփերները, որոնց վերնագիրը և բովանդակությունը զրոյական երկարություն ունեն, երբեք չեն ցուցադրվում:

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

.popover('hide')

Թաքցնում է տարրի պոպովերը: Վերադառնում է զանգահարողին նախքան popover-ը իրականում թաքցվել է (այսինքն՝ նախքան hidden.bs.popoverիրադարձությունը տեղի ունենալը): Սա համարվում է պոպովերի «ձեռնարկ» հրահրում:

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

.popover('toggle')

Անջատում է տարրի popover-ը: Վերադառնում է զանգահարողին նախքան popover-ն իրականում ցուցադրվել կամ թաքցվել է (այսինքն՝ նախքան իրադարձությունը shown.bs.popoverկամ hidden.bs.popoverիրադարձությունը տեղի ունենալը): Սա համարվում է պոպովերի «ձեռնարկ» հրահրում:

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

.popover('destroy')

Թաքցնում և ոչնչացնում է տարրի պոպովերը: Պոպովերը, որոնք օգտագործում են պատվիրակում (որոնք ստեղծվում են selectorտարբերակի միջոցով ) չեն կարող անհատապես ոչնչացվել հետնորդ ձգան տարրերի վրա:

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

Իրադարձություններ

Միջոցառման տեսակը Նկարագրություն
show.bs.popover Այս իրադարձությունը գործարկվում է անմիջապես, երբ showկանչվում է օրինակի մեթոդը:
ցուցադրված.bs.popover Այս իրադարձությունը գործարկվում է, երբ popover-ը տեսանելի է դառնում օգտատիրոջը (կսպասի CSS անցումների ավարտին):
hide.bs.popover Այս իրադարձությունը գործարկվում է անմիջապես, երբ hideկանչվում է օրինակի մեթոդը:
թաքնված.bs.popover Այս իրադարձությունը գործարկվում է, երբ popover-ն ավարտում է օգտագործողից թաքցնելը (կսպասի CSS անցումների ավարտին):
տեղադրված.bs.popover Այս միջոցառումը գործարկվում է այն show.bs.popoverիրադարձությունից հետո, երբ popover ձևանմուշը ավելացվի DOM-ում:
$('#myPopover').on('hidden.bs.popover', function () {
  // do something…
})

Զգուշացման հաղորդագրություններ alert.js

Զգուշացումների օրինակներ

Այս փլագինով ավելացրեք անջատման գործառույթը բոլոր ահազանգերի հաղորդագրություններին:

Կոճակ օգտագործելիս .closeայն պետք է լինի առաջին զավակը .alert-dismissibleև նշագծման մեջ չպետք է լինի տեքստային բովանդակություն:

Օգտագործումը

Պարզապես ավելացրեք data-dismiss="alert"ձեր փակման կոճակին, որպեսզի ավտոմատ կերպով ազդանշան փակման գործառույթը տրամադրվի: Զգուշացումը փակելով այն կհեռացվի DOM-ից:

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

Որպեսզի ձեր ծանուցումները փակելիս օգտագործեն անիմացիա, համոզվեք, որ դրանք ունեն .fadeև.in դասերն արդեն կիրառված են դրանց համար:

Մեթոդներ

$().alert()

data-dismiss="alert"Կատարում է ազդանշան, որը լսում է ատրիբուտ ունեցող ժառանգական տարրերի վրա սեղմումների իրադարձությունները : (Պետք չէ data-api-ի ավտոմատ սկզբնավորումն օգտագործելիս):

$().alert('close')

Փակում է ահազանգը՝ հեռացնելով այն DOM-ից: Եթե .fade​​և .inդասերը առկա են տարրի վրա, նախքան այն հեռացնելը զգուշացումը կթուլանա:

Իրադարձություններ

Bootstrap-ի նախազգուշացման հավելվածը բացահայտում է մի քանի իրադարձություններ՝ ազդանշանային գործառույթին միանալու համար:

Միջոցառման տեսակը Նկարագրություն
փակել.բս.զգոն Այս իրադարձությունը գործարկվում է անմիջապես, երբ closeկանչվում է օրինակի մեթոդը:
փակված.բս.զգոն Այս իրադարձությունը գործարկվում է, երբ ահազանգը փակված է (կսպասի CSS-ի անցումների ավարտին):
$('#myAlert').on('closed.bs.alert', function () {
  // do something…
})

Կոճակներ button.js

Կատարեք ավելին կոճակներով: Կառավարեք կոճակի վիճակը կամ ստեղծեք կոճակների խմբեր ավելի շատ բաղադրիչների համար, ինչպիսիք են գործիքների տողերը:

Պետական

Ավելացնել data-loading-text="Loading..."կոճակի վրա բեռնման վիճակ օգտագործելու համար:

Այս հատկությունը հնացած է v3.3.5-ից և հեռացվել է v4-ում:

Օգտագործեք ցանկացած պետություն, որը ցանկանում եք:

Հանուն այս ցույցի, մենք օգտագործում ենք data-loading-textև $().button('loading'), բայց դա միակ վիճակը չէ, որ դուք կարող եք օգտագործել: Այս մասին ավելին տես ստորև $().button(string)փաստաթղթերում :

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

Մեկ անջատիչ

Ավելացրեք data-toggle="button"՝ մեկ կոճակի վրա փոխարկումն ակտիվացնելու համար:

Նախապես փոխարկված կոճակները պետք է .activeևaria-pressed="true"

Նախապես փոխարկված կոճակների համար դուք պետք է ինքներդ ավելացնեք .activeդասը և aria-pressed="true"հատկանիշը :button

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

Նշման տուփ / ռադիո

Ավելացրե՛ք data-toggle="buttons"պարունակող .btn-groupվանդակում կամ ռադիո մուտքագրումներ՝ դրանց համապատասխան ոճերի փոխարկումը հնարավոր դարձնելու համար:

Նախապես ընտրված տարբերակները պետք է.active

Նախապես ընտրված տարբերակների համար դուք պետք .activeէ ինքներդ ավելացնեք դասը մուտքագրման մեջ label:

Տեսողական ստուգված վիճակը թարմացվում է միայն սեղմելով

Եթե ​​վանդակի կոճակի ստուգված վիճակը թարմացվում է առանց կոճակի clickվրա իրադարձություն գործարկելու (օրինակ ՝ մուտքագրման հատկությունը <input type="reset">սահմանելու միջոցով կամ միջոցով checked), դուք պետք է ինքներդ փոխեք .activeդասը մուտքագրման վրա :label

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

Մեթոդներ

$().button('toggle')

Անջատում է մղման վիճակը: Կոճակին տալիս է այն տեսքը, որ այն ակտիվացված է:

$().button('reset')

Վերականգնում է կոճակի վիճակը - տեքստը փոխում է բնօրինակ տեքստի: Այս մեթոդը ասինխրոն է և վերադառնում է մինչև վերակայման փաստացի ավարտը:

$().button(string)

Փոխում է տեքստը ցանկացած տվյալների սահմանված տեքստային վիճակի:

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

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

Collapse collapse.js

Ճկուն փլագին, որն օգտագործում է մի քանի դասեր՝ հեշտ փոխակերպման վարքագծի համար:

Plugin-ի կախվածություն

Collapse-ը պահանջում է, որ transitions plugin- ը ներառվի Bootstrap-ի ձեր տարբերակում:

Օրինակ

Սեղմեք ստորև բերված կոճակները՝ դասի փոփոխությունների միջոցով մեկ այլ տարր ցուցադրելու և թաքցնելու համար.

  • .collapseթաքցնում է բովանդակությունը
  • .collapsingկիրառվում է անցումների ժամանակ
  • .collapse.inցույց է տալիս բովանդակությունը

Դուք կարող եք օգտագործել hrefատրիբուտով հղում կամ հատկանիշով կոճակ data-target: Երկու դեպքում data-toggle="collapse"էլ պահանջվում է.

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>

Ակորդեոնի օրինակ

Ընդլայնել լռելյայն փլուզման վարքագիծը՝ վահանակի բաղադրիչով ակորդեոն ստեղծելու համար:

Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson adsquid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Սննդի բեռնատար quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua վրան մի թռչուն դրեց կաղամար մեկ ծագման սուրճ nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Գովազդ բուսակերների բացառիկ մսագործի տեղակալ Լոմո. Սռնապաններ occaecat craft գարեջրի ֆերմա-սեղան, հում ջինսե էսթետիկ սինթեզ, դուք հավանաբար չեք լսել դրանց մասին accusamus labore կայուն VHS:
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson adsquid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Սննդի բեռնատար quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua վրան մի թռչուն դրեց կաղամար մեկ ծագման սուրճ nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Գովազդ բուսակերների բացառիկ մսագործի տեղակալ Լոմո. Սռնապաններ occaecat craft գարեջրի ֆերմա-սեղան, հում ջինսե էսթետիկ սինթեզ, դուք հավանաբար չեք լսել դրանց մասին accusamus labore կայուն VHS:
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson adsquid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Սննդի բեռնատար quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua վրան մի թռչուն դրեց կաղամար մեկ ծագման սուրճ nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Գովազդ բուսակերների բացառիկ մսագործի տեղակալ Լոմո. Սռնապաններ occaecat craft գարեջրի ֆերմա-սեղան, հում ջինսե էսթետիկ սինթեզ, դուք հավանաբար չեք լսել դրանց մասին accusamus labore կայուն 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>

Հնարավոր է նաև s-ը փոխանակել .panel-bodys-ի հետ .list-group:

  • Bootply
  • Մեկ itmus ac facilin
  • Երկրորդ էրոս

Մատչելի դարձրեք ընդարձակման/ծալման կառավարումները

Համոզվեք, որ ավելացրեք aria-expandedկառավարման տարրին: Այս հատկանիշը հստակորեն սահմանում է ծալվող տարրի ներկայիս վիճակը էկրանի ընթերցիչների և նմանատիպ օժանդակ տեխնոլոգիաների համար: Եթե ​​ծալվող տարրը լռելյայն փակ է, այն պետք է ունենա aria-expanded="false". Եթե ​​դուք կարգադրել եք, որ ծալվող տարրը բաց լինի լռելյայն՝ օգտագործելով inդասը, aria-expanded="true"փոխարենը դրեք կառավարում: Փլագինը ավտոմատ կերպով կփոխի այս հատկանիշը՝ հիմնվելով ծալվող տարրի բացման կամ փակման վրա, թե ոչ:

Բացի այդ, եթե ձեր կառավարման տարրը թիրախավորում է մեկ ծալվող տարր, այսինքն՝ data-targetհատկանիշը մատնացույց է անում idընտրիչին, դուք կարող եք լրացուցիչ aria-controlsհատկանիշ ավելացնել կառավարման տարրին, որը պարունակում idէ ծալվող տարրը: Էկրանի ժամանակակից ընթերցիչները և նմանատիպ օժանդակ տեխնոլոգիաները օգտագործում են այս հատկանիշը՝ օգտատերերին լրացուցիչ դյուրանցումներ տրամադրելու համար՝ անմիջապես դեպի ծալվող տարրը նավարկելու համար:

Օգտագործումը

Փլուզման պլագինը օգտագործում է մի քանի դասեր՝ ծանր բարձրացնելու համար.

  • .collapseթաքցնում է բովանդակությունը
  • .collapse.inցույց է տալիս բովանդակությունը
  • .collapsingավելացվում է, երբ անցումը սկսվում է, և հեռացվում է, երբ այն ավարտվում է

Այս դասերը կարելի է գտնել component-animations.less.

Տվյալների ատրիբուտների միջոցով

Պարզապես ավելացրեք data-toggle="collapse"և a data-targetտարրին, որպեսզի ինքնաբերաբար նշանակվի ծալվող տարրի կառավարումը: Հատկանիշն data-targetընդունում է CSS ընտրիչ՝ կիրառման համար փլուզումը: Համոզվեք, որ դասը ավելացրե՛ք collapseծալվող տարրին: Եթե ​​ցանկանում եք, որ այն լռելյայն բացվի, ավելացրեք լրացուցիչ դասը in:

Ակորդեոնի նման խմբի կառավարում ավելացնելու համար ծալվող կառավարում ավելացրեք տվյալների հատկանիշը data-parent="#selector": Տեսեք ցուցադրությունը՝ սա գործողության մեջ տեսնելու համար:

JavaScript-ի միջոցով

Ձեռքով միացնել՝

$('.collapse').collapse()

Ընտրանքներ

Ընտրանքները կարող են փոխանցվել տվյալների ատրիբուտների կամ JavaScript-ի միջոցով: Տվյալների ատրիբուտների համար ավելացրեք տարբերակի անունը data-, ինչպես data-parent="".

Անուն տիպ լռելյայն նկարագրությունը
ծնող ընտրիչ կեղծ Եթե ​​ապահովված է ընտրիչ, ապա նշված ծնողի տակ գտնվող բոլոր ծալվող տարրերը կփակվեն, երբ ցուցադրվի այս ծալվող տարրը: (նման է ավանդական ակորդեոնի վարքագծին. սա կախված է panelդասից)
փոխարկել բուլյան ճիշտ Անջատում է ծալվող տարրը կանչի ժամանակ

Մեթոդներ

.collapse(options)

Ակտիվացնում է ձեր բովանդակությունը որպես ծալովի տարր: Ընդունում է ընտրովի տարբերակներ object:

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

.collapse('toggle')

Անջատում է ծալվող տարրը ցուցադրված կամ թաքցվածի: Վերադառնում է զանգահարողին մինչև ծալվող տարրը իրականում ցուցադրվել կամ թաքցվել է (այսինքն՝ նախքան իրադարձությունը shown.bs.collapseկամ hidden.bs.collapseիրադարձությունը տեղի ունենալը):

.collapse('show')

Ցույց է տալիս ծալվող տարր: Վերադառնում է զանգահարողին նախքան ծալվող տարրը փաստացի ցուցադրվելը (այսինքն՝ նախքան shown.bs.collapseիրադարձությունը տեղի ունենալը):

.collapse('hide')

Թաքցնում է ծալվող տարրը: Վերադառնում է զանգահարողին նախքան ծալվող տարրը իրականում թաքցվել է (այսինքն՝ նախքան hidden.bs.collapseիրադարձությունը տեղի ունենալը):

Իրադարձություններ

Bootstrap-ի փլուզման դասը բացահայտում է մի քանի իրադարձություններ՝ փլուզման գործառույթին միանալու համար:

Միջոցառման տեսակը Նկարագրություն
show.bs.collapse Այս իրադարձությունը գործարկվում է անմիջապես, երբ showկանչվում է օրինակի մեթոդը:
ցուցադրված.bs.collapse Այս իրադարձությունը գործարկվում է, երբ ծալման տարրը տեսանելի է դառնում օգտատիրոջը (կսպասի CSS անցումների ավարտին):
hide.bs.collapse Այս իրադարձությունը գործարկվում է անմիջապես, երբ hideմեթոդը կանչվում է:
hidden.bs.collapse Այս միջոցառումը գործարկվում է, երբ օգտատերից թաքցված է կոծկման տարրը (կսպասի CSS անցումների ավարտին):
$('#myCollapsible').on('hidden.bs.collapse', function () {
  // do something…
})

Կարուսել կարուսել .js

Սլայդերի ցուցադրման բաղադրիչ տարրերի միջով հեծանվով անցնելու համար, ինչպես կարուսելը: Ներդրված կարուսելները չեն աջակցվում:

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

Ընտրովի ենթագրեր

Հեշտությամբ ավելացրեք ենթագրեր ձեր սլայդներին՝ օգտագործելով .carousel-captionորևէ տարր .item: Տեղադրեք գրեթե ցանկացած ընտրովի HTML այնտեղ, և այն ավտոմատ կերպով կհավասարեցվի և ձևաչափվի:

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

Բազմաթիվ կարուսելներ

Կարուսելների համար անհրաժեշտ է օգտագործել idամենաարտաքին կոնտեյների վրա (the .carousel), որպեսզի կարուսելի հսկիչները ճիշտ աշխատեն: Բազմաթիվ կարուսելներ ավելացնելիս կամ կարուսելները փոխելիս idհամոզվեք, որ թարմացնեք համապատասխան հսկիչները:

Տվյալների ատրիբուտների միջոցով

Օգտագործեք տվյալների ատրիբուտներ՝ կարուսելի դիրքը հեշտությամբ կառավարելու համար: data-slideընդունում է հիմնաբառերը prevկամ next, որը փոխում է սլայդի դիրքը ներկայիս դիրքի համեմատ: Որպես այլընտրանք, օգտագործեք data-slide-to՝ չմշակված սլայդի ինդեքսը կարուսելին փոխանցելու համար data-slide-to="2", որը սլայդի դիրքը տեղափոխում է որոշակի ինդեքսի՝ սկսած 0.

Հատկանիշն data-ride="carousel"օգտագործվում է կարուսելը որպես աշխույժ նշելու համար՝ սկսած էջի բեռնումից: Այն չի կարող օգտագործվել նույն կարուսելի (ավելորդ և անհարկի) բացահայտ JavaScript սկզբնավորման հետ համատեղ:

JavaScript-ի միջոցով

Ձեռքով զանգահարեք կարուսել՝

$('.carousel').carousel()

Ընտրանքները կարող են փոխանցվել տվյալների ատրիբուտների կամ JavaScript-ի միջոցով: Տվյալների ատրիբուտների համար ավելացրեք տարբերակի անունը data-, ինչպես data-interval="".

Անուն տիպ լռելյայն նկարագրությունը
ընդմիջում թիվ 5000 Ժամանակի չափը, որը հետաձգվում է ապրանքի ինքնաբերաբար հեծանիվ վարելու միջև: Եթե ​​կեղծ է, կարուսելը ինքնաբերաբար չի շրջվի:
դադար լարային | դատարկ "սավառնել" Եթե ​​դրված է "hover", ապա դադարեցնում է կարուսելի հեծանիվը միացված mouseenterև վերսկսում է կարուսելի հեծանիվը միացված mouseleave: Եթե ​​դրված է null, ապա սավառնելով կարուսելի վրա այն չի դադարեցնի:
պատել բուլյան ճիշտ Արդյոք կարուսելը պետք է անընդհատ պտտվի, թե կոշտ կանգառներ ունենա:
ստեղնաշար բուլյան ճիշտ Արդյոք կարուսելը պետք է արձագանքի ստեղնաշարի իրադարձություններին:

Նախաձեռնում է կարուսելը կամընտիր ընտրանքներով objectև սկսում հեծանվով անցնել իրերի միջով:

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

Շրջում է կարուսելի տարրերի միջով ձախից աջ:

Դադարեցնում է կարուսելը իրերի միջով հեծանիվ անցնելուց:

Կարուսելը տեղափոխում է որոշակի շրջանակ (0-ի վրա հիմնված, զանգվածի նման):

Ցիկլեր դեպի նախորդ կետը:

Շրջագայություններ դեպի հաջորդ կետ:

Bootstrap-ի կարուսելի դասը բացահայտում է երկու իրադարձություն՝ կարուսելի ֆունկցիոնալությանը միանալու համար:

Երկու իրադարձություններն ունեն հետևյալ լրացուցիչ հատկությունները.

  • directionՈւղղությունը, որով սահում է կարուսելը (կամ "left"կամ "right"):
  • relatedTargetDOM տարրը, որը սահում է իր տեղը որպես ակտիվ տարր:

Կարուսելի բոլոր իրադարձությունները կրակում են հենց կարուսելի վրա (այսինքն՝ <div class="carousel">):

Միջոցառման տեսակը Նկարագրություն
slide.bs.կարուսել Այս իրադարձությունն անմիջապես գործարկվում է, երբ գործարկվում է slideօրինակի մեթոդը:
slid.bs.կարուսել Այս միջոցառումը գործարկվում է, երբ կարուսելը ավարտում է իր սլայդային անցումը:
$('#myCarousel').on('slide.bs.carousel', function () {
  // do something…
})

Կցեք affix.js

Օրինակ

Affix plugin- position: fixed;ը միանում և անջատվում է՝ ընդօրինակելով հայտնաբերված էֆեկտը position: sticky;: Աջ կողմում գտնվող ենթանավիգացիան affix plugin-ի կենդանի ցուցադրությունն է:


Օգտագործումը

Օգտագործեք հավելվածի հավելվածը տվյալների ատրիբուտների միջոցով կամ ձեռքով ձեր սեփական JavaScript-ով: Երկու իրավիճակներում էլ դուք պետք է տրամադրեք CSS ձեր ամրացված բովանդակության դիրքավորման և լայնության համար:

Նշում․ մի օգտագործեք կցման պլագինը համեմատաբար տեղակայված տարրում պարունակվող տարրի վրա, օրինակ՝ ձգված կամ հրված սյունակում, Safari-ի մատուցման սխալի պատճառով :

Դիրքորոշում CSS-ի միջոցով

Affix plugin-ը փոխվում է երեք դասերի միջև, որոնցից յուրաքանչյուրը ներկայացնում է որոշակի վիճակ .affix՝ .affix-top, և .affix-bottom: Դուք պետք է տրամադրեք ոճերը, բացառությամբ position: fixed;on-ի .affix, այս դասերի համար (անկախ այս հավելվածից)՝ իրական դիրքերը կարգավորելու համար:

Ահա թե ինչպես է աշխատում աֆիքս հավելվածը.

  1. Սկսելու համար հավելվածն ավելացնում .affix-topէ՝ ցույց տալու համար, որ տարրը գտնվում է ամենաբարձր դիրքում: Այս պահին ոչ մի CSS դիրքավորում չի պահանջվում:
  2. Ոլորելով այն տարրի կողքով, որը ցանկանում եք ամրացնել, պետք է գործարկի իրական ամրացումը: Այստեղ .affixփոխարինվում .affix-topև position: fixed;տեղադրվում է (տրամադրվում է Bootstrap-ի CSS-ի կողմից):
  3. .affixԵթե ​​ներքևի շեղումը սահմանված է, ոլորելով դրա կողքով պետք է փոխարինվի .affix-bottom. Քանի որ օֆսեթները կամընտիր են, մեկի կարգավորումը պահանջում է, որ դուք սահմանեք համապատասխան CSS: Այս դեպքում position: absolute;անհրաժեշտության դեպքում ավելացրեք: Փլագինը օգտագործում է տվյալների հատկանիշը կամ JavaScript տարբերակը՝ որոշելու, թե որտեղից պետք է տեղավորել տարրը:

Հետևեք վերը նշված քայլերին՝ ձեր CSS-ը ստորև նշված օգտագործման տարբերակներից որևէ մեկի համար սահմանելու համար:

Տվյալների ատրիբուտների միջոցով

Ցանկացած տարրի վրա կցելու վարքագիծը հեշտությամբ ավելացնելու համար պարզապես ավելացրեք data-spy="affix"այն տարրին, որը ցանկանում եք լրտեսել: Օգտագործեք շեղումներ՝ որոշելու համար, թե երբ պետք է միացնել տարրի ամրացումը:

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

JavaScript-ի միջոցով

Զանգահարեք հավելվածի հավելվածը JavaScript-ի միջոցով.

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

Ընտրանքներ

Ընտրանքները կարող են փոխանցվել տվյալների ատրիբուտների կամ JavaScript-ի միջոցով: Տվյալների ատրիբուտների համար ավելացրեք տարբերակի անունը data-, ինչպես data-offset-top="200".

Անուն տիպ լռելյայն նկարագրությունը
օֆսեթ համարը | ֆունկցիա | օբյեկտ 10 Փիքսելներ, որոնք պետք է շրջվեն էկրանից ոլորման դիրքը հաշվարկելիս: Եթե ​​տրամադրվում է մեկ համար, ապա շեղումը կկիրառվի ինչպես վերևի, այնպես էլ ներքևի ուղղություններով: Եզակի, ներքևի և վերին օֆսեթ ապահովելու համար պարզապես տրամադրեք օբյեկտ offset: { top: 10 }կամ offset: { top: 10, bottom: 5 }. Օգտագործեք ֆունկցիա, երբ անհրաժեշտ է դինամիկ կերպով հաշվարկել օֆսեթը:
թիրախ ընտրիչ | հանգույց | jQuery տարր windowօբյեկտը _ Նշում է աֆիքսի թիրախային տարրը:

Մեթոդներ

.affix(options)

Ակտիվացնում է ձեր բովանդակությունը որպես ամրացված բովանդակություն: Ընդունում է ընտրովի տարբերակներ object:

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

.affix('checkPosition')

Վերահաշվում է կցորդի վիճակը՝ հիմնվելով համապատասխան տարրերի չափերի, դիրքի և ոլորման դիրքի վրա: Այն.affix , .affix-topև .affix-bottomդասերը ավելացվում են կամ հեռացվում կցված բովանդակությունից՝ համաձայն նոր վիճակի: Այս մեթոդը պետք է կանչվի ամեն անգամ, երբ կցված բովանդակության կամ թիրախային տարրի չափերը փոխվում են՝ ամրացված բովանդակության ճիշտ դիրքավորումն ապահովելու համար:

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

Իրադարձություններ

Bootstrap-ի affix plugin-ը բացահայտում է մի քանի իրադարձություններ՝ կցելու գործառույթին միանալու համար:

Միջոցառման տեսակը Նկարագրություն
affix.bs.affix Այս իրադարձությունը գործարկվում է տարրը կցվելուց անմիջապես առաջ:
affixed.bs.affix Այս միջոցառումը գործարկվում է տարրը ամրացնելուց հետո:
affix-top.bs.affix Այս իրադարձությունը գործարկվում է անմիջապես տարրը վերևում ամրացնելուց առաջ:
affixed-top.bs.affix Այս միջոցառումը գործարկվում է այն բանից հետո, երբ տարրը կցվում է վերևում:
affix-bottom.bs.affix Այս իրադարձությունը գործարկվում է անմիջապես նախքան տարրը կցվել է ներքևում:
affixed-bottom.bs.affix Այս միջոցառումը գործարկվում է այն բանից հետո, երբ տարրը կցվել է ներքևում: