跳到正文
GitHub

反馈

Alert

关于这个页面的一条消息,就地显示。

什么时候用它

读者需要看见、可能需要处理的事。只需要注意一下的,是 Toast。

示例

tones

Read-only mode

A migration is running; edits are paused until it finishes.

Deployed

misoto22-site is live at commit a1b2c3d.

Token expires in 6 days

Rotate it before the next release.

说明

关于当前页面的一条消息,就地显示。

danger 语气带 role="alert",其余带 role="status",这是“打断读者”和“等一个停顿”的区别。把这两个弄反是这里最常见的无障碍事故:一条“已保存”提示在别人说到一半时插话,或者一个支付错误压根没被念出来。

语气表示消息的严重程度,不是装饰。颜色由图标和文字各说一遍,所以在黑白打印和色盲眼里,意思都还在。

属性

Alert props
属性类型默认值说明
actionReactNode可选的动作——重试,或者一个指向能解决问题的设置页的链接。
childrenReactNode
hideIconbooleanfalse隐藏前置图标,用于密集的行内提示。
titleReactNode
toneAlertTone'info'

同时接受 Omit<HTMLAttributes<HTMLDivElement>, 'title'> 里的全部属性,它们会直接透传给底层元素,不再逐条列出。

类型

export type AlertTone = 'info' | 'success' | 'warning' | 'danger'

无障碍

  • danger 是 role="alert",会打断;其余三种是 role="status",等读屏说完这句话。
  • 颜色由图标和文字双重表达。