开发
API

tt.hideHomeButton

基础库 1.48.0 开始支持本方法,这是一个异步方法。

隐藏返回首页按钮。基础库 1.48.0 版本起,当用户打开的小程序最底层页面是非首页时,默认展示【返回首页】按钮,开发者可在页面 onShow 中调用 hideHomeButton 进行隐藏。 基础库 2.42.0 版本起,【返回首页】按钮 UI 改版,当用户打开小程序为一级页面,会露出小程序 logo,如果此时为非首页,点击 logo 会回到首页。此能力只能关闭返回首页的能力,但不影响左上角小程序 logo 按钮的露出。

语法

tt.hideHomeButton(options)

参数说明

options 为 object 类型,属性如下:

属性名类型默认值必填说明最低支持版本
successfunction接口调用成功的回调函数1.48.0
failfunction接口调用失败的回调函数1.48.0
completefunction接口调用结束的回调函数(调用成功、失败都会执行)1.48.0

回调成功

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring"hideHomeButton:ok"1.48.0

回调失败

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring"hideHomeButton:fail " + 详细错误信息1.48.0

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

Page({
  onShow() {
    // 隐藏当前页面的返回首页按钮
    tt.hideHomeButton({
      success() {
        console.log("调用成功");
      },
    });
  },
});

Bug & Tip

  • 不隐藏 小程序-右上角更多 面板下的返回首页功能按钮(基于功能需要,只隐藏明显的回到首页按钮,但保留回到首页能力)
点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助