更新记录
1.0.0(2026-10-10)
- 首次提供智能骨架屏运行时(uni-app x)
- 支持按布局文件绘制骨架、列表 repeat、流光动画与暗黑主题
平台兼容性
uni-app x(4.19)
| Chrome | Safari | Android | iOS | 鸿蒙 | 微信小程序 |
|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | √ |
其他
| 多语言 | 暗黑模式 | 宽屏模式 | 蒸汽模式 |
|---|---|---|---|
| × | √ | √ | × |
智能骨架屏(uni-app x)
开发时从本机 H5 采集真实布局,运行时只按 skeleton/{id}.layout.json 画灰色块。手机端不再测量子节点。
安装
将本插件放入项目 uni_modules/y0218-smart-skeleton。HBuilderX 4.19+,easycom 自动生效,组件标签为 smart-skeleton。
用法
<smart-skeleton name="order-card" :loading="loading" :repeat="orders.length" :repeat-gap="12">
<order-card :item="orders[0]" />
</smart-skeleton>
布局需先注册:
import { setSkeletonLayout } from '@/uni_modules/y0218-smart-skeleton'
setSkeletonLayout('order-card', layoutJson)
建议在 skeleton/install.js(或等价入口)里批量注册,并在应用入口引入。
主要属性
| 属性 | 说明 |
|---|---|
| loading | 必填,为真时只画骨架 |
| name | 布局 id,建议每个区域都传 |
| repeat / repeatGap | 列表重复份数与间距 |
| animate | 流光动画,默认 true |
| theme | light / dark / auto |
| color / shine / dark | 骨架色 |
| minHeight | 无布局时的占位高度,默认 88 |
采集
配套 CLI(npm)在开发期连接本机 H5,用 Playwright 采集布局并写入 skeleton/*.layout.json。正式包不读取采集标记,也不请求采集端口。
说明
- 仅支持 uni-app x;普通 uni-app(Vue2/Vue3)请用配套插件
y0218-skeleton-vue - 两端 API 一致:同一套
smart-skeleton属性与setSkeletonLayout - 本插件不采集任何数据,无广告,无系统权限申请
- 流光在 App 端用定时器驱动,离开页面会清除

收藏人数:
购买源码授权版(
试用
赞赏(0)
下载 256
赞赏 2
下载 12670260
赞赏 1955
赞赏
京公网安备:11010802035340号