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) | 彩色通知信息描边色 |