Skip to content

Skeleton 骨架屏

在内容真正加载完成前先显示一个轮廓占位,缓解"白屏 + 跳动"的视觉割裂。

何时使用

  • 网络较慢,加载需 1 秒以上。
  • 图文混排的列表 / 详情页。
  • 第一次加载数据时使用;后续刷新优先用 loading 状态。

基本使用

完全无参时显示一个标题 + 三段段落的默认占位。

带动画

active 开启微光扫描动画,提示"正在加载"。

带头像

avatar 设为 true 显示左侧圆形占位;传对象可调形状与大小。

段落自定义

paragraph 传对象可改 rows(行数)和 width(宽度,可数组分别设每行宽)。

标题自定义

title 传对象可控制宽度。

圆角化

round 让占位条变圆角,与圆角文本组件视觉更协调。

切换为真实内容

loading=false 时直接渲染默认插槽,常用于异步加载完成后揭示真实内容。

API

Props

参数类型默认值说明
activebooleanfalse显示扫光动画
loadingbooleantruefalse 时显示默认插槽内容
avatarboolean | { shape, size }false头像占位
titleboolean | { width }true标题占位
paragraphboolean | { rows, width }true段落占位
roundbooleanfalse圆角化占位条

Slots

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

Released under the MIT License.