Skip to content

FaAlert 提示

提示组件,用于展示重要信息、状态反馈和警告内容。

使用场景

  • 表单校验提示
  • 操作结果反馈
  • 页面公告说明
  • 风险或错误警告
  • 功能状态提示

Props

属性类型默认值说明
iconstring-图标名称,传入 Iconify 图标名
titlestring-提示标题
descriptionstring-提示描述
variant'default' | 'destructive''default'提示样式变体
classHTMLAttributes['class']-自定义 CSS 类

Slots

名称说明
description自定义描述内容,会覆盖 description prop 的显示

示例

基础用法

vue
<template>
  <FaAlert
    icon="i-lucide:info"
    title="提示信息"
    description="这是一条普通提示,用于展示页面说明或操作反馈。"
  />
</template>

不同样式

vue
<template>
  <div class="space-y-4">
    <FaAlert
      icon="i-lucide:info"
      title="普通提示"
      description="这是一条普通提示。"
    />
    <FaAlert
      icon="i-lucide:circle-alert"
      title="危险提示"
      description="这是一条需要用户注意的危险提示。"
      variant="destructive"
    />
  </div>
</template>

自定义描述内容

vue
<template>
  <FaAlert icon="i-lucide:terminal" title="命令执行完成">
    <template #description>
      <div>
        已成功生成文件,可继续进行下一步操作。
        <FaButton variant="link" class="h-auto px-0">
          查看详情
        </FaButton>
      </div>
    </template>
  </FaAlert>
</template>

注意事项

  1. 图标设置icon 使用 Iconify 图标名称,留空则不显示图标
  2. 描述内容:同时传入 description prop 和 description slot 时,优先显示 slot 内容
  3. 样式变体destructive 适合错误、风险、危险操作等提示
  4. 底层实现:组件基于 shadcn-vue Alert 实现,保留其基础结构和样式