Skip to content

Empty 空状态

当某个区域的内容为空时,显示一个“空状态”的占位提示信息。

基础用法

通过标签 NueEmpty 生成空状态组件。

描述

使用属性 description 属性或者插槽 #description 设置占位文本。

<template>
    <nue-div wrap="nowrap">
        <nue-empty description="当前页面暂无数据" />
        <nue-empty>
            <template #description>
                <nue-text>当前页面暂无数据</nue-text>
            </template>
        </nue-empty>
    </nue-div>
</template>

图片路径

通过属性 imageSrc 设置自定义图片的路径。

<template>
    <nue-empty image-src="https://picsum.photos/64/64" />
</template>

图片大小

通过属性 imageSize 设置图片大小。属性类型为 string,支持 CSS width 单位值。

TIP

由于属性 imageSize 不支持分别设置宽高,所有图片大小仅实现缩放效果。若要同时设置宽度和高度(且不同),可以使用 theme 属性进行自定义样式的应用。

<template>
    <nue-empty image-size="4rem" />
</template>

注意事项

  1. 图片设置imageSize 属性用于设置图片的显示大小,接受 CSS 宽度值。
  2. 描述文本description 属性和 #description 插槽可以同时使用,插槽内容会覆盖属性值。
  3. 自定义图片:可以使用 imageSrc 属性设置自定义的空状态图片。

组件属性与事件

下方涵盖了 NueEmpty 组件所有的可用属性与事件。

属性

属性Type默认值说明
imageSrcstring-自定义图片路径
imageSizestring-图片大小,接受 CSS 宽度值
descriptionstring-描述文本
themestring | string[] | Record<string, boolean>-主题样式(继承自 GlobalProps)

Released under the MIT License.