Vant4 Skeleton 骨架屏

介紹

用于在內(nèi)容加載過(guò)程中展示一組占位圖形。

引入

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

import { createApp } from 'vue';
import {
  Skeleton,
  SkeletonTitle,
  SkeletonImage,
  SkeletonAvatar,
  SkeletonParagraph,
} from 'vant';

const app = createApp();
app.use(Skeleton);
app.use(SkeletonTitle);
app.use(SkeletonImage);
app.use(SkeletonAvatar);
app.use(SkeletonParagraph);

代碼演示

基礎(chǔ)用法

通過(guò) ?title? 屬性顯示標(biāo)題占位圖，通過(guò) ?row? 屬性配置占位段落行數(shù)。

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

顯示頭像

通過(guò) ?avatar? 屬性顯示頭像占位圖。

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

展示子組件

將 ?loading? 屬性設(shè)置成 ?false? 表示內(nèi)容加載完成，此時(shí)會(huì)隱藏占位圖，并顯示 ?Skeleton? 的子組件。

<van-skeleton title avatar :row="3" :loading="loading">
  <div>實(shí)際內(nèi)容</div>
</van-skeleton>

import { ref, onMounted } from 'vue';

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

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

    return {
      loading,
    };
  },
};

自定義展示內(nèi)容

通過(guò) ?template? 插槽完成自定義內(nèi)容的展示。

<van-skeleton>
  <template #template>
    <div :style="{ display: 'flex', width: '100%' }">
      <van-skeleton-image />
      <div :style="{ flex: 1, marginLeft: '16px' }">
        <van-skeleton-paragraph row-width="60%" />
        <van-skeleton-paragraph />
        <van-skeleton-paragraph />
        <van-skeleton-paragraph />
      </div>
    </div>
  </template>
</van-skeleton>

API

Skeleton Props

SkeletonParagraph Props

SkeletonTitle Props

SkeletonAvatar Props

SkeletonImage Props

Skeleton Slots

類(lèi)型定義

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

import type {
  SkeletonProps,
  SkeletonImageProps,
  SkeletonTitleProps,
  SkeletonImageShape,
  SkeletonAvatarShape,
  SkeletonParagraphProps,
} from 'vant';

主題定制

樣式變量

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