uni.setNavigationBarTitle(OBJECT)

展示全部

# 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	H5	微信小程序	支付宝小程序	百度小程序	抖音小程序	飞书小程序	QQ小程序	快手小程序	京东小程序
x	√	√	√	√	1.48.0+	x	√	√	√

HarmonyOS Next 兼容性

HarmonyOS Next
HBuilderX 4.31

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

OBJECT参数说明

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

示例

uni.showNavigationBarLoading()

# uni.hideNavigationBarLoading(OBJECT)

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

平台差异说明

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

HarmonyOS Next 兼容性

HarmonyOS Next
HBuilderX 4.31

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	否	接口调用结束的回调函数（调用成功、失败都会执行）