uni.setNavigationBarTitle(options) @setnavigationbartitle

# uni.setNavigationBarTitle(options)

动态设置当前页面的标题 GitCode GitHub

# setNavigationBarTitle 兼容性

Web	微信小程序	Android	iOS	HarmonyOS
4.0	4.41	3.97	4.11	4.61

# 参数

名称

类型

必填

默认值

兼容性

描述

options

SetNavigationBarTitleOptions

是

名称

类型

必备

默认值

兼容性

描述

title

string

是

页面标题

success

(result: AsyncApiSuccessResult) => void

否

接口调用成功的回调函数

fail

(error: SetNavigationBarTitleFail) => void

否

接口调用失败的回调函数

complete

(res: AsyncApiResult) => void

否

接口调用结束的回调函数（调用成功、失败都会执行）

# SetNavigationBarTitleFail 的属性值

名称	类型	必备	默认值	兼容性	描述
errCode	number	是	-	-	设置导航栏标题错误码 - 4: 框架内部异常
errSubject	string	是	-	-	统一错误主题（模块）名称
data	any	否	-	-	错误信息中包含的数据
cause	Error	否	-	-	源错误信息，可以包含多个错误，详见SourceError
errMsg	string	是	-	-	-

# AsyncApiResult 的属性值

名称	类型	必备	默认值	兼容性	描述
errMsg	string	是	-	-	-

# 返回值

类型

必备

Promise<AsyncApiSuccessResult>

否

名称	类型	必备	默认值	兼容性	描述
errMsg	string	是	-	-	-

# 参见

# 示例

hello uni-app x

Template

Script

<template>
  <page-head title="setNavigationBarTitle"></page-head>
  <view class="uni-padding-wrap uni-common-mt">
    <button @tap="setNavigationBarNewTitle" class="uni-btn">
      设置当前页面标题为: {{ newTitle }}
    </button>
    <button @tap="setNavigationBarLongTitle" class="uni-btn">
      设置超长标题
    </button>
    <!-- #ifdef APP-HARMONY -->
    <button @tap="showNavigationBarLoading" class="uni-btn">
      设置标题 loading
    </button>
    <button @tap="hideNavigationBarLoading" class="uni-btn">
      隐藏标题 loading
    </button>
    <!-- #endif -->
  </view>
</template>