Alert

用于保存结果或注意事项等需要持续显示在相关内容旁的消息。

预览

信息、成功与错误

比较 Registry 更新、同步成功和缺少令牌提示,各有对应图标和说明。

安装

首次使用此 Registry?请先完成 基础配置与共享样式安装 。

npx shadcn@latest add @neumorphism-ui/alert

先安装一次共享 base,然后使用 CLI 添加组件及其依赖。

Registry JSON

用法

在 Alert 内组合 AlertTitle 和 AlertDescription。根据消息含义选择 variant,同时用文字说明结果,避免只靠颜色表达。

import { Alert, AlertDescription, AlertTitle } from "@/components/ui/alert";

export default function Example() {
  return (
    <Alert variant="success">
      <AlertTitle>Changes saved</AlertTitle>
      <AlertDescription>Your workspace is up to date.</AlertDescription>
    </Alert>
  );
}

API 参考

用于排列图标、标题和说明的组合式 Alert。提供 default、success、destructive 三种变体,所有变体都同时使用边框和文字对比度,而不只依赖颜色。

组件属性类型默认值说明
Alertvariant"default" | "success" | "destructive""default"选择消息的语义和视觉状态。
AlertchildrenReact.ReactNode—排列图标、AlertTitle 和 AlertDescription。
AlertclassNamestring—扩展默认表面样式。

无障碍

  • 01

    Alert 使用 role=alert,适合动态出现的重要消息。

  • 02

    页面加载时已经存在的普通提示通常不需要 role=alert 的即时朗读,可覆盖 role 或改用其他容器。

  • 03

    装饰性图标应设置 aria-hidden=true,同时用标题和说明文本传达其含义。