Alert 警告提示

6353 / 2025-10-06 08:48:34 2018世界杯球队

Alert 警告提示

警告提示是临时通知,用于提供关于操作或事件的简洁反馈。

Storybook@heroui/alertSourceStyles source

安装

CLIpnpmnpmyarnbunThe above command is for individual installation only. You may skip this step if @heroui/react is already installed globally.

导入

IndividualGlobal

用法

PreviewCodeOpen in Chat

颜色

警告提示提供 6 种颜色变体以传达不同含义。

PreviewCodeOpen in Chat

变体

PreviewCodeOpen in Chat

圆角

PreviewCodeOpen in Chat

自定义图标

默认情况下,警告提示会根据 color 属性显示相应的图标。您可以使用 icon 属性提供自定义图标来覆盖此设置。

PreviewCodeOpen in Chat

无图标

您可以通过将 hideIcon 属性设置为 true 来隐藏图标。

PreviewCodeOpen in Chat

无图标包装器

您可以通过将 hideIconWrapper 属性设置为 true 来隐藏图标包装器。

PreviewCodeOpen in Chat

带操作

警告提示支持 endContent 属性以添加额外操作。

PreviewCodeOpen in Chat

受控可见性

您可以使用 isVisible 和 onVisibleChange 属性来控制警告提示的可见性。

PreviewCodeOpen in Chat

自定义样式

您可以通过向组件插槽传递自定义的 Tailwind CSS 类来定制警告提示。

PreviewCodeOpen in Chat

自定义实现

您可以使用 useAlert 钩子来创建您自己的警告提示组件。

数据属性

警告提示在 base 元素上具有以下属性:

data-visible: 当警告提示可见时

data-closeable: 当警告提示可关闭时

data-has-title: 当警告提示有标题时

data-has-description: 当警告提示有描述时

插槽

警告提示具有以下插槽:

base: 主警告提示容器元素

title: 标题元素

description: 描述元素

mainWrapper: 标题和描述内容的包装器

closeButton: 关闭按钮元素

iconWrapper: 警告提示图标包装器

alertIcon: 警告提示图标元素

无障碍访问

警告提示具有 alert 角色

默认情况下关闭按钮具有 aria-label="关闭"

关闭后,警告提示将从 DOM 中移除

API

Alert 属性

PropTypeDefaulttitleReactNodeiconReactNodedescriptionReactNodecolordefault | primary | secondary | success | warning | danger"default"variantsolid | bordered | flat | faded"flat"radiusnone | sm | md | lg | full"md"startContentReactNodeendContentReactNodeisVisiblebooleanisClosablebooleanfalsehideIconbooleanfalsehideIconWrapperbooleanfalsecloseButtonPropsButtonProps

Alert 事件

PropTypeDefaultonClose() => voidonVisibleChange(isVisible: boolean) => void