JavaScript
Doneu vida als components de Bootstrap amb més d'una dotzena de connectors jQuery personalitzats. Inclou-los fàcilment tots, o un per un.
Doneu vida als components de Bootstrap amb més d'una dotzena de connectors jQuery personalitzats. Inclou-los fàcilment tots, o un per un.
Els connectors es poden incloure individualment (utilitzant els *.js
fitxers individuals de Bootstrap) o tots alhora (utilitzant bootstrap.js
o minificat bootstrap.min.js
).
Tots dos bootstrap.js
i bootstrap.min.js
contenen tots els connectors en un sol fitxer. Inclou només un.
Alguns connectors i components CSS depenen d'altres connectors. Si incloeu connectors individualment, assegureu-vos de comprovar aquestes dependències als documents. Tingueu en compte també que tots els connectors depenen de jQuery (això significa que jQuery s'ha d'incloure abans dels fitxers de connectors). Consulteu el nostrebower.json
per veure quines versions de jQuery són compatibles.
Podeu utilitzar tots els connectors Bootstrap únicament a través de l'API de marcatge sense escriure una sola línia de JavaScript. Aquesta és l'API de primera classe de Bootstrap i hauria de ser la vostra primera consideració quan feu servir un connector.
Dit això, en algunes situacions pot ser desitjable desactivar aquesta funcionalitat. Per tant, també oferim la possibilitat de desactivar l'API d'atribut de dades desvinculant tots els esdeveniments del document amb espai de noms data-api
. Això es veu així:
Alternativament, per orientar un connector específic, només cal incloure el nom del connector com a espai de noms juntament amb l'espai de noms de l'api de dades com aquest:
No utilitzeu atributs de dades de diversos connectors al mateix element. Per exemple, un botó no pot tenir una informació sobre eines i alternar un modal. Per aconseguir-ho, utilitzeu un element d'embolcall.
També creiem que hauríeu de poder utilitzar tots els connectors Bootstrap només mitjançant l'API de JavaScript. Totes les API públiques són mètodes únics que es poden encadenar i retornen la col·lecció sobre la qual s'ha actuat.
Tots els mètodes haurien d'acceptar un objecte d'opcions opcionals, una cadena que tingui com a objectiu un mètode concret o res (que iniciï un connector amb un comportament predeterminat):
Cada connector també exposa el seu constructor en brut en una Constructor
propietat: $.fn.popover.Constructor
. Si voleu obtenir una instància de connector concreta, recupera-la directament d'un element: $('[rel="popover"]').data('popover')
.
Podeu canviar la configuració predeterminada d'un connector modificant l' Constructor.DEFAULTS
objecte del connector:
De vegades és necessari utilitzar connectors Bootstrap amb altres marcs d'interfície d'usuari. En aquestes circumstàncies, ocasionalment es poden produir col·lisions d'espais de noms. Si això passa, podeu trucar .noConflict
al connector del qual voleu revertir el valor.
Bootstrap ofereix esdeveniments personalitzats per a les accions úniques de la majoria dels connectors. Generalment, aquests es presenten en una forma d'infinitiu i de participi passat, on l'infinitiu (p. ex. show
) s'activa a l'inici d'un esdeveniment i la seva forma de participi passat (p. ex. shown
) s'activa en finalitzar una acció.
A partir de la 3.0.0, tots els esdeveniments Bootstrap tenen espai de noms.
Tots els esdeveniments infinitius proporcionen preventDefault
funcionalitat. Això proporciona la possibilitat d'aturar l'execució d'una acció abans que comenci.
Els consells sobre eines i les finestres emergents utilitzen el nostre desinfectador integrat per desinfectar les opcions que accepten HTML.
El valor per defecte whiteList
és el següent:
Si voleu afegir nous valors a aquest valor predeterminat whiteList
, podeu fer el següent:
Si voleu evitar el nostre desinfectant perquè preferiu utilitzar una biblioteca dedicada, per exemple DOMPurify , hauríeu de fer el següent:
document.implementation.createHTMLDocument
En el cas dels navegadors que no admeten document.implementation.createHTMLDocument
, com Internet Explorer 8, la funció de desinfecció integrada retorna l'HTML tal qual.
Si voleu realitzar la desinfecció en aquest cas, especifiqueu sanitizeFn
i utilitzeu una biblioteca externa com DOMPurify .
Es pot accedir a la versió de cadascun dels connectors jQuery de Bootstrap mitjançant la VERSION
propietat del constructor del connector. Per exemple, per al connector tooltip:
Els connectors d'Bootstrap no cauen especialment amb gràcia quan JavaScript està desactivat. Si t'importa l'experiència de l'usuari en aquest cas, fes servir <noscript>
per explicar la situació (i com tornar a activar JavaScript) als teus usuaris i/o afegir les teves pròpies alternatives personalitzades.
Bootstrap no admet oficialment biblioteques JavaScript de tercers com Prototype o jQuery UI. Malgrat .noConflict
els esdeveniments amb espai de noms, és possible que hi hagi problemes de compatibilitat que hàgiu de solucionar pel vostre compte.
Per obtenir efectes de transició senzills, inclou transition.js
una vegada juntament amb els altres fitxers JS. Si utilitzeu el compilat (o minificat) bootstrap.js
, no cal incloure-ho; ja hi és.
Transition.js és un ajudant bàsic per a transitionEnd
esdeveniments, així com un emulador de transició CSS. Els altres connectors l'utilitzen per comprovar la compatibilitat amb la transició CSS i per capturar les transicions penjades.
Les transicions es poden desactivar globalment utilitzant el fragment de JavaScript següent, que ha de venir després que s'hagi carregat transition.js
(o bootstrap.js
o , segons sigui el cas):bootstrap.min.js
Els modals són indicacions de diàleg simplificades, però flexibles amb la funcionalitat mínima necessària i els valors predeterminats intel·ligents.
Assegureu-vos de no obrir un modal mentre un altre encara sigui visible. Mostrar més d'un modal alhora requereix un codi personalitzat.
Intenteu sempre col·locar el codi HTML d'un modal en una posició de primer nivell del vostre document per evitar que altres components afectin l'aparença i/o la funcionalitat del modal.
Hi ha algunes advertències sobre l'ús de modals en dispositius mòbils. Consulteu els nostres documents d'assistència per al navegador per obtenir més informació.
A causa de com HTML5 defineix la seva semàntica, l' autofocus
atribut HTML no té cap efecte en els modals d'Bootstrap. Per aconseguir el mateix efecte, utilitzeu JavaScript personalitzat:
Un modal representat amb la capçalera, el cos i el conjunt d'accions al peu de pàgina.
Commuteu un modal mitjançant JavaScript fent clic al botó següent. Es lliscarà cap avall i s'esvaeix des de la part superior de la pàgina.
Assegureu-vos d'afegir role="dialog"
i aria-labelledby="..."
, fent referència al títol modal, a .modal
, i role="document"
al .modal-dialog
mateix.
A més, podeu donar una descripció del vostre diàleg modal amb aria-describedby
on .modal
.
La inserció de vídeos de YouTube en modalitats requereix JavaScript addicional que no estigui a Bootstrap per aturar automàticament la reproducció i molt més. Consulteu aquesta útil publicació de Stack Overflow per obtenir més informació.
Els modals tenen dues mides opcionals, disponibles mitjançant classes modificadores per col·locar-les en un fitxer .modal-dialog
.
Per als modals que simplement apareixen en lloc de desaparèixer per veure's, elimineu la .fade
classe del vostre marcatge modal.
Per aprofitar el sistema de quadrícula Bootstrap dins d'un modal, només cal que niu .row
s dins .modal-body
i després utilitzeu les classes normals del sistema de quadrícula.
Tens un munt de botons que activen tots el mateix modal, només amb continguts lleugerament diferents? Utilitzeu event.relatedTarget
i atributs HTMLdata-*
(possiblement mitjançant jQuery ) per variar el contingut del modal en funció del botó que s'hagi fet clic. Consulteu els documents d'esdeveniments modals per obtenir més informació sobre relatedTarget
,
El connector modal alterna el contingut ocult a demanda, mitjançant atributs de dades o JavaScript. També s'afegeix .modal-open
al <body>
comportament de desplaçament predeterminat per anul·lar i genera una .modal-backdrop
àrea de clic per descartar els modals mostrats quan es fa clic fora del modal.
Activa un modal sense escriure JavaScript. Estableix data-toggle="modal"
en un element del controlador, com un botó, juntament amb un data-target="#foo"
o href="#foo"
per orientar un modal específic per alternar.
Truqueu a un modal amb id myModal
amb una sola línia de JavaScript:
Les opcions es poden passar mitjançant atributs de dades o JavaScript. Per als atributs de dades, afegiu el nom de l'opció a data-
, com a data-backdrop=""
.
Nom | tipus | per defecte | descripció |
---|---|---|---|
teló de fons | booleà o la cadena'static' |
veritat | Inclou un element de fons modal. Alternativament, especifiqueu static un teló de fons que no tanqui el modal en fer clic. |
teclat | booleà | veritat | Tanca el modal quan es prem la tecla d'escapament |
espectacle | booleà | veritat | Mostra el modal quan s'inicialitza. |
remot | Camí | fals | Aquesta opció està obsoleta des de la v3.3.0 i s'ha eliminat a la v4. En lloc d'això, recomanem que utilitzeu una plantilla del costat del client o un marc d'enllaç de dades, o que truqueu vosaltres mateixos a jQuery.load . Si es proporciona un URL remot, el contingut es carregarà una vegada mitjançant el mètode de jQuery |
.modal(options)
Activa el teu contingut com a modal. Accepta opcions opcionals object
.
.modal('toggle')
Commuta manualment un modal. Torna a la persona que truca abans que el modal s'hagi mostrat o amagat (és a dir, abans que es produeixi l'esdeveniment shown.bs.modal
o ).hidden.bs.modal
.modal('show')
Obre manualment un modal. Torna a la persona que truca abans que s'hagi mostrat realment el modal (és a dir, abans shown.bs.modal
que es produeixi l'esdeveniment).
.modal('hide')
Amaga manualment un modal. Torna a la persona que truca abans que el modal s'hagi amagat (és a dir, abans hidden.bs.modal
que es produeixi l'esdeveniment).
.modal('handleUpdate')
Reajusta el posicionament del modal per contrarestar una barra de desplaçament en cas que n'hagués d'aparèixer, cosa que faria que el modal salti cap a l'esquerra.
Només cal quan l'alçada del modal canvia mentre està obert.
La classe modal de Bootstrap exposa alguns esdeveniments per connectar-se a la funcionalitat modal.
Tots els esdeveniments modals es desencadenen al propi modal (és a dir, al <div class="modal">
).
Tipus d'esdeveniment | Descripció |
---|---|
show.bs.modal | Aquest esdeveniment s'activa immediatament quan show es crida al mètode d'instància. Si és causat per un clic, l'element clicat està disponible com a relatedTarget propietat de l'esdeveniment. |
mostrat.bs.modal | Aquest esdeveniment s'activa quan el modal s'ha fet visible per a l'usuari (esperarà que finalitzin les transicions CSS). Si és causat per un clic, l'element clicat està disponible com a relatedTarget propietat de l'esdeveniment. |
ocultar.bs.modal | Aquest esdeveniment s'activa immediatament quan hide s'ha cridat el mètode d'instància. |
hidden.bs.modal | Aquest esdeveniment s'activa quan el modal s'ha acabat d'ocultar a l'usuari (esperarà que finalitzin les transicions CSS). |
carregat.bs.modal | Aquest esdeveniment s'activa quan el modal ha carregat contingut mitjançant l' remote opció. |
Afegiu menús desplegables a gairebé qualsevol cosa amb aquest connector senzill, incloses la barra de navegació, les pestanyes i les píndoles.
Mitjançant atributs de dades o JavaScript, el connector desplegable alterna el contingut ocult (menús desplegables) canviant la .open
classe a l'element de la llista principal.
Als dispositius mòbils, l'obertura d'un menú desplegable afegeix una .dropdown-backdrop
àrea de toc per tancar els menús desplegables quan toqueu fora del menú, un requisit per a un suport adequat per a iOS. Això vol dir que canviar d'un menú desplegable obert a un menú desplegable diferent requereix un toc addicional al mòbil.
Nota: l' data-toggle="dropdown"
atribut es basa per tancar menús desplegables a nivell d'aplicació, per la qual cosa és una bona idea utilitzar-lo sempre.
Afegeix data-toggle="dropdown"
a un enllaç o un botó per canviar un menú desplegable.
Per mantenir intactes els URL amb els botons d'enllaç, utilitzeu l' data-target
atribut en lloc de href="#"
.
Truqueu als menús desplegables mitjançant JavaScript:
data-toggle="dropdown"
encara requeritIndependentment de si truqueu al vostre menú desplegable mitjançant JavaScript o utilitzeu l'api de dades, data-toggle="dropdown"
sempre cal que estigui present a l'element activador del menú desplegable.
Cap
$().dropdown('toggle')
Activa o desactiva el menú desplegable d'una barra de navegació determinada o de la navegació per pestanyes.
Tots els esdeveniments desplegables es desencadenen a l' .dropdown-menu
element pare de '.
Tots els esdeveniments desplegables tenen una relatedTarget
propietat, el valor de la qual és l'element d'ancoratge alternatiu.
Tipus d'esdeveniment | Descripció |
---|---|
desplegable.show.bs | Aquest esdeveniment s'activa immediatament quan es crida al mètode d'instància de mostra. |
desplegable.bs.mostrat | Aquest esdeveniment s'activa quan el desplegable s'ha fet visible per a l'usuari (esperarà que finalitzin les transicions CSS). |
llista desplegable hide.bs | Aquest esdeveniment s'activa immediatament quan s'ha cridat el mètode d'instància oculta. |
desplegable.bs.ocult | Aquest esdeveniment s'activa quan el menú desplegable s'ha acabat d'ocultar a l'usuari (esperarà que finalitzin les transicions CSS). |
El connector ScrollSpy serveix per actualitzar automàticament els objectius de navegació en funció de la posició del desplaçament. Desplaceu-vos per l'àrea de sota de la barra de navegació i observeu el canvi de classe activa. També es destacaran els subelements desplegables.
Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi abans que s'esgotin qui. Tumblr drets de la bicicleta de la granja a la taula qualsevol. Anim keffiyeh carles cardigan. Velit seitan mcsweeney's photo booth 3 llop lluna irure. Suèter Cosby pantalons curts de texans lomo, dessuadora amb caputxa de williamsburg mínim qui probablement no n'has sentit a parlar i cardigan trust fund culpa biodièsel wes anderson estètica. Nihil tatuat acusamus, cred ironia biodièsel keffiyeh artesà ullamco consequat.
Veniam marfa bigoti monopatí, adipisicing fugiat velit pitchfork beard. Freegan beard aliqua cupidatat mcsweeney's vero. Cupidatat four loko nisi, ea helvetica nulla carles. Camió de menjar amb jersei cosby tatuat, vinil quis no freegan de mcsweeney. Lo-fi wes anderson +1 sartorial. Carles no exercici estètic quis gentrify. Brooklyn adipisicing cervesa artesana vice keytar desert.
Occaecat commodo aliqua delectus. Fap cervesa artesana deserunt monopatí ea. Lomo bicycle rights adipisicing banh mi, velit ea are next level locavore single-origin coffee in magna veniam. High life id vinyl, echo park consequat quis aliquip banh mi pitchfork. Vero VHS és adipisicing. Consectetur nisi DIY minim messenger bag. Cred ex in, delectus sostenible 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 whatever delectus food truck. Sapiente synth id assumenda. Locavore sed helvetica clixé ironia, thundercats probablement no n'hagueu sentit a parlar consequat hoodie sense gluten lo-fi fap aliquip. Treballa el lloc abans que s'esgotin, terry richardson proident brunch no s'ha d'aconseguir un jersei cosby igual que un artesà helvètic. Cardigan cervesa artesana seitan readymade velit. VHS cambray laboris tempor veniam. Anim mollit minim commodo ullamco thundercats.
Els enllaços de la barra de navegació han de tenir objectius d'identificació resolubles. Per exemple, un <a href="#home">home</a>
ha de correspondre a alguna cosa al DOM com <div id="home"></div>
.
:visible
ignorat els elements no objectiuEls elements de destinació que no siguin :visible
segons jQuery s'ignoraran i els seus elements de navegació corresponents no es ressaltaran mai.
Independentment del mètode d'implementació, scrollspy requereix l'ús de position: relative;
l'element que esteu espiant. En la majoria dels casos aquest és el <body>
. Quan feu una exploració de desplaçaments en elements diferents de <body>
, assegureu-vos de tenir un height
conjunt i overflow-y: scroll;
aplicar.
Per afegir fàcilment un comportament scrollspy a la vostra navegació de la barra superior, afegiu data-spy="scroll"
-lo a l'element que voleu espiar (normalment seria el <body>
). A continuació, afegiu l' data-target
atribut amb l'ID o la classe de l'element pare de qualsevol .nav
component Bootstrap.
Després d'afegir position: relative;
el vostre CSS, truqueu al scrollspy mitjançant JavaScript:
.scrollspy('refresh')
Quan utilitzeu scrollspy juntament amb l'addició o eliminació d'elements del DOM, haureu de cridar el mètode d'actualització de la següent manera:
Les opcions es poden passar mitjançant atributs de dades o JavaScript. Per als atributs de dades, afegiu el nom de l'opció a data-
, com a data-offset=""
.
Nom | tipus | per defecte | descripció |
---|---|---|---|
compensació | nombre | 10 | Píxels a compensar des de la part superior quan es calcula la posició del desplaçament. |
Tipus d'esdeveniment | Descripció |
---|---|
activate.bs.scrollspy | Aquest esdeveniment s'activa cada vegada que el scrollspy activa un element nou. |
Afegiu una funcionalitat de pestanyes ràpida i dinàmica per passar pels panells de contingut local, fins i tot mitjançant menús desplegables. Les pestanyes imbricades no s'admeten.
Denim cru, probablement no has sentit parlar d'ells, Austin. Nesciunt tofu stumptown aliqua, neteja mestre de sintetitzadors retro. Mustache cliche tempor, williamsburg carles vegan helvetica. Rerehenderit butcher retro keffiyeh dreamcatcher synth. Cosby sweater 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.
Aquest connector amplia el component de navegació amb pestanyes per afegir àrees amb pestanyes.
Activa les pestanyes amb tabulació mitjançant JavaScript (cada pestanya s'ha d'activar individualment):
Podeu activar pestanyes individuals de diverses maneres:
Podeu activar una navegació de pestanyes o píndoles sense escriure cap JavaScript simplement especificant data-toggle="tab"
o data-toggle="pill"
en un element. Si afegiu les classes nav
i a la pestanya s'aplicarà l' estil de la pestanya Bootstrap , mentre que si afegiu les classes i s'aplicarà l' estil de la pastilla .nav-tabs
ul
nav
nav-pills
Per fer que les pestanyes s'esvaeixin, afegiu .fade
-les a cadascuna .tab-pane
. El primer panell de pestanyes també ha .in
de fer visible el contingut inicial.
$().tab
Activa un element de pestanya i un contenidor. La pestanya hauria de tenir un node de contenidor data-target
o una href
orientació al DOM. En els exemples anteriors, les pestanyes són la <a>
s amb data-toggle="tab"
atributs.
.tab('show')
Selecciona la pestanya donada i mostra el seu contingut associat. Qualsevol altra pestanya que s'hagi seleccionat anteriorment es desactiva i el seu contingut associat s'amaga. Torna a la persona que truca abans que s'hagi mostrat realment el panell de pestanyes (és a dir, abans shown.bs.tab
que es produeixi l'esdeveniment).
Quan es mostra una pestanya nova, els esdeveniments es desencadenen en l'ordre següent:
hide.bs.tab
(a la pestanya activa actual)show.bs.tab
(a la pestanya per mostrar)hidden.bs.tab
(a la pestanya activa anterior, la mateixa que per a l' hide.bs.tab
esdeveniment)shown.bs.tab
(a la pestanya recentment activa que s'acaba de mostrar, la mateixa que per a l' show.bs.tab
esdeveniment)Si no hi havia cap pestanya activa, els esdeveniments hide.bs.tab
i hidden.bs.tab
no s'activaran.
Tipus d'esdeveniment | Descripció |
---|---|
mostrar.bs.tab | Aquest esdeveniment s'activa a la pestanya mostra, però abans que s'hagi mostrat la nova pestanya. Utilitzeu event.target i event.relatedTarget per orientar la pestanya activa i la pestanya activa anterior (si està disponible) respectivament. |
pestanya.bs.mostrada | Aquest esdeveniment s'activa a la mostra de pestanyes després que s'hagi mostrat una pestanya. Utilitzeu event.target i event.relatedTarget per orientar la pestanya activa i la pestanya activa anterior (si està disponible) respectivament. |
ocultar.bs.tab | Aquest esdeveniment s'activa quan s'ha de mostrar una pestanya nova (i, per tant, s'ha d'amagar la pestanya activa anterior). Utilitzeu event.target i event.relatedTarget per orientar la pestanya activa actual i la nova pestanya que s'activarà aviat, respectivament. |
hidden.bs.tab | Aquest esdeveniment s'activa després que es mostri una pestanya nova (i, per tant, s'amaga la pestanya activa anterior). Utilitzeu event.target i event.relatedTarget per orientar la pestanya activa anterior i la nova pestanya activa, respectivament. |
Inspirat en l'excel·lent connector jQuery.tipsy escrit per Jason Frame; Els consells sobre eines són una versió actualitzada, que no es basen en imatges, utilitza CSS3 per a animacions i atributs de dades per a l'emmagatzematge de títols locals.
Els consells sobre eines amb títols de longitud zero no es mostren mai.
Passeu el cursor per sobre dels enllaços següents per veure els consells sobre eines:
Pantalons ajustats keffiyeh del següent nivell , probablement no n'hagueu sentit a parlar. Photo Booth barba denim cru tipografia bossa de missatgeria vegana stumptown. Seitan de granja a taula, la roba americana de quinoa sostenible de 8 bits fixie de mcsweeney té un cambray de vinil terry richardson. Beard stumptown, cardigans banh mi lomo thundercats. Tofu biodièsel williamsburg marfa, quatre loko mcsweeney's cleanse vegan chambray. Un artesà realment irònic , sigui quin sigui el keytar , scenester farm-to-table banksy Austin twitter handle freegan cred raw denim cafè d'origen únic viral.
Hi ha quatre opcions disponibles: superior, dreta, inferior i alineada a l'esquerra.
Per motius de rendiment, les apis de dades d'informació sobre eines i popover estan activades, és a dir, les heu d'iniciar vosaltres mateixos .
Una manera d'iniciar tots els consells d'eines d'una pàgina seria seleccionar-los pel seu data-toggle
atribut:
El connector d'informació sobre eines genera contingut i marques sota demanda i, per defecte, col·loca els consells sobre eines després del seu element activador.
Activa la informació sobre eines mitjançant JavaScript:
L'etiquetatge necessari per a una informació sobre eines és només un data
atribut i title
a l'element HTML voleu tenir una informació sobre eines. El marcatge generat d'una informació sobre eines és bastant senzill, tot i que requereix una posició (per defecte, establerta top
pel connector).
De vegades, voleu afegir una informació sobre eines a un hiperenllaç que embolica diverses línies. El comportament predeterminat del complement d'informació eines és centrar-lo horitzontalment i verticalment. Afegiu white-space: nowrap;
-hi els vostres ancoratges per evitar-ho.
Quan utilitzeu consells sobre elements dins d'un .btn-group
o d'un .input-group
, o en elements relacionats amb la taula ( <td>
, <th>
, <tr>
, <thead>
, <tbody>
, <tfoot>
), haureu d'especificar l'opció container: 'body'
(documentada a continuació) per evitar efectes secundaris no desitjats (com ara que l'element creixi i/o o perdent les seves cantonades arrodonides quan s'activa la informació sobre eines).
Per als usuaris que naveguen amb un teclat i, en particular, els usuaris de tecnologies d'assistència, només hauríeu d'afegir informació sobre eines als elements enfocats al teclat, com ara enllaços, controls de formulari o qualsevol element arbitrari amb un tabindex="0"
atribut.
Per afegir una informació sobre eines a un element disabled
o .disabled
, col·loqueu l'element dins de a <div>
i apliqueu-hi la informació sobre eines <div>
.
Les opcions es poden passar mitjançant atributs de dades o JavaScript. Per als atributs de dades, afegiu el nom de l'opció a data-
, com a data-animation=""
.
Tingueu en compte que, per raons de seguretat, les opcions sanitize
, sanitizeFn
i whiteList
no es poden proporcionar mitjançant atributs de dades.
Nom | Tipus | Per defecte | Descripció |
---|---|---|---|
animació | booleà | veritat | Apliqueu una transició d'esvaïment CSS a la informació sobre eines |
contenidor | cadena | fals | fals | Afegeix la informació sobre eines a un element específic. Exemple: |
retard | nombre | objecte | 0 | Retard per mostrar i amagar la informació sobre eines (ms): no s'aplica al tipus d'activador manual Si es proporciona un número, s'aplica un retard tant per ocultar com per mostrar L'estructura de l'objecte és: |
html | booleà | fals | Inseriu HTML a la informació sobre eines. Si és fals, text s'utilitzarà el mètode de jQuery per inserir contingut al DOM. Utilitzeu text si us preocupen els atacs XSS. |
col·locació | cadena | funció | 'superior' | Com posicionar la informació sobre eines - superior | baix | esquerra | dreta | automàtic. Quan s'utilitza una funció per determinar la ubicació, es crida amb el node DOM d'informació eines com a primer argument i el node DOM de l'element activador com a segon. El |
selector | corda | fals | Si es proporciona un selector, els objectes d'informació eines es delegaran als objectius especificats. A la pràctica, això també s'utilitza per aplicar informació sobre eines als elements DOM afegits dinàmicament ( jQuery.on suport). Vegeu això i un exemple informatiu . |
plantilla | corda | '<div class="tooltip" role="tooltip"><div class="tooltip-arrow"></div><div class="tooltip-inner"></div></div>' |
HTML base que s'ha d'utilitzar en crear la informació sobre eines. La informació sobre eines
L'element d'embolcall més extern hauria de tenir la |
títol | cadena | funció | '' | Valor del títol predeterminat si Si es dóna una funció, es cridarà amb la seva |
disparador | corda | 'enfocament al ratolí' | Com s'activa la informació sobre eines - feu clic a | flotar | focus | manual. Podeu passar múltiples activadors; separeu-los amb un espai. manual no es pot combinar amb cap altre activador. |
mirador | cadena | objecte | funció | { selector: 'cos', farciment: 0 } | Manté la informació sobre eines dins dels límits d'aquest element. Exemple: Si es dóna una funció, es crida amb l'element desencadenant node DOM com a únic argument. El |
desinfectar | booleà | veritat | Activa o desactiva la desinfecció. Si està activat 'template' , 'content' i 'title' les opcions es desinfectaran. |
llista blanca | objecte | Valor per defecte | Objecte que conté atributs i etiquetes permesos |
desinfectarFn | nul | funció | nul | Aquí podeu proporcionar la vostra pròpia funció de desinfecció. Això pot ser útil si preferiu utilitzar una biblioteca dedicada per realitzar la desinfecció. |
Les opcions per als consells d'eines individuals es poden especificar alternativament mitjançant l'ús d'atributs de dades, tal com s'ha explicat anteriorment.
$().tooltip(options)
Adjunta un controlador d'informació eines a una col·lecció d'elements.
.tooltip('show')
Revela la informació sobre eines d'un element. Torna a la persona que truca abans que s'hagi mostrat realment la informació sobre eines (és a dir, abans shown.bs.tooltip
que es produeixi l'esdeveniment). Això es considera una activació "manual" de la informació sobre eines. Els consells sobre eines amb títols de longitud zero no es mostren mai.
.tooltip('hide')
Amaga la informació sobre eines d'un element. Torna a la persona que truca abans que la informació sobre eines s'hagi amagat (és a dir, abans hidden.bs.tooltip
que es produeixi l'esdeveniment). Això es considera una activació "manual" de la informació sobre eines.
.tooltip('toggle')
Commuta la informació sobre eines d'un element. Torna a la persona que truca abans que s'hagi mostrat o amagat la informació sobre eines (és a dir, abans que es produeixi l'esdeveniment shown.bs.tooltip
o ). hidden.bs.tooltip
Això es considera una activació "manual" de la informació sobre eines.
.tooltip('destroy')
Amaga i destrueix la informació sobre eines d'un element. Els consells sobre eines que utilitzen la delegació (que es creen amb l' selector
opció ) no es poden destruir individualment en elements activadors descendents.
Tipus d'esdeveniment | Descripció |
---|---|
mostrar.bs.informació-eina | Aquest esdeveniment s'activa immediatament quan show es crida al mètode d'instància. |
indicació.bs.mostrada | Aquest esdeveniment s'activa quan la informació sobre eines s'ha fet visible per a l'usuari (esperarà que finalitzin les transicions CSS). |
ocultar.bs.tooltip | Aquest esdeveniment s'activa immediatament quan hide s'ha cridat el mètode d'instància. |
hidden.bs.tooltip | Aquest esdeveniment s'activa quan la informació sobre eines s'ha acabat d'ocultar per a l'usuari (esperarà que finalitzin les transicions CSS). |
informació.bs.inserida | Aquest esdeveniment s'activa després de l' show.bs.tooltip esdeveniment quan s'ha afegit la plantilla d'informació eines al DOM. |
Afegiu petites superposicions de contingut, com les de l'iPad, a qualsevol element per allotjar informació secundària.
Les finestres emergents tant el títol com el contingut són de longitud zero mai es mostren.
Els popovers requereixen que el connector d'informació eines s'inclogui a la vostra versió de Bootstrap.
Per motius de rendiment, les apis de dades d'informació sobre eines i popover estan activades, és a dir, les heu d'iniciar vosaltres mateixos .
Una manera d'inicialitzar totes les finestres emergents d'una pàgina seria seleccionar-les pel seu data-toggle
atribut:
Quan utilitzeu finestres emergents en elements dins d'un .btn-group
o d'un .input-group
, o en elements relacionats amb la taula ( <td>
, <th>
, <tr>
, <thead>
, <tbody>
, <tfoot>
), haureu d'especificar l'opció container: 'body'
(documentada a continuació) per evitar efectes secundaris no desitjats (com ara que l'element creixi i/o o perdent les seves cantonades arrodonides quan s'activa el popover).
Per afegir un popover a un element disabled
o .disabled
, col·loqueu l'element dins de a <div>
i apliqueu-hi el popover <div>
.
De vegades, voleu afegir una finestra emergent a un hiperenllaç que embolcalla diverses línies. El comportament predeterminat del connector emergent és centrar-lo horitzontalment i verticalment. Afegiu white-space: nowrap;
-hi els vostres ancoratges per evitar-ho.
Hi ha quatre opcions disponibles: superior, dreta, inferior i alineada a l'esquerra.
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pel·lentesc ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pel·lentesc ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pel·lentesc ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pel·lentesc ornare sem lacinia quam venenatis vestibulum.
Utilitzeu el focus
disparador per descartar popovers al següent clic que faci l'usuari.
Per a un comportament adequat entre navegadors i plataformes, heu d'utilitzar l' <a>
etiqueta, no l' <button>
etiqueta, i també heu d'incloure els atributs role="button"
i .tabindex
Activa les finestres emergents mitjançant JavaScript:
Les opcions es poden passar mitjançant atributs de dades o JavaScript. Per als atributs de dades, afegiu el nom de l'opció a data-
, com a data-animation=""
.
Tingueu en compte que, per raons de seguretat, les opcions sanitize
, sanitizeFn
i whiteList
no es poden proporcionar mitjançant atributs de dades.
Nom | Tipus | Per defecte | Descripció |
---|---|---|---|
animació | booleà | veritat | Apliqueu una transició d'esvaïment CSS al popover |
contenidor | cadena | fals | fals | Afegeix la finestra emergent a un element específic. Exemple: |
contingut | cadena | funció | '' | Valor de contingut predeterminat si Si es dóna una funció, s'anomenarà amb la seva |
retard | nombre | objecte | 0 | Retard per mostrar i amagar la finestra emergent (ms): no s'aplica al tipus d'activador manual Si es proporciona un número, s'aplica un retard tant per ocultar com per mostrar L'estructura de l'objecte és: |
html | booleà | fals | Inseriu HTML a la finestra emergent. Si és fals, text s'utilitzarà el mètode de jQuery per inserir contingut al DOM. Utilitzeu text si us preocupen els atacs XSS. |
col·locació | cadena | funció | 'dret' | Com posicionar el popover - superior | baix | esquerra | dreta | automàtic. Quan s'utilitza una funció per determinar la ubicació, es crida amb el node DOM emergent com a primer argument i el node DOM de l'element activador com a segon. El |
selector | corda | fals | Si es proporciona un selector, els objectes emergents es delegaran als objectius especificats. A la pràctica, això s'utilitza per permetre que el contingut HTML dinàmic s'afegeixi popovers. Vegeu això i un exemple informatiu . |
plantilla | corda | '<div class="popover" role="tooltip"><div class="arrow"></div><h3 class="popover-title"></h3><div class="popover-content"></div></div>' |
HTML base per utilitzar quan es crea el popover. Els popover's Els popover's
L'element d'embolcall més extern hauria de tenir la |
títol | cadena | funció | '' | Valor del títol predeterminat si Si es dóna una funció, s'anomenarà amb la seva |
disparador | corda | 'clic' | Com s'activa el popover - feu clic a | flotar | focus | manual. Podeu passar múltiples activadors; separeu-los amb un espai. manual no es pot combinar amb cap altre activador. |
mirador | cadena | objecte | funció | { selector: 'cos', farciment: 0 } | Manté el popover dins dels límits d'aquest element. Exemple: Si es dóna una funció, es crida amb l'element desencadenant node DOM com a únic argument. El |
desinfectar | booleà | veritat | Activa o desactiva la desinfecció. Si està activat 'template' , 'content' i 'title' les opcions es desinfectaran. |
llista blanca | objecte | Valor per defecte | Objecte que conté atributs i etiquetes permesos |
desinfectarFn | nul | funció | nul | Aquí podeu proporcionar la vostra pròpia funció de desinfecció. Això pot ser útil si preferiu utilitzar una biblioteca dedicada per realitzar la desinfecció. |
Les opcions per a popovers individuals es poden especificar alternativament mitjançant l'ús d'atributs de dades, tal com s'ha explicat anteriorment.
$().popover(options)
Inicialitza les finestres emergents per a una col·lecció d'elements.
.popover('show')
Revela el popover d'un element. Torna a la persona que truca abans que s'hagi mostrat realment el popover (és a dir, abans shown.bs.popover
que es produeixi l'esdeveniment). Això es considera una activació "manual" del popover. Les finestres emergents tant el títol com el contingut són de longitud zero mai es mostren.
.popover('hide')
Amaga la finestra emergent d'un element. Torna a la persona que truca abans que el popover s'hagi amagat (és a dir, abans hidden.bs.popover
que es produeixi l'esdeveniment). Això es considera una activació "manual" del popover.
.popover('toggle')
Activa o desactiva la finestra emergent d'un element. Torna a la persona que truca abans que el popover s'hagi mostrat o amagat (és a dir, abans que es produeixi l'esdeveniment shown.bs.popover
o ). hidden.bs.popover
Això es considera una activació "manual" del popover.
.popover('destroy')
Amaga i destrueix el popover d'un element. Els popovers que utilitzen la delegació (que es creen amb l' selector
opció ) no es poden destruir individualment en elements activadors descendents.
Tipus d'esdeveniment | Descripció |
---|---|
show.bs.popover | Aquest esdeveniment s'activa immediatament quan show es crida al mètode d'instància. |
mostrat.bs.popover | Aquest esdeveniment s'activa quan la finestra emergent s'ha fet visible per a l'usuari (esperarà que finalitzin les transicions CSS). |
hide.bs.popover | Aquest esdeveniment s'activa immediatament quan hide s'ha cridat el mètode d'instància. |
hidden.bs.popover | Aquest esdeveniment s'activa quan la finestra emergent s'ha acabat d'ocultar per a l'usuari (esperarà que finalitzin les transicions CSS). |
inserit.bs.popover | Aquest esdeveniment s'activa després de l' show.bs.popover esdeveniment quan s'ha afegit la plantilla popover al DOM. |
Afegiu la funcionalitat de descartar a tots els missatges d'alerta amb aquest connector.
Quan s'utilitza un .close
botó, ha de ser el primer fill del .alert-dismissible
i no hi pot haver contingut de text abans de l'etiquetatge.
Canvia això i allò i torna-ho a provar. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.
Només heu d'afegir data-dismiss="alert"
al vostre botó de tancament per donar automàticament una funcionalitat de tancament d'alerta. Tancar una alerta l'elimina del DOM.
Perquè les vostres alertes facin servir l'animació en tancar, assegureu-vos que ja tinguin les classes .fade
i aplicades..in
$().alert()
Fa que una alerta escolti els esdeveniments de clic als elements descendents que tenen l' data-dismiss="alert"
atribut. (No és necessari quan s'utilitza l'inicialització automàtica de l'api de dades.)
$().alert('close')
Tanca una alerta eliminant-la del DOM. Si el .fade
i.in
estan presents a l'element, l'alerta s'esvairà abans que s'elimini.
El connector d'alerta de Bootstrap exposa alguns esdeveniments per connectar-se a la funcionalitat d'alerta.
Tipus d'esdeveniment | Descripció |
---|---|
tancar.bs.alerta | Aquest esdeveniment s'activa immediatament quan close es crida al mètode d'instància. |
tancat.bs.alerta | Aquest esdeveniment s'activa quan l'alerta s'ha tancat (esperarà que finalitzin les transicions CSS). |
Fes més amb els botons. Controla els estats dels botons o crea grups de botons per a més components com ara barres d'eines.
El Firefox manté els estats de control de formularis (desactivació i verificació) durant les càrregues de la pàgina . Una solució alternativa és utilitzar autocomplete="off"
. Vegeu l'error de Mozilla #654072 .
Afegeix data-loading-text="Loading..."
per utilitzar un estat de càrrega en un botó.
Aquesta funció està obsoleta des de la v3.3.5 i s'ha eliminat a la v4.
Pel bé d'aquesta demostració, estem utilitzant data-loading-text
i $().button('loading')
, però aquest no és l'únic estat que podeu utilitzar. Vegeu més sobre això a continuació a la $().button(string)
documentació .
Afegeix data-toggle="button"
per activar la commutació en un sol botó.
.active
iaria-pressed="true"
Per als botons pre-alternats, heu d'afegir la .active
classe i l' aria-pressed="true"
atribut a button
vosaltres mateixos.
Afegiu data-toggle="buttons"
-hi una .btn-group
casella de selecció o entrades de ràdio per activar la commutació dels seus respectius estils.
.active
Per a les opcions preseleccionades, heu d'afegir la .active
classe a l'entrada label
.
Si l'estat marcat d'un botó de casella de selecció s'actualitza sense activar un click
esdeveniment al botó (per exemple, mitjançant <input type="reset">
o mitjançant la configuració de la checked
propietat de l'entrada), haureu de canviar la .active
classe a l'entrada label
.
$().button('toggle')
Commuta l'estat push. Dóna al botó l'aspecte que s'ha activat.
$().button('reset')
Restableix l'estat del botó: canvia el text pel text original. Aquest mètode és asíncron i torna abans que s'hagi completat el restabliment.
$().button(string)
Canvia el text a qualsevol estat de text definit amb dades.
Connector flexible que utilitza un grapat de classes per a un comportament fàcil de canviar.
Collapse requereix que el connector de transicions s'inclogui a la vostra versió de Bootstrap.
Feu clic als botons següents per mostrar i amagar un altre element mitjançant els canvis de classe:
.collapse
amaga contingut.collapsing
s'aplica durant les transicions.collapse.in
mostra contingutPodeu utilitzar un enllaç amb l' href
atribut o un botó amb l' data-target
atribut. En ambdós casos, data-toggle="collapse"
és necessari.
Amplieu el comportament de col·lapse predeterminat per crear un acordió amb el component del panell.
També és possible canviar .panel-body
s per .list-group
s.
Assegureu-vos d'afegir aria-expanded
a l'element de control. Aquest atribut defineix explícitament l'estat actual de l'element plegable per als lectors de pantalla i tecnologies d'assistència similars. Si l'element plegable es tanca per defecte, hauria de tenir un valor de aria-expanded="false"
. Si heu configurat l'element plegable perquè estigui obert de manera predeterminada mitjançant la in
classe, configureu aria-expanded="true"
-lo al control. El connector canviarà automàticament aquest atribut en funció de si l'element plegable s'ha obert o tancat o no.
A més, si el vostre element de control està orientat a un sol element plegable, és a dir, l' data-target
atribut apunta a un id
selector, podeu afegir un aria-controls
atribut addicional a l'element de control, que contingui l' id
element plegable. Els lectors de pantalla moderns i tecnologies d'assistència similars fan ús d'aquest atribut per oferir als usuaris dreceres addicionals per navegar directament a l'element plegable.
El connector de col·lapse utilitza unes quantes classes per gestionar el treball pesat:
.collapse
amaga el contingut.collapse.in
mostra el contingut.collapsing
s'afegeix quan comença la transició i s'elimina quan s'acabaAquestes classes es poden trobar a component-animations.less
.
Només cal afegir data-toggle="collapse"
i a data-target
a l'element per assignar automàticament el control d'un element plegable. L' data-target
atribut accepta un selector CSS al qual aplicar el col·lapse. Assegureu-vos d'afegir la classe collapse
a l'element plegable. Si voleu que s'obri per defecte, afegiu la classe addicional in
.
Per afegir una gestió de grups semblant a un acordió a un control plegable, afegiu l'atribut de dades data-parent="#selector"
. Consulteu la demostració per veure-ho en acció.
Habilita manualment amb:
Les opcions es poden passar mitjançant atributs de dades o JavaScript. Per als atributs de dades, afegiu el nom de l'opció a data-
, com a data-parent=""
.
Nom | tipus | per defecte | descripció |
---|---|---|---|
pare | selector | fals | Si es proporciona un selector, tots els elements plegables sota el pare especificat es tancaran quan es mostri aquest element plegable. (semblant al comportament d'acordió tradicional - això depèn de la panel classe) |
alternar | booleà | veritat | Activa o desactiva l'element plegable en invocació |
.collapse(options)
Activa el teu contingut com a element plegable. Accepta opcions opcionals object
.
.collapse('toggle')
Commuta un element plegable per mostrar-lo o amagar-lo. Torna a la persona que truca abans que l'element plegable s'hagi mostrat o amagat (és a dir, abans que es produeixi l'esdeveniment shown.bs.collapse
o ).hidden.bs.collapse
.collapse('show')
Mostra un element plegable. Torna a la persona que truca abans que s'hagi mostrat realment l'element plegable (és a dir, abans shown.bs.collapse
que es produeixi l'esdeveniment).
.collapse('hide')
Amaga un element plegable. Torna a la persona que truca abans que l'element plegable s'hagi amagat (és a dir, abans hidden.bs.collapse
que es produeixi l'esdeveniment).
La classe de col·lapse de Bootstrap exposa alguns esdeveniments per connectar-se a la funcionalitat de col·lapse.
Tipus d'esdeveniment | Descripció |
---|---|
show.bs.collapse | Aquest esdeveniment s'activa immediatament quan show es crida al mètode d'instància. |
mostrat.bs.collapse | Aquest esdeveniment s'activa quan un element de col·lapse s'ha fet visible per a l'usuari (esperarà que finalitzin les transicions CSS). |
ocultar.bs.collapse | Aquest esdeveniment s'activa immediatament quan hide s'ha cridat el mètode. |
hidden.bs.collapse | Aquest esdeveniment s'activa quan un element de col·lapse s'ha amagat per a l'usuari (esperarà que finalitzin les transicions CSS). |
Un component de presentació de diapositives per circular per elements, com un carrusel. Els carrusels imbricats no s'admeten.
En general, el component del carrusel no compleix els estàndards d'accessibilitat. Si heu de complir, considereu altres opcions per presentar el vostre contingut.
Bootstrap utilitza exclusivament CSS3 per a les seves animacions, però Internet Explorer 8 i 9 no admeten les propietats CSS necessàries. Per tant, no hi ha animacions de transició de diapositives quan s'utilitzen aquests navegadors. Hem decidit intencionadament no incloure alternatives basades en jQuery per a les transicions.
La .active
classe s'ha d'afegir a una de les diapositives. En cas contrari, el carrusel no serà visible.
Les classes .glyphicon .glyphicon-chevron-left
i .glyphicon .glyphicon-chevron-right
no són necessàriament necessàries per als controls. Bootstrap proporciona .icon-prev
i .icon-next
com a alternatives Unicode senzilles.
Afegiu subtítols a les vostres diapositives fàcilment amb l' .carousel-caption
element de qualsevol .item
. Col·loqueu gairebé qualsevol HTML opcional allà dins i s'alinearà i formatarà automàticament.
Els carrusels requereixen l'ús d'un id
contenidor a l'exterior (el .carousel
) perquè els controls del carrusel funcionin correctament. Quan afegiu diversos carrusels o quan canvieu un carrusel id
, assegureu-vos d'actualitzar els controls pertinents.
Utilitzeu atributs de dades per controlar fàcilment la posició del carrusel. data-slide
accepta les paraules clau prev
o next
, que altera la posició de la diapositiva en relació a la seva posició actual. Alternativament, utilitzeu data-slide-to
per passar un índex de diapositives en brut al carrusel data-slide-to="2"
, que canvia la posició de la diapositiva a un índex concret que comença per 0
.
L' data-ride="carousel"
atribut s'utilitza per marcar un carrusel com a animador a partir de la càrrega de la pàgina. No es pot utilitzar en combinació amb la inicialització explícita de JavaScript (redundant i innecessària) del mateix carrusel.
Truqueu manualment al carrusel amb:
Les opcions es poden passar mitjançant atributs de dades o JavaScript. Per als atributs de dades, afegiu el nom de l'opció a data-
, com a data-interval=""
.
Nom | tipus | per defecte | descripció |
---|---|---|---|
interval | nombre | 5000 | La quantitat de temps per retardar entre el cicle automàtic d'un element. Si és fals, el carrusel no girarà automàticament. |
pausa | cadena | nul | "passar el ratolí" | Si s'estableix en "hover" , posa en pausa el cicle del carrusel encès mouseenter i reprèn el cicle del carrusel encès mouseleave . Si s'estableix en null , passar el cursor per sobre del carrusel no el posarà en pausa. |
embolicar | booleà | veritat | Si el carrusel ha de circular contínuament o tenir parades dures. |
teclat | booleà | veritat | Si el carrusel ha de reaccionar als esdeveniments del teclat. |
.carousel(options)
Inicialitza el carrusel amb opcions opcionals object
i comença a circular pels elements.
.carousel('cycle')
Recorre els elements del carrusel d'esquerra a dreta.
.carousel('pause')
Impedeix que el carrusel circuli per elements.
.carousel(number)
Cicle el carrusel a un fotograma concret (basat en 0, similar a una matriu).
.carousel('prev')
Cicles a l'element anterior.
.carousel('next')
Passa a l'element següent.
La classe de carrusel de Bootstrap exposa dos esdeveniments per connectar-se a la funcionalitat del carrusel.
Tots dos esdeveniments tenen les següents propietats addicionals:
direction
: La direcció en què llisca el carrusel (o "left"
bé "right"
).relatedTarget
: l'element DOM que s'està fent lliscar al seu lloc com a element actiu.Tots els esdeveniments del carrusel es desenvolupen al mateix carrusel (és a dir, al <div class="carousel">
).
Tipus d'esdeveniment | Descripció |
---|---|
slide.bs.carrusel | Aquest esdeveniment s'activa immediatament quan slide s'invoca el mètode d'instància. |
slid.bs.carrusel | Aquest esdeveniment s'activa quan el carrusel ha completat la transició de diapositives. |
El connector d'afix s'activa position: fixed;
i desactiva, emulant l'efecte trobat amb position: sticky;
. La subnavegació de la dreta és una demostració en directe del connector afix.
Utilitzeu el connector afix mitjançant atributs de dades o manualment amb el vostre propi JavaScript.En ambdues situacions, heu de proporcionar CSS per al posicionament i l'amplada del vostre contingut col·locat.
Nota: no utilitzeu el connector d'afixos en un element contingut en un element relativament posicionat, com ara una columna estirada o empesa, a causa d'un error de representació de Safari .
El connector d'afix alterna entre tres classes, cadascuna representant un estat particular: .affix
, .affix-top
, i .affix-bottom
. Heu de proporcionar els estils, amb l'excepció de position: fixed;
on .affix
, d'aquestes classes vosaltres mateixos (independentment d'aquest connector) per gestionar les posicions reals.
Així és com funciona el connector d'afix:
.affix-top
per indicar que l'element es troba a la seva posició superior. En aquest moment no cal cap posicionament CSS..affix
substitueix .affix-top
i estableix position: fixed;
(proporcionat pel CSS de Bootstrap)..affix
per .affix-bottom
. Com que els desplaçaments són opcionals, establir-ne un requereix que establiu el CSS adequat. En aquest cas, afegir position: absolute;
quan sigui necessari. El connector utilitza l'atribut de dades o l'opció JavaScript per determinar on col·locar l'element des d'allà.Seguiu els passos anteriors per configurar el vostre CSS per a qualsevol de les opcions d'ús següents.
Per afegir fàcilment un comportament d'afixos a qualsevol element, només cal que afegiudata-spy="affix"
-lo a l'element que voleu espiar. Utilitzeu desplaçaments per definir quan s'ha de canviar la fixació d'un element.
Truqueu al connector d'afix mitjançant JavaScript:
Les opcions es poden passar mitjançant atributs de dades o JavaScript. Per als atributs de dades, afegiu el nom de l'opció a data-
, com a data-offset-top="200"
.
Nom | tipus | per defecte | descripció |
---|---|---|---|
compensació | nombre | funció | objecte | 10 | Píxels a compensar de la pantalla en calcular la posició del desplaçament. Si es proporciona un sol número, el desplaçament s'aplicarà tant a la part superior com a la inferior. Per proporcionar un desplaçament únic, inferior i superior, només cal que proporcioneu un objecte offset: { top: 10 } o offset: { top: 10, bottom: 5 } . Utilitzeu una funció quan necessiteu calcular dinàmicament un desplaçament. |
objectiu | selector | node | element jQuery | l' window objecte |
Especifica l'element objectiu de l'afix. |
.affix(options)
Activa el teu contingut com a contingut enganxat. Accepta opcions opcionals object
.
.affix('checkPosition')
Recalcula l'estat de l'afix en funció de les dimensions, la posició i la posició de desplaçament dels elements rellevants. Les classes .affix
, .affix-top
, i .affix-bottom
s'afegeixen o s'eliminen del contingut adjunt segons el nou estat. Aquest mètode s'ha de cridar sempre que es canvien les dimensions del contingut col·locat o de l'element objectiu, per garantir el posicionament correcte del contingut col·locat.
El connector d'afixos de Bootstrap exposa alguns esdeveniments per connectar-vos a la funcionalitat d'afixos.
Tipus d'esdeveniment | Descripció |
---|---|
afix.bs.afix | Aquest esdeveniment s'activa immediatament abans que l'element s'hagi col·locat. |
afixat.bs.afix | Aquest esdeveniment s'activa després de col·locar l'element. |
afix-top.bs.affix | Aquest esdeveniment es dispara immediatament abans que l'element s'hagi fixat a la part superior. |
afixed-top.bs.affix | Aquest esdeveniment s'activa després que l'element s'hagi fixat a la part superior. |
afix-bottom.bs.affix | Aquest esdeveniment s'activa immediatament abans que l'element s'hagi fixat a la part inferior. |
afixed-bottom.bs.affix | Aquest esdeveniment s'activa després que l'element s'hagi fixat a la part inferior. |