Alertes
Proporcioneu missatges de comentaris contextuals per a les accions típiques dels usuaris amb un grapat de missatges d'alerta disponibles i flexibles.
Exemples
Les alertes estan disponibles per a qualsevol extensió de text, així com un botó d'ignorar opcional. Per obtenir un estil adequat, utilitzeu una de les vuit classes contextuals necessàries.alert-success
(p. ex., ). Per a l'acomiadament en línia, utilitzeu el connector d'alertes jQuery .
<div class="alert alert-primary" role="alert">
This is a primary alert—check it out!
</div>
<div class="alert alert-secondary" role="alert">
This is a secondary alert—check it out!
</div>
<div class="alert alert-success" role="alert">
This is a success alert—check it out!
</div>
<div class="alert alert-danger" role="alert">
This is a danger alert—check it out!
</div>
<div class="alert alert-warning" role="alert">
This is a warning alert—check it out!
</div>
<div class="alert alert-info" role="alert">
This is a info alert—check it out!
</div>
<div class="alert alert-light" role="alert">
This is a light alert—check it out!
</div>
<div class="alert alert-dark" role="alert">
This is a dark alert—check it out!
</div>
Transmetre significat a les tecnologies d'assistència
L'ús del color per afegir significat només proporciona una indicació visual, que no es transmetrà als usuaris de tecnologies d'assistència, com ara lectors de pantalla. Assegureu-vos que la informació indicada pel color sigui òbvia des del contingut mateix (per exemple, el text visible) o s'inclogui mitjançant mitjans alternatius, com ara text addicional amagat amb la .sr-only
classe.
Color de l'enllaç
Utilitzeu la .alert-link
classe d'utilitat per proporcionar ràpidament enllaços de colors coincidents dins de qualsevol alerta.
<div class="alert alert-primary" role="alert">
This is a 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">
This is a 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">
This is a 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">
This is a 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">
This is a 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">
This is a 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">
This is a 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">
This is a dark alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
Contingut addicional
Les alertes també poden contenir elements HTML addicionals com encapçalaments, paràgrafs i divisors.
Ben fet!
Ah, sí, heu llegit correctament aquest missatge d'alerta important. Aquest text d'exemple s'allargarà una mica més perquè pugueu veure com funciona l'espaiat dins d'una alerta amb aquest tipus de contingut.
Sempre que ho necessiteu, assegureu-vos d'utilitzar les utilitats de marge per mantenir les coses bones i ordenades.
<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>
Descartant
Mitjançant el connector d'alerta JavaScript, és possible descartar qualsevol alerta en línia. Així és com:
- Assegureu-vos que heu carregat el connector d'alerta o el JavaScript Bootstrap compilat.
- Si esteu creant el nostre JavaScript des de la font, requereix
util.js
. La versió compilada inclou això. - Afegiu un botó de descartar i la
.alert-dismissible
classe, que afegeix un farciment addicional a la dreta de l'alerta i posiciona el.close
botó. - Al botó descartar, afegiu l'
data-dismiss="alert"
atribut, que activa la funcionalitat de JavaScript. Assegureu-vos d'utilitzar l'<button>
element amb ell per a un comportament adequat en tots els dispositius. - Per animar alertes quan les ignoreu, assegureu-vos d'afegir les classes
.fade
i ..show
Podeu veure això en acció amb una demostració en directe:
<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>
Comportament de JavaScript
Disparadors
Activa l'eliminació d'una alerta mitjançant JavaScript:
O amb data
atributs en un botó dins de l'alerta , com s'ha demostrat anteriorment:
Tingueu en compte que tancar una alerta l'eliminarà del DOM.
Mètodes
Mètode | Descripció |
---|---|
$().alert() |
Fa que una alerta escolti els esdeveniments de clic als elements descendents que tenen l' data-dismiss="alert" atribut. (No és necessari quan s'utilitza l'inicialització automàtica de l'api de dades.) |
$().alert('close') |
Tanca una alerta eliminant-la del DOM. Si les classes .fade i .show estan presents a l'element, l'alerta s'esvairà abans que s'elimini. |
$().alert('dispose') |
Destrueix l'alerta d'un element. |
Esdeveniments
El connector d'alerta de Bootstrap exposa alguns esdeveniments per connectar-se a la funcionalitat d'alerta.
Esdeveniment | Descripció |
---|---|
close.bs.alert |
Aquest esdeveniment s'activa immediatament quan close es crida al mètode d'instància. |
closed.bs.alert |
Aquest esdeveniment s'activa quan l'alerta s'ha tancat (esperarà que finalitzin les transicions CSS). |