Skip to content

Empty 空状态

页面或列表中数据为空时的图文引导占位组件,支持 6 种预设场景模式、3D 浮雕光晕矢量徽章、自定义插图与行动按钮。


代码示例

1. 基础预设场景 (Preset Modes)

通过 mode 快捷设定场景为 data (数据空)、search (搜索空)、cart (购物车空)、network (无网络)、permission (无权限)。

vue
<template>
  <mu-empty mode="data" description="当前没有找到任何相关记录" />
  <mu-empty mode="search" description="未搜索到符合条件的搜索结果" />
  <mu-empty mode="cart" description="您的购物车空空如也" button-text="去抢购" @click-button="onGoShop" />
</template>

2. 自定义图片空状态 (Custom Image)

通过 image 传入外部图片或 GIF 动图地址。

vue
<template>
  <mu-empty
    image="/static/empty.png"
    title="暂无数据"
    description="请稍后重新加载"
    button-text="刷新重试"
  />
</template>

API 属性说明 (Props)

参数名说明类型可选值默认值
mode预设场景模式Stringdata | search | cart | message | network | permission'data'
title标题文案String-自动匹配预设
description / subText详细说明描述文案String-''
icon自定义矢量图标名称String-自动匹配预设
iconSize图标尺寸大小 (rpx)Number | String-52
iconColor自定义矢量图标色彩String-自动匹配预设
image / src自定义图片或动图 URLString-''
imageSize自定义图片尺寸 (px)Number | String-160
buttonText底部行动按钮文字String-''
padding上下内边距String-'80rpx 0 60rpx'

事件说明 (Events)

事件名说明回调参数
click-button点击底部行动按钮时触发(event: MouseEvent)

插槽说明 (Slots)

插槽名说明
default自定义底部行动按钮区域插槽
image自定义顶部插图/动图区域插槽

基于 MIT 协议开源发行

H5 模拟器 (empty)☀️🔄