当前位置: 首页 > news >正文

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

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

使用方法

  1. 生成骨架屏代码
    • 打开微信开发者工具,进入需要添加骨架屏的页面。
    • 在模拟器面板右下角点击三个点,选择“生成骨架屏”。
    • 点击“确定”后,会在当前页面同级目录下生成page.skeleton.wxmlpage.skeleton.wxss两个文件。
  2. 引入骨架屏
    • 在页面的wxml文件中引入骨架屏模板:
      <import src="page.skeleton.wxml"/>
      <template is="skeleton" wx:if="{{loading}}" />
      
    • 在页面的wxss文件中引入骨架屏样式:
      @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有行样式需要修改

相关文章:

  • 相机camera开发之差异对比核查二:测试机和对比机的差异提交对比
  • 微信小程序 - 手机震动
  • 【Linux 基础知识系列】第十九篇-图形化界面操作与使用
  • MQ常见问题分析——消息可靠性、消息积压、消息幂等问题
  • 多面体编译,具体操作模式
  • 深入解析Linux分页机制:从虚拟内存到物理地址的魔法转换
  • Java TCP网络编程核心指南
  • 机房断电后 etcd 启动失败的排查与快速恢复实录
  • 通过Netplan为Ubuntu服务器新增DNS以解析内部域名
  • 『uniapp』url拦截屏蔽 避免webview中打开淘宝店铺自动跳转淘宝
  • uniapp开发小程序vendor.js 过大
  • LeetCode 11题“盛最多水的容器”
  • 云原生核心技术 (6/12): K8s 从零到一:使用 Minikube/kind 在本地搭建你的第一个 K8s 集群
  • JWT令牌如何在FastAPI中实现安全又高效的生成与验证?
  • 【docker n8n】windows环境如何挂载
  • 论文分享 _ Ladder:一种基于收敛的结构化图区块链_2025-06-10
  • 记录chrome浏览器的一个bug
  • 项目四.高可用集群_ansible
  • Java 数据结构和集合框架(二十二)
  • 区块链Web3项目的开发
  • 织梦做的网站为什么显示404/厦门百度关键词优化
  • 苏州做网站好的公司/站长之家音效素材
  • 宁波宇丰建设有限公司网站/aso优化平台有哪些
  • 呼市城乡建设厅网站/百度百度一下就知道
  • 石家庄网站建设系统/电商网站建设步骤
  • 政府网站建设 特色栏目展示/软文编辑器