Alertes
Fournissez des messages de retour contextuels pour les actions utilisateur typiques avec la poignée de messages d'alerte disponibles et flexibles.
Exemples
Les alertes sont disponibles pour n'importe quelle longueur de texte, ainsi qu'un bouton de rejet facultatif. Pour un style approprié, utilisez l'une des huit classes contextuelles requises.alert-success
(par exemple, ). Pour le rejet en ligne, utilisez le plugin alerts jQuery .
<div class="alert alert-primary" role="alert">
A simple primary alert—check it out!
</div>
<div class="alert alert-secondary" role="alert">
A simple secondary alert—check it out!
</div>
<div class="alert alert-success" role="alert">
A simple success alert—check it out!
</div>
<div class="alert alert-danger" role="alert">
A simple danger alert—check it out!
</div>
<div class="alert alert-warning" role="alert">
A simple warning alert—check it out!
</div>
<div class="alert alert-info" role="alert">
A simple info alert—check it out!
</div>
<div class="alert alert-light" role="alert">
A simple light alert—check it out!
</div>
<div class="alert alert-dark" role="alert">
A simple dark alert—check it out!
</div>
Donner du sens aux technologies d'assistance
L'utilisation de la couleur pour ajouter du sens ne fournit qu'une indication visuelle, qui ne sera pas transmise aux utilisateurs de technologies d'assistance, telles que les lecteurs d'écran. Assurez-vous que les informations indiquées par la couleur sont soit évidentes à partir du contenu lui-même (par exemple, le texte visible), soit incluses par des moyens alternatifs, tels que du texte supplémentaire masqué avec la .sr-only
classe.
Couleur du lien
Utilisez la .alert-link
classe utilitaire pour fournir rapidement des liens colorés correspondants dans n'importe quelle alerte.
<div class="alert alert-primary" role="alert">
A simple primary alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
<div class="alert alert-secondary" role="alert">
A simple secondary alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
<div class="alert alert-success" role="alert">
A simple success alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
<div class="alert alert-danger" role="alert">
A simple danger alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
<div class="alert alert-warning" role="alert">
A simple warning alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
<div class="alert alert-info" role="alert">
A simple info alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
<div class="alert alert-light" role="alert">
A simple light alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
<div class="alert alert-dark" role="alert">
A simple dark alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
Contenu additionnel
Les alertes peuvent également contenir des éléments HTML supplémentaires tels que des titres, des paragraphes et des séparateurs.
Bien fait!
Aww ouais, vous avez lu avec succès cet important message d'alerte. Cet exemple de texte va durer un peu plus longtemps afin que vous puissiez voir comment l'espacement dans une alerte fonctionne avec ce type de contenu.
Chaque fois que vous en avez besoin, assurez-vous d'utiliser des utilitaires de marge pour garder les choses bien rangées.
<div class="alert alert-success" role="alert">
<h4 class="alert-heading">Well done!</h4>
<p>Aww yeah, you successfully read this important alert message. This example text is going to run a bit longer so that you can see how spacing within an alert works with this kind of content.</p>
<hr>
<p class="mb-0">Whenever you need to, be sure to use margin utilities to keep things nice and tidy.</p>
</div>
Licenciement
À l'aide du plugin JavaScript d'alerte, il est possible de rejeter toute alerte en ligne. Voici comment:
- Assurez-vous d'avoir chargé le plugin d'alerte ou le JavaScript Bootstrap compilé.
- Si vous construisez notre JavaScript à partir de la source, cela nécessite
util.js
. La version compilée inclut ceci. - Ajoutez un bouton de rejet et la
.alert-dismissible
classe, ce qui ajoute un rembourrage supplémentaire à droite de l'alerte et positionne le.close
bouton. - Sur le bouton Ignorer, ajoutez l'
data-dismiss="alert"
attribut, qui déclenche la fonctionnalité JavaScript. Assurez-vous d'utiliser l'<button>
élément avec lui pour un comportement correct sur tous les appareils. - Pour animer les alertes lors de leur rejet, assurez-vous d'ajouter les classes
.fade
et ..show
Vous pouvez voir cela en action avec une démo en direct :
<div class="alert alert-warning alert-dismissible fade show" role="alert">
<strong>Holy guacamole!</strong> You should check in on some of those fields below.
<button type="button" class="close" data-dismiss="alert" aria-label="Close">
<span aria-hidden="true">×</span>
</button>
</div>
Comportement JavaScript
Déclencheurs
Activer le rejet d'une alerte via JavaScript :
$('.alert').alert()
Ou avec des data
attributs sur un bouton dans l'alerte , comme illustré ci-dessus :
<button type="button" class="close" data-dismiss="alert" aria-label="Close">
<span aria-hidden="true">×</span>
</button>
Notez que la fermeture d'une alerte la supprimera du DOM.
Méthodes
Méthode | La description |
---|---|
$().alert() |
Fait en sorte qu'une alerte écoute les événements de clic sur les éléments descendants qui ont l' data-dismiss="alert" attribut. (Pas nécessaire lors de l'utilisation de l'initialisation automatique de l'API de données.) |
$().alert('close') |
Ferme une alerte en la supprimant du DOM. Si les classes .fade et .show sont présentes sur l'élément, l'alerte disparaîtra avant d'être supprimée. |
$().alert('dispose') |
Détruit l'alerte d'un élément. |
$('.alert').alert('close')
Événements
Le plugin d'alerte de Bootstrap expose quelques événements pour se connecter à la fonctionnalité d'alerte.
Événement | La description |
---|---|
close.bs.alert |
Cet événement se déclenche immédiatement lorsque la close méthode d'instance est appelée. |
closed.bs.alert |
Cet événement est déclenché lorsque l'alerte a été fermée (il attendra que les transitions CSS soient terminées). |
$('#myAlert').on('closed.bs.alert', function () {
// do something...
})