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