Alert 提示条Alert
嵌在页面里的一条提示,和它说明的内容待在一起:表单上方的错误汇总、功能区顶部的公告。操作之后一闪而过的反馈用 Toast;必须先处理才能继续的用 Dialog。
状态色
六种 tone,默认 accent。每种带一个默认图标;颜色和图标之外,文字本身要把事情说清楚。
小提示。按住 Shift 再点可以连续选择多行。
这个项目已归档,目前是只读的。
计划维护。本周六 02:00–04:00 服务会短暂不可用。
已发布。所有人现在都能看到最新版本。
存储空间即将用完。已使用 92%,上传可能很快失败。
付款失败。银行卡被拒绝,请更换支付方式后重试。
带操作
action 放在右侧,通常是一个小按钮。窄于 520px 时操作换到正文下面一行。
存储空间即将用完。已使用 92%,升级后可获得 100 GB。
可关闭
closable 显示关闭按钮。关闭时高度用 soft 弹簧折叠并淡出,结束后才卸载,下面的内容平滑补位。open / onOpenChange 可受控;出现时不做入场动画,避免页面加载时跳动。
新版本可用。刷新页面即可更新到 2.4.0。
自定义图标
icon 换掉默认图标;传 false 不显示图标。
你关注的任务有 3 条新评论。
没有图标的提示条。
规格
- 容器
- 圆角 18 · 内边距 16 · 柔和底色,不描边
- 关闭
- 高度 spring-soft 折叠 + 淡出,结束后卸载
接口
属性
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
tone | 'neutral' | 'accent' | 'success' | 'warning' | 'danger' | 'info' | 'accent' | 状态色,同时决定默认图标和默认角色。 |
title | ReactNode | — | 加粗的标题,后面接正文。 |
icon | ReactNode | false | — | 自定义图标;false 不显示。默认按 tone 选。 |
action | ReactNode | — | 右侧的操作(按钮、链接)。 |
closable | boolean | — | 显示关闭按钮。 |
open / defaultOpen | boolean | true | 是否显示,受控 / 非受控。 |
onOpenChange | (open: boolean) => void | — | 显示状态变化时。 |
onClose | () => void | — | 点了关闭按钮。 |
closeLabel | string | '关闭' | 关闭按钮的读屏名称。 |
role | string | — | 覆盖默认角色(见下)。 |
无障碍
- warning 和 danger 默认是
role="alert":出现时读屏立即打断播报。其余是role="status":等读屏空闲时再读。 - 页面加载时就在的静态提示不需要播报,可以传
role="note"之类覆盖;只有动态插入的才值得用 alert。 - 关闭按钮是带名字的图标按钮,Tab 聚焦、Enter / 空格触发。关闭后焦点会丢失,请在 onClose 里把焦点移到合理的位置。
- 图标是装饰性的,对读屏隐藏;状态必须从文字里读得出来。
- 正文文字用正文色,在六种柔和底色上的对比度都高于 4.5:1。