# wx.setTopBarText(Object object)

Start from base library version 1.4.3. Please remaining backward compatible.

From base library 1.9.9 Start, this interface stops maintenance

with Promise style call: Supported

Need page permissions: Mini Programs cannot call this interface from a plugin page, and plugins cannot call the interface from the plugins page

Mini Program plugin: Not supported

Dynamically set the top column text content. If the current Mini Program is not capped, it will be called successfully, but it will not take effect immediately. Only after the user puts the Mini Program on the top will the text be changed.

# parameter

# Object object

attribute type Default values Required Introductions
text string yes Top bar text
success function no Interface calls the successful callback function
fail function no Interface calls failed callback functions
complete function no Callback function at the end of an interface call (both successful and unsuccessful calls are executed)

# sample code

  text: 'hello, world!'

# Be careful

  • After successful invocation, interval 5s To call this interface again, if the 5s This interface is called again within the fail,errMsg:"setTopBarText: fail invoke too frequently"