Empty 空状态

介绍

空状态时的占位提示。

引入

import Vue from 'vue';
import Empty from '@ophiuchus/empty';

Vue.use(Empty);

代码演示

基础用法

<sf-empty description="描述文字" />

图片类型

Empty 组件内置了多种占位图片类型，可以在不同业务场景下使用。

<!-- 通用错误 -->
<sf-empty image="error" description="描述文字" />
<!-- 网络错误 -->
<sf-empty image="network" description="描述文字" />
<!-- 搜索提示 -->
<sf-empty image="search" description="描述文字" />

自定义图片

需要自定义图片时，可以在 image 属性中传入任意图片 URL。

<sf-empty
  class="custom-image"
  image="https://img4.tuhu.org/OfRUe9mR6SL-NuijriKZSg_w200_h200.png"
  description="描述文字"
/>

<style>
  .custom-image .sf-empty__image {
    width: 90px;
    height: 90px;
  }
</style>

底部内容

通过默认插槽可以在 Empty 组件的下方插入内容。

<sf-empty description="描述文字">
  <sf-button round type="danger" class="bottom-button">按钮</sf-button>
</sf-empty>

<style>
  .bottom-button {
    width: 160px;
    height: 40px;
  }
</style>

API

Props

| 参数 | 说明 | 类型 | 默认值 | | --- | --- | --- | --- | | image | 图片类型，可选值为 error network search，支持传入图片 URL | string | default | | image-size | 图片大小，默认单位为 px | number | string | - | | description | 图片下方的描述文字 | string | - |

Slots

| 名称 | 说明 | | ----------- | -------------- | | default | 自定义底部内容 | | image | 自定义图标 | | description | 自定义描述文字 |

样式变量

组件提供了下列 Less 变量，可用于自定义样式，使用方法请参考主题定制。

| 名称 | 默认值 | 描述 | | ------------------------------ | ----------------- | ---- | | @empty-padding | @padding-xl 0 | - | | @empty-image-size | 160px | - | | @empty-description-margin-top | @padding-md | - | | @empty-description-padding | 0 60px | - | | @empty-description-color | @gray-6 | - | | @empty-description-font-size | @font-size-md | - | | @empty-description-line-height | @line-height-md | - | | @empty-bottom-margin-top | 24px | - |