JS Dropdown (dropdown.js)
Um menu suspenso é um menu toggleable que permite ao usuário para escolher um valor de uma lista pré-definida.
Para um tutorial sobre Dropdowns, leia nossa Bootstrap Dropdowns Tutorial .
As Classes suspensa Plugin
| Classe | Descrição | Exemplo |
|---|---|---|
| .dropdown | Indica um menu suspenso | Tente |
| .dropdown-menu | Constrói o menu dropdown | Tente |
| .dropdown-menu-right | Direita alinha um menu suspenso | Tente |
| .dropdown-header | Adiciona um cabeçalho dentro do menu dropdown | Tente |
| .dropup | Indica um menu dropup | Tente |
| .disabled | Desativa um item no menu suspenso | Tente |
| .divider | Separa itens dentro do menu suspenso com uma linha horizontal | Tente |
Via data-* Atributos
Adicionar data-toggle="dropdown" para um link ou um botão para alternar um menu suspenso.
Exemplo
<a href="#" class="dropdown-toggle"
data-toggle="dropdown">Dropdown Example</a>
Tente você mesmo " via JavaScript
Habilitar manualmente com:
Nota: A data-toggle="dropdown" atributo é obrigatório, independentemente de você chamar o dropdown() método.
Opções suspensas
| None |
Métodos suspensas
A tabela a seguir lista os métodos suspensos todos disponíveis.
| Método | Descrição | Tente |
|---|---|---|
| .dropdown("toggle") | Alterna o menu suspenso | Tente |
Eventos suspensas
A tabela a seguir lista os eventos suspensos todos disponíveis.
| Evento | Descrição | Tente |
|---|---|---|
| show.bs.dropdown | Ocorre quando o menu suspenso está prestes a ser mostrado. | Tente |
| shown.bs.dropdown | Ocorre quando a lista suspensa é totalmente mostrado (após transições CSS foram concluídas) | Tente |
| hide.bs.dropdown | Ocorre quando a lista suspensa é prestes a ser ocultado | Tente |
| hidden.bs.dropdown | Ocorre quando a lista suspensa é totalmente escondida (após transições CSS foram concluídas) | Tente |
Dica: Use jQuery event.relatedTarget para obter o elemento que desencadeou o menu suspenso:
Exemplo
$(".dropdown").on("show.bs.dropdown", function(event){
var x = $(event.relatedTarget).text(); // Get the text of the element
alert(x);
}); Tente você mesmo " 
Exemplos
Alterar o ícone acento circunflexo a cabeça para baixo
O exemplo a seguir altera o ícone acento circunflexo de apontar para baixo, para cima ao clicar no menu suspenso:
Exemplo
/* CSS: */
<style>
.caret.caret-up {
border-top-width: 0;
border-bottom: 4px solid #fff;
}
</style>
/* JS: */
<script>
$(document).ready(function(){
$(".dropdown").on("hide.bs.dropdown", function(){
$(".btn").html('Dropdown
<span class="caret"></span>');
});
$(".dropdown").on("show.bs.dropdown",
function(){
$(".btn").html('Dropdown <span
class="caret caret-up"></span>');
});
});
</script> Tente você mesmo " Navbar Com suspensa
O exemplo a seguir adiciona um menu suspenso para um botão na barra de navegação:
Exemplo
<nav class="navbar navbar-inverse">
<div class="container-fluid">
<div class="navbar-header">
<a class="navbar-brand" href="#">WebSiteName</a>
</div>
<div>
<ul class="nav navbar-nav">
<li class="active"><a href="#">Home</a></li>
<li
class="dropdown">
<a
class="dropdown-toggle" data-toggle="dropdown" href="#">Page
1
<span class="caret"></span></a>
<ul
class="dropdown-menu">
<li><a href="#">Page
1-1</a></li>
<li><a href="#">Page
1-2</a></li>
<li><a href="#">Page
1-3</a></li>
</ul>
</li>
<li><a href="#">Page 2</a></li>
<li><a href="#">Page 3</a></li>
</ul>
</div>
</div>
</nav> Tente você mesmo " O exemplo a seguir adiciona um menu suspenso com um formulário de login na barra de navegação:
Exemplo
<ul class="nav navbar-nav navbar-right">
<li class="dropdown">
<a class="dropdown-toggle" data-toggle="dropdown" href="#">Login <span
class="glyphicon glyphicon-log-in"></span></a>
<div
class="dropdown-menu">
<form
id="formlogin" class="form container-fluid">
<div class="form-group">
<label for="usr">Name:</label>
<input type="text" class="form-control" id="usr">
</div>
<div
class="form-group">
<label for="pwd">Password:</label>
<input type="password" class="form-control" id="pwd">
</div>
<button
type="button" id="btnLogin" class="btn btn-block">Login</button>
</form>
<div class="container-fluid">
<a class="small" href="#">Forgot password?</a>
</div>
</div>
</li>
</ul> Tente você mesmo " Dropdowns Multi-Nível
Neste exemplo, usamos jQuery para abrir menus suspensos de multi-nível no clique:
Exemplo
<script>
$(document).ready(function(){
$('.dropdown-submenu a.test').on("click",
function(e){
$(this).next('ul').toggle();
e.stopPropagation();
e.preventDefault();
});
});
</script> Tente você mesmo " Neste exemplo, criamos um costume .dropdown-submenu classe para dropdowns multi-nível:
Exemplo
/* CSS: */
<style>
.dropdown-submenu {
position: relative;
}
.dropdown-submenu .dropdown-menu {
top: 0;
left: 100%;
margin-top:
-1px;
}
</style>
/* JS: */
<script>
$(document).ready(function(){
$('.dropdown-submenu a.test').on("click",
function(e){
$(this).next('ul').toggle();
e.stopPropagation();
e.preventDefault();
});
});
</script> Tente você mesmo "