twbs--bootstrap/docs/components/alerts.md

layout	title
page	Alerts

Provide contextual feedback messages for typical user actions with the handful of available and flexible alert messages. For inline dismissal, use the [alerts jQuery plugin]({{ site.baseurl }}javascript/#alerts).

Wrap any text and an optional dismiss button in .alert and one of the four contextual classes (e.g., .alert-success) for basic alert messages.

{% callout info %}

No default class

Alerts don't have default classes, only base and modifier classes. A default gray alert doesn't make too much sense, so you're required to specify a type via contextual class. Choose from success, info, warning, or danger. {% endcallout %}

{% example html %}

Well done! You successfully read this important alert message.

Heads up! This alert needs your attention, but it's not super important.

Warning! Better check yourself, you're not looking too good.

Oh snap! Change a few things up and try submitting again.

{% endexample %}

Dismissing

Build on any alert by adding an optional .alert-dismissible and close button.

{% example html %}

× Close Warning! Better check yourself, you're not looking too good.

{% endexample %}

{% callout warning %}

Ensure proper behavior across all devices

Be sure to use the <button> element with the data-dismiss="alert" data attribute. {% endcallout %}

Link color

Use the .alert-link utility class to quickly provide matching colored links within any alert.

{% example html %}

Well done! You successfully read this important alert message.

Heads up! This alert needs your attention, but it's not super important.

Warning! Better check yourself, you're not looking too good.

Oh snap! Change a few things up and try submitting again.

{% endexample %}

Examples

{% example html %}

× Close Holy guacamole! Best check yo self, you're not looking too good.

{% endexample %}

When using a .close button, it must be the first child of the .alert-dismissible and no text content may come before it in the markup.

{% example html %}

×Close

Sorry, something went wrong.

Change this and that and try again. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.

Take this action Or do this

{% endexample %}

Usage

Enable dismissal of an alert via JavaScript:

{% highlight js %} $(".alert").alert() {% endhighlight %}

Markup

Just add data-dismiss="alert" to your close button to automatically give an alert close functionality. Closing an alert removes it from the DOM.

{% highlight html %} × Close {% endhighlight %}

To have your alerts use animation when closing, make sure they have the .fade and .in classes already applied to them.

Methods

$().alert()

Makes an alert listen for click events on descendant elements which have the data-dismiss="alert" attribute. (Not necessary when using the data-api's auto-initialization.)

$().alert('close')

Closes an alert by removing it from the DOM. If the .fade and .in classes are present on the element, the alert will fade out before it is removed.

{% highlight js %}$(".alert").alert('close'){% endhighlight %}

Events

Bootstrap's alert plugin exposes a few events for hooking into alert functionality.

Event Type	Description
close.bs.alert	This event fires immediately when the close instance method is called.
closed.bs.alert	This event is fired when the alert has been closed (will wait for CSS transitions to complete).

{% highlight js %} $('#myAlert').on('closed.bs.alert', function () { // do something… }) {% endhighlight %}