Bootstrap 4 - menus suspensos
Descrição
Os menus suspensos são menus contextuais alternáveis para exibir links em formato de lista.
Para usar o dropdown, basta envolver o menu dropdown na classe .dropdown . O exemplo a seguir demonstra um menu suspenso básico -
Exemplo
<html lang = "en">
<head>
<!-- Meta tags -->
<meta charset = "utf-8">
<meta name = "viewport" content = "width = device-width, initial-scale = 1, shrink-to-fit = no">
<!-- Bootstrap CSS -->
<link rel = "stylesheet"
href = "https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/css/bootstrap.min.css"
integrity = "sha384-MCw98/SFnGE8fJT3GXwEOngsV7Zt27NXFoaoApmYm81iuXoPkFOJwJ8ERdknLPMO"
crossorigin = "anonymous">
<title>Bootstrap 4 Example</title>
</head>
<body>
<div class = "container">
<h2>Basic Dropdown</h2>
<div class = "row">
<div class = "dropdown">
<button class = "btn btn-info dropdown-toggle" type = "button"
id = "dropdownMenuButton" data-toggle = "dropdown" aria-haspopup = "true"
aria-expanded = "false">Dropdown button</button>
<div class = "dropdown-menu" aria-labelledby = "dropdownMenuButton">
<a class = "dropdown-item" href = "#">Home</a>
<a class = "dropdown-item" href = "#">About Us</a>
<a class = "dropdown-item" href = "#">Contact Us</a>
</div>
</div>
</div>
</div>
<!-- jQuery first, then Popper.js, then Bootstrap JS -->
<script src = "https://code.jquery.com/jquery-3.3.1.slim.min.js"
integrity = "sha384-q8i/X+965DzO0rT7abK41JStQIAqVgRVzpbzo5smXKp4YfRvH+8abtTE1Pi6jizo"
crossorigin = "anonymous">
</script>
<script src = "https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.3/umd/popper.min.js"
integrity = "sha384-ZMP7rVo3mIykV+2+9J3UJ46jBk0WLaUAdn689aCwoqbBJiSnjAK/l8WvCWPIPm49"
crossorigin = "anonymous">
</script>
<script src = "https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/js/bootstrap.min.js"
integrity = "sha384-ChfqqxuZUCnJSK3+MXmPNIyE6ZbWh2IMqE241rYiqJxyMiZ6OW/JmZQ5stwEULTy"
crossorigin = "anonymous">
</script>
</body>
</html>Isso produzirá o seguinte resultado -
Resultado
Lista suspensa com botões de divisão
Você pode criar menu suspenso de botão de divisão usando a classe .dropdown-toggle-split , que fornece espaço ao redor do cursor e do botão suspenso.
O exemplo a seguir demonstra isso -
Exemplo
<html lang = "en">
<head>
<!-- Meta tags -->
<meta charset = "utf-8">
<meta name = "viewport" content = "width = device-width, initial-scale = 1, shrink-to-fit = no">
<!-- Bootstrap CSS -->
<link rel = "stylesheet"
href = "https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/css/bootstrap.min.css"
integrity = "sha384-MCw98/SFnGE8fJT3GXwEOngsV7Zt27NXFoaoApmYm81iuXoPkFOJwJ8ERdknLPMO"
crossorigin = "anonymous">
<title>Bootstrap 4 Example</title>
</head>
<body>
<div class = "container">
<h2>Dropdown with Split Buttons</h2>
<div class = "row">
<div class = "btn-group">
<button type = "button" class = "btn btn-primary">Primary</button>
<button type = "button" class = "btn btn-primary
dropdown-toggle dropdown-toggle-split" data-toggle = "dropdown">
</button>
<div class = "dropdown-menu">
<a class = "dropdown-item" href = "#">Home</a>
<a class = "dropdown-item" href = "#">About Us</a>
<a class = "dropdown-item" href = "#">Contact Us</a>
</div>
</div>
<div class = "btn-group">
<button type = "button" class = "btn btn-secondary">Secondary</button>
<button type = "button" class = "btn btn-secondary dropdown-toggle dropdown-toggle-split" data-toggle = "dropdown">
</button>
<div class = "dropdown-menu">
<a class = "dropdown-item" href = "#">Home</a>
<a class = "dropdown-item" href = "#">About Us</a>
<a class = "dropdown-item" href = "#">Contact Us</a>
</div>
</div>
<div class = "btn-group">
<button type =" button" class = "btn btn-success">Success</button>
<button type = "button" class = "btn btn-success dropdown-toggle dropdown-toggle-split" data-toggle = "dropdown">
</button>
<div class = "dropdown-menu">
<a class = "dropdown-item" href = "#">Home</a>
<a class = "dropdown-item" href = "#">About Us</a>
<a class = "dropdown-item" href = "#">Contact Us</a>
</div>
</div>
<div class = "btn-group">
<button type = "button" class = "btn btn-info">Info</button>
<button type = "button" class = "btn btn-info dropdown-toggle dropdown-toggle-split" data-toggle = "dropdown">
</button>
<div class = "dropdown-menu">
<a class = "dropdown-item" href = "#">Home</a>
<a class = "dropdown-item" href = "#">About Us</a>
<a class = "dropdown-item" href = "#">Contact Us</a>
</div>
</div>
<div class = "btn-group">
<button type = "button" class = "btn btn-warning">Warning</button>
<button type = "button" class = "btn btn-warning dropdown-toggle dropdown-toggle-split" data-toggle = "dropdown">
</button>
<div class = "dropdown-menu">
<a class = "dropdown-item" href = "#">Home</a>
<a class = "dropdown-item" href = "#">About Us</a>
<a class = "dropdown-item" href = "#">Contact Us</a>
</div>
</div>
<div class = "btn-group">
<button type = "button" class = "btn btn-danger">Danger</button>
<button type = "button" class = "btn btn-danger dropdown-toggle dropdown-toggle-split" data-toggle = "dropdown">
</button>
<div class = "dropdown-menu">
<a class = "dropdown-item" href = "#">Home</a>
<a class = "dropdown-item" href = "#">About Us</a>
<a class = "dropdown-item" href = "#">Contact Us</a>
</div>
</div>
</div>
</div>
<!-- jQuery first, then Popper.js, then Bootstrap JS -->
<script src = "https://code.jquery.com/jquery-3.3.1.slim.min.js"
integrity = "sha384-q8i/X+965DzO0rT7abK41JStQIAqVgRVzpbzo5smXKp4YfRvH+8abtTE1Pi6jizo"
crossorigin = "anonymous">
</script>
<script src = "https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.3/umd/popper.min.js"
integrity = "sha384-ZMP7rVo3mIykV+2+9J3UJ46jBk0WLaUAdn689aCwoqbBJiSnjAK/l8WvCWPIPm49"
crossorigin = "anonymous">
</script>
<script src = "https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/js/bootstrap.min.js"
integrity = "sha384-ChfqqxuZUCnJSK3+MXmPNIyE6ZbWh2IMqE241rYiqJxyMiZ6OW/JmZQ5stwEULTy"
crossorigin = "anonymous">
</script>
</body>
</html>Isso produzirá o seguinte resultado -
Resultado
Tamanhos suspensos e botões de divisão
Os botões suspensos podem ser exibidos em tamanhos grandes e pequenos usando as classes btn-lg e btn-sm , incluindo botões suspensos de divisão.
Exemplo
<html lang = "en">
<head>
<!-- Meta tags -->
<meta charset = "utf-8">
<meta name = "viewport" content = "width = device-width, initial-scale = 1, shrink-to-fit = no">
<!-- Bootstrap CSS -->
<link rel = "stylesheet"
href = "https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/css/bootstrap.min.css"
integrity = "sha384-MCw98/SFnGE8fJT3GXwEOngsV7Zt27NXFoaoApmYm81iuXoPkFOJwJ8ERdknLPMO"
crossorigin = "anonymous">
<title>Bootstrap 4 Example</title>
</head>
<body>
<div class = "container">
<h2>Dropdown Sizes and Split Buttons</h2>
<div class = "btn-group">
<button class = "btn btn-info btn-lg dropdown-toggle" type = "button"
data-toggle = "dropdown" aria-haspopup = "true" aria-expanded = "false">
Large button
</button>
<div class = "dropdown-menu">
<a class = "dropdown-item" href = "#">Home</a>
<a class = "dropdown-item" href = "#">About Us</a>
<a class = "dropdown-item" href =" #">Contact Us</a>
</div>
</div>
<div class = "btn-group">
<button class = "btn btn-info btn-lg" type = "button">
Large split button
</button>
<button type = "button" class = "btn btn-lg btn-info dropdown-toggle dropdown-toggle-split"
data-toggle = "dropdown" aria-haspopup = "true" aria-expanded = "false">
<span class = "sr-only">Toggle Dropdown</span>
</button>
<div class = "dropdown-menu">
<a class = "dropdown-item" href = "#">Home</a>
<a class = "dropdown-item" href = "#">About Us</a>
<a class = "dropdown-item" href = "#">Contact Us</a>
</div>
</div>
<br>
<br>
<div class = "btn-group">
<button class = "btn btn-info btn-sm dropdown-toggle" type = "button"
data-toggle = "dropdown" aria-haspopup = "true" aria-expanded = "false">
Small button
</button>
<div class = "dropdown-menu">
<a class = "dropdown-item" href = "#">Home</a>
<a class = "dropdown-item" href = "#">About Us</a>
<a class = "dropdown-item" href = "#">Contact Us</a>
</div>
</div>
<div class = "btn-group">
<button class = "btn btn-info btn-sm" type = "button">
Small split button
</button>
<button type = "button" class = "btn btn-sm btn-info dropdown-toggle dropdown-toggle-split"
data-toggle = "dropdown" aria-haspopup = "true" aria-expanded = "false">
<span class = "sr-only">Toggle Dropdown</span>
</button>
<div class = "dropdown-menu">
<a class = "dropdown-item" href = "#">Home</a>
<a class = "dropdown-item" href = "#">About Us</a>
<a class = "dropdown-item" href = "#">Contact Us</a>
</div>
</div>
</div>
<!-- jQuery first, then Popper.js, then Bootstrap JS -->
<script src = "https://code.jquery.com/jquery-3.3.1.slim.min.js"
integrity = "sha384-q8i/X+965DzO0rT7abK41JStQIAqVgRVzpbzo5smXKp4YfRvH+8abtTE1Pi6jizo"
crossorigin = "anonymous">
</script>
<script src = "https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.3/umd/popper.min.js"
integrity = "sha384-ZMP7rVo3mIykV+2+9J3UJ46jBk0WLaUAdn689aCwoqbBJiSnjAK/l8WvCWPIPm49"
crossorigin = "anonymous">
</script>
<script src = "https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/js/bootstrap.min.js"
integrity = "sha384-ChfqqxuZUCnJSK3+MXmPNIyE6ZbWh2IMqE241rYiqJxyMiZ6OW/JmZQ5stwEULTy"
crossorigin = "anonymous">
</script>
</body>
</html>Isso produzirá o seguinte resultado -
Resultado
Direções suspensas
Você pode expandir o menu suspenso para cima usando a classe .dropup e, também, colocar o menu suspenso no lado direito e esquerdo usando .dropright ou .dropleft classes. O exemplo a seguir demonstra as direções do menu suspenso -
Exemplo
<html lang = "en">
<head>
<!-- Meta tags -->
<meta charset = "utf-8">
<meta name = "viewport" content = "width = device-width, initial-scale = 1, shrink-to-fit = no">
<!-- Bootstrap CSS -->
<link rel = "stylesheet"
href = "https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/css/bootstrap.min.css"
integrity = "sha384-MCw98/SFnGE8fJT3GXwEOngsV7Zt27NXFoaoApmYm81iuXoPkFOJwJ8ERdknLPMO"
crossorigin = "anonymous">
<title>Bootstrap 4 Example</title>
</head>
<body>
<div class = "container">
<br>
<br>
<h2>Dropdown Directions</h2>
<br>
<br>
<div class = "row">
<div class = "btn-group dropright">
<button type = "button" class = "btn btn-info dropdown-toggle"
data-toggle = "dropdown" aria-haspopup = "true" aria-expanded = "false">
Dropright
</button>
<div class = "dropdown-menu">
<a class = "dropdown-item" href = "#">Home</a>
<a class = "dropdown-item" href = "#">About Us</a>
<a class = "dropdown-item" href = "#">Contact Us</a>
</div>
</div>
<div class = "btn-group dropup">
<button type = "button" class = "btn btn-info dropdown-toggle"
data-toggle = "dropdown" aria-haspopup = "true" aria-expanded = "false">
Dropup
</button>
<div class = "dropdown-menu">
<a class = "dropdown-item" href = "#">Home</a>
<a class = "dropdown-item" href = "#">About Us</a>
<a class = "dropdown-item" href = "#">Contact Us</a>
</div>
</div>
<div class = "btn-group dropleft">
<button type = "button" class = "btn btn-info dropdown-toggle"
data-toggle = "dropdown" aria-haspopup = "true" aria-expanded = "false">
Dropleft
</button>
<div class = "dropdown-menu">
<a class = "dropdown-item" href = "#">Home</a>
<a class = "dropdown-item" href = "#">About Us</a>
<a class = "dropdown-item" href = "#">Contact Us</a>
</div>
</div>
</div>
</div>
<!-- jQuery first, then Popper.js, then Bootstrap JS -->
<script src = "https://code.jquery.com/jquery-3.3.1.slim.min.js"
integrity = "sha384-q8i/X+965DzO0rT7abK41JStQIAqVgRVzpbzo5smXKp4YfRvH+8abtTE1Pi6jizo"
crossorigin = "anonymous">
</script>
<script src = "https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.3/umd/popper.min.js"
integrity = "sha384-ZMP7rVo3mIykV+2+9J3UJ46jBk0WLaUAdn689aCwoqbBJiSnjAK/l8WvCWPIPm49"
crossorigin = "anonymous">
</script>
<script src = "https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/js/bootstrap.min.js"
integrity = "sha384-ChfqqxuZUCnJSK3+MXmPNIyE6ZbWh2IMqE241rYiqJxyMiZ6OW/JmZQ5stwEULTy"
crossorigin = "anonymous">
</script>
</body>
</html>Isso produzirá o seguinte resultado -
Resultado
Cabeçalhos, divisores e texto
Use a classe .dropdown-header para adicionar cabeçalhos dentro do menu suspenso, a classe .dropdown-divider adiciona divisor ao menu suspenso com uma borda horizontal fina e a classe .dropdown-item-text é usada para colocar o texto em um menu suspenso.
O exemplo a seguir demonstra a criação de cabeçalhos, divisores e texto usando as classes acima -
Exemplo
<html lang = "en">
<head>
<!-- Meta tags -->
<meta charset = "utf-8">
<meta name = "viewport" content = "width = device-width, initial-scale = 1, shrink-to-fit = no">
<!-- Bootstrap CSS -->
<link rel = "stylesheet"
href = "https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/css/bootstrap.min.css"
integrity = "sha384-MCw98/SFnGE8fJT3GXwEOngsV7Zt27NXFoaoApmYm81iuXoPkFOJwJ8ERdknLPMO"
crossorigin = "anonymous">
<title>Bootstrap 4 Example</title>
</head>
<body>
<div class = "container">
<h2>Headers</h2>
<div class = "btn-group dropright">
<button type = "button" class = "btn btn-info dropdown-toggle"
data-toggle = "dropdown" aria-haspopup = "true" aria-expanded = "false">
Headers Example
</button>
<div class = "dropdown-menu p-4 text-muted">
<h6 class = "dropdown-header">This is Header</h6>
<a class = "dropdown-item" href = "#">Home</a>
<a class = "dropdown-item" href = "#">About Us</a>
<a class = "dropdown-item" href = "#">Contact Us</a>
</div>
</div>
<br>
<br>
<h2>Dividers</h2>
<div class = "btn-group dropright">
<button type = "button" class = "btn btn-info dropdown-toggle"
data-toggle = "dropdown" aria-haspopup = "true" aria-expanded = "false">
Dividers Example
</button>
<div class = "dropdown-menu">
<a class = "dropdown-item" href = "#">Home</a>
<a class = "dropdown-item" href = "#">About Us</a>
<div class = "dropdown-divider"></div>
<a class = "dropdown-item" href = "#">Contact Us</a>
</div>
</div>
<br>
<br>
<h2>Text</h2>
<div class = "dropdown">
<button type = "button" class = "btn btn-info dropdown-toggle" data-toggle = "dropdown">
Dropdown button
</button>
<div class = "dropdown-menu">
<a class = "dropdown-item" href = "#">Home</a>
<a class = "dropdown-item" href = "#">About Us</a>
<a class = "dropdown-item-text" href = "#">This is Text Link</a>
<span class = "dropdown-item-text" href = "#">Thi is just Text</span>
</div>
</div>
</div>
<!-- jQuery first, then Popper.js, then Bootstrap JS -->
<script src = "https://code.jquery.com/jquery-3.3.1.slim.min.js"
integrity = "sha384-q8i/X+965DzO0rT7abK41JStQIAqVgRVzpbzo5smXKp4YfRvH+8abtTE1Pi6jizo"
crossorigin = "anonymous">
</script>
<script src = "https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.3/umd/popper.min.js"
integrity = "sha384-ZMP7rVo3mIykV+2+9J3UJ46jBk0WLaUAdn689aCwoqbBJiSnjAK/l8WvCWPIPm49"
crossorigin = "anonymous">
</script>
<script src = "https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/js/bootstrap.min.js"
integrity = "sha384-ChfqqxuZUCnJSK3+MXmPNIyE6ZbWh2IMqE241rYiqJxyMiZ6OW/JmZQ5stwEULTy"
crossorigin = "anonymous">
</script>
</body>
</html>Isso produzirá o seguinte resultado -
Resultado
Item ativo e desativado
Você pode tornar os itens ativos adicionando a classe .active aos itens no menu suspenso e use a classe .disabled para desativar o item no menu suspenso.
O exemplo a seguir demonstra o item ativo e desativado no menu suspenso -
Exemplo
<html lang = "en">
<head>
<!-- Meta tags -->
<meta charset = "utf-8">
<meta name = "viewport" content = "width = device-width, initial-scale = 1, shrink-to-fit = no">
<!-- Bootstrap CSS -->
<link rel = "stylesheet"
href = "https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/css/bootstrap.min.css"
integrity = "sha384-MCw98/SFnGE8fJT3GXwEOngsV7Zt27NXFoaoApmYm81iuXoPkFOJwJ8ERdknLPMO"
crossorigin = "anonymous">
<title>Bootstrap 4 Example</title>
</head>
<body>
<div class = "container">
<h2>Active and Disabled item</h2>
<div class = "dropdown">
<button type = "button" class = "btn btn-info dropdown-toggle"
data-toggle = "dropdown">
Dropdown button
</button>
<div class = "dropdown-menu">
<a class = "dropdown-item" href = "#">Home</a>
<a class = "dropdown-item active" href = "#">About Us - Active Item</a>
<a class = "dropdown-item disabled" href = "#">Contct Us - Disabled Item</a>
</div>
</div>
</div>
<!-- jQuery first, then Popper.js, then Bootstrap JS -->
<script src = "https://code.jquery.com/jquery-3.3.1.slim.min.js"
integrity = "sha384-q8i/X+965DzO0rT7abK41JStQIAqVgRVzpbzo5smXKp4YfRvH+8abtTE1Pi6jizo"
crossorigin = "anonymous">
</script>
<script src = "https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.3/umd/popper.min.js"
integrity = "sha384-ZMP7rVo3mIykV+2+9J3UJ46jBk0WLaUAdn689aCwoqbBJiSnjAK/l8WvCWPIPm49"
crossorigin = "anonymous">
</script>
<script src = "https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/js/bootstrap.min.js"
integrity = "sha384-ChfqqxuZUCnJSK3+MXmPNIyE6ZbWh2IMqE241rYiqJxyMiZ6OW/JmZQ5stwEULTy"
crossorigin = "anonymous">
</script>
</body>
</html>Isso produzirá o seguinte resultado -