跳到主要内容

Alert 提示条Alert

嵌在页面里的一条提示,和它说明的内容待在一起:表单上方的错误汇总、功能区顶部的公告。操作之后一闪而过的反馈用 Toast;必须先处理才能继续的用 Dialog。

状态色

六种 tone,默认 accent。每种带一个默认图标;颜色和图标之外,文字本身要把事情说清楚。

小提示。按住 Shift 再点可以连续选择多行。
这个项目已归档,目前是只读的。
计划维护。本周六 02:00–04:00 服务会短暂不可用。
已发布。所有人现在都能看到最新版本。

带操作

action 放在右侧,通常是一个小按钮。窄于 520px 时操作换到正文下面一行。

可关闭

closable 显示关闭按钮。关闭时高度用 soft 弹簧折叠并淡出,结束后才卸载,下面的内容平滑补位。open / onOpenChange 可受控;出现时不做入场动画,避免页面加载时跳动。

新版本可用。刷新页面即可更新到 2.4.0。

自定义图标

icon 换掉默认图标;传 false 不显示图标。

你关注的任务有 3 条新评论。
没有图标的提示条。

规格

容器
圆角 18 · 内边距 16 · 柔和底色,不描边
关闭
高度 spring-soft 折叠 + 淡出,结束后卸载

接口

属性

属性类型默认值说明
tone'neutral' | 'accent' | 'success' | 'warning' | 'danger' | 'info''accent'状态色,同时决定默认图标和默认角色。
titleReactNode—加粗的标题,后面接正文。
iconReactNode | false—自定义图标;false 不显示。默认按 tone 选。
actionReactNode—右侧的操作(按钮、链接)。
closableboolean—显示关闭按钮。
open / defaultOpenbooleantrue是否显示,受控 / 非受控。
onOpenChange(open: boolean) => void—显示状态变化时。
onClose() => void—点了关闭按钮。
closeLabelstring'关闭'关闭按钮的读屏名称。
rolestring—覆盖默认角色(见下)。

无障碍

  • warning 和 danger 默认是 role="alert":出现时读屏立即打断播报。其余是 role="status":等读屏空闲时再读。
  • 页面加载时就在的静态提示不需要播报,可以传 role="note" 之类覆盖;只有动态插入的才值得用 alert。
  • 关闭按钮是带名字的图标按钮,Tab 聚焦、Enter / 空格触发。关闭后焦点会丢失,请在 onClose 里把焦点移到合理的位置。
  • 图标是装饰性的,对读屏隐藏;状态必须从文字里读得出来。
  • 正文文字用正文色,在六种柔和底色上的对比度都高于 4.5:1。