JavaScript
Dați viață componentelor Bootstrap cu peste o duzină de pluginuri jQuery personalizate. Includeți-le cu ușurință pe toate sau unul câte unul.
Dați viață componentelor Bootstrap cu peste o duzină de pluginuri jQuery personalizate. Includeți-le cu ușurință pe toate sau unul câte unul.
Pluginurile pot fi incluse individual (folosind *.js
fișierele individuale ale Bootstrap) sau toate odată (folosind bootstrap.js
sau miniat bootstrap.min.js
).
Ambele bootstrap.js
și bootstrap.min.js
conțin toate pluginurile într-un singur fișier. Includeți doar unul.
Unele plugin-uri și componente CSS depind de alte plugin-uri. Dacă includeți pluginuri individual, asigurați-vă că verificați aceste dependențe în documente. De asemenea, rețineți că toate pluginurile depind de jQuery (aceasta înseamnă că jQuery trebuie inclus înainte de fișierele plugin). Consultați-nebower.json
pentru a vedea ce versiuni de jQuery sunt acceptate.
Puteți utiliza toate pluginurile Bootstrap doar prin intermediul API-ului de marcare, fără a scrie o singură linie de JavaScript. Acesta este API-ul de primă clasă al lui Bootstrap și ar trebui să fie prima dvs. considerație atunci când utilizați un plugin.
Acestea fiind spuse, în unele situații poate fi de dorit să dezactivați această funcționalitate. Prin urmare, oferim, de asemenea, posibilitatea de a dezactiva API-ul atributului de date prin dezlegarea tuturor evenimentelor din documentul spațial de nume cu data-api
. Acesta arată astfel:
Alternativ, pentru a viza un anumit plugin, includeți doar numele pluginului ca spațiu de nume împreună cu spațiul de nume data-api, astfel:
Nu utilizați atribute de date de la mai multe plugin-uri pe același element. De exemplu, un buton nu poate avea atât un balon explicativ, cât și un modal. Pentru a realiza acest lucru, utilizați un element de înfășurare.
De asemenea, credem că ar trebui să puteți utiliza toate pluginurile Bootstrap doar prin API-ul JavaScript. Toate API-urile publice sunt metode unice, care pot fi înlănțuite și returnează colecția asupra căreia se acționează.
Toate metodele ar trebui să accepte un obiect opțional opțional, un șir care vizează o anumită metodă sau nimic (care inițiază un plugin cu comportament implicit):
Fiecare plugin își expune, de asemenea, constructorul brut pe o Constructor
proprietate: $.fn.popover.Constructor
. Dacă doriți să obțineți o anumită instanță de plugin, preluați-o direct dintr-un element: $('[rel="popover"]').data('popover')
.
Puteți modifica setările implicite pentru un plugin modificând obiectul pluginului Constructor.DEFAULTS
:
Uneori este necesar să utilizați pluginuri Bootstrap cu alte cadre UI. În aceste circumstanțe, pot apărea ocazional coliziuni ale spațiului de nume. Dacă se întâmplă acest lucru, puteți apela .noConflict
la pluginul căruia doriți să reveniți la valoarea.
Bootstrap oferă evenimente personalizate pentru acțiunile unice ale majorității pluginurilor. În general, acestea vin într-o formă de infinitiv și participiu trecut - unde infinitivul (ex. show
) este declanșat la începutul unui eveniment, iar forma sa de participiu trecut (ex. shown
) este declanșat la finalizarea unei acțiuni.
Începând cu 3.0.0, toate evenimentele Bootstrap sunt spațiate de nume.
Toate evenimentele infinitive oferă preventDefault
funcționalitate. Aceasta oferă posibilitatea de a opri execuția unei acțiuni înainte de a începe.
Sfaturile cu instrumente și popoverele folosesc dezinfectantul nostru încorporat pentru a dezinfecta opțiunile care acceptă HTML.
Valoarea implicită whiteList
este următoarea:
Dacă doriți să adăugați noi valori la această valoare implicită whiteList
, puteți face următoarele:
Dacă doriți să ocoliți dezinfectantul nostru deoarece preferați să utilizați o bibliotecă dedicată, de exemplu DOMPurify , ar trebui să faceți următoarele:
document.implementation.createHTMLDocument
În cazul browserelor care nu acceptă document.implementation.createHTMLDocument
, cum ar fi Internet Explorer 8, funcția de dezinfectare încorporată returnează codul HTML așa cum este.
Dacă doriți să efectuați igienizarea în acest caz, vă rugăm să specificați sanitizeFn
și să utilizați o bibliotecă externă precum DOMPurify .
Versiunea fiecărui plugin jQuery de la Bootstrap poate fi accesată prin VERSION
proprietatea constructorului pluginului. De exemplu, pentru pluginul tooltip:
Pluginurile Bootstrap nu revin în mod deosebit de grațios atunci când JavaScript este dezactivat. Dacă vă pasă de experiența utilizatorului în acest caz, folosiți <noscript>
pentru a explica situația (și cum să reactivați JavaScript) utilizatorilor dvs. și/sau adăugați propriile alternative personalizate.
Bootstrap nu acceptă oficial biblioteci JavaScript terță parte, cum ar fi Prototype sau jQuery UI. În ciuda .noConflict
evenimentelor cu spații de nume, pot exista probleme de compatibilitate pe care trebuie să le rezolvați singur.
Pentru efecte de tranziție simple, includeți transition.js
o dată alături de celelalte fișiere JS. Dacă utilizați fișierul compilat (sau minimizat) bootstrap.js
, nu este nevoie să îl includeți - este deja acolo.
Transition.js este un ajutor de bază pentru transitionEnd
evenimente, precum și un emulator de tranziție CSS. Este folosit de celelalte plugin-uri pentru a verifica suportul pentru tranziția CSS și pentru a prinde tranzițiile suspendate.
Tranzițiile pot fi dezactivate la nivel global utilizând următorul fragment JavaScript, care trebuie să vină după ce transition.js
(sau bootstrap.js
sau bootstrap.min.js
, după caz), s-a încărcat:
Modalurile sunt raționalizate, dar flexibile, solicitări de dialog cu funcționalitatea minimă necesară și valori implicite inteligente.
Asigurați-vă că nu deschideți un modal în timp ce altul este încă vizibil. Afișarea mai multor modal la un moment dat necesită cod personalizat.
Încercați întotdeauna să plasați codul HTML al unui modal într-o poziție de nivel superior în documentul dvs. pentru a evita ca alte componente să afecteze aspectul și/sau funcționalitatea modalului.
Există câteva avertismente cu privire la utilizarea modalelor pe dispozitivele mobile. Consultați documentele noastre de asistență pentru browser pentru detalii.
Datorită modului în care HTML5 își definește semantica, autofocus
atributul HTML nu are niciun efect în modalele Bootstrap. Pentru a obține același efect, utilizați JavaScript personalizat:
Un modal redat cu antet, corp și un set de acțiuni în subsol.
Comutați un modal prin JavaScript făcând clic pe butonul de mai jos. Acesta va aluneca în jos și va dispărea din partea de sus a paginii.
Asigurați-vă că adăugați role="dialog"
și aria-labelledby="..."
, făcând referire la titlul modal, la .modal
, și role="document"
la .modal-dialog
însuși.
În plus, puteți oferi o descriere a dialogului dvs. modal cu aria-describedby
on .modal
.
Încorporarea videoclipurilor YouTube în modal necesită JavaScript suplimentar care nu este în Bootstrap pentru a opri automat redarea și multe altele. Consultați această postare utilă Stack Overflow pentru mai multe informații.
Modalurile au două dimensiuni opționale, disponibile prin clase de modificatori pentru a fi plasate pe un .modal-dialog
.
Pentru modalele care apar pur și simplu în loc să se estompeze pentru a le vizualiza, eliminați .fade
clasa din marcajul modal.
Pentru a profita de sistemul de grilă Bootstrap într-un modal, pur și simplu imbricați .row
s în cadrul .modal-body
și apoi utilizați clasele normale ale sistemului de grilă.
Aveți o grămadă de butoane care declanșează același mod, doar cu conținut ușor diferit? Utilizați event.relatedTarget
și atributele HTMLdata-*
(eventual prin jQuery ) pentru a varia conținutul modalului în funcție de ce buton a fost făcut clic. Consultați documentele despre evenimente modale pentru detalii despre relatedTarget
,
Pluginul modal schimbă conținutul ascuns la cerere, prin atribute de date sau JavaScript. De asemenea, se adaugă .modal-open
la <body>
comportamentul de defilare implicit pentru a suprascrie și generează o .modal-backdrop
zonă pentru a oferi o zonă de clic pentru respingerea modalelor afișate atunci când faceți clic în afara modului.
Activați un mod fără a scrie JavaScript. Setați data-toggle="modal"
pe un element de controler, cum ar fi un buton, împreună cu data-target="#foo"
sau href="#foo"
pentru a viza un anumit mod de comutare.
Apelați un modal cu id myModal
cu o singură linie de JavaScript:
Opțiunile pot fi transmise prin atribute de date sau JavaScript. Pentru atributele datelor, adăugați numele opțiunii la data-
, ca în data-backdrop=""
.
Nume | tip | Mod implicit | Descriere |
---|---|---|---|
fundal | boolean sau șirul'static' |
Adevărat | Include un element modal de fundal. Alternativ, specificați static pentru un fundal care nu închide modal la clic. |
tastatură | boolean | Adevărat | Închide modulul când este apăsată tasta Escape |
spectacol | boolean | Adevărat | Afișează modal atunci când este inițializat. |
la distanta | cale | fals | Această opțiune este depreciată de la v3.3.0 și a fost eliminată în v4. Vă recomandăm, în schimb, să utilizați un șablon la nivel de client sau un cadru de legare a datelor sau să apelați singur jQuery.load . Dacă este furnizată o adresă URL la distanță, conținutul va fi încărcat o singură dată prin metoda jQuery |
.modal(options)
Activează conținutul dvs. ca modal. Acceptă opțiuni opționale object
.
.modal('toggle')
Comută manual un modal. Se întoarce la apelant înainte ca modalul să fie afișat sau ascuns (adică înainte ca evenimentul shown.bs.modal
sau să hidden.bs.modal
apară).
.modal('show')
Deschide manual un modal. Se întoarce la apelant înainte ca modalul să fie afișat efectiv (adică înainte de apariția shown.bs.modal
evenimentului).
.modal('hide')
Ascunde manual un modal. Se întoarce la apelant înainte ca modalul să fi fost efectiv ascuns (adică înainte de apariția hidden.bs.modal
evenimentului).
.modal('handleUpdate')
Reajustează poziționarea modalului pentru a contracara o bară de defilare în cazul în care ar trebui să apară una, ceea ce ar face modalul să sară la stânga.
Este necesar doar atunci când înălțimea modalului se modifică în timp ce este deschis.
Clasa modală a Bootstrap expune câteva evenimente pentru conectarea la funcționalitatea modală.
Toate evenimentele modale sunt declanșate la modal în sine (adică la <div class="modal">
).
Tip de eveniment | Descriere |
---|---|
show.bs.modal | Acest eveniment se declanșează imediat când show este apelată metoda instanței. Dacă este cauzat de un clic, elementul pe care s-a făcut clic este disponibil ca relatedTarget proprietate a evenimentului. |
arătat.bs.modal | Acest eveniment este declanșat atunci când modalul a fost făcut vizibil pentru utilizator (va aștepta finalizarea tranzițiilor CSS). Dacă este cauzat de un clic, elementul pe care s-a făcut clic este disponibil ca relatedTarget proprietate a evenimentului. |
ascunde.bs.modal | Acest eveniment este declanșat imediat când hide metoda instanței a fost apelată. |
ascuns.bs.modal | Acest eveniment este declanșat când modalul a terminat de ascuns utilizatorului (va aștepta finalizarea tranzițiilor CSS). |
încărcat.bs.modal | Acest eveniment este declan��at atunci când modalul a încărcat conținut folosind remote opțiunea. |
Adăugați meniuri drop-down la aproape orice cu acest plugin simplu, inclusiv bara de navigare, file și pastile.
Prin atribute de date sau JavaScript, pluginul drop-down comută conținut ascuns (meniuri drop-down) prin comutarea .open
clasei pe elementul din lista părinte.
Pe dispozitivele mobile, deschiderea unui meniu derulant adaugă o .dropdown-backdrop
zonă de atingere pentru închiderea meniurilor derulante atunci când atingeți în afara meniului, o cerință pentru suport adecvat iOS. Aceasta înseamnă că trecerea de la un meniu derulant deschis la un meniu derulant diferit necesită o atingere suplimentară pe mobil.
Notă: data-toggle="dropdown"
se bazează pe atributul pentru închiderea meniurilor drop-down la nivel de aplicație, așa că este o idee bună să-l folosiți întotdeauna.
Adăugați data-toggle="dropdown"
la un link sau la un buton pentru a comuta un meniu drop-down.
Pentru a păstra adresele URL intacte cu butoanele de link, utilizați data-target
atributul în loc de href="#"
.
Apelați meniurile derulante prin JavaScript:
data-toggle="dropdown"
încă necesarIndiferent dacă apelați meniul drop-down prin JavaScript sau utilizați în schimb data-api, data-toggle="dropdown"
este întotdeauna necesar să fie prezent pe elementul de declanșare al meniului drop-down.
Nici unul
$().dropdown('toggle')
Comută meniul derulant al unei anumite bare de navigare sau al navigării cu file.
Toate evenimentele drop-down sunt declanșate la .dropdown-menu
elementul părinte al lui.
Toate evenimentele dropdown au o relatedTarget
proprietate, a cărei valoare este elementul de ancorare de comutare.
Tip de eveniment | Descriere |
---|---|
show.bs.menu derulant | Acest eveniment se declanșează imediat când este apelată metoda show instance. |
afișat.bs.menu derulant | Acest eveniment este declanșat atunci când meniul derulant a fost făcut vizibil pentru utilizator (va aștepta finalizarea tranzițiilor CSS). |
ascunde.bs.dropdown | Acest eveniment este declanșat imediat când a fost apelată metoda de ascundere a instanței. |
hidden.bs.dropdown | Acest eveniment este declanșat când meniul derulant s-a terminat de ascuns utilizatorului (va aștepta finalizarea tranzițiilor CSS). |
Pluginul ScrollSpy este pentru actualizarea automată a țintelor de navigare pe baza poziției derulării. Derulați zona de sub bara de navigare și urmăriți schimbarea clasei active. Subelementele derulante vor fi de asemenea evidențiate.
Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi înainte de a se epuiza. Tumblr, de la fermă la masă, drepturi la bicicletă. Anim keffiyeh carles cardigan. cabina foto Velit seitan mcsweeney 3 lupul luna irure. Cosby pulover lomo jean pantaloni scurți, hanoracul williamsburg minim qui probabil nu ai auzit de ele et cardigan trust fund culpa biodiesel wes anderson estetica. Nihil tatuat accusamus, cred ironia biodiesel keffiyeh artizan ullamco consequat.
Veniam marfa mustache skateboard, adipisicing fugiat velit pitchfork beard. Freegan beard aliqua cupidatat mcsweeney's vero. Cupidatat four loko nisi, ea helvetica nulla carles. Camion de mâncare cu pulover cosby tatuat, mcsweeney's quis non freegan vinyl. Lo-fi wes anderson +1 sartorial. Carles non exercițiu estetic quis gentrify. Brooklyn adipisicing bere artizanală vice keytar deserunt.
Occaecat commodo aliqua delectus. Fap craft bere 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 este adipisicing. Consectetur nisi DIY minim messenger bag. Cred ex in, sustainable delectus consectetur fanny pack 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.
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 orice delectus food truck. Sapiente synth id assumenda. Locavore sed helvetica clișeu ironie, thundercats probabil nu ați auzit de ele consequat hanorac fără gluten lo-fi fap aliquip. Labore elit placeat before they sold out, terry richardson proident brunch nesciunt cares cosby sweater pariatur keffiyeh ut helvetica artisan. Cardigan bere craft seitan readymade velit. VHS chambray laboris tempor veniam. Anim mollit minim commodo ullamco thundercats.
Legăturile din bara de navigare trebuie să aibă ținte de ID rezolvabile. De exemplu, un <a href="#home">home</a>
must corespunde cu ceva din DOM precum <div id="home"></div>
.
:visible
-țintă ignorateElementele țintă care nu sunt :visible
conform jQuery vor fi ignorate și elementele lor de navigare corespunzătoare nu vor fi niciodată evidențiate.
Indiferent de metoda de implementare, scrollspy necesită utilizarea position: relative;
elementului pe care îl spionați. În cele mai multe cazuri, acesta este <body>
. Când scrollspying pe alte elemente decât <body>
, asigurați-vă că aveți un height
set și overflow-y: scroll;
aplicat.
Pentru a adăuga cu ușurință comportamentul scrollspy la navigarea din bara de sus, adăugați data-spy="scroll"
la elementul pe care doriți să îl spionați (de obicei, acesta ar fi <body>
). Apoi adăugați data-target
atributul cu ID-ul sau clasa elementului părinte al oricărei .nav
componente Bootstrap.
După ce ați adăugat position: relative;
CSS, apelați scrollspy prin JavaScript:
.scrollspy('refresh')
Când utilizați scrollspy împreună cu adăugarea sau eliminarea elementelor din DOM, va trebui să apelați metoda de reîmprospătare astfel:
Opțiunile pot fi transmise prin atribute de date sau JavaScript. Pentru atributele datelor, adăugați numele opțiunii la data-
, ca în data-offset=""
.
Nume | tip | Mod implicit | Descriere |
---|---|---|---|
decalaj | număr | 10 | Pixeli de decalat de sus atunci când se calculează poziția derulării. |
Tip de eveniment | Descriere |
---|---|
activare.bs.scrollspy | Acest eveniment se declanșează ori de câte ori un element nou este activat de scrollspy. |
Adăugați o funcție rapidă și dinamică a filei pentru a trece prin panourile de conținut local, chiar și prin meniurile drop-down. Filele imbricate nu sunt acceptate.
Denim brut probabil că nu ați auzit de ei pantaloni scurți de blugi Austin. Nesciunt tofu stumptown aliqua, retro synth master cleanse. Mustache cliche tempor, williamsburg carles vegan helvetica. Reprehenderit butcher retro keffiyeh dreamcatcher synth. Pulover Cosby eu banh mi, qui irure terry richardson ex squid. 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.
Etsy mixtape wayfarers, ethical wes anderson tofu before they sold out mcsweeney's organic lomo retro fanny pack lo-fi farm-to-table readymade. Messenger bag gentrify pitchfork tattooed craft beer, iphone skateboard locavore carles etsy salvia banksy hoodie helvetica. DIY synth PBR banksy irony. Leggings gentrify squid 8-bit cred pitchfork. Williamsburg banh mi whatever gluten-free, carles pitchfork biodiesel fixie etsy retro mlkshk vice blog. Scenester cred you probably haven't heard of them, vinyl craft beer blog stumptown. Pitchfork sustainable tofu synth chambray yr.
Trust fund seitan letterpress, keytar raw denim keffiyeh etsy art party before they sold out master cleanse gluten-free squid scenester freegan cosby sweater. Fanny pack portland seitan DIY, art party locavore wolf cliche high life echo park Austin. Cred vinyl keffiyeh DIY salvia PBR, banh mi before they sold out farm-to-table VHS viral locavore cosby sweater. Lomo wolf viral, mustache readymade thundercats keffiyeh craft beer marfa ethical. Wolf salvia freegan, sartorial keffiyeh echo park vegan.
Acest plugin extinde componenta de navigare cu file pentru a adăuga zone cu file.
Activați filele tabulabile prin JavaScript (fiecare filă trebuie activată individual):
Puteți activa file individuale în mai multe moduri:
Puteți activa o filă sau o navigare prin pilule fără a scrie JavaScript, prin simpla specificare data-toggle="tab"
sau data-toggle="pill"
pe un element. Adăugarea claselor nav
și la filă va aplica stilul filei Bootstrap , în timp ce adăugarea claselor și va aplica stilul pilulelor .nav-tabs
ul
nav
nav-pills
Pentru ca filele să dispară, adăugați .fade
la fiecare .tab-pane
. De asemenea, primul panou de file trebuie .in
să facă vizibil conținutul inițial.
$().tab
Activează un element de filă și un container de conținut. Tab ar trebui să aibă fie un, fie un data-target
nod href
de container în DOM. În exemplele de mai sus, filele sunt <a>
s-urile cu data-toggle="tab"
atribute.
.tab('show')
Selectează fila dată și afișează conținutul asociat. Orice altă filă care a fost selectată anterior devine neselectată și conținutul asociat este ascuns. Revine la apelant înainte ca panoul de file să fie afișat efectiv (adică înainte de apariția shown.bs.tab
evenimentului).
Când se afișează o filă nouă, evenimentele se declanșează în următoarea ordine:
hide.bs.tab
(în fila activă curentă)show.bs.tab
(în fila de afișat)hidden.bs.tab
(pe fila activă anterioară, aceeași ca pentru hide.bs.tab
eveniment)shown.bs.tab
(în fila nou-activă tocmai afișată, aceeași ca și pentru show.bs.tab
eveniment)Dacă nicio filă nu era deja activă, atunci evenimentele hide.bs.tab
și hidden.bs.tab
nu vor fi declanșate.
Tip de eveniment | Descriere |
---|---|
arată.bs.tab | Acest eveniment se declanșează în afișarea filelor, dar înainte ca noua filă să fie afișată. Utilizați event.target și event.relatedTarget pentru a viza fila activă și, respectiv, fila activă anterioară (dacă este disponibilă). |
afișat.bs.tab | Acest eveniment se declanșează în afișarea filelor după ce a fost afișată o filă. Utilizați event.target și event.relatedTarget pentru a viza fila activă și, respectiv, fila activă anterioară (dacă este disponibilă). |
ascunde.bs.tab | Acest eveniment se declanșează atunci când trebuie afișată o filă nouă (și astfel fila activă anterioară trebuie să fie ascunsă). Utilizați event.target și event.relatedTarget pentru a viza fila activă curentă și, respectiv, noua filă care va fi activă în curând. |
ascuns.bs.tab | Acest eveniment se declanșează după ce este afișată o nouă filă (și astfel fila activă anterioară este ascunsă). Utilizați event.target și event.relatedTarget pentru a viza fila activă anterioară și, respectiv, noua filă activă. |
Inspirat de excelentul plugin jQuery.tipsy scris de Jason Frame; Sfaturile instrumente sunt o versiune actualizată, care nu se bazează pe imagini, utilizează CSS3 pentru animații și atribute de date pentru stocarea locală a titlurilor.
Sfaturile instrumente cu titluri de lungime zero nu sunt niciodată afișate.
Treceți cu mouse-ul peste linkurile de mai jos pentru a vedea sfaturi despre instrumente:
Pantaloni strâmți, keffiyeh , probabil că nu ați auzit de ei. Cabina foto barbă din denim brut tipografie geantă vegană stumptown. Seitanul de la fermă la masă, mcsweeney's fixie sustainable quinoa 8-bit american apparel au un terry richardson vinyl chambray. Beard Stumptown, cardigans banh mi lomo thundercats. Tofu biodiesel williamsburg marfa, four loko mcsweeney's cleanse vegan chambray. Un artizan cu adevărat ironic orice keytar , scenester farm-to-table banksy Austin twitter handle freegan cred raw denim cafea de origine unică virală.
Sunt disponibile patru opțiuni: aliniat sus, dreapta, jos și stânga.
Din motive de performanță, API-ul de date Tooltip și Popover sunt opt-in, ceea ce înseamnă că trebuie să le inițializați singur .
O modalitate de a inițializa toate sfaturile instrumente dintr-o pagină ar fi să le selectați după data-toggle
atributul lor:
Pluginul de indicații cu instrumente generează conținut și markup la cerere și, în mod implicit, plasează indicatorii de informații după elementul de declanșare.
Declanșați balonul cu ajutorul JavaScript:
Markupul necesar pentru un balon explicativ este doar un data
atribut și title
pe elementul HTML doriți să aveți un balon explicativ. Markupul generat al unui tooltip este destul de simplu, deși necesită o poziție (în mod implicit, setată top
de plugin).
Uneori doriți să adăugați un sfat explicativ la un hyperlink care include mai multe linii. Comportamentul implicit al plugin-ului tooltip este de a-l centra orizontal și vertical. Adaugă white-space: nowrap;
la ancorele tale pentru a evita acest lucru.
Când utilizați sfaturi cu instrumente pentru elemente dintr-un .btn-group
sau un .input-group
, sau pe elemente legate de tabel ( <td>
, <th>
, <tr>
, <thead>
, <tbody>
, <tfoot>
), va trebui să specificați opțiunea container: 'body'
(documentată mai jos) pentru a evita efectele secundare nedorite (cum ar fi elementul care crește și/ sau pierderea colțurilor rotunjite atunci când este declanșat tooltip).
Pentru utilizatorii care navighează cu o tastatură și, în special, utilizatorii de tehnologii de asistență, ar trebui să adăugați doar sfaturi pentru elementele focalizate pe tastatură, cum ar fi linkuri, comenzi de formular sau orice element arbitrar cu un tabindex="0"
atribut.
Pentru a adăuga un sfat explicativ la un element disabled
sau .disabled
, puneți elementul în interiorul lui a <div>
și aplicați-l <div>
în schimb.
Opțiunile pot fi transmise prin atribute de date sau JavaScript. Pentru atributele datelor, adăugați numele opțiunii la data-
, ca în data-animation=""
.
Rețineți că, din motive de securitate sanitize
, opțiunile sanitizeFn
și whiteList
nu pot fi furnizate utilizând atribute de date.
Nume | Tip | Mod implicit | Descriere |
---|---|---|---|
animaţie | boolean | Adevărat | Aplicați o tranziție de estompare CSS la balonul explicativ |
recipient | șir | fals | fals | Adaugă indicația la un anumit element. Exemplu: |
întârziere | număr | obiect | 0 | Întârziere afișarea și ascunderea balonului explicativ (ms) - nu se aplică tipului de declanșare manuală Dacă este furnizat un număr, se aplică întârziere atât pentru ascunde/afișare Structura obiectului este: |
html | boolean | fals | Inserați HTML în sfatul instrumentului. Dacă este fals, text metoda jQuery va fi folosită pentru a insera conținut în DOM. Folosiți text dacă vă îngrijorează atacurile XSS. |
plasare | șir | funcţie | 'top' | Cum se poziționează indicatorul - sus | jos | stânga | dreapta | auto. Când o funcție este utilizată pentru a determina plasarea, aceasta este apelată cu nodul DOM ca prim argument și elementul de declanșare nodul DOM ca al doilea. Contextul |
selector | şir | fals | Dacă este furnizat un selector, obiectele de tip tooltip vor fi delegate țintelor specificate. În practică, aceasta este folosită și pentru a aplica sfaturi pentru elementele DOM adăugate dinamic ( jQuery.on suport). Vedeți acesta și un exemplu informativ . |
șablon | şir | '<div class="tooltip" role="tooltip"><div class="tooltip-arrow"></div><div class="tooltip-inner"></div></div>' |
HTML de bază de utilizat la crearea descrierii explicative. Indicațiile
Elementul de înveliș exterior ar trebui să aibă |
titlu | șir | funcţie | '' | Valoarea implicită a titlului dacă Dacă este dată o funcție, aceasta va fi apelată cu |
declanșatorul | şir | „focalizare” | Cum se declanșează balonul - faceți clic pe | hover | focus | manual. Puteți trece mai multe declanșatoare; separați-le cu un spațiu. manual nu poate fi combinat cu niciun alt declanșator. |
fereastra | șir | obiect | funcţie | { selector: „corp”, umplutură: 0 } | Menține sfatul instrument în limitele acestui element. Exemplu: Dacă o funcție este dată, aceasta este apelată cu elementul de declanșare nodul DOM ca singur argument. Contextul |
dezinfecta | boolean | Adevărat | Activați sau dezactivați igienizarea. Dacă este activat 'template' , 'content' și 'title' opțiunile vor fi dezinfectate. |
Lista albă | obiect | Valoare implicită | Obiect care conține atribute și etichete permise |
igienizaFn | nul | funcţie | nul | Aici vă puteți furniza propria funcție de dezinfectare. Acest lucru poate fi util dacă preferați să utilizați o bibliotecă dedicată pentru a efectua igienizarea. |
Opțiunile pentru sfaturi instrumente individuale pot fi specificate alternativ prin utilizarea atributelor de date, așa cum s-a explicat mai sus.
$().tooltip(options)
Atașează un handler tooltip la o colecție de elemente.
.tooltip('show')
Dezvăluie explicația unui element. Se întoarce la apelant înainte ca indicația să fie afișată efectiv (adică înainte de apariția shown.bs.tooltip
evenimentului). Aceasta este considerată o declanșare „manuală” a descrierii explicative. Sfaturile instrumente cu titluri de lungime zero nu sunt niciodată afișate.
.tooltip('hide')
Ascunde explicația unui element. Se întoarce la apelant înainte ca indicația să fie ascunsă (adică înainte de apariția hidden.bs.tooltip
evenimentului). Aceasta este considerată o declanșare „manuală” a descrierii explicative.
.tooltip('toggle')
Comută în lista de informații despre un element. Revine la apelant înainte ca balonul să fie afișat sau ascuns (adică înainte ca evenimentul shown.bs.tooltip
sau să hidden.bs.tooltip
apară). Aceasta este considerată o declanșare „manuală” a descrierii explicative.
.tooltip('destroy')
Ascunde și distruge sfatul instrument al unui element. Sfaturile instrumente care utilizează delegarea (care sunt create folosind opțiunea selector
) nu pot fi distruse individual pe elementele de declanșare descendente.
Tip de eveniment | Descriere |
---|---|
arată.bs.tooltip | Acest eveniment se declanșează imediat când show este apelată metoda instanței. |
afișat.bs.tooltip | Acest eveniment este declanșat când balonul explicativ a fost făcut vizibil pentru utilizator (va aștepta finalizarea tranzițiilor CSS). |
ascunde.bs.tooltip | Acest eveniment este declanșat imediat când hide metoda instanței a fost apelată. |
hidden.bs.tooltip | Acest eveniment este declanșat când sfarsitul explicativ a terminat de ascuns utilizatorului (va aștepta finalizarea tranzițiilor CSS). |
introdus.bs.tooltip | Acest eveniment este declanșat după show.bs.tooltip eveniment, când șablonul de indicații explicative a fost adăugat la DOM. |
Adăugați mici suprapuneri de conținut, cum ar fi cele de pe iPad, la orice element pentru a găzdui informații secundare.
Popover-urile al căror titlu și conținut sunt de lungime zero nu sunt niciodată afișate.
Popover-urile necesită ca pluginul tooltip să fie inclus în versiunea dvs. de Bootstrap.
Din motive de performanță, API-ul de date Tooltip și Popover sunt opt-in, ceea ce înseamnă că trebuie să le inițializați singur .
O modalitate de a inițializa toate popover-urile dintr-o pagină ar fi să le selectați după data-toggle
atributul lor:
Când utilizați popover-uri pe elemente dintr-un .btn-group
sau un .input-group
, sau pe elemente legate de tabel ( <td>
, <th>
, <tr>
, <thead>
, <tbody>
, <tfoot>
), va trebui să specificați opțiunea container: 'body'
(documentată mai jos) pentru a evita efectele secundare nedorite (cum ar fi elementul care crește și/ sau pierderea colțurilor rotunjite la declanșarea popover-ului).
Pentru a adăuga un popover la un element disabled
sau .disabled
, puneți elementul în interiorul lui a <div>
și aplicați popover-ul acestuia <div>
.
Uneori doriți să adăugați un popover la un hyperlink care include mai multe linii. Comportamentul implicit al plugin-ului popover este de a-l centra orizontal și vertical. Adaugă white-space: nowrap;
la ancorele tale pentru a evita acest lucru.
Sunt disponibile patru opțiuni: aliniat sus, dreapta, jos și stânga.
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Utilizați focus
declanșatorul pentru a închide popover-urile la următorul clic pe care îl face utilizatorul.
Pentru un comportament adecvat între browsere și platforme, trebuie să utilizați <a>
eticheta, nu eticheta <button>
și, de asemenea, trebuie să includeți atributele role="button"
și .tabindex
Activați popover-urile prin JavaScript:
Opțiunile pot fi transmise prin atribute de date sau JavaScript. Pentru atributele datelor, adăugați numele opțiunii la data-
, ca în data-animation=""
.
Rețineți că, din motive de securitate sanitize
, opțiunile sanitizeFn
și whiteList
nu pot fi furnizate utilizând atribute de date.
Nume | Tip | Mod implicit | Descriere |
---|---|---|---|
animaţie | boolean | Adevărat | Aplicați o tranziție de estompare CSS la popover |
recipient | șir | fals | fals | Adaugă popover-ul la un anumit element. Exemplu: |
conţinut | șir | funcţie | '' | Valoarea implicită a conținutului dacă Dacă este dată o funcție, aceasta va fi apelată cu |
întârziere | număr | obiect | 0 | Întârziere afișarea și ascunderea popover-ului (ms) - nu se aplică tipului de declanșare manuală Dacă este furnizat un număr, se aplică întârziere atât pentru ascunde/afișare Structura obiectului este: |
html | boolean | fals | Inserați HTML în popover. Dacă este fals, text metoda jQuery va fi folosită pentru a insera conținut în DOM. Folosiți text dacă vă îngrijorează atacurile XSS. |
plasare | șir | funcţie | 'dreapta' | Cum să poziționați popover-ul - sus | jos | stânga | dreapta | auto. Când o funcție este utilizată pentru a determina plasarea, este apelată cu nodul popover DOM ca prim argument și elementul de declanșare nodul DOM ca al doilea. Contextul |
selector | şir | fals | Dacă este furnizat un selector, obiectele popover vor fi delegate țintelor specificate. În practică, aceasta este utilizată pentru a permite conținutului HTML dinamic să fie adăugate popovers. Vedeți acesta și un exemplu informativ . |
șablon | şir | '<div class="popover" role="tooltip"><div class="arrow"></div><h3 class="popover-title"></h3><div class="popover-content"></div></div>' |
HTML de bază de utilizat la crearea popover-ului. Popover-urile Popover-urile
Elementul de înveliș exterior ar trebui să aibă |
titlu | șir | funcţie | '' | Valoarea implicită a titlului dacă Dacă este dată o funcție, aceasta va fi apelată cu |
declanșatorul | şir | 'clic' | Cum se declanșează popoverul - faceți clic pe | hover | focus | manual. Puteți trece mai multe declanșatoare; separați-le cu un spațiu. manual nu poate fi combinat cu niciun alt declanșator. |
fereastra | șir | obiect | funcţie | { selector: „corp”, umplutură: 0 } | Menține popover-ul în limitele acestui element. Exemplu: Dacă o funcție este dată, aceasta este apelată cu elementul de declanșare nodul DOM ca singur argument. Contextul |
dezinfecta | boolean | Adevărat | Activați sau dezactivați igienizarea. Dacă este activat 'template' , 'content' și 'title' opțiunile vor fi dezinfectate. |
Lista albă | obiect | Valoare implicită | Obiect care conține atribute și etichete permise |
igienizaFn | nul | funcţie | nul | Aici vă puteți furniza propria funcție de dezinfectare. Acest lucru poate fi util dacă preferați să utilizați o bibliotecă dedicată pentru a efectua igienizarea. |
Opțiunile pentru popover-uri individuale pot fi specificate alternativ prin utilizarea atributelor de date, așa cum s-a explicat mai sus.
$().popover(options)
Inițializează popover-urile pentru o colecție de elemente.
.popover('show')
Dezvăluie popover-ul unui element. Revine la apelant înainte ca popover-ul să fie afișat efectiv (adică înainte de apariția shown.bs.popover
evenimentului). Aceasta este considerată o declanșare „manuală” a popover-ului. Popover-urile al căror titlu și conținut sunt de lungime zero nu sunt niciodată afișate.
.popover('hide')
Ascunde popover-ul unui element. Se întoarce la apelant înainte ca popover-ul să fi fost efectiv ascuns (adică înainte de apariția hidden.bs.popover
evenimentului). Aceasta este considerată o declanșare „manuală” a popover-ului.
.popover('toggle')
Comută popover-ul unui element. Revine la apelant înainte ca popover-ul să fi fost efectiv afișat sau ascuns (adică înainte ca evenimentul shown.bs.popover
sau să hidden.bs.popover
apară). Aceasta este considerată o declanșare „manuală” a popover-ului.
.popover('destroy')
Ascunde și distruge popover-ul unui element. Popover-urile care folosesc delegarea (care sunt create folosind opțiunea selector
) nu pot fi distruse individual pe elementele de declanșare descendente.
Tip de eveniment | Descriere |
---|---|
show.bs.popover | Acest eveniment se declanșează imediat când show este apelată metoda instanței. |
arătat.bs.popover | Acest eveniment este declanșat atunci când popover-ul a fost făcut vizibil pentru utilizator (va aștepta finalizarea tranzițiilor CSS). |
ascunde.bs.popover | Acest eveniment este declanșat imediat când hide metoda instanței a fost apelată. |
ascuns.bs.popover | Acest eveniment este declanșat când popover-ul a terminat de a fi ascuns utilizatorului (va aștepta finalizarea tranzițiilor CSS). |
introdus.bs.popover | Acest eveniment este declanșat după show.bs.popover eveniment când șablonul popover a fost adăugat la DOM. |
Adăugați funcționalitatea de respingere la toate mesajele de alertă cu acest plugin.
Când utilizați un .close
buton, acesta trebuie să fie primul copil al acestuia .alert-dismissible
și niciun conținut text nu poate apărea înaintea acestuia în marcaj.
Schimbați asta și asta și încercați din nou. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.
Doar adăugați data-dismiss="alert"
butonul de închidere pentru a oferi automat o funcție de închidere de alertă. Închiderea unei alerte o elimină din DOM.
Pentru ca alertele dvs. să folosească animația la închidere, asigurați-vă că au aplicate deja clasele .fade
și ..in
$().alert()
Face ca o alertă să asculte evenimentele de clic pe elementele descendente care au data-dismiss="alert"
atributul. (Nu este necesar atunci când utilizați auto-inițializarea aplicației de date.)
$().alert('close')
Închide o alertă eliminând-o din DOM. Dacă clasele .fade
și .in
sunt prezente pe element, alerta va dispărea înainte de a fi eliminată.
Pluginul de alertă Bootstrap expune câteva evenimente pentru conectarea la funcționalitatea de alertă.
Tip de eveniment | Descriere |
---|---|
închide.bs.alert | Acest eveniment se declanșează imediat când close este apelată metoda instanței. |
închis.bs.alert | Acest eveniment este declanșat când alerta a fost închisă (va aștepta finalizarea tranzițiilor CSS). |
Faceți mai mult cu butoanele. Controlați stările butoanelor sau creați grupuri de butoane pentru mai multe componente, cum ar fi barele de instrumente.
Firefox persistă stările de control al formularelor (dezactivare și verificare) în timpul încărcării paginilor . O soluție pentru aceasta este utilizarea autocomplete="off"
. Vezi eroarea Mozilla #654072 .
Adăugați data-loading-text="Loading..."
pentru a utiliza o stare de încărcare pe un buton.
Această caracteristică este depreciată de la v3.3.5 și a fost eliminată în v4.
De dragul acestei demonstrații, folosim data-loading-text
și $().button('loading')
, dar aceasta nu este singura stare pe care o puteți folosi. Vedeți mai multe despre asta mai jos în $().button(string)
documentație .
Adăugați data-toggle="button"
pentru a activa comutarea pe un singur buton.
.active
șiaria-pressed="true"
Pentru butoanele pre-commutate, trebuie să adăugați .active
clasa și aria-pressed="true"
atributul la button
dvs.
Adăugați data-toggle="buttons"
la o .btn-group
casetă de selectare sau intrări radio pentru a activa comutarea în stilurile respective.
.active
Pentru opțiunile preselectate, trebuie să adăugați singur .active
clasa la intrare .label
Dacă starea bifată a unui buton casetă de selectare este actualizată fără a declanșa un click
eveniment pe buton (de exemplu, prin <input type="reset">
sau prin setarea checked
proprietății intrării), va trebui să comutați singur .active
clasa pe intrare .label
$().button('toggle')
Comută starea push. Oferă butonului aspectul că a fost activat.
$().button('reset')
Resetează starea butonului - schimbă textul cu textul original. Această metodă este asincronă și revine înainte ca resetarea să se fi încheiat efectiv.
$().button(string)
Schimbă textul în orice stare de text definită de date.
Plugin flexibil care utilizează o mână de clase pentru un comportament ușor de comutare.
Restrângerea necesită ca pluginul de tranziții să fie inclus în versiunea dvs. de Bootstrap.
Faceți clic pe butoanele de mai jos pentru a afișa și a ascunde un alt element prin modificări de clasă:
.collapse
ascunde conținutul.collapsing
se aplică în timpul tranzițiilor.collapse.in
afișează conținutPuteți folosi un link cu href
atributul sau un buton cu data-target
atributul. În ambele cazuri, data-toggle="collapse"
este necesar.
Extindeți comportamentul de restrângere implicit pentru a crea un acordeon cu componenta panoului.
De asemenea, este posibil să schimbați .panel-body
s cu .list-group
s.
Asigurați-vă că adăugați aria-expanded
la elementul de control. Acest atribut definește în mod explicit starea curentă a elementului pliabil pentru cititoarele de ecran și tehnologiile de asistență similare. Dacă elementul pliabil este închis în mod implicit, acesta ar trebui să aibă o valoare de aria-expanded="false"
. Dacă ați setat elementul pliabil să fie deschis în mod implicit utilizând in
clasa, setați aria-expanded="true"
în schimb controlul. Pluginul va comuta automat acest atribut în funcție de faptul dacă elementul pliabil a fost deschis sau închis sau nu.
În plus, dacă elementul dvs. de control vizează un singur element pliabil - adică data-target
atributul indică către un id
selector - puteți adăuga un aria-controls
atribut suplimentar la elementul de control, care conține id
elementul pliabil. Cititoarele de ecran moderne și tehnologiile de asistență similare folosesc acest atribut pentru a oferi utilizatorilor comenzi rapide suplimentare pentru a naviga direct la elementul pliabil în sine.
Pluginul de colaps folosește câteva clase pentru a face față sarcinilor grele:
.collapse
ascunde conținutul.collapse.in
arata continutul.collapsing
este adăugată când începe tranziția și eliminată când se terminăAceste clase pot fi găsite în component-animations.less
.
Doar adăugați data-toggle="collapse"
și data-target
a elementului pentru a atribui automat controlul unui element pliabil. Atributul data-target
acceptă un selector CSS pentru a aplica restrângerea. Asigurați-vă că adăugați clasa collapse
la elementul pliabil. Dacă doriți să se deschidă implicit, adăugați clasa suplimentarăin
.
Pentru a adăuga un management de grup asemănător unui acordeon la un control pliabil, adăugați atributul de date data-parent="#selector"
. Consultați demonstrația pentru a vedea acest lucru în acțiune.
Activați manual cu:
Opțiunile pot fi transmise prin atribute de date sau JavaScript. Pentru atributele datelor, adăugați numele opțiunii la data-
, ca în data-parent=""
.
Nume | tip | Mod implicit | Descriere |
---|---|---|---|
mamă | selector | fals | Dacă este furnizat un selector, atunci toate elementele pliabile de sub părintele specificat vor fi închise atunci când este afișat acest element pliabil. (similar cu comportamentul tradițional la acordeon - acesta depinde de panel clasă) |
comutare | boolean | Adevărat | Comută elementul pliabil la invocare |
.collapse(options)
Activează conținutul dvs. ca element pliabil. Acceptă opțiuni opționale object
.
.collapse('toggle')
Comută un element pliabil la afișat sau ascuns. Se întoarce la apelant înainte ca elementul pliabil să fi fost efectiv afișat sau ascuns (adică înainte ca evenimentul shown.bs.collapse
sau să hidden.bs.collapse
apară).
.collapse('show')
Afișează un element pliabil. Se întoarce la apelant înainte ca elementul pliabil să fie afișat efectiv (adică înainte de apariția shown.bs.collapse
evenimentului).
.collapse('hide')
Ascunde un element pliabil. Se întoarce la apelant înainte ca elementul pliabil să fi fost efectiv ascuns (adică înainte de apariția hidden.bs.collapse
evenimentului).
Clasa de colaps a lui Bootstrap expune câteva evenimente pentru conectarea la funcționalitatea de colaps.
Tip de eveniment | Descriere |
---|---|
arată.bs.colaps | Acest eveniment se declanșează imediat când show este apelată metoda instanței. |
arătat.bs.colaps | Acest eveniment este declanșat atunci când un element de restrângere a fost făcut vizibil pentru utilizator (va aștepta finalizarea tranzițiilor CSS). |
ascunde.bs.colaps | Acest eveniment este declanșat imediat când hide metoda a fost apelată. |
ascuns.bs.colaps | Acest eveniment este declanșat atunci când un element de restrângere a fost ascuns utilizatorului (va aștepta finalizarea tranzițiilor CSS). |
O componentă de prezentare de diapozitive pentru ciclism prin elemente, cum ar fi un carusel. Caruselele imbricate nu sunt acceptate.
Componenta carusel nu este în general conformă cu standardele de accesibilitate. Dacă trebuie să respectați, vă rugăm să luați în considerare alte opțiuni pentru prezentarea conținutului dvs.
Bootstrap folosește exclusiv CSS3 pentru animațiile sale, dar Internet Explorer 8 și 9 nu acceptă proprietățile CSS necesare. Astfel, nu există animații de tranziție de diapozitive atunci când utilizați aceste browsere. Am decis în mod intenționat să nu includem soluții de rezervă bazate pe jQuery pentru tranziții.
Clasa .active
trebuie adăugată la unul dintre diapozitive. În caz contrar, caruselul nu va fi vizibil.
Clasele .glyphicon .glyphicon-chevron-left
și .glyphicon .glyphicon-chevron-right
nu sunt neapărat necesare pentru controale. Bootstrap oferă .icon-prev
și .icon-next
ca alternative simple Unicode.
Adăugați cu ușurință subtitrări la diapozitive cu .carousel-caption
elementul din orice .item
. Puneți aproape orice HTML opțional acolo și va fi aliniat și formatat automat.
Caruselele necesită utilizarea unui id
container de pe cel mai exterior (the .carousel
) pentru ca comenzile caruselului să funcționeze corect. Când adăugați mai multe carusele sau când schimbați un carusel id
, asigurați-vă că actualizați controalele relevante.
Utilizați atributele de date pentru a controla cu ușurință poziția caruselului. data-slide
acceptă cuvintele cheie prev
sau next
, care modifică poziția diapozitivului în raport cu poziția curentă. Alternativ, utilizați data-slide-to
pentru a transmite un index de diapozitiv brut la carusel data-slide-to="2"
, care schimbă poziția de diapozitiv la un anumit index începând cu0
.
Atributul data-ride="carousel"
este folosit pentru a marca un carusel ca animat începând cu încărcarea paginii. Nu poate fi utilizat în combinație cu inițializarea JavaScript explicită (redundantă și inutilă) a aceluiași carusel.
Apelați manual caruselul cu:
Opțiunile pot fi transmise prin atribute de date sau JavaScript. Pentru atributele datelor, adăugați numele opțiunii la data-
, ca în data-interval=""
.
Nume | tip | Mod implicit | Descriere |
---|---|---|---|
interval | număr | 5000 | Durata de întârziere între trecerea automată pe bicicletă a unui articol. Dacă este fals, caruselul nu va rula automat. |
pauză | șir | nul | "planare" | Dacă este setat la "hover" , întrerupe ciclul carusel pornit mouseenter și reia ciclul caruselului pornit mouseleave . Dacă este setat la null , trecerea cursorului peste carusel nu îl va întrerupe. |
înfășura | boolean | Adevărat | Dacă caruselul ar trebui să circule continuu sau să aibă opriri grele. |
tastatură | boolean | Adevărat | Dacă caruselul ar trebui să reacționeze la evenimentele de la tastatură. |
.carousel(options)
Inițializează caruselul cu opțiuni opționale object
și începe să parcurgă articole.
.carousel('cycle')
Parcurge articolele din carusel de la stânga la dreapta.
.carousel('pause')
Oprește caruselul să parcurgă articole.
.carousel(number)
Ciclulează caruselul la un anumit cadru (bazat pe 0, similar cu o matrice).
.carousel('prev')
Se trece la articolul anterior.
.carousel('next')
Se trece la articolul următor.
Clasa carusel a lui Bootstrap expune două evenimente pentru conectarea la funcționalitatea carusel.
Ambele evenimente au următoarele proprietăți suplimentare:
direction
: Direcția în care alunecă caruselul (fie "left"
sau "right"
).relatedTarget
: elementul DOM care este alunecat în poziție ca element activ.Toate evenimentele carusel sunt declanșate la carusel în sine (adică la <div class="carousel">
).
Tip de eveniment | Descriere |
---|---|
slide.bs.carusel | Acest eveniment se declanșează imediat când slide este invocată metoda instanței. |
alunecare.bs.carusel | Acest eveniment este declanșat când caruselul și-a încheiat tranziția de diapozitiv. |
Pluginul position: fixed;
de afixare activează și dezactivează, emulând efectul găsit cu position: sticky;
. Subnavigația din dreapta este o demonstrație live a pluginului afix.
Utilizați pluginul de afixare prin atribute de date sau manual cu propriul JavaScript. În ambele situații, trebuie să furnizați CSS pentru poziționarea și lățimea conținutului atașat.
Notă: nu utilizați pluginul de afixare pe un element conținut într-un element relativ poziționat, cum ar fi o coloană trasă sau împinsă, din cauza unei erori de redare Safari .
Pluginul afix comută între trei clase, fiecare reprezentând o anumită stare: .affix
, .affix-top
, și .affix-bottom
. Trebuie să furnizați stilurile, cu excepția position: fixed;
lui.affix
, pentru aceste clase (independent de acest plugin) pentru a gestiona pozițiile reale.
Iată cum funcționează pluginul afix:
.affix-top
pentru a indica că elementul se află în poziția sa de sus. În acest moment nu este necesară nicio poziționare CSS..affix
înlocuiește .affix-top
și se setează position: fixed;
(furnizat de CSS-ul Bootstrap)..affix
cu .affix-bottom
. Deoarece offset-urile sunt opționale, setarea unuia necesită să setați CSS-ul corespunzător. În acest caz, adăugați position: absolute;
când este necesar. Pluginul folosește atributul de date sau opțiunea JavaScript pentru a determina unde să poziționeze elementul de acolo.Urmați pașii de mai sus pentru a vă seta CSS pentru oricare dintre opțiunile de utilizare de mai jos.
Pentru a adăuga cu ușurință un comportament de afixare la orice element, trebuie doar să adăugați data-spy="affix"
la elementul pe care doriți să îl spionați. Utilizați decalaje pentru a defini când să comutați fixarea unui element.
Apelați pluginul afix prin JavaScript:
Opțiunile pot fi transmise prin atribute de date sau JavaScript. Pentru atributele datelor, adăugați numele opțiunii la data-
, ca în data-offset-top="200"
.
Nume | tip | Mod implicit | Descriere |
---|---|---|---|
decalaj | număr | funcția | obiect | 10 | Pixeli de decalat față de ecran la calcularea poziției derulării. Dacă este furnizat un singur număr, decalajul va fi aplicat atât în direcția de sus, cât și de jos. Pentru a oferi un offset unic, de jos și de sus, trebuie doar să furnizați un obiect offset: { top: 10 } sau offset: { top: 10, bottom: 5 } . Utilizați o funcție atunci când trebuie să calculați dinamic un offset. |
ţintă | selector | nod | element jQuery | window obiectul _ |
Specifică elementul țintă al afixului. |
.affix(options)
Activează conținutul dvs. ca conținut atașat. Acceptă opțiuni opționale object
.
.affix('checkPosition')
Recalculează starea afixului pe baza dimensiunilor, poziției și poziției de defilare a elementelor relevante. Clasele .affix
, .affix-top
, și .affix-bottom
sunt adăugate sau eliminate din conținutul atașat în funcție de noua stare. Această metodă trebuie apelată ori de câte ori dimensiunile conținutului atașat sau ale elementului țintă sunt modificate, pentru a asigura poziționarea corectă a conținutului atașat.
Pluginul de afixare al Bootstrap expune câteva evenimente pentru conectarea la funcționalitatea afixului.
Tip de eveniment | Descriere |
---|---|
afix.bs.afix | Acest eveniment se declanșează imediat înainte ca elementul să fie fixat. |
aplicat.bs.afix | Acest eveniment este declanșat după ce elementul a fost fixat. |
afix-top.bs.affix | Acest eveniment se declanșează imediat înainte ca elementul să fie fixat în partea de sus. |
lipit-top.bs.afix | Acest eveniment este declanșat după ce elementul a fost fixat în partea de sus. |
afix-bottom.bs.afix | Acest eveniment se declanșează imediat înainte ca elementul să fie fixat în partea de jos. |
fixat-de jos.bs.afix | Acest eveniment este declanșat după ce elementul a fost fixat în partea de jos. |