Alertas
Proporcione mensaxes de comentarios contextuais para as accións típicas dos usuarios cun puñado de mensaxes de alerta dispoñibles e flexibles.
Exemplos
As alertas están dispoñibles para calquera lonxitude de texto, así como un botón de exclusión opcional. Para un estilo adecuado, use unha das oito clases contextuais requiridas.alert-success
(por exemplo, ). Para o despedimento en liña, use o complemento de alertas 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>
Transmitir significado ás tecnoloxías de asistencia
Usar cor para engadir significado só proporciona unha indicación visual, que non se transmitirá aos usuarios de tecnoloxías auxiliares, como lectores de pantalla. Asegúrese de que a información indicada pola cor sexa obvia desde o propio contido (por exemplo, o texto visible) ou se inclúa a través de medios alternativos, como o texto adicional oculto coa .sr-only
clase.
Cor da ligazón
Use a .alert-link
clase de utilidade para proporcionar rapidamente ligazóns de cores coincidentes en calquera alerta.
<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>
Contido adicional
As alertas tamén poden conter elementos HTML adicionais como títulos, parágrafos e divisores.
Ben feito!
Aww, si, leches esta importante mensaxe de alerta. Este texto de exemplo durarase un pouco máis para que poidas ver como funciona o espazo nunha alerta con este tipo de contido.
Sempre que o necesites, asegúrate de usar as utilidades de marxe para manter as cousas ben e ordenadas.
<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>
Descartando
Usando o complemento JavaScript de alerta, é posible descartar calquera alerta en liña. Aquí tes como:
- Asegúrate de cargar o complemento de alerta ou o JavaScript de Bootstrap compilado.
- Se estás construíndo o noso JavaScript desde a orixe, require
util.js
. A versión compilada inclúe isto. - Engade un botón de exclusión e a
.alert-dismissible
clase, que engade un recheo adicional á dereita da alerta e sitúa o.close
botón. - No botón descartar, engade o
data-dismiss="alert"
atributo, que activa a funcionalidade de JavaScript. Asegúrate de usar o<button>
elemento con el para un comportamento correcto en todos os dispositivos. - Para animar alertas ao ignoralas, asegúrate de engadir as clases
.fade
e ..show
Podes ver isto en acción cunha demostración en directo:
<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>
Comportamento de JavaScript
Disparadores
Activar a descarte dunha alerta mediante JavaScript:
$('.alert').alert()
Ou con data
atributos nun botón dentro da alerta , como se demostrou anteriormente:
<button type="button" class="close" data-dismiss="alert" aria-label="Close">
<span aria-hidden="true">×</span>
</button>
Teña en conta que ao pechar unha alerta eliminarase do DOM.
Métodos
Método | Descrición |
---|---|
$().alert() |
Fai que unha alerta escoite eventos de clic en elementos descendentes que teñen o data-dismiss="alert" atributo. (Non é necesario cando se usa a inicialización automática da API de datos). |
$().alert('close') |
Pecha unha alerta quitándoa do DOM. Se as clases .fade e .show están presentes no elemento, a alerta desaparecerá antes de eliminarla. |
$().alert('dispose') |
Destrúe a alerta dun elemento. |
$('.alert').alert('close')
Eventos
O complemento de alerta de Bootstrap expón algúns eventos para conectarse á funcionalidade de alerta.
Evento | Descrición |
---|---|
close.bs.alert |
Este evento desenvólvese inmediatamente cando close se chama ao método de instancia. |
closed.bs.alert |
Este evento desenvólvese cando se pechou a alerta (esperará a que se completen as transicións CSS). |
$('#myAlert').on('closed.bs.alert', function () {
// do something...
})