不能直接使用微信开发者工具生成的 .skeleton.wxml,因其依赖小程序专有语法(如 is="xxx"、data-event-opts、动态 style="{{}}"),而 uni-app 编译器不识别运行时 is 属性,会导致节点缺失、样式失效、动画不触发及真机错位;必须手写静态、轻量、无响应式开销的骨架组件,统一用 rpx/px、内联样式、 占位,并通过 v-if + $nextTick 精准控制显隐与加载节奏。

必须手写,不能靠微信开发者工具生成的 .skeleton.wxml 直接搬进 .vue 文件——真机上大概率错位、动画不触发、is="xxx" 报错,且小程序平台根本不认这种运行时注入逻辑。
为什么不能直接用微信开发者工具生成的骨架屏
微信开发者工具导出的 index.skeleton.wxml 是为原生小程序设计的,依赖 is 属性动态挂载模板,而 uni-app 编译到 mp-weixin 时会跳过这部分逻辑,导致 WXML 节点缺失或结构错乱。常见报错如:Component is not found in path "wxcomponents/dist/xxx" 或样式完全失效。
更关键的是:生成结果里大量使用 data-event-opts、is="components/xxx"、style="{{xxx}}" 等小程序专有语法,uni-app 的 Vue 模板编译器无法识别,也不支持运行时解析 is 值。
- 删掉所有以
is=开头的属性(包括is="skeleton") - 删掉所有
data-event-opts及类似绑定属性 - 把
class="sk-image"这类生成类名,统一替换成固定内联样式,例如style="background-color: #f2f2f2;" - 禁用任何百分比宽高(
width: 100%)、vh/vw,全部改用rpx或px
怎么写一个真正能用的骨架组件
核心原则:静态、轻量、无响应式开销。不要在骨架组件里用 props、slot、v-for 或计算属性——它们会在 v-if 切换时触发无谓更新,拖慢首屏渲染。
推荐结构:
<template><view class="skeleton-wrapper"><!-- 头图占位 --><image mode="scaleToFill" style="width: 750rpx; height: 300rpx; background-color: #f2f2f2;"></image><!-- 标题行 --><view style="width: 60%; height: 40rpx; margin: 30rpx 0 20rpx; background-color: #e4e4e4; border-radius: 4rpx;"></view><!-- 正文段 --><view v-for="i in 3" :key="i" style="width: 100%; height: 24rpx; margin-bottom: 16rpx; background-color: #f2f2f2; border-radius: 3rpx;"></view></view></template>
- 图片必须用
+mode="scaleToFill",不用加 background,否则真实图片加载完成会 layout shift - 所有尺寸用
rpx(推荐)或固定px,iOS 和安卓端表现最稳 - 颜色统一用
#f2f2f2(背景块)和#e4e4e4(高亮块),规避暗黑模式翻车 - 避免用伪元素(
::after)、渐变背景(linear-gradient)——小程序不支持 background-image 动画
loading 状态怎么控制才不闪不白
90% 的“一闪就白”问题,根源是 loading 状态没和视图刷新节奏对齐。不是“接口返回了”,而是“DOM 真的重绘完了”。
-
this.loading = true必须写在uni.request调用前,不是 success 回调里 - 接口返回后,先赋值数据(如
this.list = res.data),再this.$nextTick(() => { this.loading = false }) - 小程序嵌套深时,加
setTimeout(() => { this.loading = false }, 16)保底(16ms ≈ 一帧) - 异常时不要清空骨架,保留并加「重试」按钮——白屏比灰屏更让人焦虑
- 切忌用
v-show控制骨架显隐;必须用v-if,否则骨架节点始终在 WXML 中,干扰scroll-view和intersection-observer
CSS 动画在各端怎么写才不崩
微信小程序不支持 background-image 动画,H5 支持但 WKWebView 对 -webkit- 敏感,统一方案只有:纯色 + opacity 脉冲。
动画定义必须包在条件编译里:
/* #ifdef H5 */
.skeleton-fade {
animation: pulse 1.5s ease-in-out infinite;
}
@keyframes pulse {
0%, 100% { opacity: 0.6; }
50% { opacity: 1; }
}
/* #endif */
- App 端需额外加
/* #ifdef APP-PLUS */块,并用-webkit-animation - 禁止在骨架组件中用
transition或复杂 timing-function,低端安卓机(尤其 Android 8–10)容易卡顿或跳帧 - 动画只作用于 opacity,别动 transform / width / height —— 小程序 setData 频次受限,layout 计算开销大
最易被忽略的一点:真机调试时,iPhone X 及以上机型常出现骨架左右偏移,根本原因是基础库对 vh/vw 支持不稳定,且 upx 在骨架这种纯静态结构中因编译时机偏差导致计算失准——所以务必全程禁用 %、vh、vw、upx。用 rpx,它才是跨端最老实的单位。











