Vue3空状态（Empty）

置顶 theMuseCatcher

已于 2024-11-01 10:20:57 修改

阅读量2.6k

点赞数 1

于 2023-04-17 10:13:06 首次发布

本文链接：https://blog.csdn.net/Dandrose/article/details/130193927

版权

Vue3 同时被 3 个专栏收录

81 篇文章 13 订阅

订阅专栏

TypeScript

80 篇文章 4 订阅

订阅专栏

Less

74 篇文章 3 订阅

订阅专栏

可自定义设置以下属性：

自定义描述内容（description），类型：string | slot | null，默认 '暂无数据'
设置描述文本的样式（descriptionStyle），类型：CSSProperties，默认 {}
显示图片的链接，或者选择两种预置风格图片（image），类型：'outlined' | 'filled' | string | slot，默认 'filled'
设置图片的样式（imageStyle），类型：CSSProperties，默认 {}
设置底部内容（footer），类型：slot，默认 undefined

效果如下图：

在线预览

①创建空状态组件Empty.vue：

其中引入使用了以下工具函数：

监听插槽存在 useSlotsExist

<script setup lang="ts">
import { computed } from 'vue'
import type { CSSProperties } from 'vue'
import { useSlotsExist } from '../utils'
interface Props {
  description?: string // 自定义描述内容 string | slot
  descriptionStyle?: CSSProperties // 设置描述文本的样式
  image?: 'filled' | 'outlined' | string // 显示图片的链接，或者 选择两种预置风格图片 string | slot
  imageStyle?: CSSProperties // 设置图片的样式
  footer?: string // 设置底部内容 string | slot
}
const props = withDefaults(defineProps<Props>(), {
  description: '暂无数据',
  descriptionStyle: () => ({}),
  image: 'filled',
  imageStyle: () => ({}),
  footer: undefined
})
const slotsExist = useSlotsExist(['default', 'description', 'footer'])
const showDescription = computed(() => {
  return slotsExist.description || props.description
})
const showFooter = computed(() => {
  return slotsExist.footer || props.footer
})
</script>
<template>
  <div class="m-empty" :class="{ 'empty-image-outlined': image === 'outlined' }">
    <div class="m-empty-image" :style="imageStyle">
      <slot v-if="slotsExist.default"></slot>
      <svg
        v-else-if="image === 'filled'"
        class="empty-filled"
        :style="imageStyle"
        viewBox="0 0 184 152"
        xmlns="http://www.w3.org/2000/svg"
      >
        <g fill="none" fill-rule="evenodd">
          <g transform="translate(24 31.67)">
            <ellipse fill-opacity=".8" fill="#F5F5F7" cx="67.797" cy="106.89" rx="67.797" ry="12.668"></ellipse>
            <path
              d="M122.034 69.674L98.109 40.229c-1.148-1.386-2.826-2.225-4.593-2.225h-51.44c-1.766 0-3.444.839-4.592 2.225L13.56 69.674v15.383h108.475V69.674z"
              fill="#AEB8C2"
            ></path>
            <path
              d="M101.537 86.214L80.63 61.102c-1.001-1.207-2.507-1.867-4.048-1.867H31.724c-1.54 0-3.047.66-4.048 1.867L6.769 86.214v13.792h94.768V86.214z"
              fill="url(#linearGradient-1)"
              transform="translate(13.56)"
            ></path>
            <path
              d="M33.83 0h67.933a4 4 0 0 1 4 4v93.344a4 4 0 0 1-4 4H33.83a4 4 0 0 1-4-4V4a4 4 0 0 1 4-4z"
              fill="#F5F5F7"
            ></path>
            <path
              d="M42.678 9.953h50.237a2 2 0 0 1 2 2V36.91a2 2 0 0 1-2 2H42.678a2 2 0 0 1-2-2V11.953a2 2 0 0 1 2-2zM42.94 49.767h49.713a2.262 2.262 0 1 1 0 4.524H42.94a2.262 2.262 0 0 1 0-4.524zM42.94 61.53h49.713a2.262 2.262 0 1 1 0 4.525H42.94a2.262 2.262 0 0 1 0-4.525zM121.813 105.032c-.775 3.071-3.497 5.36-6.735 5.36H20.515c-3.238 0-5.96-2.29-6.734-5.36a7.309 7.309 0 0 1-.222-1.79V69.675h26.318c2.907 0 5.25 2.448 5.25 5.42v.04c0 2.971 2.37 5.37 5.277 5.37h34.785c2.907 0 5.277-2.421 5.277-5.393V75.1c0-2.972 2.343-5.426 5.25-5.426h26.318v33.569c0 .617-.077 1.216-.221 1.789z"
              fill="#DCE0E6"
            ></path>
          </g>
          <path
            d="M149.121 33.292l-6.83 2.65a1 1 0 0 1-1.317-1.23l1.937-6.207c-2.589-2.944-4.109-6.534-4.109-10.408C138.802 8.102 148.92 0 161.402 0 173.881 0 184 8.102 184 18.097c0 9.995-10.118 18.097-22.599 18.097-4.528 0-8.744-1.066-12.28-2.902z"
            fill="#DCE0E6"
          ></path>
          <g transform="translate(149.65 15.383)" fill="#FFF">
            <ellipse cx="20.654" cy="3.167" rx="2.849" ry="2.815"></ellipse>
            <path d="M5.698 5.63H0L2.898.704zM9.259.704h4.985V5.63H9.259z"></path>
          </g>
        </g>
      </svg>
      <svg
        v-else-if="image === 'outlined'"
        class="empty-outlined"
        :style="imageStyle"
        viewBox="0 0 64 41"
        xmlns="http://www.w3.org/2000/svg"
      >
        <g transform="translate(0 1)" fill="none" fill-rule="evenodd">
          <ellipse fill="#f5f5f5" cx="32" cy="33" rx="32" ry="7"></ellipse>
          <g fill-rule="nonzero" stroke="#d9d9d9">
            <path
              d="M55 12.76L44.854 1.258C44.367.474 43.656 0 42.907 0H21.093c-.749 0-1.46.474-1.947 1.257L9 12.761V22h46v-9.24z"
            ></path>
            <path
              d="M41.613 15.931c0-1.605.994-2.93 2.227-2.931H55v18.137C55 33.26 53.68 35 52.05 35h-40.1C10.32 35 9 33.259 9 31.137V13h11.16c1.233 0 2.227 1.323 2.227 2.928v.022c0 1.605 1.005 2.901 2.237 2.901h14.752c1.232 0 2.237-1.308 2.237-2.913v-.007z"
              fill="#fafafa"
            ></path>
          </g>
        </g>
      </svg>
      <img v-else-if="image" class="empty-image" :src="image" alt="empty" />
    </div>
    <p v-if="showDescription" class="empty-description" :style="descriptionStyle">
      <slot name="description">{{ description }}</slot>
    </p>
    <div v-if="showFooter" class="empty-footer">
      <slot name="footer">{{ footer }}</slot>
    </div>
  </div>
</template>
<style lang="less" scoped>
.m-empty {
  margin-inline: 8px;
  text-align: center;
  .m-empty-image {
    height: 100px;
    margin-bottom: 8px;
    opacity: 1;
    .empty-filled {
      display: inline-block;
      vertical-align: bottom;
      width: 184px;
      height: 100px;
    }
    .empty-outlined {
      display: inline-block;
      vertical-align: bottom;
      width: 64px;
      height: 40px;
    }
    .empty-image {
      display: inline-block;
      height: 100%;
      vertical-align: middle;
    }
  }
  .empty-description {
    font-size: 14px;
    color: rgba(0, 0, 0, 0.25);
    line-height: 1.5714285714285714;
  }
  .empty-footer {
    margin-top: 16px;
  }
}
.empty-image-outlined {
  margin-block: 32px;
  .m-empty-image {
    height: 40px;
  }
}
</style>

②在要使用的页面引入：

<script setup lang="ts">
import Empty from './Empty.vue'
</script>
<template>
  <div>
    <h1>{{ $route.name }} {{ $route.meta.title }}</h1>
    <h2 class="mt30 mb10">预置风格: filled</h2>
    <Empty />
    <h2 class="mt30 mb10">预置风格: outlined</h2>
    <Empty image="outlined" />
    <h2 class="mt30 mb10">无描述</h2>
    <Empty :description="null" />
    <h2 class="mt30 mb10">自定义风格</h2>
    <h3 class="mb10">自定义图片地址、描述内容和样式</h3>
    <Empty
      image="https://gw.alipayobjects.com/mdn/miniapp_social/afts/img/A*pevERLJC9v0AAAAAAAAAAABjAQAAAQ/original"
      :image-style="{
        height: '60px'
      }"
    >
      <template #description>
        <span>
          Customize
          <a href="#api">Description</a>
        </span>
      </template>
      <template #footer>
        <Button type="primary">Create Now</Button>
      </template>
    </Empty>
    <h2>插槽自定义</h2>
    <Empty :image-style="{ height: '48px' }" :description-style="{ color: 'rgb(169, 174, 184)' }">
      <svg
        class="u-svg"
        viewBox="0 0 48 48"
        fill="none"
        xmlns="http://www.w3.org/2000/svg"
        stroke="currentColor"
        stroke-width="4"
        stroke-linecap="butt"
        stroke-linejoin="miter"
      >
        <path
          d="M24 5v6m7 1 4-4m-18 4-4-4m28.5 22H28s-1 3-4 3-4-3-4-3H6.5M40 41H8a2 2 0 0 1-2-2v-8.46a2 2 0 0 1 .272-1.007l6.15-10.54A2 2 0 0 1 14.148 18H33.85a2 2 0 0 1 1.728.992l6.149 10.541A2 2 0 0 1 42 30.541V39a2 2 0 0 1-2 2Z"
        ></path>
      </svg>
    </Empty>
  </div>
</template>
<style lang="less" scoped>
.u-svg {
  display: inline-block;
  vertical-align: bottom;
  width: 48px;
  height: 48px;
  fill: none;
  stroke: rgb(169, 174, 184);
}
</style>