# uni.setNavigationBarTitle(OBJECT)

动态设置当前页面的标题。

HarmonyOS Next 兼容性

HarmonyOS Next
HBuilderX 4.23

OBJECT参数说明

参数 类型 必填 说明
title String 页面标题
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

# 参数 HarmonyOS Next 兼容性

名称 HarmonyOS Next 兼容性
options -
名称 HarmonyOS Next 兼容性
title HBuilderX 4.23
success -
fail -
complete -

# SetNavigationBarTitleFail 的属性值

名称 HarmonyOS Next 兼容性
errCode -
errSubject -
data -
cause -
errMsg -

# AsyncApiResult 的属性值

名称 HarmonyOS Next 兼容性
errMsg -

示例

uni.setNavigationBarTitle({
	title: '新的标题'
});

注意

  • 如果需要在页面进入时设置标题,可以在onReady内执行,以避免被框架内的修改所覆盖。如果必须在onShow内执行需要延迟一小段时间

# uni.setNavigationBarColor(OBJECT)

设置页面导航条颜色。如果需要进入页面就设置颜色,请延迟执行,防止被框架内设置颜色逻辑覆盖

平台差异说明

App H5 微信小程序 支付宝小程序 百度小程序 抖音小程序、飞书小程序 QQ小程序 快手小程序 京东小程序
x

HarmonyOS Next 兼容性

HarmonyOS Next
HBuilderX 4.23

OBJECT参数说明

参数 类型 必填 说明 平台差异说明
frontColor String 前景颜色值,包括按钮、标题、状态栏的颜色,仅支持 #ffffff 和 #000000 App、H5、微信小程序、百度小程序、抖音小程序、QQ小程序、快手小程序、京东小程序
backgroundColor String 背景颜色值,有效值为十六进制颜色
animation Object 动画效果,{duration,timingFunc} 微信小程序、百度小程序、QQ小程序、快手小程序、京东小程序
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

# 参数 HarmonyOS Next 兼容性

名称 HarmonyOS Next 兼容性
options -
名称 HarmonyOS Next 兼容性
frontColor HBuilderX 4.23
backgroundColor HBuilderX 4.23
success -
fail -
complete -

# SetNavigationBarColorFail 的属性值

名称 HarmonyOS Next 兼容性
errCode -
errSubject -
data -
cause -
errMsg -

# AsyncApiResult 的属性值

名称 HarmonyOS Next 兼容性
errMsg -

注意

  • Android 上的 backgroundColor 参数有限制,黑色大于 rgb(30,30,30), 白色小于 rgb(235,235,235)
  • 如果需要在页面进入时设置标题,可以在onReady内执行,以避免被框架内的修改所覆盖。如果必须在onShow内执行需要延迟一小段时间

animation 结构

属性 类型 默认值 必填 说明
duration number 0 动画变化时间,单位 ms
timingFunc String 'linear' 动画变化方式

animation.timingFunc 有效值

说明
linear 动画从头到尾的速度是相同的。
easeIn 动画以低速开始
easeOut 动画以低速结束。
easeInOut 动画以低速开始和结束。

success返回参数说明

参数名 类型 说明
errMsg String 调用结果

示例

uni.setNavigationBarColor({
    frontColor: '#ffffff',
    backgroundColor: '#ff0000',
    animation: {
        duration: 400,
        timingFunc: 'easeIn'
    }
})

# uni.showNavigationBarLoading(OBJECT)

在当前页面显示导航条加载动画。

平台差异说明

App HarmonyOS Next H5 微信小程序 支付宝小程序 百度小程序 抖音小程序 飞书小程序 QQ小程序 快手小程序 京东小程序
x x 1.48.0+ x

HarmonyOS Next 兼容性

HarmonyOS Next
HBuilderX 4.24

App平台(不包括 HarmonyOS Next)调用此API时会在屏幕中间悬浮显示loading

OBJECT参数说明

参数 类型 必填 说明
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

示例

uni.showNavigationBarLoading()

# uni.hideNavigationBarLoading(OBJECT)

在当前页面隐藏导航条加载动画。

平台差异说明

App HarmonyOS Next H5 微信小程序 支付宝小程序 百度小程序 抖音小程序 飞书小程序 QQ小程序 快手小程序 京东小程序
x x 1.48.0+ x

HarmonyOS Next 兼容性

HarmonyOS Next
HBuilderX 4.24

App平台(不包括 HarmonyOS Next)调用此API时会关闭屏幕中间悬浮显示的loading

OBJECT参数说明

参数 类型 必填 说明
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

示例

uni.hideNavigationBarLoading()

# uni.hideHomeButton(OBJECT)

隐藏返回首页按钮。

平台差异说明

App HarmonyOS Next H5 微信小程序 支付宝小程序 百度小程序 抖音小程序 飞书小程序 QQ小程序 快手小程序 京东小程序
x x x x x 1.48.0+ x 1.10.0+ x

OBJECT参数说明

参数 类型 必填 说明
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

示例

uni.hideHomeButton()

说明

  • 微信小程序自基础库版本2.8.3开始支持
  • 当用户打开的小程序最底层页面是非首页时,默认展示“返回首页”按钮,开发者可在页面onShow中调用hideHomeButton进行隐藏。