R后悔药 Rue.js
  • 首页
    • 深度指南
    • 实战例子
    • 快速上手
    • 路由指南
    • 术语表
    • 错误代码参考
  • API
    • 合作伙伴
    • 插件
    • 组件库
    • 工具链
    • Text.js
    • 新闻简报
    • 常见问题
    • 团队
    • 版本发布
    • 社区指南
    • 行为规范
    • 隐私政策
  • 赞助
  • 合作伙伴
设置
目录统计
总条目
  • 按钮 Button
  • 排版 Typography
  • 时间选择器 TimePicker
  • 下拉菜单 Dropdown
  • 悬浮操作按钮 FAB
  • 模态框 Modal
  • 切换 Swap
  • 主题控制器 Theme Controller
  • 手风琴 Accordion
  • 头像 Avatar
  • 徽标 Badge
  • 卡片 Card
  • 轮播 Carousel
  • 聊天气泡 Chat
  • 折叠面板 Collapse
  • 倒计时 Countdown
  • 描述列表 Descriptions
  • 对比 Diff
  • 二维码 QRCode
  • 悬浮 3D 卡片 Hover 3D
  • 悬浮画廊 Hover Gallery
  • 键盘提示 Kbd
  • 列表 List
  • 统计 Stat
  • 状态 Status
  • 表格 Table
  • 文本轮播 Text Rotate
  • 时间线 Timeline
  • 锚点 Anchor
  • 固钉 Affix
  • 面包屑 Breadcrumbs
  • 底部导航 Dock
  • 链接 Link
  • 菜单 Menu
  • 导航栏 Navbar
  • 分页 Pagination
  • 步骤 Steps
  • 选项卡 Tabs
  • 提示 Alert
  • 结果页 Result
  • 空状态 Empty
  • 加载 Loading
  • 全局提示 Message
  • 进度条 Progress
  • 环形进度 Radial Progress
  • 骨架屏 Skeleton
  • 通知提醒框 Notification
  • 轻提示 Toast
  • 气泡确认框 Popconfirm
  • 气泡卡片 Popover
  • 工具提示 Tooltip
  • 日历 Calendar
  • 颜色选择器 ColorPicker
  • 复选框 Checkbox
  • 字段集 Fieldset
  • 表单 Form
  • 文件输入 File Input
  • 筛选器 Filter
  • 标签 Label
  • 单选框 Radio
  • 范围选择 Range
  • 评分 Rating
  • 分段选择 Segmented
  • 自动完成 AutoComplete
  • 选择器 Select
  • 树选择 TreeSelect
  • 树控件 Tree
  • 提及输入 Mentions
  • 穿梭框 Transfer
  • 漫游引导 Tour
  • 输入框 Input
  • 数字输入 InputNumber
  • 文本域 Textarea
  • 开关 Toggle
  • 校验器 Validator
  • 分隔线 Divider
  • 弹性布局 Flex
  • 分割面板 Splitter
  • 抽屉侧边栏 Drawer
  • 页脚 Footer
  • 栅格 Grid
  • 瀑布流 Masonry
  • 布局 Layout
  • 主视觉区 Hero
  • 指示器 Indicator
  • 组合项 Join
  • 蒙版 Mask
  • 水印 Watermark
  • 间距 Space
  • 堆叠 Stack
  • 浏览器样机 Mockup Browser
  • 代码样机 Mockup Code
  • 手机样机 Mockup Phone
  • 窗口样机 Mockup Window
目录统计
总条目
  • 按钮 Button
  • 排版 Typography
  • 时间选择器 TimePicker
  • 下拉菜单 Dropdown
  • 悬浮操作按钮 FAB
  • 模态框 Modal
  • 切换 Swap
  • 主题控制器 Theme Controller
  • 手风琴 Accordion
  • 头像 Avatar
  • 徽标 Badge
  • 卡片 Card
  • 轮播 Carousel
  • 聊天气泡 Chat
  • 折叠面板 Collapse
  • 倒计时 Countdown
  • 描述列表 Descriptions
  • 对比 Diff
  • 二维码 QRCode
  • 悬浮 3D 卡片 Hover 3D
  • 悬浮画廊 Hover Gallery
  • 键盘提示 Kbd
  • 列表 List
  • 统计 Stat
  • 状态 Status
  • 表格 Table
  • 文本轮播 Text Rotate
  • 时间线 Timeline
  • 锚点 Anchor
  • 固钉 Affix
  • 面包屑 Breadcrumbs
  • 底部导航 Dock
  • 链接 Link
  • 菜单 Menu
  • 导航栏 Navbar
  • 分页 Pagination
  • 步骤 Steps
  • 选项卡 Tabs
  • 提示 Alert
  • 结果页 Result
  • 空状态 Empty
  • 加载 Loading
  • 全局提示 Message
  • 进度条 Progress
  • 环形进度 Radial Progress
  • 骨架屏 Skeleton
  • 通知提醒框 Notification
  • 轻提示 Toast
  • 气泡确认框 Popconfirm
  • 气泡卡片 Popover
  • 工具提示 Tooltip
  • 日历 Calendar
  • 颜色选择器 ColorPicker
  • 复选框 Checkbox
  • 字段集 Fieldset
  • 表单 Form
  • 文件输入 File Input
  • 筛选器 Filter
  • 标签 Label
  • 单选框 Radio
  • 范围选择 Range
  • 评分 Rating
  • 分段选择 Segmented
  • 自动完成 AutoComplete
  • 选择器 Select
  • 树选择 TreeSelect
  • 树控件 Tree
  • 提及输入 Mentions
  • 穿梭框 Transfer
  • 漫游引导 Tour
  • 输入框 Input
  • 数字输入 InputNumber
  • 文本域 Textarea
  • 开关 Toggle
  • 校验器 Validator
  • 分隔线 Divider
  • 弹性布局 Flex
  • 分割面板 Splitter
  • 抽屉侧边栏 Drawer
  • 页脚 Footer
  • 栅格 Grid
  • 瀑布流 Masonry
  • 布局 Layout
  • 主视觉区 Hero
  • 指示器 Indicator
  • 组合项 Join
  • 蒙版 Mask
  • 水印 Watermark
  • 间距 Space
  • 堆叠 Stack
  • 浏览器样机 Mockup Browser
  • 代码样机 Mockup Code
  • 手机样机 Mockup Phone
  • 窗口样机 Mockup Window

Empty 空状态

Empty 用来承接列表、筛选、面板和工作流中的无数据状态。它保持了 Rue 一贯的轻量卡片语言,同时提供了空状态组件最核心的 image、description、children 和预设插画能力。

组件提供可复用的空态表达:默认插画适合页面主体,simple 插画适合嵌入式空态,语义插槽则方便你在卡片、筛选器、列表面板里继续细调样式。

# 基础空状态

默认插画、文案和动作区已经能覆盖大多数页面级空态。

当前筛选条件下还没有上线中的条目。你可以放宽条件,或者直接创建新内容。

# 预设插画与变体

default 与 simple 两套预设插画覆盖页面主空态和紧凑容器;surface、soft、outline 对应不同层级。

默认插画适合页面主体空态。
简洁插画适合表格、筛选或紧凑容器。
outline 更适合嵌入次级区域。

# 自定义插画与左对齐布局

需要更贴近业务语义时,可以直接传自定义节点,并切到 start 布局承接更多说明。

同步队列还是空的
把素材从个人工作台加入同步清单后,这里会自动生成批次并持续追踪状态。

# 嵌入式空态与语义插槽

classNames 和 styles 让 empty 可以自然嵌进列表、筛选面板和卡片,而不需要额外包一层 if。

成员视图0 records
筛选结果为空,先移除状态过滤器再试一次。
素材库草稿区
这里也可以只保持文案与动作区,不一定强制带插画。

API

保持易接入的属性组织方式,同时补一层更贴近 Rue 页面编排的尺寸、变体和语义插槽。

属性说明类型默认值
image空状态插画,支持字符串地址、预设插画组件函数或任意 JSX 节点。string | FC | anyEmpty.PRESENTED_IMAGE_DEFAULT
description文案区,可传字符串、富文本节点;显式传 false / null 可隐藏。any暂无数据
children底部动作区,适合放按钮、链接、过滤器重置等后续动作。any-
imageStyle / imageAlt控制插画容器样式与 img 的 alt 文案,支持字符串图片场景。any / string- / empty
size统一调整容器、插画与文案尺度,支持 sm / md / lg 及 small / default / large 别名。'sm' | 'md' | 'lg' | 'small' | 'default' | 'large'md
align内容布局方向,支持居中空态和左对齐嵌入式空态。'center' | 'start'center
variantRue 风格表面层级,适合页面主空态、嵌入卡片与轻量占位区。'surface' | 'soft' | 'outline'surface
className / rootClassName / style根节点扩展类名和样式,rootClassName 便于支持项目代码中的根节点类名分工。string / string / any-
classNames / styles语义插槽扩展,覆盖 root、image、description、footer 四个区域。object / object-
role根节点无障碍角色,默认以 status 暴露空状态反馈。stringstatus

静态成员

预设插画可以直接作为 image 传入,也可以在别的容器里独立复用。

属性说明类型默认值
Empty.PRESENTED_IMAGE_DEFAULT默认插画,适合页面级空状态。可直接作为 image 传入,或单独渲染。FC<EmptyPresentedImageProps>-
Empty.PRESENTED_IMAGE_SIMPLE简洁插画,适合表格、筛选区和紧凑卡片。FC<EmptyPresentedImageProps>-
页内导航
页内导航
文档
  • 深度指南
  • 实战例子
  • 快速上手
  • 术语表
  • 错误码参照表
关于
  • 常见问题
  • 团队
  • 版本发布
  • 社区指南
生态
  • 插件
  • 组件库
  • 路由指南
  • Text.js
© 2024-2026 Xiangmin Liu
Rue.JS