组件
- 手风琴 (Accordion)
- 警告 (Alert)
- 警告对话框 (Alert Dialog)
- 宽高比 (Aspect Ratio)
- 头像 (Avatar)
- 徽章 (Badge)
- 面包屑 (Breadcrumb)
- 按钮 (Button)
- 按钮组 (Button Group)
- 日历 (Calendar)
- 卡片 (Card)
- 轮播图 (Carousel)
- 图表 (Chart)
- 复选框 (Checkbox)
- 折叠面板 (Collapsible)
- 组合框 (Combobox)
- 命令面板 (Command)
- 上下文菜单 (Context Menu)
- 数据表格 (Data Table)
- 日期选择器 (Date Picker)
- 对话框 (Dialog)
- 抽屉 (Drawer)
- 下拉菜单 (Dropdown Menu)
- 空状态 (Empty)
- 字段 (Field)
- 表单 (Form)
- 悬停卡片 (Hover Card)
- 输入框 (Input)
- 输入组 (Input Group)
- 验证码输入 (Input OTP)
- 项 (Item)
- 键盘按键 (Kbd)
- 标签 (Label)
- 菜单栏 (Menubar)
- 原生选择器 (Native Select)
- 导航菜单 (Navigation Menu)
- 数字输入框 (Number Field)
- 分页 (Pagination)
- 引脚输入 (Pin Input)
- 气泡卡片 (Popover)
- 进度条 (Progress)
- 单选框组 (Radio Group)
- 范围日历 (Range Calendar)
- 可调整大小 (Resizable)
- 滚动区域 (Scroll Area)
- 选择器 (Select)
- 分隔线 (Separator)
- 侧边栏抽屉 (Sheet)
- 侧边栏 (Sidebar)
- 骨架屏 (Skeleton)
- 滑块 (Slider)
- 轻量提示 (Sonner)
- 加载动画 (Spinner)
- 步骤条 (Stepper)
- 开关 (Switch)
- 表格 (Table)
- 标签页 (Tabs)
- 标签输入 (Tags Input)
- 文本域 (Textarea)
- 吐司提示 (Toast)
- 切换按钮 (Toggle)
- 切换按钮组 (Toggle Group)
- 工具提示 (Tooltip)
- 排版 (Typography)
开始使用
<script setup lang="ts">
import { ArrowUpRightIcon, FolderCode } from 'lucide-vue-next'
import { Button } from '@/components/ui/button'
import {
Empty,
EmptyContent,
EmptyDescription,
EmptyHeader,
EmptyMedia,
EmptyTitle,
} from '@/components/ui/empty'
</script>
<template>
<Empty>
<EmptyHeader>
<EmptyMedia variant="icon">
<FolderCode />
</EmptyMedia>
<EmptyTitle>No Projects Yet</EmptyTitle>
<EmptyDescription>
You haven't created any projects yet. Get started by creating your first
project.
</EmptyDescription>
</EmptyHeader>
<EmptyContent>
<div class="flex gap-2">
<Button>Create Project</Button>
<Button variant="outline">
Import Project
</Button>
</div>
</EmptyContent>
<Button variant="link" as-child class="text-muted-foreground" size="sm">
<a href="#">
Learn More <ArrowUpRightIcon />
</a>
</Button>
</Empty>
</template>安装
pnpm dlx shadcn-vue@latest add empty
使用方法
<script setup lang="ts">
import { FolderOpen } from 'lucide-vue-next'
import { Button } from '@/registry/default/ui/button'
import {
Empty,
EmptyContent,
EmptyDescription,
EmptyHeader,
EmptyMedia,
EmptyTitle,
} from '@/registry/default/ui/empty'
</script>
<template>
<Empty>
<EmptyHeader>
<EmptyMedia variant="icon">
<FolderOpen />
</EmptyMedia>
</EmptyHeader>
<EmptyTitle>No data</EmptyTitle>
<EmptyDescription>No data found</EmptyDescription>
<EmptyContent>
<Button>Add data</Button>
</EmptyContent>
</Empty>
</template>示例
大纲
使用 border 工具类来创建轮廓样式的空状态。
云存储为空
上传文件到云存储,以便随时随地访问。
<script setup lang="ts">
import { Cloud } from 'lucide-vue-next'
import { Button } from '@/components/ui/button'
import {
Empty,
EmptyContent,
EmptyDescription,
EmptyHeader,
EmptyMedia,
EmptyTitle,
} from '@/components/ui/empty'
</script>
<template>
<Empty class="border border-dashed">
<EmptyHeader>
<EmptyMedia variant="icon">
<Cloud />
</EmptyMedia>
<EmptyTitle>Cloud Storage Empty</EmptyTitle>
<EmptyDescription>
Upload files to your cloud storage to access them anywhere.
</EmptyDescription>
</EmptyHeader>
<EmptyContent>
<Button variant="outline" size="sm">
Upload Files
</Button>
</EmptyContent>
</Empty>
</template>背景
使用 bg-* 和 bg-gradient-* 工具类为该空状态添加背景。
没有通知
您已处理完所有内容。新的通知将出现在这里。
<script setup lang="ts">
import { Bell, RefreshCcw } from 'lucide-vue-next'
import { Button } from '@/components/ui/button'
import {
Empty,
EmptyContent,
EmptyDescription,
EmptyHeader,
EmptyMedia,
EmptyTitle,
} from '@/components/ui/empty'
</script>
<template>
<Empty class="from-muted/50 to-background h-full bg-gradient-to-b from-30%">
<EmptyHeader>
<EmptyMedia variant="icon">
<Bell />
</EmptyMedia>
<EmptyTitle>No Notifications</EmptyTitle>
<EmptyDescription>
You're all caught up. New notifications will appear here.
</EmptyDescription>
</EmptyHeader>
<EmptyContent>
<Button variant="outline" size="sm">
<RefreshCcw />
Refresh
</Button>
</EmptyContent>
</Empty>
</template>头像
使用 EmptyMedia 组件在空状态中展示头像。
ZN用户不在线
该用户当前不在线。您可以留言通知他们,或者稍后再试。
<script setup lang="ts">
import { Avatar, AvatarFallback, AvatarImage } from '@/components/ui/avatar'
import { Button } from '@/components/ui/button'
import {
Empty,
EmptyContent,
EmptyDescription,
EmptyHeader,
EmptyMedia,
EmptyTitle,
} from '@/components/ui/empty'
</script>
<template>
<Empty>
<EmptyHeader>
<EmptyMedia variant="default">
<Avatar class="size-12">
<AvatarImage
src="https://github.com/zernonia.png"
class="grayscale"
/>
<AvatarFallback>ZN</AvatarFallback>
</Avatar>
</EmptyMedia>
<EmptyTitle>User Offline</EmptyTitle>
<EmptyDescription>
This user is currently offline. You can leave a message to notify them
or try again later.
</EmptyDescription>
</EmptyHeader>
<EmptyContent>
<Button size="sm">
Leave Message
</Button>
</EmptyContent>
</Empty>
</template>头像组
使用 EmptyMedia 组件在空状态中展示头像组。
AA
SB
ZN暂无团队成员
邀请您的团队成员共同参与该项目。
<script setup lang="ts">
import { Plus } from 'lucide-vue-next'
import {
Avatar,
AvatarFallback,
AvatarImage,
} from '@/components/ui/avatar'
import { Button } from '@/components/ui/button'
import {
Empty,
EmptyContent,
EmptyDescription,
EmptyHeader,
EmptyMedia,
EmptyTitle,
} from '@/components/ui/empty'
</script>
<template>
<Empty>
<EmptyHeader>
<EmptyMedia variant="default">
<div class="*:ring-background flex -space-x-2 *:size-12 *:ring-2 *:grayscale">
<Avatar>
<AvatarImage
src="https://github.com/ace-of-aces.png"
alt="@ace-of-aces"
/>
<AvatarFallback>AA</AvatarFallback>
</Avatar>
<Avatar>
<AvatarImage
src="https://github.com/sadeghbarati.png"
alt="@sadeghbarati"
/>
<AvatarFallback>SB</AvatarFallback>
</Avatar>
<Avatar>
<AvatarImage
src="https://github.com/zernonia.png"
alt="@zernonia"
/>
<AvatarFallback>ZN</AvatarFallback>
</Avatar>
</div>
</EmptyMedia>
<EmptyTitle>No Team Members</EmptyTitle>
<EmptyDescription>
Invite your team to collaborate on this project.
</EmptyDescription>
</EmptyHeader>
<EmptyContent>
<Button size="sm">
<Plus />
Invite Members
</Button>
</EmptyContent>
</Empty>
</template>输入组
您可以将 InputGroup 组件添加到 EmptyContent 组件中。
404 - 未找到页面
您查找的页面不存在。请尝试在下方搜索您需要的内容。
/
需要帮助? 联系支持
<script setup lang="ts">
import { SearchIcon } from 'lucide-vue-next'
import {
Empty,
EmptyContent,
EmptyDescription,
EmptyHeader,
EmptyTitle,
} from '@/components/ui/empty'
import {
InputGroup,
InputGroupAddon,
InputGroupInput,
} from '@/components/ui/input-group'
import { Kbd } from '@/components/ui/kbd'
</script>
<template>
<Empty>
<EmptyHeader>
<EmptyTitle>404 - Not Found</EmptyTitle>
<EmptyDescription>
The page you're looking for doesn't exist. Try searching for what you
need below.
</EmptyDescription>
</EmptyHeader>
<EmptyContent>
<InputGroup class="sm:w-3/4">
<InputGroupInput placeholder="Try searching for pages..." />
<InputGroupAddon>
<SearchIcon />
</InputGroupAddon>
<InputGroupAddon align="inline-end">
<Kbd>/</Kbd>
</InputGroupAddon>
</InputGroup>
<EmptyDescription>
Need help? <a href="#">Contact support</a>
</EmptyDescription>
</EmptyContent>
</Empty>
</template>API 参考
空状态
空状态的主要组件。包裹了 EmptyHeader 和 EmptyContent 组件。
| 属性 | 类型 | 默认 |
|---|---|---|
class | string |
<template>
<Empty>
<EmptyHeader />
<EmptyContent />
</Empty>
</template>EmptyHeader
EmptyHeader 组件用于包裹空状态的媒体内容、标题和描述。
| 属性 | 类型 | 默认 |
|---|---|---|
class | string |
<template>
<EmptyHeader>
<EmptyMedia />
<EmptyTitle />
<EmptyDescription />
</EmptyHeader>
</template>EmptyMedia
使用 EmptyMedia 组件来显示空状态的媒体,如图标或图片。您也可以用它来显示其他组件,例如头像。
| 属性 | 类型 | 默认 |
|---|---|---|
variant | "default" | "icon" | default |
class | string |
<template>
<EmptyMedia variant="icon">
<Icon />
</EmptyMedia>
</template><template>
<EmptyMedia>
<Avatar>
<AvatarImage src="..." />
<AvatarFallback>CN</AvatarFallback>
</Avatar>
</EmptyMedia>
</template>EmptyTitle
使用 EmptyTitle 组件来显示空状态的标题。
| 属性 | 类型 | 默认 |
|---|---|---|
class | string |
<template>
<EmptyTitle>No data</EmptyTitle>
</template>EmptyDescription
使用 EmptyDescription 组件来显示空状态的描述。
| 属性 | 类型 | 默认 |
|---|---|---|
class | string |
<template>
<EmptyDescription>You do not have any notifications.</EmptyDescription>
</template>EmptyContent
使用 EmptyContent 组件来显示空状态的内容,例如按钮、输入框或链接。
| 属性 | 类型 | 默认 |
|---|---|---|
class | string |
<template>
<EmptyContent>
<Button>Add Project</Button>
</EmptyContent>
</template>