Skeleton 骨架屏

介绍

用于在内容加载过程中展示一组占位图形。

引入

通过以下方式来全局注册组件，更多注册方式请参考组件注册。

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

类型定义

组件导出以下类型定义：

import type { SkeletonProps, SkeletonAvatarShape } from 'vant';

主题定制

样式变量

组件提供了下列 CSS 变量，可用于自定义样式，使用方法请参考 ConfigProvider 组件。