Empty空状态 - 图1

空状态

空状态时的展示占位图。

空状态时的展示占位图。

何时使用

  • 当目前没有数据时,用于显式的用户提示。
  • 初始化场景时的引导创建流程。

代码演示

Empty空状态 - 图2

基本

简单的展示。

  1. <template>
  2. <a-empty />
  3. </template>

Empty空状态 - 图3

全局化配置

自定义全局组件的 Empty 样式。

  1. <template>
  2. <div>
  3. <a-switch
  4. un-checked-children="default"
  5. checked-children="customize"
  6. :checked="customize"
  7. @change="val => (customize = val)"
  8. />
  9. <a-divider />
  10. <a-config-provider>
  11. <template v-if="customize" #renderEmpty>
  12. <div style="text-align: center">
  13. <a-icon type="smile" style="font-size: 20px" />
  14. <p>Data Not Found</p>
  15. </div>
  16. </template>
  17. <div class="config-provider">
  18. <h3>Select</h3>
  19. <a-select :style="style" :options="[]" />
  20. <h3>TreeSelect</h3>
  21. <a-tree-select :style="style" :tree-data="[]" />
  22. <h3>Cascader</h3>
  23. <a-cascader :style="style" :options="[]" :show-search="true" />
  24. <h3>Transfer</h3>
  25. <a-transfer :data-source="[]" />
  26. <h3>Table</h3>
  27. <a-table style="margin-top: 8px" :columns="columns" :data-source="[]" />
  28. <h3>List</h3>
  29. <a-list :data-source="[]" />
  30. </div>
  31. </a-config-provider>
  32. </div>
  33. </template>
  34. <script>
  35. export default {
  36. data() {
  37. return {
  38. customize: false,
  39. style: { width: '200px' },
  40. columns: [
  41. {
  42. title: 'Name',
  43. dataIndex: 'name',
  44. key: 'name',
  45. },
  46. {
  47. title: 'Age',
  48. dataIndex: 'age',
  49. key: 'age',
  50. },
  51. ],
  52. };
  53. },
  54. };
  55. </script>
  56. <style>
  57. .code-box-demo .config-provider h3 {
  58. font-size: inherit;
  59. margin: 16px 0 8px 0;
  60. }
  61. </style>

Empty空状态 - 图4

自定义

自定义图片、描述、附属内容。

  1. <template>
  2. <a-empty
  3. image="https://gw.alipayobjects.com/mdn/miniapp_social/afts/img/A*pevERLJC9v0AAAAAAAAAAABjAQAAAQ/original"
  4. :image-style="{
  5. height: '60px',
  6. }"
  7. >
  8. <span slot="description"> Customize <a href="#API">Description</a> </span>
  9. <a-button type="primary">
  10. Create Now
  11. </a-button>
  12. </a-empty>
  13. </template>

Empty空状态 - 图5

无描述

无描述展示。

  1. <template>
  2. <a-empty :description="false" />
  3. </template>

Empty空状态 - 图6

选择图片

可以通过设置 imageEmpty.PRESENTED_IMAGE_SIMPLE 选择另一种风格的图片。

  1. <template>
  2. <a-empty :image="simpleImage" />
  3. </template>
  4. <script>
  5. import { Empty } from 'ant-design-vue';
  6. export default {
  7. beforeCreate() {
  8. this.simpleImage = Empty.PRESENTED_IMAGE_SIMPLE;
  9. },
  10. };
  11. </script>

API

  1. <Empty>
  2. <Button>创建</Button>
  3. </Empty>
参数说明类型默认值版本
description自定义描述内容string | v-slot-
imageStyle图片样式CSSProperties-1.5.0
image设置显示图片,为 string 时表示自定义图片地址string | v-slotfalse

内置图片 (1.5.0 以上版本)

  • Empty.PRESENTED_IMAGE_SIMPLE

    Empty空状态 - 图7

  • Empty.PRESENTED_IMAGE_DEFAULT

    Empty空状态 - 图8