Vant3 Empty 空狀態(tài)

2021-09-14 11:23 更新

介紹

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

實例演示

引入

通過以下方式來全局注冊組件,更多注冊方式請參考組件注冊。

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

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

代碼演示

基礎(chǔ)用法

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

圖片類型

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

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

自定義圖片

需要自定義圖片時,可以在 image 屬性中傳入任意圖片 URL。

<van-empty
  class="custom-image"
  image="https://img.yzcdn.cn/vant/custom-empty-image.png"
  description="描述文字"
/>

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

底部內(nèi)容

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

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

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

API

Props

參數(shù) 說明 類型 默認(rèn)值
image 圖片類型,可選值為 error network search,支持傳入圖片 URL string default
image-size 圖片大小,默認(rèn)單位為 px number | string -
description 圖片下方的描述文字 string -

Slots

名稱 說明
default 自定義底部內(nèi)容
image 自定義圖標(biāo)
description 自定義描述文字

樣式變量

組件提供了下列 CSS 變量,可用于自定義樣式,使用方法請參考 ConfigProvider 組件

名稱 默認(rèn)值 描述
--van-empty-padding var(--van-padding-xl) 0 -
--van-empty-image-size 160px -
--van-empty-description-margin-top var(--van-padding-md) -
--van-empty-description-padding 0 60px -
--van-empty-description-color var(--van-gray-6) -
--van-empty-description-font-size var(--van-font-size-md) -
--van-empty-description-line-height var(--van-line-height-md) -
--van-empty-bottom-margin-top 24px -


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號