Doneu vida als components de Bootstrap, ara amb 13 connectors de jQuery personalitzats.
Els connectors es poden incloure individualment (encara que alguns tenen dependències necessàries) o tots alhora. Tant bootstrap.js com bootstrap.min.js contenen tots els connectors en un sol fitxer.
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 cos amb espai de noms amb `'data-api''. Això es veu així:
- $ ( 'cos' ). apagat ( '.data-api' )
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:
- $ ( 'cos' ). off ( '.alert.data-api' )
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.
- $ ( ".btn.danger" ). botó ( "commutar" ). addClass ( "greix" )
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):
- $ ( "#myModal" ). modal () // inicialitzat amb valors per defecte
- $ ( "#myModal" ). modal ({ keyboard : false }) // inicialitzat sense teclat
- $ ( "#myModal" ). modal ( 'mostrar' ) // inicialitza i invoca show immediatament
Cada connector també exposa el seu constructor en brut en una propietat `Constructor`: $.fn.popover.Constructor
. Si voleu obtenir una instància de connector concreta, recupera-la directament d'un element: $('[rel=popover]').data('popover')
.
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.
- var bootstrapButton = $ . fn . botó . noConflict () // retorna $.fn.button al valor assignat anteriorment
- $ . fn . bootstrapBtn = bootstrapButton // dóna a $().bootstrapBtn la funcionalitat d'arrencada
Bootstrap ofereix esdeveniments personalitzats per a la majoria de les accions úniques del connector. 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ó.
Tots els esdeveniments infinitius proporcionen la funcionalitat preventDefault. Això proporciona la possibilitat d'aturar l'execució d'una acció abans que comenci.
- $ ( '#myModal' ). on ( 'mostrar' , funció ( e ) {
- si (! dades ) retorna e . preventDefault () // deixa de mostrar el modal
- })
Per obtenir efectes de transició senzills, incloeu bootstrap-transition.js una vegada juntament amb els altres fitxers JS. Si utilitzeu el fitxer bootstrap.js compilat (o minificat) , no cal incloure-ho, ja hi és.
Alguns exemples del connector de transició:
Els modals són indicacions de diàleg simplificades, però flexibles amb la funcionalitat mínima necessària i els valors predeterminats intel·ligents.
Un modal representat amb la capçalera, el cos i el conjunt d'accions al peu de pàgina.
Un bon cos...
- <div class = "esvaïment d'ocultació modal" >
- <div class = "capçalera-modal" >
- <button type = "button" class = "tancar" data-dismiss = "modal" aria-hidden = "true" > × </button>
- <h3> Capçalera modal </h3>
- </div>
- <div class = "cos modal" >
- <p> Un bon cos... </p>
- </div>
- <div class = "modal-footer" >
- <a href = "#" class = "btn" > Tanca </a>
- <a href = "#" class = "btn btn-primary" > Desa els canvis </a>
- </div>
- </div>
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.
- <!-- Botó per activar el modal -->
- <a href = "#myModal" role = "button" class = "btn" data-toggle = "modal" > Llança la demostració modal </a>
- <!-- Modal -->
- <div id = "myModal" class = "modal hide fade" tabindex = "-1" role = "dialog" aria-labelledby = "myModalLabel" aria-hidden = "true" >
- <div class = "capçalera-modal" >
- <button type = "button" class = "tancar" data-dismiss = "modal" aria-hidden = "true" > × </button>
- <h3 id = "myModalLabel" > Capçalera modal </h3>
- </div>
- <div class = "cos modal" >
- <p> Un bon cos... </p>
- </div>
- <div class = "modal-footer" >
- <button class = "btn" data-dismiss = "modal" aria-hidden = "true" > Tanca </button>
- <button class = "btn btn-primary" > Desa els canvis </button>
- </div>
- </div>
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.
- <button type = "button" data-toggle = "modal" data-target = "#myModal" > Inicia el modal </button>
Truqueu a un modal amb id myModal
amb una sola línia de JavaScript:
- $ ( '#myModal' ). modal ( opcions )
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à | 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 | Si es proporciona una URL remota, el contingut es carregarà mitjançant el
|
Activa el teu contingut com a modal. Accepta opcions opcionals object
.
- $ ( '#myModal' ). modal ({
- teclat : fals
- })
Commuta manualment un modal.
- $ ( '#myModal' ). modal ( 'alternar' )
Obre manualment un modal.
- $ ( '#myModal' ). modal ( 'mostrar' )
Amaga manualment un modal.
- $ ( '#myModal' ). modal ( 'amagar' )
La classe modal de Bootstrap exposa alguns esdeveniments per connectar-se a la funcionalitat modal.
Esdeveniment | Descripció |
---|---|
espectacle | Aquest esdeveniment s'activa immediatament quan show es crida al mètode d'instància. |
mostrat | Aquest esdeveniment s'activa quan el modal s'ha fet visible per a l'usuari (esperarà que es completin les transicions CSS). |
amagar | Aquest esdeveniment s'activa immediatament quan hide s'ha cridat el mètode d'instància. |
amagat | Aquest esdeveniment s'activa quan el modal s'ha acabat d'ocultar a l'usuari (esperarà que es completin les transicions CSS). |
- $ ( '#myModal' ). on ( 'amagat' , funció () {
- // fer quelcom…
- })
Afegiu menús desplegables a gairebé qualsevol cosa amb aquest connector senzill, incloses la barra de navegació, les pestanyes i les píndoles.
Afegeix data-toggle="dropdown"
a un enllaç o un botó per canviar un menú desplegable.
- <div class = "menú desplegable" >
- <a class = "dropdown-toggle" data-toggle = "dropdown" href = "#" > Activador de desplegable </a>
- <ul class = "menú desplegable" rol = "menú" aria-labelledby = "dLabel" >
- ...
- </ul>
- </div>
Per mantenir intactes els URL, utilitzeu l' data-target
atribut en lloc de href="#"
.
- <div class = "menú desplegable" >
- <a class = "dropdown-toggle" id = "dLabel" role = "button" data-toggle = "dropdown" data-target = "#" href = "/page.html" >
- Menú desplegable
- <b class = "caret" ></b>
- </a>
- <ul class = "menú desplegable" rol = "menú" aria-labelledby = "dLabel" >
- ...
- </ul>
- </div>
Truqueu als menús desplegables mitjançant JavaScript:
- $ ( '.dropdown-toggle' ). desplegable ()
Cap
Una API programàtica per canviar els menús per a una barra de navegació o navegació per pestanyes determinada.
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.
Per afegir fàcilment un comportament scrollspy a la vostra navegació de la barra superior, només cal data-spy="scroll"
que afegiu l'element que voleu espiar (normalment aquest seria el cos) i data-target=".navbar"
seleccioneu quin navegador utilitzar. Voleu utilitzar scrollspy amb un .nav
component.
- <body data-spy = "scroll" data-target = ".navbar" > ... </body>
Truqueu al scrollspy mitjançant JavaScript:
- $ ( '#navbar' ). scrollspy ()
<a href="#home">home</a>
ha de correspondre a alguna cosa del dom com
<div id="home"></div>
.
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:
- $ ( '[data-spy="scroll"]' ). cada ( funció () {
- var $spy = $ ( això ). scrollspy ( 'actualitzar' )
- });
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. |
Esdeveniment | Descripció |
---|---|
activar | 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.
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.
Fons fiduciari seitan letterpress, keytar raw denim keffiyeh etsy art party abans d'esgotar-se el mestre cleanse calamar sense gluten scenester freegan cosby sweater. Fanny pack portland seitan bricolatge, festa d'art locavore llop clixé high life echo park Austin. Cred vinyl keffiyeh DIY salvia PBR, banh mi abans d'esgotar-se el jersei cosby viral locavore VHS de granja a taula. Lomo llop viral, bigoti readymade thundercats keffiyeh cervesa artesana marfa ètica. Wolf salvia freegan, keffieh echo park vegà.
Activa les pestanyes amb tabulació mitjançant JavaScript (cada pestanya s'ha d'activar individualment):
- $ ( '#myTab a' ). feu clic ( funció ( e ) {
- e . preventDefault ();
- $ ( això ). pestanya ( 'mostrar' );
- })
Podeu activar pestanyes individuals de diverses maneres:
- $ ( '#myTab a[href="#profile"]' ). pestanya ( 'mostrar' ); // Seleccioneu la pestanya pel nom
- $ ( '#myTab a:first' ). pestanya ( 'mostrar' ); // Seleccioneu la primera pestanya
- $ ( '#myTab a:last' ). pestanya ( 'mostrar' ); // Seleccioneu l'última pestanya
- $ ( '#myTab li:eq(2) a' ). pestanya ( 'mostrar' ); // Seleccioneu la tercera pestanya (indexada 0)
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.nav-tabs
ul
- <ul class = "nav nav-tabs" >
- <li><a href = "#home" data-toggle = "tab" > Inici </a></li>
- <li><a href = "#profile" data-toggle = "tab" > Perfil </a></li>
- <li><a href = "#messages" data-toggle = "tab" > Missatges </a></li>
- <li><a href = "#settings" data-toggle = "tab" > Configuració </a></li>
- </ul>
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.
- <ul class = "nav nav-tabs" id = "myTab" >
- <li class = "active" ><a href = "#home" > Inici </a></li>
- <li><a href = "#profile" > Perfil </a></li>
- <li><a href = "#messages" > Missatges </a></li>
- <li><a href = "#settings" > Configuració </a></li>
- </ul>
- <div class = "tab-content" >
- <div class = "tab-pae active" id = "home" > ... </div>
- <div class = "tab-pane" id = "perfil" > ... </div>
- <div class = "tab-pane" id = "missatges" > ... </div>
- <div class = "tab-pane" id = "configuració" > ... </div>
- </div>
- <script>
- $ ( funció () {
- $ ( '#myTab a:last' ). pestanya ( 'mostrar' );
- })
- </script>
Esdeveniment | Descripció |
---|---|
espectacle | 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. |
mostrat | 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. |
- $ ( 'a[data-toggle="tab"]' ). on ( 'mostrat' , funció ( e ) {
- e . target // pestanya activada
- e . relatedTarget // pestanya anterior
- })
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.
Per raons de rendiment, la informació sobre eines i les API de dades emergents estan activades, és a dir, les heu d'inicialitzar vosaltres mateixos .
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.
Quan utilitzeu informació sobre eines i finestres emergents amb els grups d'entrada de Bootstrap, haureu d'establir l' container
opció (documentada a continuació) per evitar efectes secundaris no desitjats.
Activa la informació sobre eines mitjançant JavaScript:
- $ ( '#exemple' ). informació sobre eines ( opcions )
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=""
.
Nom | tipus | per defecte | descripció |
---|---|---|---|
animació | booleà | veritat | apliqueu una transició d'esvaïment CSS a la informació sobre eines |
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 | dret |
selector | corda | fals | Si es proporciona un selector, els objectes d'informació eines es delegaran als objectius especificats. |
títol | cadena | funció | '' | valor de títol predeterminat si l'etiqueta `title` no està present |
disparador | corda | 'enfocament al ratolí' | com s'activa la informació sobre eines - feu clic a | flotar | focus | manual. Tingueu en compte que passeu l'activador de diversos tipus, separats per espais i tipus d'activador. |
retard | nombre | objecte | 0 | retard en 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: |
contenidor | cadena | fals | fals | Afegeix la informació sobre eines a un element específic |
- <a href = "#" data-toggle = "tooltip" title = "primera informació sobre eines" > passa el cursor per sobre meu </a>
Adjunta un controlador d'informació eines a una col·lecció d'elements.
Revela la informació sobre eines d'un element.
- $ ( '#element' ). informació sobre eines ( 'mostra' )
Amaga la informació sobre eines d'un element.
- $ ( '#element' ). informació sobre eines ( 'amaga' )
Commuta la informació sobre eines d'un element.
- $ ( '#element' ). informació sobre eines ( 'commuta' )
Amaga i destrueix la informació sobre eines d'un element.
- $ ( '#element' ). informació sobre eines ( 'destrueix' )
Afegiu petites superposicions de contingut, com les de l'iPad, a qualsevol element per allotjar informació secundària. Passeu el cursor per sobre del botó per activar el popover. Requereix que s'inclogui Tooltip .
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.
No es mostra cap marcatge perquè es generen finestres emergents a partir de JavaScript i el contingut d'un data
atribut.
Activa les finestres emergents mitjançant JavaScript:
- $ ( '#exemple' ). popover ( opcions )
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=""
.
Nom | tipus | per defecte | descripció |
---|---|---|---|
animació | booleà | veritat | apliqueu una transició d'esvaïment CSS a la informació sobre eines |
html | booleà | fals | Insereix 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 | dret |
selector | corda | fals | si es proporciona un selector, els objectes d'informació eines es delegaran als objectius especificats |
disparador | corda | 'clic' | com s'activa el popover - feu clic a | flotar | focus | manual |
títol | cadena | funció | '' | valor de títol predeterminat si l'atribut `title` no està present |
contingut | cadena | funció | '' | valor de contingut per defecte si l'atribut `data-content` no està present |
retard | nombre | objecte | 0 | retard en 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: |
contenidor | cadena | fals | fals | Afegeix la finestra emergent a un element específic |
Per raons de rendiment, la informació sobre eines i l'apis de dades emergents estan activades. Si voleu utilitzar-les, només heu d'especificar una opció de selecció.
Inicialitza les finestres emergents per a una col·lecció d'elements.
Revela un popover d'elements.
- $ ( '#element' ). popover ( 'mostrar' )
Amaga una finestra emergent d'elements.
- $ ( '#element' ). popover ( 'amagar' )
Activa o desactiva una finestra emergent d'elements.
- $ ( '#element' ). popover ( 'alternar' )
Amaga i destrueix el popover d'un element.
- $ ( '#element' ). popover ( 'destrueix' )
Afegiu la funcionalitat de descartar a tots els missatges d'alerta amb aquest connector.
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.
Activa l'eliminació d'una alerta mitjançant JavaScript:
- $ ( ".alerta" ). alerta ()
Només heu d'afegir data-dismiss="alert"
al vostre botó de tancament per donar automàticament una funcionalitat de tancament d'alerta.
- <a class = "close" data-dismiss = "alert" href = "#" > × </a>
Embolcalla totes les alertes amb una funcionalitat propera. Perquè les vostres alertes s'animin quan estiguin tancades, assegureu-vos que ja tenen la classe .fade
i .in
aplicada.
Tanca una alerta.
- $ ( ".alerta" ). alerta ( 'tancar' )
La classe d'alerta de Bootstrap exposa alguns esdeveniments per connectar-se a la funcionalitat d'alerta.
Esdeveniment | Descripció |
---|---|
Tanca | Aquest esdeveniment s'activa immediatament quan close es crida al mètode d'instància. |
tancat | Aquest esdeveniment s'activa quan l'alerta s'ha tancat (esperarà que finalitzin les transicions CSS). |
- $ ( '#la meva-alerta' ). bind ( 'tancat' , funció () {
- // fer quelcom…
- })
Obteniu estils bàsics i suport flexible per a components plegables com els acordions i la navegació.
* Cal que s'inclogui el connector Transitions.
Utilitzant el connector de col·lapse, vam crear un giny senzill d'estil acordió:
- <div class = "acordió" id = "acordió2" >
- <div class = "grup d'acordió" >
- <div class = "acordió-capçalera" >
- <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseOne" >
- Element de grup plegable #1
- </a>
- </div>
- <div id = "collapseOne" class = "Cos d'acordió col·lapse" >
- <div class = "acordió-interior" >
- Anim pariatur cliche...
- </div>
- </div>
- </div>
- <div class = "grup d'acordió" >
- <div class = "acordió-capçalera" >
- <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseTwo" >
- Element de grup plegable núm. 2
- </a>
- </div>
- <div id = "collapseTwo" class = "collapse del cos d'acordió" >
- <div class = "acordió-interior" >
- Anim pariatur cliche...
- </div>
- </div>
- </div>
- </div>
- ...
També podeu utilitzar el connector sense el marcatge d'acordió. Feu que un botó commuti l'expansió i el replegament d'un altre element.
- <button type = "button" class = "btn btn-danger" data-toggle = "collapse" data-target = "#demo" >
- simple plegable
- </button>
- <div id = "demo" class = "collapse in" > … </div>
Només cal afegir data-toggle="collapse"
i data-target
a l'element per assignar automàticament el control d'un element plegable. L' data-target
atribut accepta un selector de css per 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:
- $ ( ".collapse" ). col·lapsar ()
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 selector, tots els elements plegables sota el pare especificat es tancaran quan es mostri aquest element plegable. (semblant al comportament tradicional d'acordió) |
alternar | booleà | veritat | Activa o desactiva l'element plegable en invocació |
Activa el teu contingut com a element plegable. Accepta opcions opcionals object
.
- $ ( '#myCollapsible' ). col·lapse ({
- alternar : fals
- })
Commuta un element plegable per mostrar-lo o amagar-lo.
Mostra un element plegable.
Amaga un element plegable.
La classe de col·lapse de Bootstrap exposa alguns esdeveniments per connectar-se a la funcionalitat de col·lapse.
Esdeveniment | Descripció |
---|---|
espectacle | Aquest esdeveniment s'activa immediatament quan show es crida al mètode d'instància. |
mostrat | Aquest esdeveniment s'activa quan un element de col·lapse s'ha fet visible per a l'usuari (esperarà que es completin les transicions CSS). |
amagar | Aquest esdeveniment s'activa immediatament quan hide s'ha cridat el mètode. |
amagat | Aquest esdeveniment s'activa quan s'ha amagat un element de col·lapse per a l'usuari (esperarà que finalitzin les transicions CSS). |
- $ ( '#myCollapsible' ). on ( 'amagat' , funció () {
- // fer quelcom…
- })
La presentació de diapositives següent mostra un complement i un component genèrics per recórrer elements com un carrusel.
- <div id = "myCarousel" class = "diapositiva del carrusel" >
- <ol class = "indicadors de carrusel" >
- <li data-target = "#myCarousel" data-slide-to = "0" class = "actiu" ></li>
- <li data-target = "#myCarousel" data-slide-to = "1" ></li>
- <li data-target = "#myCarousel" data-slide-to = "2" ></li>
- </ol>
- <!-- Elements del carrusel -->
- <div class = "carrusel-interior" >
- <div class = "element actiu" > … </div>
- <div class = "element" > … </div>
- <div class = "element" > … </div>
- </div>
- <!-- Navegació del carrusel -->
- <a class = "carousel-control left" href = "#myCarousel" data-slide = "anterior" > ‹ </a>
- <a class = "carousel-control right" href = "#myCarousel" data-slide = "següent" > › </a>
- </div>
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. També podeu utilitzar data-slide-to
per passar un índex de diapositives en brut al carrusel data-slide-to="2"
, que salta la posició de la diapositiva a un índex concret que comença per 0
.
Truqueu manualment al carrusel amb:
- $ ( '.carrusel' ). carrusel ()
Les opcions es poden passar mitjançant atributs de dades o JavaScriptz. 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 | corda | "passar el ratolí" | Atura el cicle del carrusel a l'entrada del ratolí i reprèn el cicle del carrusel a la sortida del ratolí. |
Inicialitza el carrusel amb opcions opcionals object
i comença a circular pels elements.
- $ ( '.carrusel' ). carrusel ({
- interval : 2000
- })
Recorre els elements del carrusel d'esquerra a dreta.
Impedeix que el carrusel circuli per elements.
Cicle el carrusel a un fotograma concret (basat en 0, similar a una matriu).
Cicles a l'element anterior.
Passa a l'element següent.
La classe de carrusel de Bootstrap exposa dos esdeveniments per connectar-se a la funcionalitat del carrusel.
Esdeveniment | Descripció |
---|---|
diapositiva | Aquest esdeveniment s'activa immediatament quan slide s'invoca el mètode d'instància. |
lliscar | Aquest esdeveniment s'activa quan el carrusel ha completat la transició de diapositives. |
Un connector bàsic i fàcil d'ampliar per crear ràpidament capes de lletra elegants amb qualsevol entrada de text de formulari.
- <input type = "text" data-provide = "typeahead" >
Voleu configurar autocomplete="off"
per evitar que els menús del navegador predeterminats apareguin al menú desplegable Bootstrap typeahead.
Afegiu atributs de dades per registrar un element amb la funcionalitat typeahead tal com es mostra a l'exemple anterior.
Truqueu al typeahead manualment amb:
- $ ( '.typeahead' ). escriviu ()
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-source=""
.
Nom | tipus | per defecte | descripció |
---|---|---|---|
font | matriu, funció | [ ] | La font de dades per a la consulta. Pot ser una matriu de cadenes o una funció. A la funció se li passen dos arguments, el query valor del camp d'entrada i la process devolució de trucada. La funció es pot utilitzar de manera síncrona retornant la font de dades directament o de manera asíncrona mitjançant l' process únic argument de la devolució de trucada. |
elements | nombre | 8 | El nombre màxim d'elements per mostrar al menú desplegable. |
minLongitud | nombre | 1 | La longitud mínima de caràcters necessària abans d'activar els suggeriments d'emplenament automàtic |
emparellador | funció | cas insensible | El mètode utilitzat per determinar si una consulta coincideix amb un element. Accepta un sol argument, item amb el qual provar la consulta. Accediu a la consulta actual amb this.query . Retorna un valor booleà true si la consulta coincideix. |
classificador | funció | concordança exacta, distingeix entre majúscules i minúscules, no distingeix entre majúscules i minúscules |
Mètode utilitzat per ordenar els resultats d'autocompletar. Accepta un sol argument items i té l'abast de la instància typeahead. Feu referència a la consulta actual amb this.query . |
actualitzador | funció | retorna l'element seleccionat | El mètode utilitzat per retornar l'element seleccionat. Accepta un sol argument, el item i té l'abast de la instància typeahead. |
subratllador | funció | ressalta totes les coincidències predeterminades | Mètode utilitzat per destacar els resultats d'autocompletar. Accepta un sol argument item i té l'abast de la instància typeahead. Hauria de tornar html. |
Inicialitza una entrada amb una tipografia.
La subnavegació de l'esquerra és una demostració en directe del connector afix.
Per afegir fàcilment un comportament d'afixos a qualsevol element, només cal que afegiu data-spy="affix"
-lo a l'element que voleu espiar. A continuació, utilitzeu els desplaçaments per definir quan activar i desactivar la fixació d'un element.
- <div data-spy = "affix" data-offset-top = "200" > ... </div>
affix
,
affix-top
, i
affix-bottom
. Recordeu comprovar si hi ha un pare potencialment col·lapsat quan s'iniciï l'afix, ja que elimina contingut del flux normal de la pàgina.
Truqueu al connector d'afix mitjançant JavaScript:
- $ ( '#navbar' ). afix ()
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 l'esquerra. Per escoltar una sola direcció o diversos desplaçaments únics, només cal que proporcioneu un objecte offset: { x: 10 } . Utilitzeu una funció quan necessiteu proporcionar una compensació dinàmica (útil per a alguns dissenys sensibles). |