my.setNavigationBar

Parameters

Property	Type	Required	Description
title	String	No	Text displayed in the navigation bar
image	String	No	Image URL (HTTPS only); replaces title when set
backgroundColor	String	No	Background color in hex format (e.g., `#ffffff`)
borderBottomColor	String	No	Bottom border color in hex format
success	Function	No	Callback on success
fail	Function	No	Callback on failure
complete	Function	No	Callback that always executes

Code Example

Set Title and Background Color

my.setNavigationBar({
  title: 'My Page',
  backgroundColor: '#108ee9',
  success() {
    console.log('Navigation bar updated');
  },
  fail() {
    console.log('Failed to update navigation bar');
  }
});

Set Title with Border

my.setNavigationBar({
  title: 'Settings',
  backgroundColor: '#ffffff',
  borderBottomColor: '#eeeeee'
});

Use Image Instead of Title

my.setNavigationBar({
  image: 'https://example.com/logo@3x.png',
  backgroundColor: '#ffffff'
});

Use Cases

Dynamic Title Based on Data

Page({
  onLoad(query) {
    // Set title based on page data
    my.setNavigationBar({
      title: query.name || 'Details'
    });
  }
});

Theme-Aware Navigation

Page({
  setTheme(isDark) {
    my.setNavigationBar({
      title: 'Settings',
      backgroundColor: isDark ? '#1a1a1a' : '#ffffff',
      borderBottomColor: isDark ? '#333333' : '#eeeeee'
    });
  }
});

my.showNavigationBarLoading

Show loading indicator

my.hideBackHome

Hide back to home button

JSAPI Reference

Basic

In-App Events

UI

Media

Storage

File

Location

Map

Network

Device

Sharing

Collection

Update

Web View

Alipay Connect

Open Capabilities

Other

Parameters

Code Example

Set Title and Background Color

Set Title with Border

Use Image Instead of Title

Notes

Use Cases

my.showNavigationBarLoading

my.hideBackHome

​Parameters

​Code Example

​Set Title and Background Color

​Set Title with Border

​Use Image Instead of Title

​Notes

​Use Cases

​Related APIs

my.showNavigationBarLoading

my.hideBackHome

Parameters

Code Example

Set Title and Background Color

Set Title with Border

Use Image Instead of Title

Notes

Use Cases

Related APIs