字节小程序
开发者社区
小程序小游戏
登录
小程序页面结构升级重要通知

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

36959浏览作者: 社区管理员-JN

尊敬的开发者:

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

主要更改内容为default/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 版本起,将提供新旧版导航栏的切换功能,默认为新版导航栏,切换入口如下图所示,该开关将在调整期限截止后下线,之后只保留新版导航栏。


四、相关指引文档/链接

内容

链接

获取小程序页面结构自定义能力规范

点击查看

小程序自定义框架改标准框架调整指南

点击查看

小程序自定义框架新版本适配指南

点击查看


2022.2.21







最后一次编辑于 2022年07月28日
加载中