Bootstrap JS suspenso


Classes CSS suspensas

Para um tutorial sobre Dropdowns, leia nosso Tutorial Bootstrap Dropdowns .

Class Description Example
.dropdown Indicates a dropdown menu
.dropdown-item Style links inside the dropdown menu with proper padding etc
.dropdown-item-text Style text or text links inside the dropdown menu with proper padding etc
.dropdown-menu Builds the dropdown menu
.dropdown-menu-right Right-aligns a dropdown menu
.dropdown-header Adds a header inside the dropdown menu
.dropup Indicates a dropup menu
.disabled Disables an item in the dropdown menu
.active Styles the active element in a dropdown menu
.divider Separates items inside the dropdown menu with a horizontal line

Via dados-* Atributos

Adicione data-toggle="dropdown"a um link ou botão para alternar um menu suspenso.

Exemplo

<button type="button" class="dropdown-toggle" data-toggle="dropdown">Dropdown Example</button>

Por JavaScript

Ative manualmente com:

Exemplo

$('.dropdown-toggle').dropdown();

Observação: o atributo data-toggle="dropdown" é necessário independentemente de você chamar o método dropdown().


Opções suspensas

None

Métodos suspensos

A tabela a seguir lista todos os métodos suspensos disponíveis.

Method Description Try it
.dropdown("toggle") Toggles the dropdown. If set, it will open the dropdown menu by default
.dropdown("update") Updates the position of an element's dropdown
.dropdown("dispose") Destroys an element's dropdown

Eventos suspensos

A tabela a seguir lista todos os eventos suspensos disponíveis.

Event Description Try it
show.bs.dropdown Occurs when the dropdown is about to be shown.
shown.bs.dropdown Occurs when the dropdown is fully shown (after CSS transitions have completed)
hide.bs.dropdown Occurs when the dropdown is about to be hidden
hidden.bs.dropdown Occurs when the dropdown is fully hidden (after CSS transitions have completed)

Dica: Use event.relatedTarget do jQuery para obter o elemento que acionou o menu suspenso:

Exemplo

$(".dropdown").on("show.bs.dropdown", function(event){
  var x = $(event.relatedTarget).text(); // Get the text of the element
  alert(x);
});