Da vida aos compoñentes de Bootstrap, agora con 13 complementos jQuery personalizados.
Os complementos pódense incluír individualmente (aínda que algúns teñen dependencias obrigatorias) ou todos á vez. Tanto bootstrap.js como bootstrap.min.js conteñen todos os complementos nun único ficheiro.
Podes usar todos os complementos de Bootstrap só a través da API de marcado sen escribir unha soa liña de JavaScript. Esta é a API de primeira clase de Bootstrap e debería ser a túa primeira consideración ao usar un complemento.
Dito isto, nalgunhas situacións pode ser desexable desactivar esta función. Polo tanto, tamén ofrecemos a posibilidade de desactivar a API de atributos de datos desvinculando todos os eventos do corpo espazado con "data-api". Isto parece isto:
- $ ( 'corpo' ). off ( '.data-api' )
Alternativamente, para apuntar a un complemento específico, simplemente inclúa o nome do complemento como espazo de nomes xunto co espazo de nomes da API de datos como este:
- $ ( 'corpo' ). off ( '.alert.data-api' )
Tamén cremos que deberías poder usar todos os complementos de Bootstrap só a través da API de JavaScript. Todas as API públicas son métodos únicos que se poden encadear e devolven a colección sobre a que se actuou.
- $ ( ".btn.danger" ). botón ( "alternar" ). addClass ( "graxa" )
Todos os métodos deben aceptar un obxecto de opcións opcionais, unha cadea que se dirixe a un método en particular ou nada (que inicia un complemento co comportamento predeterminado):
- $ ( "#myModal" ). modal () // inicializado con valores predeterminados
- $ ( "#myModal" ). modal ({ keyboard : false }) // inicializado sen teclado
- $ ( "#myModal" ). modal ( 'mostrar' ) // inicializa e invoca show inmediatamente
Cada complemento tamén expón o seu construtor en bruto nunha propiedade `Construtor`: $.fn.popover.Constructor
. Se queres obter unha instancia de complemento en particular, obtén directamente desde un elemento: $('[rel=popover]').data('popover')
.
Ás veces é necesario usar complementos de Bootstrap con outros marcos de IU. Nestas circunstancias, ocasionalmente poden ocorrer colisións de espazos de nomes. Se isto ocorre, podes chamar .noConflict
ao complemento do que desexas reverter o valor.
- var bootstrapButton = $ . fn . botón . noConflict () // devolve $.fn.button ao valor previamente asignado
- $ . fn . bootstrapBtn = bootstrapButton // dálle a $().bootstrapBtn a funcionalidade de arranque
Bootstrap ofrece eventos personalizados para a maioría das accións únicas do complemento. Xeralmente, estes veñen nunha forma de infinitivo e de participio pasado, onde o infinitivo (ex. show
) desenvólvese ao comezo dun evento e a súa forma de participio pasado (ex. shown
) desenvólvese ao completar unha acción.
Todos os eventos de infinitivo proporcionan a funcionalidade preventDefault. Isto proporciona a capacidade de deter a execución dunha acción antes de que comece.
- $ ( '#myModal' ). on ( 'mostrar' , función ( e ) {
- se (! datos ) devolve e . preventDefault () // impide que se mostre o modal
- })
Para efectos de transición sinxelos, inclúa bootstrap-transition.js unha vez xunto cos outros ficheiros JS. Se estás usando o compilado (ou minificado) bootstrap.js , non hai necesidade de incluír isto, xa está aí.
Algúns exemplos do complemento de transición:
Os modais son sinxelos, pero flexibles, as solicitudes de diálogo coa funcionalidade mínima necesaria e os valores predeterminados intelixentes.
Un modal renderizado con cabeceira, corpo e conxunto de accións no pé.
Un bo corpo...
- <div class = "esvanecemento de ocultación modal" >
- <div class = "encabezado-modal" >
- <button type = "button" class = "close" data-dismiss = "modal" aria-hidden = "true" > × </button>
- <h3> Cabeceira modal </h3>
- </div>
- <div class = "corpo-modal" >
- <p> Un bo corpo... </p>
- </div>
- <div class = "modal-footer" >
- <a href = "#" class = "btn" > Pechar </a>
- <a href = "#" class = "btn btn-primary" > Gardar cambios </a>
- </div>
- </div>
Alterna un modal a través de JavaScript facendo clic no botón de abaixo. Deslizarase cara abaixo e desaparecerá dende a parte superior da páxina.
- <!-- Botón para activar modal -->
- <a href = "#myModal" role = "button" class = "btn" data-toggle = "modal" > Iniciar demostración modal </a>
- <!-- Modal -->
- <div id = "myModal" class = "modal hide fade" tabindex = "-1" role = "dialog" aria-labelledby = "myModalLabel" aria-hidden = "true" >
- <div class = "encabezado-modal" >
- <button type = "button" class = "close" data-dismiss = "modal" aria-hidden = "true" > × </button>
- <h3 id = "myModalLabel" > Cabeceira modal </h3>
- </div>
- <div class = "corpo-modal" >
- <p> Un bo corpo... </p>
- </div>
- <div class = "modal-footer" >
- <button class = "btn" data-dismiss = "modal" aria-hidden = "true" > Pechar </button>
- <button class = "btn btn-primary" > Garda os cambios </button>
- </div>
- </div>
Activa un modal sen escribir JavaScript. Establécese data-toggle="modal"
nun elemento do controlador, como un botón, xunto cun data-target="#foo"
ou href="#foo"
para seleccionar un modal específico para alternar.
- <button type = "button" data-toggle = "modal" data-target = "#myModal" > Iniciar modal </button>
Chame a un modal con id myModal
cunha única liña de JavaScript:
- $ ( '#myModal' ). modal ( opcións )
As opcións pódense pasar a través de atributos de datos ou JavaScript. Para os atributos de datos, engada o nome da opción a data-
, como en data-backdrop=""
.
Nome | tipo | por defecto | descrición |
---|---|---|---|
pano de fondo | booleano | verdade | Inclúe un elemento de fondo modal. Alternativamente, especifique static un fondo que non peche o modal ao facer clic. |
teclado | booleano | verdade | Pecha o modal cando se preme a tecla Esc |
mostrar | booleano | verdade | Mostra o modal cando se inicializa. |
remoto | camiño | falso | Se se proporciona un URL remoto, o contido cargarase mediante o
|
Activa o teu contido como modal. Acepta opcións opcionais object
.
- $ ( '#myModal' ). modal ({
- teclado : falso
- })
Alterna manualmente un modal.
- $ ( '#myModal' ). modal ( 'alternar' )
Abre manualmente un modal.
- $ ( '#myModal' ). modal ( 'mostrar' )
Oculta manualmente un modal.
- $ ( '#myModal' ). modal ( 'ocultar' )
A clase modal de Bootstrap expón algúns eventos para conectarse á funcionalidade modal.
Evento | Descrición |
---|---|
mostrar | Este evento desenvólvese inmediatamente cando show se chama ao método de instancia. |
mostrado | Este evento desenvólvese cando o modal se fixo visible para o usuario (esperará a que se completen as transicións css). |
ocultar | Este evento desenvólvese inmediatamente cando hide se chamou ao método de instancia. |
agochado | Este evento desenvólvese cando o modal rematou de ocultarse ao usuario (esperará a que se completen as transicións css). |
- $ ( '#myModal' ). on ( 'oculto' , función () {
- // facer algo…
- })
Engade menús despregables a case calquera cousa con este sinxelo complemento, incluíndo a barra de navegación, as pestanas e as pílulas.
Engadir data-toggle="dropdown"
a unha ligazón ou botón para alternar un menú despregable.
- <div class = "menú desplegable" >
- <a class = "dropdown-toggle" data-toggle = "dropdown" href = "#" > Activador do menú despregable </a>
- <ul class = "menú desplegable" role = "menú" aria-labelledby = "dLabel" >
- ...
- </ul>
- </div>
Para manter os URL intactos, utiliza o data-target
atributo en lugar de href="#"
.
- <div class = "menú desplegable" >
- <a class = "dropdown-toggle" id = "dLabel" role = "button" data-toggle = "dropdown" data-target = "#" href = "/page.html" >
- Despregar menú
- <b class = "caret" ></b>
- </a>
- <ul class = "menú desplegable" role = "menú" aria-labelledby = "dLabel" >
- ...
- </ul>
- </div>
Chame aos menús despregables mediante JavaScript:
- $ ( '.dropdown-toggle' ). desplegable ()
Ningún
Unha API programática para alternar menús para unha determinada barra de navegación ou navegación por pestanas.
O complemento ScrollSpy serve para actualizar automaticamente os obxectivos de navegación en función da posición do desprazamento. Desprázate pola área debaixo da barra de navegación e observa o cambio de clase activa. Tamén se destacarán os subelementos do menú despregable.
Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi antes de que esgotasen qui. Dereitos das bicicletas Tumblr da granxa á mesa. Anim keffiyeh carles cardigan. Fotomatón de Velit seitan mcsweeney 3 wolf moon irure. Suéter Cosby pantalóns curtos de vaquero lomo, sudadera con capucha williamsburg mínimo que probablemente non escoitou falar deles et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tatuado acusamus, cred ironía biodiesel keffiyeh artesán ullamco consequat.
Monopatín con bigote Veniam marfa, adipisicing fugiat velit pitchfork beard. Freegan beard aliqua cupidatat mcsweeney's vero. Cupidatat four loko nisi, ea helvetica nulla carles. Camión de comida con camisola cosby tatuada, vinilo non freegan de mcsweeney. Lo-fi wes anderson +1 sartorial. Carles non exercicio estético quis gentrify. Brooklyn adipisicing craft beer vice keytar deserunt.
Occaecat commodo aliqua delectus. Fap cervexa artesanal deserunt monopatín ea. Os dereitos das bicicletas Lomo 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 é adipisicing. Consectetur nisi DIY bolsa de mensaxería mínima. Cred ex in, delectus sustentable 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 cliché ironía, thundercats probablemente non escoitou falar deles consequat hoodie sen glute lo-fi fap aliquip. Traballe antes de que se esgotasen, terry richardson proident brunch non deixa de ter un suéter cosby e tamén un artesán helvético. Cardigan cervexa artesanal seitán readymade velit. VHS chambray laboris tempor veniam. Anim mollit minim commodo ullamco thundercats.
Para engadir facilmente o comportamento scrollspy á túa navegación da barra superior, só tes que engadir data-spy="scroll"
ao elemento que queres espiar (normalmente este sería o corpo) e data-target=".navbar"
seleccionar o navegador que queres usar. Quererá usar scrollspy cun .nav
compoñente.
- <body data-spy = "scroll" data-target = ".navbar" > ... </body>
Chame ao scrollspy mediante JavaScript:
- $ ( '#navbar' ). scrollspy ()
<a href="#home">home</a>
debe corresponder a algo no dom como
<div id="home"></div>
.
Ao usar scrollspy xunto coa engade ou eliminación de elementos do DOM, terás que chamar ao método de actualización deste xeito:
- $ ( '[data-spy="scroll"]' ). cada ( función () {
- var $spy = $ ( isto ). scrollspy ( 'actualizar' )
- });
As opcións pódense pasar a través de atributos de datos ou JavaScript. Para os atributos de datos, engada o nome da opción a data-
, como en data-offset=""
.
Nome | tipo | por defecto | descrición |
---|---|---|---|
compensar | número | 10 | Píxeles para compensar desde arriba ao calcular a posición do desprazamento. |
Evento | Descrición |
---|---|
activar | Este evento desenvólvese sempre que o scrollspy activa un novo elemento. |
Engade funcións de pestanas rápidas e dinámicas para pasar a través dos paneis de contido local, mesmo a través dos menús despregables.
Denim cru que probablemente non escoitou falar deles shorts de jeans Austin. Nesciunt tofu stumptown aliqua, sintetizador retro cleanse. Bigote cliché tempor, williamsburg carles vegan helvetica. Reprehenderit 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.
Fondo fiduciario seitan letterpress, keytar raw denim keffiyeh etsy art party antes de que se esgotasen master cleanse calamares sen glute scenester freegan cosby sweater. Riñonera Portland Seitan DIY, fiesta artística locavore lobo cliché high life echo park Austin. Cred vinyl keffiyeh DIY salvia PBR, banh mi antes de que esgotasen o suéter cosby de locavore viral VHS da granxa á mesa. Lomo lobo viral, bigote readymade thundercats keffiyeh cervexa artesanal marfa ética. Wolf salvia freegan, keffieh echo park vegano.
Activa as pestanas con tabulacións a través de JavaScript (cada pestana debe activarse individualmente):
- $ ( '#myTab a' ). prema ( función ( e ) {
- e . preventDefault ();
- $ ( este ). pestana ( 'mostrar' );
- })
Podes activar pestanas individuais de varias maneiras:
- $ ( '#myTab a[href="#profile"]' ). pestana ( 'mostrar' ); // Selecciona a pestana polo nome
- $ ( '#myTab a:first' ). pestana ( 'mostrar' ); // Selecciona a primeira pestana
- $ ( '#myTab a:last' ). pestana ( 'mostrar' ); // Selecciona a última pestana
- $ ( '#myTab li:eq(2) a' ). pestana ( 'mostrar' ); // Selecciona a terceira pestana (indexada 0)
Podes activar unha pestana ou navegación por pílulas sen escribir JavaScript simplemente especificando data-toggle="tab"
ou data-toggle="pill"
nun elemento. Engadindo as clases nav
e nav-tabs
á pestana ul
aplicarase o estilo da pestana Bootstrap.
- <ul class = "nav nav-tabs" >
- <li><a href = "#home" data-toggle = "tab" > Inicio </a></li>
- <li><a href = "#profile" data-toggle = "tab" > Perfil </a></li>
- <li><a href = "#messages" data-toggle = "tab" > Mensaxes </a></li>
- <li><a href = "#settings" data-toggle = "tab" > Configuración </a></li>
- </ul>
Activa un elemento de pestana e un contenedor de contido. A pestana debería ter un nodo de contedores data-target
ou un href
nodo de destino no DOM.
- <ul class = "nav nav-tabs" id = "myTab" >
- <li class = "active" ><a href = "#home" > Inicio </a></li>
- <li><a href = "#profile" > Perfil </a></li>
- <li><a href = "#messages" > Mensaxes </a></li>
- <li><a href = "#settings" > Configuración </a></li>
- </ul>
- <div class = "contido da pestana" >
- <div class = "tab-pane active" id = "home" > ... </div>
- <div class = "tab-pane" id = "perfil" > ... </div>
- <div class = "tab-pane" id = "mensaxes" > ... </div>
- <div class = "tab-pane" id = "configuración" > ... </div>
- </div>
- <script>
- $ ( función () {
- $ ( '#myTab a:last' ). pestana ( 'mostrar' );
- })
- </script>
Evento | Descrición |
---|---|
mostrar | Este evento desenvólvese na mostra de pestanas, pero antes de que se mostrase a nova pestana. Use event.target e event.relatedTarget para orientar a pestana activa e a pestana activa anterior (se está dispoñible) respectivamente. |
mostrado | Este evento desenvólvese na mostra de pestanas despois de que se mostrase unha pestana. Use event.target e event.relatedTarget para orientar a pestana activa e a pestana activa anterior (se está dispoñible) respectivamente. |
- $ ( 'a[data-toggle="tab"]' ). on ( 'mostrado' , función ( e ) {
- e . destino // pestana activada
- e . relatedTarget // pestana anterior
- })
Inspirado no excelente complemento jQuery.tipsy escrito por Jason Frame; As informacións sobre ferramentas son unha versión actualizada, que non dependen de imaxes, usan CSS3 para animacións e atributos de datos para o almacenamento local de títulos.
Por razóns de rendemento, a información sobre ferramentas e as API de datos emergentes están activadas, o que significa que debes inicializalas por ti mesmo .
Pasa o cursor polas seguintes ligazóns para ver consellos:
Pantalóns axustados seguinte nivel keffiyeh probablemente non escoitou falar deles. Fotomatón barba denim crudo tipografía bolsa de mensajería vegana stumptown. Seitan da granxa á mesa, o fixie de quinoa sustentable de mcsweeney de 8 bits American Apparel teñen un cambray de vinilo terry richardson. Beard stumptown, cardigans banh mi lomo thundercats. Tofu biodiesel williamsburg marfa, four loko mcsweeney's cleanse vegan chambray. Un artesán realmente irónico calquera que sexa keytar , scenester farm-to-table banksy Austin twitter handle freegan cred raw denim café de orixe única viral.
Ao usar consellos e popovers cos grupos de entrada de Bootstrap, terás que configurar a container
opción (documentada a continuación) para evitar efectos secundarios non desexados.
Activa a información sobre ferramentas mediante JavaScript:
- $ ( '#exemplo' ). información sobre ferramentas ( opcións )
As opcións pódense pasar a través de atributos de datos ou JavaScript. Para os atributos de datos, engada o nome da opción a data-
, como en data-animation=""
.
Nome | tipo | por defecto | descrición |
---|---|---|---|
animación | booleano | verdade | aplique unha transición de fundido css á información sobre ferramentas |
html | booleano | falso | Insira html na información sobre ferramentas. Se é falso, empregarase o método de jquery text para inserir contido no dom. Usa texto se estás preocupado polos ataques XSS. |
colocación | cadea | función | 'arriba' | como colocar a información sobre ferramentas - arriba | inferior | esquerda | certo |
selector | corda | falso | Se se proporciona un selector, os obxectos de información sobre ferramentas delegaranse nos obxectivos especificados. |
título | cadea | función | '' | valor de título predeterminado se a etiqueta `title` non está presente |
disparador | corda | 'foco do rato' | como se activa a información sobre ferramentas - fai clic en | pasar o rato | foco | manual. Teña en conta que pasa varios tipos de activadores, separados por espazos e por maiúsculas. |
atraso | número | obxecto | 0 | atrasar a mostra e ocultar a información sobre ferramentas (ms): non se aplica ao tipo de disparador manual Se se proporciona un número, aplícase un atraso tanto para ocultar como para mostrar A estrutura do obxecto é: |
envase | cadea | falso | falso | Engade a información sobre ferramentas a un elemento específico |
- <a href = "#" data-toggle = "tooltip" title = "primeira información sobre ferramentas" > pasa o rato sobre min </a>
Anexa un controlador de información sobre ferramentas a unha colección de elementos.
Revela a información sobre ferramentas dun elemento.
- $ ( '#elemento' ). información sobre ferramentas ( 'mostrar' )
Oculta a información sobre ferramentas dun elemento.
- $ ( '#elemento' ). información sobre ferramentas ( 'ocultar' )
Alterna a información sobre ferramentas dun elemento.
- $ ( '#elemento' ). información sobre ferramentas ( 'alternar' )
Oculta e destrúe a información sobre ferramentas dun elemento.
- $ ( '#elemento' ). información sobre ferramentas ( 'destruír' )
Engade pequenas superposicións de contido, como as do iPad, a calquera elemento para albergar información secundaria. Pasa o rato sobre o botón para activar o popover. Require que se inclúa Tooltip .
Hai catro opcións dispoñibles: arriba, dereita, inferior e aliñada á esquerda.
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.
Non se mostra ningún marcado xa que se xeran popovers a partir de JavaScript e o contido dun data
atributo.
Activar popovers mediante JavaScript:
- $ ( '#exemplo' ). popover ( opcións )
As opcións pódense pasar a través de atributos de datos ou JavaScript. Para os atributos de datos, engada o nome da opción a data-
, como en data-animation=""
.
Nome | tipo | por defecto | descrición |
---|---|---|---|
animación | booleano | verdade | aplique unha transición de fundido css á información sobre ferramentas |
html | booleano | falso | Insira html no popover. Se é falso, empregarase o método de jquery text para inserir contido no dom. Usa texto se estás preocupado polos ataques XSS. |
colocación | cadea | función | 'correcto' | como colocar o popover - arriba | inferior | esquerda | certo |
selector | corda | falso | se se proporciona un selector, os obxectos de información sobre ferramentas delegaranse nos obxectivos especificados |
disparador | corda | 'click' | como se activa o popover - fai clic en | pasar o rato | foco | manual |
título | cadea | función | '' | valor de título predeterminado se o atributo `title` non está presente |
contido | cadea | función | '' | valor de contido predeterminado se o atributo `data-content` non está presente |
atraso | número | obxecto | 0 | atraso para mostrar e ocultar o popover (ms): non se aplica ao tipo de activación manual Se se proporciona un número, aplícase un atraso tanto para ocultar como para mostrar A estrutura do obxecto é: |
envase | cadea | falso | falso | Engade o popover a un elemento específico |
Por razóns de rendemento, a información sobre ferramentas e as apis de datos emergentes están activadas. Se queres usalas, só tes que especificar unha opción de selección.
Inicia os popovers para unha colección de elementos.
Revela un popover de elementos.
- $ ( '#elemento' ). popover ( 'mostrar' )
Oculta un popover de elementos.
- $ ( '#elemento' ). popover ( 'ocultar' )
Alterna un popover de elementos.
- $ ( '#elemento' ). popover ( 'alternar' )
Oculta e destrúe o popover dun elemento.
- $ ( '#elemento' ). popover ( 'destruír' )
Engade a función de descartar a todas as mensaxes de alerta con este complemento.
Cambia isto ou outro e téntao de novo. Duis mollis, is not commodo luctus, ninsi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.
Activar a descarte dunha alerta mediante JavaScript:
- $ ( ".alerta" ). alerta ()
Só tes que engadir data-dismiss="alert"
ao teu botón de peche para dar automaticamente unha función de peche de alerta.
- <a class = "close" data-dismiss = "alerta" href = "#" > × </a>
Envolve todas as alertas cunha funcionalidade próxima. Para que as túas alertas se animen cando estean pechadas, asegúrate de que xa teñan a clase .fade
e aplicada..in
Pecha unha alerta.
- $ ( ".alerta" ). alerta ( 'pechar' )
A clase de alerta de Bootstrap expón algúns eventos para conectarse á funcionalidade de alerta.
Evento | Descrición |
---|---|
pechar | Este evento desenvólvese inmediatamente cando close se chama ao método de instancia. |
pechado | Este evento desenvólvese cando se pechou a alerta (esperará a que se completen as transicións css). |
- $ ( '#a miña-alerta' ). ligar ( 'pechado' , función () {
- // facer algo…
- })
Obtén estilos básicos e soporte flexible para compoñentes plegables como acordeóns e navegación.
* Require que se inclúa o complemento Transitions.
Usando o complemento de contraer, creamos un widget sinxelo de estilo acordeón:
- <div class = "acordeón" id = "acordeón2" >
- <div class = "grupo de acordeóns" >
- <div class = "acordeon-heading" >
- <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseOne" >
- Elemento do grupo plegable #1
- </a>
- </div>
- <div id = "collapseOne" class = "colapso do corpo de acordeón en" >
- <div class = "acordeón interior" >
- Anim pariatur cliche...
- </div>
- </div>
- </div>
- <div class = "grupo de acordeóns" >
- <div class = "acordeon-heading" >
- <a class = "accordion-toggle" alternancia de datos = "contraer" data-parent = "#accordion2" href = "#collapseTwo" >
- Elemento do grupo plegable #2
- </a>
- </div>
- <div id = "collapseTwo" class = "colapso do corpo de acordeón" >
- <div class = "acordeón interior" >
- Anim pariatur cliche...
- </div>
- </div>
- </div>
- </div>
- ...
Tamén podes usar o complemento sen o marcado de acordeón. Fai un botón para alternar a expansión e o colapso doutro elemento.
- <button type = "button" class = "btn btn-danger" data-toggle = "colapse" data-target = "#demo" >
- simple plegable
- </button>
- <div id = "demo" class = "collapse in" > … </div>
Só ten que engadir data-toggle="collapse"
e un data-target
elemento para asignar automaticamente o control dun elemento plegable. O data-target
atributo acepta un selector css ao que aplicar o colapso. Asegúrate de engadir a clase collapse
ao elemento contraíble. Se queres que se abra por defecto, engade a clase adicional in
.
Para engadir unha xestión de grupos de tipo acordeón a un control plegable, engade o atributo de datos data-parent="#selector"
. Consulta a demostración para ver isto en acción.
Habilitar manualmente con:
- $ ( ".colapso" ). colapsar ()
As opcións pódense pasar a través de atributos de datos ou JavaScript. Para os atributos de datos, engada o nome da opción a data-
, como en data-parent=""
.
Nome | tipo | por defecto | descrición |
---|---|---|---|
pai | selector | falso | Se se selecciona, pecharanse todos os elementos contraíbles baixo o pai especificado cando se mostre este elemento contraíble. (semellante ao comportamento tradicional do acordeón) |
alternar | booleano | verdade | Alterna o elemento contraíble na invocación |
Activa o teu contido como elemento plegable. Acepta opcións opcionais object
.
- $ ( '#myCollapsible' ). contraer ({
- alternar : falso
- })
Alterna un elemento plegable para mostrar ou ocultar.
Mostra un elemento plegable.
Oculta un elemento plegable.
A clase de colapso de Bootstrap expón algúns eventos para conectarse á funcionalidade de colapso.
Evento | Descrición |
---|---|
mostrar | Este evento desenvólvese inmediatamente cando show se chama ao método de instancia. |
mostrado | Este evento desenvólvese cando un elemento de contraer se fixo visible para o usuario (esperará a que se completen as transicións css). |
ocultar | Este evento desenvólvese inmediatamente cando hide se chamou ao método. |
agochado | Este evento desenvólvese cando se ocultou ao usuario un elemento de contraer (esperará a que se completen as transicións css). |
- $ ( '#myCollapsible' ). on ( 'oculto' , función () {
- // facer algo…
- })
A seguinte presentación de diapositivas mostra un complemento xenérico e un compoñente para percorrer elementos como un carrusel.
- <div id = "myCarousel" class = "diapositiva do carrusel" >
- <ol class = "indicadores de carrusel" >
- <li data-target = "#myCarousel" data-slide-to = "0" class = "activo" ></li>
- <li data-target = "#myCarousel" data-slide-to = "1" ></li>
- <li data-target = "#myCarousel" data-slide-to = "2" ></li>
- </ol>
- <!-- Elementos do carrusel -->
- <div class = "carrusel-inner" >
- <div class = "elemento activo" > … </div>
- <div class = "elemento" > … </div>
- <div class = "elemento" > … </div>
- </div>
- <!-- Navegación do carrusel -->
- <a class = "carousel-control left" href = "#myCarousel" data-slide = "anterior" > ‹ </a>
- <a class = "carousel-control right" href = "#myCarousel" data-slide = "seguinte" > › </a>
- </div>
Usa atributos de datos para controlar facilmente a posición do carrusel. data-slide
acepta as palabras clave prev
ou next
, que altera a posición da diapositiva en relación coa súa posición actual. Alternativamente, úsao data-slide-to
para pasar un índice de diapositivas en bruto ao carrusel data-slide-to="2"
, que salta a posición da diapositiva a un índice concreto que comeza por 0
.
Chamar ao carrusel manualmente con:
- $ ( '.carrusel' ). carrusel ()
As opcións pódense pasar a través de atributos de datos ou JavaScriptz. Para os atributos de datos, engada o nome da opción a data-
, como en data-interval=""
.
Nome | tipo | por defecto | descrición |
---|---|---|---|
intervalo | número | 5000 | A cantidade de tempo que transcorre entre o ciclo automático dun elemento. Se é falso, o carrusel non se moverá automaticamente. |
pausa | corda | "pasar" | Detén o ciclo do carrusel ao entrar no rato e retoma o ciclo do carrusel ao saír do rato. |
Inicia o carrusel cunhas opcións opcionais object
e comeza a percorrer os elementos.
- $ ( '.carrusel' ). carrusel ({
- intervalo : 2000
- })
Percorre os elementos do carrusel de esquerda a dereita.
Impide que o carrusel circule por elementos.
Cicla o carrusel a un cadro particular (baseado en 0, semellante a unha matriz).
Ciclos ao elemento anterior.
Ciclos ao seguinte elemento.
A clase de carrusel de Bootstrap expón dous eventos para conectarse á funcionalidade do carrusel.
Evento | Descrición |
---|---|
diapositiva | Este evento desenvólvese inmediatamente cando slide se invoca o método de instancia. |
deslizarse | Este evento desenvólvese cando o carrusel completou a súa transición de diapositivas. |
Un complemento básico e facilmente estendido para crear rapidamente tipografías elegantes con calquera entrada de texto do formulario.
- <input type = "text" data-provide = "typeahead" >
Quererá configurar autocomplete="off"
para evitar que os menús predeterminados do navegador aparezan sobre o menú despregable Bootstrap typeahead.
Engade atributos de datos para rexistrar un elemento coa funcionalidade typeahead como se mostra no exemplo anterior.
Chame ao typeahead manualmente con:
- $ ( '.typeahead' ). teclear ()
As opcións pódense pasar a través de atributos de datos ou JavaScript. Para os atributos de datos, engada o nome da opción a data-
, como en data-source=""
.
Nome | tipo | por defecto | descrición |
---|---|---|---|
fonte | matriz, función | [ ] | A fonte de datos para a consulta. Pode ser unha matriz de cadeas ou unha función. Á función pásanse dous argumentos, o query valor no campo de entrada e a process devolución de chamada. A función pódese usar de forma sincrónica devolvendo a fonte de datos directamente ou de forma asíncrona mediante o process único argumento da devolución de chamada. |
elementos | número | 8 | O número máximo de elementos para mostrar no menú despregable. |
minLonxitude | número | 1 | A lonxitude mínima de caracteres necesaria antes de activar as suxestións de autocompletar |
emparejador | función | insensible a maiúsculas e minúsculas | O método usado para determinar se unha consulta coincide cun elemento. Acepta un único argumento, item contra o cal probar a consulta. Acceda á consulta actual con this.query . Devolve un booleano true se a consulta coincide. |
clasificador | función | coincidencia exacta, sensible a mayúsculas y minúsculas, minúsculas |
Método utilizado para ordenar os resultados de autocompletar. Acepta un único argumento items e ten o alcance da instancia typeahead. Referencia a consulta actual con this.query . |
actualizador | función | devolve o elemento seleccionado | O método utilizado para devolver o elemento seleccionado. Acepta un único argumento, o item e ten o alcance da instancia typeahead. |
resaltador | función | resalta todas as coincidencias predeterminadas | Método utilizado para resaltar os resultados de autocompletar. Acepta un único argumento item e ten o alcance da instancia typeahead. Debería devolver html. |
Inicializa unha entrada cunha tipografía.
A subnavegación da esquerda é unha demostración en directo do complemento de afixos.
Para engadir facilmente un comportamento de afixo a calquera elemento, só tes que engadir data-spy="affix"
ao elemento que queres espiar. A continuación, use os desplazamentos para definir cando activar e desactivar a fixación dun elemento.
- <div data-spy = "affix" data-offset-top = "200" > ... </div>
affix
,
affix-top
, e
affix-bottom
. Lembra buscar un pai potencialmente contraído cando se activa o afixo xa que está eliminando contido do fluxo normal da páxina.
Chame ao complemento de afixos mediante JavaScript:
- $ ( '#navbar' ). afixo ()
As opcións pódense pasar a través de atributos de datos ou JavaScript. Para os atributos de datos, engada o nome da opción a data-
, como en data-offset-top="200"
.
Nome | tipo | por defecto | descrición |
---|---|---|---|
compensar | número | función | obxecto | 10 | Píxeles para compensar da pantalla ao calcular a posición do desprazamento. Se se proporciona un só número, a compensación aplicarase tanto na dirección superior como na esquerda. Para escoitar unha única dirección ou varias compensacións únicas, só tes que proporcionar un obxecto offset: { x: 10 } . Usa unha función cando necesites proporcionar unha compensación dinámica (útil para algúns deseños sensibles). |