Vant4 Empty 空狀態(tài)

介紹

空狀態(tài)時(shí)的占位提示。

引入

通過以下方式來全局注冊(cè)組件，更多注冊(cè)方式請(qǐng)參考組件注冊(cè)。

import { createApp } from 'vue';
import { Empty } from 'vant';

const app = createApp();
app.use(Empty);

代碼演示

基礎(chǔ)用法

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

圖片類型

Empty 組件內(nèi)置了多種占位圖片類型，可以在不同業(yè)務(wù)場(chǎng)景下使用。

<!-- 通用錯(cuò)誤 -->
<van-empty image="error" description="描述文字" />
<!-- 網(wǎng)絡(luò)錯(cuò)誤 -->
<van-empty image="network" description="描述文字" />
<!-- 搜索提示 -->
<van-empty image="search" description="描述文字" />

自定義大小

通過 ?image-size? 屬性圖片的大小。

<!-- 不指定單位，默認(rèn)為 px -->
<van-empty image-size="100" description="描述文字" />
<!-- 指定單位，支持 rem, vh, vw -->
<van-empty image-size="10rem" description="描述文字" />

將 ?image-size? 設(shè)置為數(shù)組格式，可以分別設(shè)置寬高。數(shù)組第一項(xiàng)對(duì)應(yīng)寬度，數(shù)組第二項(xiàng)對(duì)應(yīng)高度。

<van-empty :image-size="[60, 40]" description="描述文字" />

自定義圖片

需要自定義圖片時(shí)，可以在 image 屬性中傳入任意圖片 URL。

<van-empty
  image="https://fastly.jsdelivr.net/npm/@vant/assets/custom-empty-image.png"
  image-size="80"
  description="描述文字"
/>

底部?jī)?nèi)容

通過默認(rèn)插槽可以在 Empty 組件的下方插入內(nèi)容。

<van-empty description="描述文字">
  <van-button round type="primary" class="bottom-button">按鈕</van-button>
</van-empty>

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

API

Props

Slots

類型定義

組件導(dǎo)出以下類型定義：

import type { EmptyProps } from 'vant';

主題定制

樣式變量

組件提供了下列 CSS 變量，可用于自定義樣式，使用方法請(qǐng)參考 ConfigProvider 組件。