字节小程序
开发者社区
小程序小游戏
登录
小程序自定义框架新版本适配指南

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

9474浏览作者: 社区管理员-LSJ

开放平台于2022年2月21日发布了《小程序页面结构升级重要通知》

本文档主要为了帮助原使用自定义&标准框架统一修改为自定义框架的小程序,进行符合平台规范的调整。

一、页面结构升级介绍

为提升开发者以及用户使用体验,平台将对小程序进行框架升级改造,从基础库 2.42.0.1 版本起生效。主要更改内容为default/custom导航栏样式调整,同时小程序面板的全局加载、下拉刷新、分包加载、更多面板等进行了升级。

更多升级介绍文档可查看:《小程序页面结构升级重要通知》

二、升级调整指南

(一)如何继续使用自定义导航栏/如何使用自定义导航栏

  • 根据申请要求进行申请权限获取小程序页面结构自定义能力规范S级以上小程序可在「开发者平台-功能管理-页面自定义能力」进行权限申请,或者寻找行业运营申请内测权限。
  • 获得自定义导航栏权限之后可以使用自定义导航栏。

(二)原标准框架进行平台自定义框架调整

新自定义导航栏元素:新改版导航栏对比旧版导航栏,小程序框架会在首页下发「品牌logo」「反馈」按钮,在非首页下发「返回」和「反馈」按钮

  1. 相应的page.json/app.json文件中字段navigationStyle应为custom(参考文档全局配置
  2. 新版本自定义导航栏中增设左上角按钮,首页展示「小程序logo」,非首页展示「返回按钮」,增设右侧「反馈按钮」按钮由小程序框架下发,开发者无需绘制,避开相应位置放置元素即可

案例1:

需要移动搜索框、定位等元素,进行重新排版,预留「logo」「反馈」的位置

案例2:

需要删除原有logo,并将标题左移,预留「logo」「反馈」的位置



  1. 位置信息开发者可通过getCustomButtonBoundingClientRect API获取,或者可以更新最新版本IDE切换新样式导航栏进行修改。
  2. 如调整过程中需要进行测试,可以通过IDE查看效果

  1. 调整完毕后,需要在版本提审前在更新日志备注【页面结构自定义调整】,提交新版本进行审核。版本审核通过后1-2个工作日内logo生效,即为修改成功;若logo未生效,可通过抖音开放平台右下角【?】—【在线咨询】进行反馈。

注意:预留出logo展示位置即可,不需要自己设计logo放在左上角,修改成功后,上传的小程序头像自动展示为logo。

三、相关指引文档/链接

文档内容

链接

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

点击查看

全局配置

点击查看

四、能力开通规范

说明:小程序想要拥有页面结构自定义能力需满足申请条件后才可申请,审核通过后即可获得该能力。

1、申请条件

  • 小程序主体信用分大于 90 分、评级达S平台定向邀请的小程序,且所属主体半年内,没有严重的违规记录。
  • 企业主体小程序支持申请。

2、申请方式:前往开发者平台-功能管理-页面结构自定义进行申请能力操作

3、审核周期:申请处理周期为 1-3 个工作日

4、使用规范

  • 小程序需要保证优质的用户体验,从视觉和布局上保证舒适度,从交流和互动上保证流畅性。
  • 小程序锚点落地页面必须是原生能力页面,不可以是 webview 实现;
  • 具备美观的 UI 设计。如:色调、字体大小统一,图片内容清晰,布局合理,按钮设计无突兀感;
  • 整体使用体验流畅。如:界面切换滑动顺畅,内容加载速度快,为用户提供及时的反馈以增加用户的耐心和信赖感;
  • 提供有效的动效,指引用户路径、凸显信息层级。避免在一屏幕中同时出现多个动效,或是夸张的效果,如闪烁、跳动。
最后一次编辑于 2023年04月10日
加载中