BbAlert

ARIA live region politeness. Unset, it follows role when you set one ('alert' → 'assertive', 'status' → 'polite'), else the variant: 'assertive' for destructive/warning, otherwise 'polite'.

Only override it when visual tone and urgency come apart — a quiet outline alert that still has to interrupt. A registered custom variant is polite whatever its name, so urgent instances of one need this set by hand.

Visually hidden string used to label the close button.

Defaults to a localised "Close" from the plugin locale. Worth setting as soon as a page carries more than one dismissible alert, so the two buttons do not read the same to a screen reader.

Defines whether to hide the close button.

The only way to make an alert permanent: an unbound alert is still dismissible, because the internal model starts at true. Replaces v2 show-close, with the polarity inverted.

Hide the icon, its own or its variant's; with neither it does nothing.

Name of a registered icon to use, or a full raw <svg> string (e.g. an SVG file imported with ?raw). Without one, the variant's icon from the build plugin's alertVariants object form shows (none by default).

No variant implies an icon — pass one, and pick it together with the variant. It reinforces the message; title and text still have to carry it alone.

Size of the icon to use.

Used by v-model. Alerts are visible on mount; the model dismisses them.

Passthrough, object form: the same keys as the pt:* attributes without the prefix. See the pt:<part> row.

Passthrough, attribute form: one attribute per part, pt:<part>, and per part and state, pt:<part>:<state>. Parts: close, icon, root, text, title. States: destructive, outline, primary, warning.

Accessibility role for the alert container. Defaults to 'alert' for destructive/warning variants, otherwise 'status'.

Derived from the variant, so setting it is a deliberate disagreement with that derivation. Reserve alert for genuinely urgent messages: several assertive alerts appearing together talk over each other.

Text content of the alert body.

For when a string is all you have — a server message, an item in a v-for. When the body is written in the template, the default slot reads better and wins over this prop.

Text content of the alert title.

Transition duration in milliseconds for enter/leave.

Visual variant of the alert.

An open registry, not a closed enum: alertVariants in the plugin config adds typed names, which then ship no CSS of their own. There is no success or info: a confirmation is usually a toast and a neutral note is outline with an icon; register one when the app needs it and colour it from --bb-success / --bb-info.

A boolean that starts at true: the alert is visible on mount and the close button sets it to false, bound or not. Set it back to true and the alert re-enters with the same transition.

Emitted with the new value whenever v-model changes.

The alert body, the shortest form: <BbAlert>Something went wrong</BbAlert>. The most specific source wins: #text > children > the text prop.

Replaces the default alert body text. Wins over children and text.

Receives { text }, the value of the text prop, so it can decorate the string instead of restating it. Precedence for the body, most specific first: #text, child content, the text prop.

Replaces the default alert title text.