# uni.setNavigationBarTitle(options)

动态设置当前页面的标题

# setNavigationBarTitle 兼容性

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

# 参数

名称 类型 必填 默认值 兼容性 描述
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

扫码体验(手机浏览器跳转到App直达页)

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>
  </view>
</template>



# 通用类型

# GeneralCallbackResult

名称 类型 必备 默认值 兼容性 描述
errMsg string -
错误信息