Skip to content

Alert 警告提示

警告提示组件,对齐 Ant Design Alert。type 对应的背景/边框/文字色由 packages/ui/src/theme/componentTokens.ts 中的 alertTypeSurfaceClass 统一维护,避免在组件内散落色板 class。

示例

可访问性

Alert 使用 role='alert' 暴露重要提示内容。默认状态图标仅作视觉辅助,会从辅助技术树中隐藏;需要传达给读屏用户的信息应放在 messagedescription 中。传入自定义 icon 时,组件不会自动隐藏它。

可关闭 Alert 的默认关闭按钮使用 aria-label='Close alert'。当使用文字、图标或本地化关闭控件时,可以通过 closeIconcloseAriaLabel 保持视觉内容与可访问名称一致。

API

属性说明类型默认值
type类型'info' | 'success' | 'warning' | 'error''info'
message提示内容ReactNode-
description描述文案ReactNode-
closable可关闭booleanfalse
showIcon显示图标booleantrue
icon自定义图标ReactNode-
banner横幅模式booleanfalse
action操作区域ReactNode-
closeIcon自定义关闭控件内容ReactNode'✕'
closeAriaLabel关闭按钮的可访问名称string'Close alert'
onClose关闭回调(event: MouseEvent<HTMLButtonElement>) => void-