Liste déroulante Bootstrap JS
Classes CSS déroulantes
Pour un didacticiel sur les listes déroulantes, lisez notre didacticiel 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 data-* Attributs
Ajouter data-toggle="dropdown"à un lien ou à un bouton pour basculer vers un menu déroulant.
Exemple
<button type="button" class="dropdown-toggle"
data-toggle="dropdown">Dropdown Example</button>
Via Javascript
Activer manuellement avec :
Exemple
$('.dropdown-toggle').dropdown();
Remarque : L'attribut data-toggle="dropdown" est obligatoire, que vous appeliez ou non la méthode dropdown().
Options de liste déroulante
| None |
Méthodes déroulantes
Le tableau suivant répertorie toutes les méthodes de liste déroulante disponibles.
| 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 |
Événements déroulants
Le tableau suivant répertorie tous les événements déroulants disponibles.
| 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) |
Astuce : Utilisez event.relatedTarget de jQuery pour obtenir l'élément qui a déclenché la liste déroulante :
Exemple
$(".dropdown").on("show.bs.dropdown", function(event){
var x = $(event.relatedTarget).text(); // Get the text of the element
alert(x);
});