警告提示
警告提示是临时通知,用于提供关于操作或事件的简洁反馈。
安装
上述命令仅用于单独安装。如果 @heroui/react
已全局安装,则可以跳过此步骤。
导入
用法
颜色
警告提示提供 6 种颜色变体以表达不同含义。
变体
圆角
自定义图标
默认情况下,Alert 组件会根据 color
属性显示相应的图标。您可以通过使用 icon
属性提供自定义图标来覆盖此默认行为。
没有图标
您可以通过将 hideIcon
属性设置为 true
来隐藏图标。
没有图标容器
您可以通过将 hideIconWrapper
属性设置为 true
来隐藏图标容器。
带有操作
Alert 组件支持 endContent
属性,用于添加额外的操作。
可控的可见性
您可以使用 isVisible
和 onVisibleChange
属性来控制 alert 组件的可见性。
自定义样式
您可以通过将自定义 Tailwind CSS 类传递给组件插槽来自定义 alert 组件的样式。
自定义实现
您可以使用 useAlert
hook 来创建您自己的 alert 组件。
数据属性
Alert 组件在其 base
元素上具有以下属性
- data-visible: 何时 alert 组件可见
- data-closeable: 何时 alert 组件可以关闭
- data-has-title: 何时 alert 组件有标题
- data-has-description: 何时 alert 组件有描述
插槽
Alert 组件具有以下插槽
base
: 主要的 alert 容器元素title
: 标题元素description
: 描述元素mainWrapper
: 标题和描述内容的容器closeButton
: 关闭按钮元素iconWrapper
: alert 图标的容器alertIcon
: alert 图标元素
可访问性
- Alert 组件的角色是
alert
- 默认情况下,关闭按钮具有 aria-label="Close"
- 关闭后,alert 组件将从 DOM 中移除
API
Alert 组件属性
属性 | 类型 | 默认值 |
title |
| |
icon |
| |
description |
| |
color |
| "default" |
variant |
| "flat" |
radius |
| "md" |
startContent |
| |
endContent |
| |
isVisible |
| |
isClosable |
| false |
hideIcon |
| false |
hideIconWrapper |
| false |
closeButtonProps |
|
Alert 组件事件
属性 | 类型 | 默认值 |
onClose |
| |
onVisibleChange |
|