# Alert

Inline semantic message, optionally dismissible.

Use Alert for an inline message that needs semantic emphasis within the current page.

## API

The package declarations define these public members.

| Member | Type | Kind | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `children` | `Snippet` | snippet | No | `undefined` | Message body. |
| `dismissLabel` | `string` | prop | No | `'Dismiss'` | Accessible label for the dismiss control. |
| `dismissible` | `boolean` | prop | No | `false` | No additional description. |
| `icon` | `IconGlyph \| boolean` | prop | No | `undefined` | Leading icon, rendered tinted to the tone colour. Pass an {@link IconGlyph} for a specific glyph, or `true` to use the tone's canonical glyph. |
| `iconContent` | `Snippet` | snippet | No | `undefined` | Arbitrary leading content in place of a glyph. Takes precedence over `icon`. A glyph and a snippet are both functions at runtime, so they cannot share one prop. |
| `onDismiss` | `() => void` | callback | No | `undefined` | No additional description. |
| `title` | `string` | prop | No | `undefined` | No additional description. |
| `tone` | `AlertTone` | prop | No | `'info'` | No additional description. |

## Related

- [Badge](/docs/components/badge): Compact semantic or categorical label.
- [StatusDot](/docs/components/status-dot): Semantic status dot with an optional label and pulse.
- [EmptyState](/docs/components/empty-state): Empty-state message with optional art and action.