Vant3 Skeleton 骨架屏

2021-09-14 11:15 更新

介紹

用于在內容加載過程中展示一組占位圖形。

實例演示

引入

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

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

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

代碼演示

基礎用法

通過 title 屬性顯示標題占位圖,通過 row 屬性配置占位段落行數。

<van-skeleton title :row="3" />

顯示頭像

通過 avatar 屬性顯示頭像占位圖。

<van-skeleton title avatar :row="3" />

展示子組件

將 loading 屬性設置成 false 表示內容加載完成,此時會隱藏占位圖,并顯示 Skeleton 的子組件。

<van-skeleton title avatar :row="3" :loading="loading">
  <div>實際內容</div>
</van-skeleton>
import { ref, onMounted } from 'vue';

export default {
  setup() {
    const loading = ref(true);

    onMounted(() => {
      loading.value = false;
    });

    return {
      loading,
    };
  },
};

API

Props

參數 說明 類型 默認值
row 段落占位圖行數 number | string 0
row-width 段落占位圖寬度,可傳數組來設置每一行的寬度 number | string |
(number | string)[]
100%
title 是否顯示標題占位圖 boolean false
avatar 是否顯示頭像占位圖 boolean false
loading 是否顯示骨架屏,傳 false 時會展示子組件內容 boolean true
animate 是否開啟動畫 boolean true
round 是否將標題和段落顯示為圓角風格 boolean false
title-width 標題占位圖寬度 number | string 40%
avatar-size 頭像占位圖大小 number | string 32px
avatar-shape 頭像占位圖形狀,可選值為 square string round

樣式變量

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

名稱 默認值 描述
--van-skeleton-row-height 16px -
--van-skeleton-row-background-color var(--van-active-color) -
--van-skeleton-row-margin-top var(--van-padding-sm) -
--van-skeleton-title-width 40% -
--van-skeleton-avatar-size 32px -
--van-skeleton-avatar-background-color var(--van-active-color) -
--van-skeleton-animation-duration 1.2s -


以上內容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號