反馈
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.
Upload failed
The file exceeds the 25 MB limit.
说明
关于当前页面的一条消息,就地显示。
danger 语气带 role="alert",其余带 role="status",这是“打断读者”和“等一个停顿”的区别。把这两个弄反是这里最常见的无障碍事故:一条“已保存”提示在别人说到一半时插话,或者一个支付错误压根没被念出来。
语气表示消息的严重程度,不是装饰。颜色由图标和文字各说一遍,所以在黑白打印和色盲眼里,意思都还在。
属性
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| action | ReactNode | 可选的动作——重试,或者一个指向能解决问题的设置页的链接。 | |
| children | ReactNode | — | |
| hideIcon | boolean | false | 隐藏前置图标,用于密集的行内提示。 |
| title | ReactNode | — | |
| tone | AlertTone | 'info' | — |
同时接受 Omit<HTMLAttributes<HTMLDivElement>, 'title'> 里的全部属性,它们会直接透传给底层元素,不再逐条列出。
类型
export type AlertTone = 'info' | 'success' | 'warning' | 'danger'无障碍
- danger 是 role="alert",会打断;其余三种是 role="status",等读屏说完这句话。
- 颜色由图标和文字双重表达。