在微信小程序中使用骨架屏

在微信小程序中使用骨架屏可以优化用户体验,避免页面加载时出现白屏现象。以下是详细的使用方法和注意事项:

使用方法

  1. 生成骨架屏代码

    • 打开微信开发者工具,进入需要添加骨架屏的页面。
    • 在模拟器面板右下角点击三个点,选择"生成骨架屏"。
    • 点击"确定"后,会在当前页面同级目录下生成page.skeleton.wxmlpage.skeleton.wxss两个文件。
  2. 引入骨架屏

    • 在页面的wxml文件中引入骨架屏模板:

      xml 复制代码
      <import src="page.skeleton.wxml"/>
      <template is="skeleton" wx:if="{{loading}}" />
    • 在页面的wxss文件中引入骨架屏样式:

      css 复制代码
      @import "./page.skeleton.wxss";
  3. 控制骨架屏显示与隐藏

    • 在页面的data数据对象中添加一个loading变量,并将其初始值设置为true
    • 在数据加载完成后,通过setData方法将loading变量设置为false,隐藏骨架屏。

配置骨架屏

可在project.config.json中增加字段skeletonConfig进行骨架屏相关配置,页面配置会覆盖掉全局配置。开发者可根据需要设置文字、图片、按钮的颜色和形状,同时可根据excludesremovehide等忽视或隐藏部分页面元素,以获取更优的展示效果。

注意事项

  1. 骨架屏仅包括页面首屏中的可见区域,对于横向滚动的swiper等容器,超出屏幕的子元素将被忽略。
  2. 骨架屏的布局复用开发者的页面布局,需要骨架屏自适应页面尺寸时,页面布局应采用rpx等自适应方案。
  3. 部分组件如movable-viewmovable-arearich-texteditorpickerpicker-viewpicker-view-columnadofficial-accountopen-data无法生成理想的骨架效果,可通过添加一个父容器,结合grayBlockempty等配置,将其置灰。
  4. 请勿修改自动生成的骨架屏的代码,当效果不理想时,建议调整相关配置,这样当页面变更时,仍可自动生成。
  5. 生成的骨架屏代码中会包含预览时的页面数据,将被用来填充页面。
  6. 骨架屏通常用于商品列表、新闻列表等页面,对于动画/原生组件较多的页面展示效果不佳。
  7. 该能力除用于展示首屏骨架外,也可作为局部加载的loading样式,可灵活使用。
  8. 在使用过程中,为了避免骨架屏和真实页面元素同时出现,可在真实页面的view标签上加一个wx:else的条件。
  9. 微信开发工具生成wxml有行样式需要修改
相关推荐
小小王app小程序开发9 小时前
淘宝扭蛋机小程序核心玩法拆解与技术运营分析
大数据·小程序
说私域11 小时前
AI智能名片商城小程序数据清洗的持续运营策略与实践研究
大数据·人工智能·小程序·流量运营·私域运营
东东51612 小时前
xxx食堂移动预约点餐系统 (springboot+微信小程序)
spring boot·微信小程序·小程序·毕业设计·个人开发·毕设
CHU72903513 小时前
一番赏盲盒抽卡机小程序:解锁惊喜体验与社交乐趣的多元功能设计
前端·小程序·php
2501_9159184115 小时前
HTTPS 代理失效,启用双向认证(mTLS)的 iOS 应用网络怎么抓包调试
android·网络·ios·小程序·https·uni-app·iphone
数字游民952715 小时前
半年时间大概上了70个web站和小程序,累计提示词超过20w
人工智能·ai·小程序·vibecoding·数字游民9527
说私域16 小时前
微商企业未来迭代的核心方向与多元探索——以链动2+1模式AI智能名片商城小程序为核心支撑
大数据·人工智能·小程序·流量运营·私域运营
276695829216 小时前
美团 小程序 mtgsig
python·小程序·node·js·mtgsig1.2·美团小程序·大众点评小程序
2501_9151063217 小时前
混合应用(Hybrid)安全加固,不依赖源码对成品 IPA 混淆
android·安全·小程序·https·uni-app·iphone·webview
00后程序员张18 小时前
无需越狱,来对 iOS 设备进行调试、管理与分析
android·ios·小程序·https·uni-app·iphone·webview