Notification 设计文档

通知提醒框:命令式全局反馈 API(notification.open/success/info/warning/error/close/destroyAll/config + useNotification)。严格对齐 Semi——标题 + 内容 + 图标;六方位独立堆叠;单例容器惰性挂载到 getPopupContainer()(默认 body);duration 秒自动关闭(0 常驻)+ hover 暂停/重启定时器 + 同 id 原地更新;role=alert + aria-labelledby 关联标题;theme(normal/light) 填充样式;icon 自定义图标;onClick 点击回调;onCloseClick 关闭按钮回调;notification.config({ top/bottom/left/right/position/duration/zIndex/direction/getPopupContainer }) 全局配置(首次生效)。useNotification() 返回 [api, holderStore],配合 <NotificationHolder store={holderStore}> 让通知继承组件树上下文。

← API 文档

使用建议

通知提醒框:命令式全局反馈 API(notification.open/success/info/warning/error/close/destroyAll/config + useNotification)。严格对齐 Semi——标题 + 内容 + 图标;六方位独立堆叠;单例容器惰性挂载到 getPopupContainer()(默认 body);duration 秒自动关闭(0 常驻)+ hover 暂停/重启定时器 + 同 id 原地更新;role=alert + aria-labelledby 关联标题;theme(normal/light) 填充样式;icon 自定义图标;onClick 点击回调;onCloseClick 关闭按钮回调;notification.config({ top/bottom/left/right/position/duration/zIndex/direction/getPopupContainer }) 全局配置(首次生效)。useNotification() 返回 [api, holderStore],配合 <NotificationHolder store={holderStore}> 让通知继承组件树上下文。

Accessibility

  • role=alert(对齐 Semi);标题经 aria-labelledby 关联;关闭按钮为 IconButton,带 ariaLabel「关闭」。不抢焦点、不锁滚动。

设计变量

变量默认值用法
--cd-color-notification-ambient-bg var(--cd-color-bg-0)透明背景色叠加层(与bg0保持一致不建议修改)
--cd-color-notification-bg-default var(--cd-color-bg-3)通知背景色
--cd-color-notification-closebtn-icon var(--cd-color-text-2)通知 关闭按钮 图标颜色
--cd-color-notification-content-text var(--cd-color-text-1)通知 内容 文本颜色
--cd-color-notification-danger-icon var(--cd-color-danger)通知 危险 图标颜色
--cd-color-notification-danger-light-bg var(--cd-color-danger-light-default)彩色通知危险背景色
--cd-color-notification-danger-light-border var(--cd-color-danger)彩色通知危险描边色
--cd-color-notification-info-icon var(--cd-color-info)通知 信息 图标颜色
--cd-color-notification-info-light-bg var(--cd-color-info-light-default)彩色通知信息背景色
--cd-color-notification-info-light-border var(--cd-color-info)彩色通知信息描边色