# 091 Alert 提示条

## 用途

在页面内显示一条信息、成功、警告或错误提示，可带标题、一个操作按钮和关闭按钮。严重程度同时由左侧色条、图标和无障碍名称（如“Error”）表达，不只靠颜色。

## 最小示例

```go
open := true
r := mujica.Alert(c, &open, "The archive could not be read.", mujica.AlertOptions{
	Severity: mujica.SeverityError,
	Title:    "Import failed",
	Action:   "Retry",
})
if r.Action {
	// retry the import
}
```

签名：`func Alert(c *ui.Context, open *bool, message string, opts AlertOptions) AlertResult`

## 参数

| 字段 | 类型 | 默认值 | 含义 |
| --- | --- | --- | --- |
| `open` | `*bool` | `nil` | 非 nil 时显示关闭按钮，关闭后置为 `false`；为 `false` 时不构建任何元素。`nil` 表示不可关闭。 |
| `message` | `string` | 必填 | 正文；为空时 panic。 |
| `Severity` | `Severity` | `SeverityInfo` | `SeverityInfo`、`SeveritySuccess`、`SeverityWarning`、`SeverityError`。 |
| `Title` | `string` | `""` | 正文上方的粗体标题。 |
| `Action` | `string` | `""` | 操作按钮文字；为空不显示。 |

返回 `AlertResult{Element, Action, Closed}`；关闭状态下 `Element` 为 nil。

## 状态

四种严重程度；操作与关闭按钮有悬停、按下和 2 DIP 焦点环。警告与错误在出现或文字变化时通过 `Context.Announce` 播报一次。

## 事件

- `Action`：操作按钮被点击或经键盘触发。
- `Closed`：用户关闭；同时 `*open` 变为 `false`。

## 键盘操作

Tab 依次聚焦操作按钮与关闭按钮；Enter 或 Space 触发。

## 限制

- 信息与成功提示不主动播报，避免页面加载时打扰读屏用户。
- 关闭不带退出动画；需要动画时由调用方在外层加 `Transition`。