Skeleton 骨架屏

在内容加载前展示页面的大致结构,降低用户的等待焦虑。支持文本段落、圆形头像、按钮/图片等多种骨架形态以及带头像的段落组合。

基础用法
默认显示 3 行文本段落骨架,自带渐变动画。
自定义行数与宽度
通过 rows 设置行数,width 设置各行宽度(支持数组逐一指定)。
圆形骨架
设置 shape='circle' 显示圆形骨架,通过 size 控制尺寸。
矩形骨架
设置 shape='rect' 显示矩形骨架,适用于按钮、图片等占位。
带头像的段落
设置 show-avatar 在段落左侧展示圆形头像骨架,avatar-size 控制头像大小。
圆角行
设置 round 使段落行变为胶囊形状。
关闭动画
设置 animated 为 false 关闭渐变闪烁动画。
加载切换
通过 loading 控制骨架与真实内容的切换,加载完成后展示 slot 内容。
卡片骨架
组合多种形态模拟卡片占位效果。

Props

参数类型默认值说明
loadingbooleantrue是否处于加载状态,为 false 时显示 slot 内容
rowsnumber3段落骨架行数
animatedbooleantrue是否开启动画
widthstring | number | Array<string | number>行宽度,数组可逐行指定
heightnumber | string16行高度(px),shape=rect 时也用于指定高度
shape'text' | 'circle' | 'rect''text'骨架形态:文本段落、圆形、矩形
size'sm' | 'md' | 'lg' | number'md'圆形骨架尺寸(仅 shape=circle 时生效)
showAvatarbooleanfalse段落左侧是否显示圆形头像
avatarSizenumber40头像大小(px)
roundbooleanfalse行是否为胶囊圆角

Slots

插槽名说明
default加载完成后的真实内容(loading 为 false 时渲染)