Skip to content

Skeleton 骨架屏 ​

在需要等待加载内容的位置提供占位图形。融合了市面上主流 UI 框架的便捷布局、高级动效以及高度灵活性。

基础用法 ​

最基础的纯文本行骨架屏。

基础用法

常见布局 ​

通过 avatar、title 和 rows 快速构建常见的列表项布局。

常见布局

精细化项控制 (SkeletonItem) ​

当内置布局无法满足时,可以使用 YhSkeletonItem 自由组装。支持 circle、rect、text、button、image 等多种语义化变体。

项控演示

创意组合:高级卡片 ​

利用 variant="rect" 和 repeat 属性,可以轻松实现复杂的卡片流式骨架。

卡片骨架

自创高级特性 ​

1. 智能节流 (Throttle) ​

通过 throttle 属性设置延迟显示时间。如果异步数据在设定时间内加载完成,骨架屏将永不出现。这能有效消除网络状况良好时骨架屏瞬间闪烁带来的"焦虑感"。

2. 视口感应 (Lazy Animation) ​

开启 lazy 后,骨架屏的闪烁动画仅会在元素进入视口(Viewport)时才正式启动。这大幅减少了长列表页面中不可见元素的 GPU 占用,是性能优化的极致实践。

3. 多态渲染 (Polymorphic) ​

SkeletonItem 的 variant 覆盖了所有主流交互设计稿中的原子元素,确保了从设计到代码的高还原度。

在 Nuxt 中使用 ​

YhSkeleton 完全优化了 Nuxt/SSR 环境,自动降级至安全渲染模式。

Nuxt 中使用

API ​

Skeleton Props ​

属性名说明类型默认值
loading是否显示加载中渲染booleantrue
animated是否开启闪烁动画booleantrue
rows默认布局渲染的行数number3
title是否渲染标题占位booleanfalse
avatar是否渲染圆形头衔占位booleanfalse
throttle延迟显示毫秒数,防止闪烁number0
lazy仅在视口内才启动动画 (自创高级)booleanfalse

SkeletonItem Props ​

属性名说明类型默认值
variant变体种类 (circle, rect, h1, h3, text, button, image)string'text'
width宽度string | number—
height高度string | number—
animated是否开启闪烁动画booleantrue
round是否为圆角booleanfalse
sharp为 true 时,显式设为直角booleanfalse
repeat循环渲染次数 (自创实用)number1

主题变量 ​

变量名说明默认值
--yh-skeleton-bg-color骨架基础背景色var(--yh-fill-color-dark)
--yh-skeleton-shimmer-color动画扫光颜色var(--yh-fill-color-light)

类型导出 ​

名称说明
YhSkeletonPropsSkeleton Props 类型
YhSkeletonSlotsSkeleton 插槽类型
YhSkeletonInstanceSkeleton 实例类型
YhSkeletonItemPropsSkeletonItem Props 类型
YhSkeletonItemVariantSkeletonItem 变体联合类型
YhSkeletonItemInstanceSkeletonItem 实例类型

Released under the MIT License.