更新记录

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 端用定时器驱动,离开页面会清除

隐私、权限声明

1. 本插件需要申请的系统权限列表:

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

暂无用户评论。