跳到主要内容

Empty 空状态 ​

uni-appH5微信小程序App

数据为空时的跨端占位状态。

何时使用 ​

列表、搜索结果、购物车等无数据场景。

何时不使用 ​

加载中的占位用 Skeleton;网络异常等错误态应提供重试入口。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
Empty 空状态 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
descriptionstring"暂无数据"描述文案,传空字符串可隐藏
imagestring""自定义插图 URL,默认显示内置 SVG 空托盘插画

Slots ​

名称说明
default操作按钮或补充内容

示例 ​

默认空状态 ​

vue
<Empty />

自定义描述 ​

vue
<Empty description="暂无订单" />

带操作按钮 ​

vue
<Empty description="购物车还是空的">
  <Button size="sm" variant="primary">去逛逛</Button>
</Empty>

自定义图片 ​

vue
<Empty :image="imgB" description="暂无收藏内容" />