Source

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 désigné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-onlyclasse.

Utilisez la .alert-linkclasse 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.

<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écessiteutil.js . La version compilée inclut ceci.
  • Ajoutez un bouton de rejet et la .alert-dismissibleclasse, ce qui ajoute un rembourrage supplémentaire à droite de l'alerte et positionne le .closebouton.
  • 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 .fadeet ..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">&times;</span>
  </button>
</div>

Comportement JavaScript

Déclencheurs

Activer le rejet d'une alerte via JavaScript :

$('.alert').alert()

Ou avec des dataattributs 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">&times;</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 .fadeet .showsont 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 closeméthode d'instance est appelée.
closed.bs.alert Cet événement est déclenché lorsque l'alerte a été fermée (attendra que les transitions CSS soient terminées). 
$('#myAlert').on('closed.bs.alert', function () {
  // do something...
})