Botões
Use os estilos de botão personalizados do Bootstrap para ações em formulários, caixas de diálogo e muito mais com suporte para vários tamanhos, estados e muito mais.
Exemplos
O Bootstrap inclui vários estilos de botão predefinidos, cada um servindo a seu próprio propósito semântico, com alguns extras adicionados para maior controle.
Transmitindo significado às tecnologias assistivas
Usar cores para adicionar significado fornece apenas uma indicação visual, que não será transmitida aos usuários de tecnologias assistivas – como leitores de tela. Certifique-se de que as informações indicadas pela cor sejam óbvias do próprio conteúdo (por exemplo, o texto visível) ou sejam incluídas por meios alternativos, como texto adicional oculto com a .sr-only
classe.
Desabilitar quebra de texto
Se você não quiser que o texto do botão seja quebrado, você pode adicionar a .text-nowrap
classe ao botão. No Sass, você pode definir $btn-white-space: nowrap
para desabilitar a quebra de texto para cada botão.
Etiquetas de botão
As .btn
classes são projetadas para serem usadas com o <button>
elemento. No entanto, você também pode usar essas classes em <a>
ou <input>
elementos (embora alguns navegadores possam aplicar uma renderização ligeiramente diferente).
Ao usar classes de botão em <a>
elementos que são usados para acionar a funcionalidade na página (como recolher conteúdo), em vez de vincular a novas páginas ou seções na página atual, esses links devem receber um role="button"
para transmitir adequadamente sua finalidade a tecnologias assistivas, como leitores de tela.
Botões de contorno
Precisa de um botão, mas não das cores de fundo pesadas que eles trazem? Substitua as classes modificadoras padrão pelas .btn-outline-*
que removem todas as imagens e cores de fundo em qualquer botão.
Tamanhos
Gosta de botões maiores ou menores? Adicione .btn-lg
ou .btn-sm
para tamanhos adicionais.
Crie botões de nível de bloco - aqueles que abrangem toda a largura de um pai - adicionando .btn-block
.
Estado ativo
Os botões aparecerão pressionados (com um fundo mais escuro, borda mais escura e sombra inserida) quando ativos. Não há necessidade de adicionar uma classe a <button>
s, pois eles usam uma pseudo-classe . No entanto, você ainda pode forçar a mesma aparência ativa com .active
(e incluir o aria-pressed="true"
atributo) caso precise replicar o estado programaticamente.
Estado desativado
Faça os botões parecerem inativos adicionando o disabled
atributo booleano a qualquer <button>
elemento.
Botões desabilitados usando o <a>
elemento se comportam um pouco diferente:
<a>
s não suportam odisabled
atributo, então você deve adicionar a.disabled
classe para fazê-la parecer visualmente desabilitada.- Alguns estilos amigáveis para o futuro estão incluídos para desativar todos os
pointer-events
botões de âncora. Em navegadores que suportam essa propriedade, você não verá o cursor desabilitado. - Botões desabilitados devem incluir o
aria-disabled="true"
atributo para indicar o estado do elemento para tecnologias assistivas.
Aviso de funcionalidade do link
A .disabled
classe usa pointer-events: none
para tentar desabilitar a funcionalidade de link de <a>
s, mas essa propriedade CSS ainda não está padronizada. Além disso, mesmo em navegadores que suportam pointer-events: none
, a navegação pelo teclado permanece inalterada, o que significa que usuários de teclado com visão e usuários de tecnologias assistivas ainda poderão ativar esses links. Portanto, por segurança, adicione um tabindex="-1"
atributo nesses links (para evitar que eles recebam o foco do teclado) e use JavaScript personalizado para desabilitar sua funcionalidade.
Plug-in de botão
Faça mais com botões. Controle os estados dos botões ou crie grupos de botões para mais componentes, como barras de ferramentas.
Alternar estados
Adicionar data-toggle="button"
para alternar o active
estado de um botão. Se você estiver alternando previamente um botão, deverá adicionar manualmente a .active
classe e aria-pressed="true"
ao arquivo <button>
.
Caixa de seleção e botões de opção
Os estilos do Bootstrap .button
podem ser aplicados a outros elementos, como <label>
s, para fornecer alternância de caixa de seleção ou botão de estilo de rádio. Adicione data-toggle="buttons"
a um .btn-group
que contém esses botões modificados para habilitar seu comportamento de alternância via JavaScript e adicione .btn-group-toggle
para estilizar os <input>
s em seus botões. Observe que você pode criar botões com alimentação de entrada única ou grupos deles.
O estado marcado para esses botões só é atualizado via click
evento no botão. Se você usar outro método para atualizar a entrada—por exemplo, com <input type="reset">
ou aplicando manualmente a propriedade da entrada — checked
você precisará ativar manualmente..active
<label>
Observe que os botões pré-marcados exigem que você adicione manualmente a .active
classe ao arquivo <label>
.
Métodos
Método | Descrição |
---|---|
$().button('toggle') |
Alterna o estado de push. Dá ao botão a aparência de que foi ativado. |
$().button('dispose') |
Destrói o botão de um elemento. |