跳到主要内容

Skeleton 骨架屏 ​

uni-appH5微信小程序App

跨端加载骨架屏,支持头像、行数和真实内容插槽。

何时使用 ​

首屏或列表加载、内容结构可预期时,用占位降低等待焦虑。

何时不使用 ​

短促的按钮级/局部加载用 Loading 或 Button loading;结构完全不可预期时用 Loading。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
Skeleton 骨架屏 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
rowsnumber3段落行数,最后一行收窄为 45% 宽
avatarbooleanfalse左侧圆形头像占位
loadingbooleantruefalse 时渲染默认 slot 的真实内容
animatedbooleantrue微光扫过动画

Slots ​

名称说明
defaultloading=false 时的真实内容

示例 ​

基础骨架 ​

vue
<Skeleton :rows="3" />

带头像 ​

vue
<Skeleton :rows="2" avatar />

加载完成切换 ​

vue
<Skeleton :rows="2" avatar :loading="loading">
  <Cell title="加载完成" value="真实内容" />
</Skeleton>
<Button size="sm" variant="ghost" style="margin-top:10px" @click="loading = !loading">切换 loading</Button>