尊敬的开发者:
你好!为提升开发者以及用户使用体验,平台将对小程序进行框架升级改造,从基础库 2.42.0.1 版本起生效。
主要更改内容为default/custom导航栏样式调整,同时小程序面板的全局加载、下拉刷新、分包加载、更多面板等进行了升级。
其中,导航栏样式需在2022年5月23日前,由开发者自行完成调整,逾期未调整的小程序将无法更新版本。
S级小程序和平台定向邀请的小程序可以申请custom-自定义导航栏权限。申请路径:功能管理-页面结构自定义,具体申请规范请查阅小程序页面结构自定义能力开通规范。
以下为本次调整详细内容:
一、导航栏变更
default-标准导航栏 | 调整可查看👉小程序自定义框架改标准框架调整指南![]()
- 首页/一级页面左侧新增小程序品牌logo展示,点击logo可返回首页;
- 为便捷使用反馈功能,原胶囊按钮右侧新增反馈按钮,标题内容居左展示;
- 子页面导航栏调整为左侧固定展示返回按钮,右侧新增反馈按钮。
custom-自定义导航栏 | 调整可查看👉小程序自定义框架新版本适配指南![]()
自定义导航栏需申请「页面结构自定义」权限方可使用,S级小程序和平台定向邀请的小程序可以申请,未获得权限的开发者需要在限时内进行调整
- 自定义页面首页将新增品牌logo常驻在左上角,点击logo可返回首页,子页面调整为左侧固定展示返回按钮;开发者需要避开logo/返回按钮范围进行改造;
- 为便捷使用反馈功能,原胶囊按钮右侧新增反馈按钮。
二、API变更
- hideHomeButton 变更:保留隐藏返回首页的能力,但不隐藏小程序品牌logo,具体请查阅小程序文档;
- 新增getCustomButtonBoundingClientRect: 返回自定义导航栏下不可改变的元素的位置信息(比如左上角logo/返回位置+ 右上角反馈位置等),具体请查阅小程序文档;
- getMenuButtonBoundingClientRect更新说明:强调只返回右上角两个胶囊的信息,不包括反馈按钮;
- X 分屏场景:删除默认导航栏不跟随这一能力。
三、IDE
为便于开发者编译,IDE 从 3.2.4 版本起,将提供新旧版导航栏的切换功能,默认为新版导航栏,切换入口如下图所示,该开关将在调整期限截止后下线,之后只保留新版导航栏。
四、相关指引文档/链接
2022.2.21