Skeleton 骨架屏
uni-appH5微信小程序App
跨端加载骨架屏,支持头像、行数和真实内容插槽。
何时使用
首屏或列表加载、内容结构可预期时,用占位降低等待焦虑。
何时不使用
短促的按钮级/局部加载用 Loading 或 Button loading;结构完全不可预期时用 Loading。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
rows | number | 3 | 段落行数,最后一行收窄为 45% 宽 |
avatar | boolean | false | 左侧圆形头像占位 |
loading | boolean | true | false 时渲染默认 slot 的真实内容 |
animated | boolean | true | 微光扫过动画 |
Slots
| 名称 | 说明 |
|---|---|
default | loading=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>