抖音小程序页面结构升级重要通知

尊敬的开发者：

你好！为提升开发者以及用户使用体验，平台将对小程序进行框架升级改造，从基础库 2.42.0.1 版本起生效。

主要更改内容为default/custom导航栏样式调整，同时小程序面板的全局加载、下拉刷新、分包加载、更多面板等逻辑等进行了升级。

其中，custom-自定义导航栏样式需在2022年5月23日前，由开发者自行完成调整，逾期未调整的小程序将无法更新版本。

S级小程序和平台定向邀请的小程序可以申请custom-自定义导航栏权限。申请路径：功能管理-页面结构自定义，具体申请规范请查阅小程序页面结构自定义能力开通规范。

以下为本次调整详细内容：

一、导航栏变更

default-标准导航栏

1. 首页/一级页面左侧新增小程序品牌logo展示，点击logo可返回首页；

2. 为便捷使用反馈功能，原胶囊按钮右侧新增反馈按钮，标题内容居左展示；

3. 子页面导航栏调整为左侧固定展示返回按钮，右侧新增反馈按钮。

custom-自定义导航栏

自定义导航栏需申请「页面结构自定义」权限方可使用，S级小程序和平台定向邀请的小程序可以申请，未获得权限的开发者需要在限时内进行调整

1. 自定义页面首页将新增品牌logo常驻在左上角，点击logo可返回首页，子页面调整为左侧固定展示返回按钮；开发者需要避开logo/返回按钮范围进行改造；

2. 为便捷使用反馈功能，原胶囊按钮右侧新增反馈按钮。

二、API变更

1. hideHomeButton 变更：保留隐藏返回首页的能力，但不隐藏小程序品牌logo，具体请查阅小程序文档；

2. 新增getCustomButtonBoundingClientRect： 返回自定义导航栏下不可改变的元素的位置信息（比如左上角logo/返回位置+ 右上角反馈位置等），具体请查阅小程序文档；

3. getMenuButtonBoundingClientRect更新说明：强调只返回右上角两个胶囊的信息，不包括反馈按钮；

4. X 分屏场景：删除默认导航栏不跟随这一能力。

三、IDE

为便于开发者编译，IDE 从 3.2.4 版本起，将提供新旧版导航栏的切换功能，默认为新版导航栏，切换入口如下图所示，该开关将在调整期限截止后下线，之后只保留新版导航栏。