Dê vida aos componentes do Bootstrap—agora com 13 plugins jQuery personalizados.
Os plug-ins podem ser incluídos individualmente (embora alguns tenham dependências obrigatórias) ou todos de uma vez. Ambos bootstrap.js e bootstrap.min.js contêm todos os plugins em um único arquivo.
Você pode usar todos os plugins do Bootstrap puramente por meio da API de marcação sem escrever uma única linha de JavaScript. Esta é a API de primeira classe do Bootstrap e deve ser sua primeira consideração ao usar um plugin.
Dito isso, em algumas situações, pode ser desejável desativar essa funcionalidade. Portanto, também fornecemos a capacidade de desabilitar a API de atributo de dados desvinculando todos os eventos no namespace do corpo com `'data-api'`. Isso se parece com isso:
- $ ( 'corpo' ). off ( '.data-api' )
Como alternativa, para segmentar um plug-in específico, basta incluir o nome do plug-in como um namespace junto com o namespace data-api assim:
- $ ( 'corpo' ). off ( '.alert.data-api' )
Também acreditamos que você deve ser capaz de usar todos os plugins Bootstrap puramente por meio da API JavaScript. Todas as APIs públicas são métodos únicos e encadeados e retornam a coleção em que atua.
- $ ( ".btn.danger" ). botão ( "alternar" ). addClass ( "gordo" )
Todos os métodos devem aceitar um objeto de opções opcional, uma string que tem como alvo um método específico ou nada (que inicia um plugin com comportamento padrão):
- $ ( "#meuModal" ). modal () // inicializado com padrões
- $ ( "#meuModal" ). modal ({ teclado : falso }) // inicializado sem teclado
- $ ( "#meuModal" ). modal ( 'show' ) // inicializa e invoca show imediatamente
Cada plugin também expõe seu construtor bruto em uma propriedade `Constructor`: $.fn.popover.Constructor
. Se você quiser obter uma instância de plug-in específica, recupere-a diretamente de um elemento: $('[rel=popover]').data('popover')
.
Às vezes é necessário usar plugins do Bootstrap com outros frameworks de UI. Nessas circunstâncias, colisões de namespace podem ocorrer ocasionalmente. Se isso acontecer, você pode chamar .noConflict
o plugin para o qual deseja reverter o valor.
- var bootstrapButton = $ . f . botão . noConflict () // retorna $.fn.button para o valor atribuído anteriormente
- $ . f . bootstrapBtn = bootstrapButton // dá a $().bootstrapBtn a funcionalidade de bootstrap
O Bootstrap fornece eventos personalizados para a maioria das ações exclusivas do plugin. Geralmente, eles vêm na forma de infinitivo e particípio passado - onde o infinitivo (ex. show
) é acionado no início de um evento, e sua forma de particípio passado (ex. shown
) é acionada na conclusão de uma ação.
Todos os eventos infinitivos fornecem a funcionalidade preventDefault. Isso fornece a capacidade de interromper a execução de uma ação antes que ela comece.
- $ ( '#meuModal' ). on ( 'mostrar' , função ( e ) {
- if (! data ) return e . preventDefault () // impede que o modal seja mostrado
- })
Para efeitos de transição simples, inclua bootstrap-transition.js uma vez junto com os outros arquivos JS. Se você estiver usando o bootstrap.js compilado (ou minificado) , não há necessidade de incluí-lo — ele já está lá.
Alguns exemplos do plugin de transição:
Os modais são prompts de diálogo simplificados, mas flexíveis, com a funcionalidade mínima necessária e padrões inteligentes.
Um modal renderizado com cabeçalho, corpo e conjunto de ações no rodapé.
Um belo corpo…
- <div class = "modal hide fade" >
- <div class = "modal-header" >
- <button type = "button" class = "close" data-dismiss = "modal" aria-hidden = "true" > × </button>
- <h3> Cabeçalho modal </h3>
- </div>
- <div class = "modal-body" >
- <p> Um belo corpo… </p>
- </div>
- <div class = "modal-footer" >
- <a href = "#" class = "btn" > Fechar </a>
- <a href = "#" class = "btn btn-primary" > Salvar alterações </a>
- </div>
- </div>
Alterne um modal via JavaScript clicando no botão abaixo. Ele deslizará para baixo e desaparecerá do topo da página.
- <!-- Botão para acionar modal -->
- <a href = "#myModal" role = "button" class = "btn" data-toggle = "modal" > Iniciar modal de demonstração </a>
- <!-- Modal -->
- <div id = "myModal" class = "modal hide fade" tabindex = "-1" role = "dialog" aria-labelledby = "myModalLabel" aria-hidden = "true" >
- <div class = "modal-header" >
- <button type = "button" class = "close" data-dismiss = "modal" aria-hidden = "true" > × </button>
- <h3 id = "myModalLabel" > Cabeçalho modal </h3>
- </div>
- <div class = "modal-body" >
- <p> Um belo corpo… </p>
- </div>
- <div class = "modal-footer" >
- <button class = "btn" data-dismiss = "modal" aria-hidden = "true" > Fechar </button>
- <button class = "btn btn-primary" > Salvar alterações </button>
- </div>
- </div>
Ative um modal sem escrever JavaScript. Definido data-toggle="modal"
em um elemento do controlador, como um botão, junto com um data-target="#foo"
ou href="#foo"
para direcionar um modal específico para alternar.
- <button type = "button" data-toggle = "modal" data-target = "#myModal" > Iniciar modal </button>
Chame um modal com id myModal
com uma única linha de JavaScript:
- $ ( '#meuModal' ). modal ( opções )
As opções podem ser passadas por meio de atributos de dados ou JavaScript. Para atributos de dados, anexe o nome da opção a data-
, como em data-backdrop=""
.
Nome | modelo | predefinição | Descrição |
---|---|---|---|
pano de fundo | boleano | verdadeiro | Inclui um elemento de pano de fundo modal. Como alternativa, especifique static um pano de fundo que não feche o modal ao clicar. |
teclado | boleano | verdadeiro | Fecha o modal quando a tecla Escape é pressionada |
mostrar | boleano | verdadeiro | Mostra o modal quando inicializado. |
controlo remoto | caminho | falso | Se uma url remota for fornecida, o conteúdo será carregado pelo
|
Ativa seu conteúdo como um modal. Aceita opções opcionais object
.
- $ ( '#meuModal' ). modal ({
- teclado : falso
- })
Alterna manualmente um modal.
- $ ( '#meuModal' ). modal ( 'alternar' )
Abre manualmente um modal.
- $ ( '#meuModal' ). modal ( 'mostrar' )
Oculta manualmente um modal.
- $ ( '#meuModal' ). modal ( 'esconder' )
A classe modal do Bootstrap expõe alguns eventos para conexão com a funcionalidade modal.
Evento | Descrição |
---|---|
mostrar | Este evento é acionado imediatamente quando o show método de instância é chamado. |
mostrando | Este evento é acionado quando o modal se torna visível para o usuário (aguardará a conclusão das transições css). |
ocultar | Este evento é acionado imediatamente quando o hide método de instância é chamado. |
escondido | Este evento é acionado quando o modal termina de ser ocultado do usuário (aguardará a conclusão das transições css). |
- $ ( '#meuModal' ). on ( 'oculto' , função () {
- // faça alguma coisa…
- })
Adicione menus suspensos a quase tudo com este plug-in simples, incluindo a barra de navegação, guias e pílulas.
Adicione data-toggle="dropdown"
a um link ou botão para alternar uma lista suspensa.
- <div class = "dropdown" >
- <a class = "dropdown-toggle" data-toggle = "dropdown" href = "#" > Acionador da lista suspensa </a>
- <ul class = "menu suspenso" role = "menu" aria-labelledby = "dLabel" >
- ...
- </ul>
- </div>
Para manter os URLs intactos, use o data-target
atributo em vez de href="#"
.
- <div class = "dropdown" >
- <a class = "dropdown-toggle" id = "dLabel" role = "button" data-toggle = "dropdown" data-target = "#" href = "/page.html" >
- Suspenso
- <b class = "caret" ></b>
- </a>
- <ul class = "menu suspenso" role = "menu" aria-labelledby = "dLabel" >
- ...
- </ul>
- </div>
Chame as listas suspensas via JavaScript:
- $ ( '.dropdown-toggle' ). lista suspensa ()
Nenhum
Uma API programática para alternar menus para uma determinada barra de navegação ou navegação com guias.
O plugin ScrollSpy é para atualizar automaticamente os destinos de navegação com base na posição de rolagem. Role a área abaixo da barra de navegação e observe a mudança de classe ativa. Os subitens suspensos também serão destacados.
Ad legging keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi antes de esgotar qui. Direitos de bicicleta da fazenda à mesa no Tumblr, qualquer que seja. Cardigan Anim Keffiyeh Carles. Cabine de fotos de Velit seitan mcsweeney 3 wolf moon irure. Cosby suéter lomo jean shorts, williamsburg hoodie minim qui você provavelmente não ouviu falar deles et cardigan trust fund culpa biodiesel wes anderson estético. Nihil tatuado accusamus, cred ironia biodiesel keffiyeh artesão ullamco consequat.
Skate de bigode Veniam marfa, barba de forquilha adipisical fugiat velit. Freegan barba aliqua cupidatat mcsweeney's vero. Cupidatat four loko nisi, ea helvetica nulla carles. Caminhão de comida de suéter cosby tatuado, vinil quis non freegan de mcsweeney. Lo-fi wes anderson +1 alfaiataria. A exercitação não estética de Carles quis gentrificar. Brooklyn adipisicing cerveja artesanal vice keytar deserunt.
Occaecat commodo aliqua delectus. Fap cerveja artesanal deserto skate ea. Lomo bike rights adipisicing banh mi, velit ea sunt next level locavore café de origem única em magna veniam. High life id vinil, echo park consequat quis aliquip banh mi pitchfork. Vero VHS é adipisco. Bolsa de mensageiro minim Consectetur nisi DIY. Cred ex in, sustentável delectus consectetur fanny pack iphone.
In incididunt echo park, officia deserunt mcsweeney's proident master cleanse thundercats sapiente veniam. Excepteur VHS elit, proident shoreditch +1 biodiesel laborum craft beer. Single-origin coffee wayfarers irure four loko, cupidatat terry richardson master cleanse. Assumenda you probably haven't heard of them art party fanny pack, tattooed nulla cardigan tempor ad. Proident wolf nesciunt sartorial keffiyeh eu banh mi sustainable. Elit wolf voluptate, lo-fi ea portland before they sold out four loko. Locavore enim nostrud mlkshk brooklyn nesciunt.
Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi before they sold out qui. Tumblr farm-to-table bicycle rights whatever. Anim keffiyeh carles cardigan. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby sweater lomo jean shorts, williamsburg hoodie minim qui you probably haven't heard of them et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tattooed accusamus, cred irony biodiesel keffiyeh artisan ullamco consequat.
Keytar twee blog, culpa messenger bag marfa qualquer que seja o food truck delectus. Sapiente synth id assumido. Locavore sed helvetica ironia clichê, thundercats você provavelmente não ouviu falar deles consequat hoodie sem glúten fap aliquip lo-fi. Labore elit placeat antes de esgotar, terry richardson proident brunch nesciunt quis cosby suéter pariatur keffiyeh ut helvetica artisan. Cardigan cerveja artesanal seitan readymade velit. VHS chambray laboris tempor veniam. Anim mollit minim comodo ullamco thundercats.
Para adicionar facilmente o comportamento do scrollspy à sua navegação na barra superior, basta adicionar data-spy="scroll"
o elemento que você deseja espionar (geralmente esse seria o corpo) e data-target=".navbar"
selecionar qual navegação usar. Você vai querer usar scrollspy com um .nav
componente.
- <body data-spy = "scroll" data-target = ".navbar" > ... </body>
Chame o scrollspy via JavaScript:
- $ ( '#navbar' ). espião de rolagem ()
<a href="#home">home</a>
deve corresponder a algo no dom como
<div id="home"></div>
.
Ao usar o scrollspy em conjunto com a adição ou remoção de elementos do DOM, você precisará chamar o método de atualização da seguinte forma:
- $ ( '[data-spy="scroll"]' ). cada ( função () {
- var $ espião = $ ( this ). scrollspy ( 'atualizar' )
- });
As opções podem ser passadas por meio de atributos de dados ou JavaScript. Para atributos de dados, anexe o nome da opção a data-
, como em data-offset=""
.
Nome | modelo | predefinição | Descrição |
---|---|---|---|
Deslocamento | número | 10 | Pixels para compensar a partir do topo ao calcular a posição de rolagem. |
Evento | Descrição |
---|---|
ativar | Este evento é acionado sempre que um novo item é ativado pelo scrollspy. |
Adicione a funcionalidade de guia rápida e dinâmica para fazer a transição entre painéis de conteúdo local, mesmo por meio de menus suspensos.
Denim bruto você provavelmente não ouviu falar deles shorts jeans Austin. Nesciunt tofu stumptown aliqua, retro synth master cleanse. Bigode clichê tempor, williamsburg carles vegan helvetica. Repreendê-lo açougueiro retro keffiyeh sintetizador dreamcatcher. Suéter Cosby eu banh mi, qui irure terry richardson ex squid. Aliquip placeat salvia cillum iphone. Seitan aliquip quis cardigan americano vestuário, açougueiro 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.
Habilite as guias com guias via JavaScript (cada guia precisa ser ativada individualmente):
- $ ( '#minhaTab a' ). clique ( função ( e ) {
- e . preventDefault ();
- $ ( isso ). tab ( 'mostrar' );
- })
Você pode ativar guias individuais de várias maneiras:
- $ ( '#myTab a[href="#profile"]' ). tab ( 'mostrar' ); // Seleciona a aba pelo nome
- $ ( '#myTab a:primeiro' ). tab ( 'mostrar' ); // Seleciona a primeira aba
- $ ( '#minhaTab a:último' ). tab ( 'mostrar' ); // Seleciona a última aba
- $ ( '#minhaTab li:eq(2) a' ). tab ( 'mostrar' ); // Selecione a terceira guia (indexada a 0)
Você pode ativar uma navegação por guias ou pílulas sem escrever nenhum JavaScript simplesmente especificando data-toggle="tab"
ou data-toggle="pill"
em um elemento. Adicionar as classes nav
e nav-tabs
à guia ul
aplicará o estilo da guia Bootstrap.
- <ul class = "nav nav-tabs" >
- <li><a href = "#home" data-toggle = "tab" > Página inicial </a></li>
- <li><a href = "#profile" data-toggle = "tab" > Perfil </a></li>
- <li><a href = "#messages" data-toggle = "tab" > Mensagens </a></li>
- <li><a href = "#settings" data-toggle = "tab" > Configurações </a></li>
- </ul>
Ativa um elemento de guia e um contêiner de conteúdo. A guia deve ter um data-target
ou um href
direcionamento para um nó de contêiner no DOM.
- <ul class = "nav nav-tabs" id = "myTab" >
- <li class = "ativo" ><a href = "#home" > Página inicial </a></li>
- <li><a href = "#profile" > Perfil </a></li>
- <li><a href = "#messages" > Mensagens </a></li>
- <li><a href = "#settings" > Configurações </a></li>
- </ul>
- <div class = "tab-content" >
- <div class = "tab-pane ativo" id = "home" > ... </div>
- <div class = "tab-pane" id = "perfil" > ... </div>
- <div class = "tab-pane" id = "mensagens" > ... </div>
- <div class = "tab-pane" id = "configurações" > ... </div>
- </div>
- <script>
- $ ( função () {
- $ ( '#minhaTab a:último' ). tab ( 'mostrar' );
- })
- </script>
Evento | Descrição |
---|---|
mostrar | Este evento é acionado na exibição de guias, mas antes que a nova guia seja exibida. Use event.target e event.relatedTarget para direcionar a guia ativa e a guia ativa anterior (se disponível), respectivamente. |
mostrando | Este evento é acionado na exibição de guias após a exibição de uma guia. Use event.target e event.relatedTarget para direcionar a guia ativa e a guia ativa anterior (se disponível), respectivamente. |
- $ ( 'a[data-toggle="tab"]' ). on ( 'mostrado' , função ( e ) {
- e . alvo // aba ativada
- e . relatedTarget // aba anterior
- })
Inspirado no excelente plugin jQuery.tipy escrito por Jason Frame; As dicas de ferramentas são uma versão atualizada, que não depende de imagens, usa CSS3 para animações e atributos de dados para armazenamento local de títulos.
Por motivos de desempenho, a dica de ferramenta e as APIs de dados popover são aceitas, o que significa que você deve inicializá-las você mesmo .
Passe o mouse sobre os links abaixo para ver dicas de ferramentas:
Calças apertadas keffiyeh de próximo nível você provavelmente não ouviu falar deles. Cabine de fotos barba jeans crua tipografia bolsa carteiro vegana stumptown. O seitan da fazenda à mesa, o vestuário americano de 8 bits de quinoa sustentável fixie da mcsweeney tem uma chambray de vinil terry richardson. Beard stumptown, cardigans banh mi lomo thundercats. Tofu biodiesel williamsburg marfa, quatro loko mcsweeney's cleanse vegan chambray. Um artesão realmente irônico , qualquer keytar , scenester farm-to-table banksy Austin twitter lidar com café de origem única.
Ao usar dicas de ferramentas e popovers com os grupos de entrada do Bootstrap, você terá que definir a container
opção (documentada abaixo) para evitar efeitos colaterais indesejados.
Acione a dica de ferramenta via JavaScript:
- $ ( '#exemplo' ). dica de ferramenta ( opções )
As opções podem ser passadas por meio de atributos de dados ou JavaScript. Para atributos de dados, anexe o nome da opção a data-
, como em data-animation=""
.
Nome | modelo | predefinição | Descrição |
---|---|---|---|
animação | boleano | verdadeiro | aplique uma transição de fade css à dica de ferramenta |
html | boleano | falso | Insira html na dica de ferramenta. Se false, o text método do jquery será usado para inserir conteúdo no dom. Use texto se estiver preocupado com ataques XSS. |
colocação | seqüência | função | 'topo' | como posicionar a dica de ferramenta - top | inferior | esquerda | certo |
seletor | corda | falso | Se um seletor for fornecido, os objetos de dica de ferramenta serão delegados aos destinos especificados. |
título | seqüência | função | '' | valor de título padrão se a tag `title` não estiver presente |
acionar | corda | 'foco flutuante' | como a dica de ferramenta é acionada - clique | pairar | foco | manual. Observe que você passa vários tipos de gatilho, separados por espaço,. |
atraso | número | objeto | 0 | atraso mostrando e ocultando a dica de ferramenta (ms) - não se aplica ao tipo de gatilho manual Se um número for fornecido, o atraso será aplicado tanto para ocultar/exibir A estrutura do objeto é: |
recipiente | seqüência | falso | falso | Anexa a dica de ferramenta a um elemento específico |
- <a href = "#" data-toggle = "dica de ferramenta" title = "primeira dica de ferramenta" > passe o mouse sobre mim </a>
Anexa um manipulador de dica de ferramenta a uma coleção de elementos.
Revela a dica de ferramenta de um elemento.
- $ ( '#elemento' ). dica de ferramenta ( 'mostrar' )
Oculta a dica de ferramenta de um elemento.
- $ ( '#elemento' ). dica de ferramenta ( 'ocultar' )
Alterna a dica de ferramenta de um elemento.
- $ ( '#elemento' ). dica de ferramenta ( 'toggle' )
Oculta e destrói a dica de ferramenta de um elemento.
- $ ( '#elemento' ). dica de ferramenta ( 'destruir' )
Adicione pequenas sobreposições de conteúdo, como as do iPad, a qualquer elemento para abrigar informações secundárias. Passe o mouse sobre o botão para acionar o popover. Requer a inclusão da dica de ferramenta .
Quatro opções estão disponíveis: alinhamento superior, direito, inferior e alinhamento à esquerda.
Sed posuere consectetur est em lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est em lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est em lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est em lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Nenhuma marcação mostrada como popovers é gerada a partir de JavaScript e conteúdo dentro de um data
atributo.
Habilite popovers via JavaScript:
- $ ( '#exemplo' ). popover ( opções )
As opções podem ser passadas por meio de atributos de dados ou JavaScript. Para atributos de dados, anexe o nome da opção a data-
, como em data-animation=""
.
Nome | modelo | predefinição | Descrição |
---|---|---|---|
animação | boleano | verdadeiro | aplique uma transição de fade css à dica de ferramenta |
html | boleano | falso | Insira html no popover. Se false, o text método do jquery será usado para inserir conteúdo no dom. Use texto se estiver preocupado com ataques XSS. |
colocação | seqüência | função | 'certo' | como posicionar o popover - top | inferior | esquerda | certo |
seletor | corda | falso | se um seletor for fornecido, os objetos de dica de ferramenta serão delegados aos destinos especificados |
acionar | corda | 'clique' | como o popover é acionado - clique | pairar | foco | manual |
título | seqüência | função | '' | valor de título padrão se o atributo `title` não estiver presente |
contente | seqüência | função | '' | valor de conteúdo padrão se o atributo `data-content` não estiver presente |
atraso | número | objeto | 0 | atraso mostrando e ocultando o popover (ms) - não se aplica ao tipo de gatilho manual Se um número for fornecido, o atraso será aplicado tanto para ocultar/exibir A estrutura do objeto é: |
recipiente | seqüência | falso | falso | Acrescenta o popover a um elemento específico |
Por motivos de desempenho, as APIs de dados de dica de ferramenta e popover são aceitas. Se você quiser usá-las, basta especificar uma opção de seletor.
Inicializa popovers para uma coleção de elementos.
Revela um popover de elementos.
- $ ( '#elemento' ). popover ( 'mostrar' )
Oculta um popover de elementos.
- $ ( '#elemento' ). popover ( 'esconder' )
Alterna um popover de elementos.
- $ ( '#elemento' ). popover ( 'alternar' )
Esconde e destrói o popover de um elemento.
- $ ( '#elemento' ). popover ( 'destruir' )
Adicione a funcionalidade de dispensa a todas as mensagens de alerta com este plug-in.
Altere isso e aquilo e tente novamente. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.
Habilite a dispensa de um alerta via JavaScript:
- $ ( ".alerta" ). alerta ()
Basta adicionar data-dismiss="alert"
ao seu botão Fechar para fornecer automaticamente uma funcionalidade de fechamento de alerta.
- <a class = "fechar" data-dismiss = "alert" href = "#" > × </a>
Envolve todos os alertas com funcionalidade de fechamento. Para que seus alertas sejam animados quando fechados, certifique-se de que eles já tenham a classe .fade
e .in
aplicada a eles.
Fecha um alerta.
- $ ( ".alerta" ). alerta ( 'perto' )
A classe de alerta do Bootstrap expõe alguns eventos para conexão com a funcionalidade de alerta.
Evento | Descrição |
---|---|
perto | Este evento é acionado imediatamente quando o close método de instância é chamado. |
fechado | Este evento é acionado quando o alerta é fechado (aguardará a conclusão das transições css). |
- $ ( '#meu-alerta' ). bind ( 'fechado' , function () {
- // faça alguma coisa…
- })
Obtenha estilos básicos e suporte flexível para componentes dobráveis, como acordeões e navegação.
* Requer a inclusão do plugin Transitions.
Usando o plug-in de recolhimento, construímos um widget simples no estilo acordeão:
- <div class = "acordeão" id = "acordeão2" >
- <div class = "grupo-acordeão" >
- <div class = "cabeçalho de acordeão" >
- <a class = "accordion-toggle" data-toggle = "recolher" data-parent = "#accordion2" href = "#collapseOne" >
- Item de grupo dobrável nº 1
- </a>
- </div>
- <div id = "collapseOne" class = "corpo sanfonado em colapso" >
- <div class = "acordeon-inner" >
- Anim pariatur clichê...
- </div>
- </div>
- </div>
- <div class = "grupo-acordeão" >
- <div class = "cabeçalho de acordeão" >
- <a class = "accordion-toggle" data-toggle = "recolher" data-parent = "#accordion2" href = "#collapseTwo" >
- Item de grupo dobrável nº 2
- </a>
- </div>
- <div id = "collapseTwo" class = "colapso-corpo sanfonado" >
- <div class = "acordeon-inner" >
- Anim pariatur clichê...
- </div>
- </div>
- </div>
- </div>
- ...
Você também pode usar o plug-in sem a marcação de acordeão. Faça um botão alternar a expansão e o recolhimento de outro elemento.
- <button type = "button" class = "btn btn-danger" data-toggle = "recolher" data-target = "#demo" >
- simples dobrável
- </button>
- <div id = "demo" class = "recolher em" > … </div>
Basta adicionar data-toggle="collapse"
e um data-target
elemento to para atribuir automaticamente o controle de um elemento dobrável. O data-target
atributo aceita um seletor CSS ao qual aplicar o recolhimento. Certifique-se de adicionar a classe collapse
ao elemento recolhível. Se você quiser que ele seja aberto por padrão, adicione a classe adicional in
.
Para adicionar gerenciamento de grupo do tipo acordeão a um controle recolhível, adicione o atributo data data-parent="#selector"
. Consulte a demonstração para ver isso em ação.
Ative manualmente com:
- $ ( ".recolher" ). colapso ()
As opções podem ser passadas por meio de atributos de dados ou JavaScript. Para atributos de dados, anexe o nome da opção a data-
, como em data-parent=""
.
Nome | modelo | predefinição | Descrição |
---|---|---|---|
pai | seletor | falso | Se seletor, todos os elementos recolhíveis sob o pai especificado serão fechados quando este item recolhível for mostrado. (semelhante ao comportamento tradicional do acordeão) |
alternar | boleano | verdadeiro | Alterna o elemento recolhível na invocação |
Ativa seu conteúdo como um elemento recolhível. Aceita opções opcionais object
.
- $ ( '#meuRecolhível' ). recolher ({
- alternar : falso
- })
Alterna um elemento recolhível para mostrado ou oculto.
Mostra um elemento recolhível.
Oculta um elemento recolhível.
A classe de recolhimento do Bootstrap expõe alguns eventos para conexão com a funcionalidade de recolhimento.
Evento | Descrição |
---|---|
mostrar | Este evento é acionado imediatamente quando o show método de instância é chamado. |
mostrando | Este evento é acionado quando um elemento de recolhimento se torna visível para o usuário (aguardará a conclusão das transições css). |
ocultar | Este evento é disparado imediatamente quando o hide método é chamado. |
escondido | Este evento é acionado quando um elemento de recolhimento foi ocultado do usuário (aguardará a conclusão das transições css). |
- $ ( '#meuRecolhível' ). on ( 'oculto' , função () {
- // faça alguma coisa…
- })
A apresentação de slides abaixo mostra um plugin genérico e um componente para percorrer elementos como um carrossel.
- <div id = "myCarousel" class = "carousel slide" >
- <ol class = "carrossel-indicadores" >
- <li data-target = "#myCarousel" data-slide-to = "0" class = "active" ></li>
- <li data-target = "#myCarousel" data-slide-to = "1" ></li>
- <li data-target = "#myCarousel" data-slide-to = "2" ></li>
- </ol>
- <!-- Itens do carrossel -->
- <div class = "carousel-inner" >
- <div class = "item ativo" > … </div>
- <div class = "item" > … </div>
- <div class = "item" > … </div>
- </div>
- <!-- Carrossel de navegação -->
- <a class = "carousel-control left" href = "#myCarousel" data-slide = "prev" > ‹ </a>
- <a class = "carousel-control right" href = "#myCarousel" data-slide = "next" > › </a>
- </div>
Use atributos de dados para controlar facilmente a posição do carrossel. data-slide
aceita as palavras-chave prev
ou next
, que altera a posição do slide em relação à sua posição atual. Como alternativa, use data-slide-to
para passar um índice bruto de slide para o carrossel data-slide-to="2"
, que pula a posição do slide para um índice específico começando com 0
.
Chame o carrossel manualmente com:
- $ ( '.carrossel' ). carrossel ()
As opções podem ser passadas através de atributos de dados ou JavaScriptz. Para atributos de dados, anexe o nome da opção a data-
, como em data-interval=""
.
Nome | modelo | predefinição | Descrição |
---|---|---|---|
intervalo | número | 5000 | A quantidade de tempo de atraso entre o ciclo automático de um item. Se for falso, o carrossel não fará o ciclo automaticamente. |
pausa | corda | "flutuar" | Pausa o ciclo do carrossel no mouseenter e retoma o ciclo do carrossel no mouseleave. |
Inicializa o carrossel com opções opcionais object
e começa a percorrer os itens.
- $ ( '.carrossel' ). carrossel ({
- intervalo : 2000
- })
Percorre os itens do carrossel da esquerda para a direita.
Interrompe o carrossel de percorrer os itens.
Alterna o carrossel para um quadro específico (baseado em 0, semelhante a uma matriz).
Volta para o item anterior.
Alterna para o próximo item.
A classe carrossel do Bootstrap expõe dois eventos para conectar-se à funcionalidade do carrossel.
Evento | Descrição |
---|---|
deslizar | Esse evento é acionado imediatamente quando o slide método de instância é invocado. |
deslizou | Este evento é acionado quando o carrossel conclui sua transição de slides. |
Um plug-in básico e facilmente estendido para criar rapidamente tipos elegantes com qualquer entrada de texto de formulário.
- <input type = "texto" data-provide = "typeahead" >
Você deve definir autocomplete="off"
para evitar que os menus padrão do navegador apareçam no menu suspenso de digitação antecipada do Bootstrap.
Adicione atributos de dados para registrar um elemento com a funcionalidade de digitação antecipada, conforme mostrado no exemplo acima.
Chame o typeahead manualmente com:
- $ ( '.typeahead' ). digitação ()
As opções podem ser passadas por meio de atributos de dados ou JavaScript. Para atributos de dados, anexe o nome da opção a data-
, como em data-source=""
.
Nome | modelo | predefinição | Descrição |
---|---|---|---|
fonte | matriz, função | [ ] | A fonte de dados a ser consultada. Pode ser um array de strings ou uma função. A função recebe dois argumentos, o query valor no campo de entrada e o process retorno de chamada. A função pode ser usada de forma síncrona retornando a fonte de dados diretamente ou de forma assíncrona por meio process do argumento único do retorno de chamada. |
Itens | número | 8 | O número máximo de itens a serem exibidos na lista suspensa. |
minLength | número | 1 | O comprimento mínimo de caracteres necessário antes de acionar sugestões de preenchimento automático |
combinador | função | não diferencia maiúsculas de minúsculas | O método usado para determinar se uma consulta corresponde a um item. Aceita um único argumento, item contra o qual testar a consulta. Acesse a consulta atual com this.query . Retorna um booleano true se a consulta for uma correspondência. |
classificador | função | correspondência exata, diferencia maiúsculas de minúsculas, não diferencia maiúsculas de minúsculas |
Método usado para classificar resultados de preenchimento automático. Aceita um único argumento items e tem o escopo da instância typeahead. Referencie a consulta atual com this.query . |
atualizador | função | retorna o item selecionado | O método usado para retornar o item selecionado. Aceita um único argumento, o item e tem o escopo da instância typeahead. |
marcador | função | destaca todas as correspondências padrão | Método usado para destacar resultados de preenchimento automático. Aceita um único argumento item e tem o escopo da instância typeahead. Deve retornar html. |
Inicializa uma entrada com um typeahead.
A subnavegação à esquerda é uma demonstração ao vivo do plugin affix.
Para adicionar facilmente o comportamento do afixo a qualquer elemento, basta adicionar data-spy="affix"
ao elemento que você deseja espionar. Em seguida, use deslocamentos para definir quando ativar e desativar a fixação de um elemento.
- <div data-spy = "affix" data-offset-top = "200" > ... </div>
affix
,
affix-top
, e
affix-bottom
. Lembre-se de verificar se há um pai potencialmente recolhido quando o afixo for ativado, pois está removendo o conteúdo do fluxo normal da página.
Chame o plug-in afixo via JavaScript:
- $ ( '#navbar' ). afixo ()
As opções podem ser passadas por meio de atributos de dados ou JavaScript. Para atributos de dados, anexe o nome da opção a data-
, como em data-offset-top="200"
.
Nome | modelo | predefinição | Descrição |
---|---|---|---|
Deslocamento | número | função | objeto | 10 | Pixels a serem deslocados da tela ao calcular a posição de rolagem. Se for fornecido um único número, o deslocamento será aplicado nas direções superior e esquerda. Para ouvir uma única direção ou vários deslocamentos exclusivos, basta fornecer um objeto offset: { x: 10 } . Use uma função quando precisar fornecer um deslocamento dinamicamente (útil para alguns designs responsivos). |