my.hideTabBar

Use this API to hide the tab bar, optionally with an animation effect.

Parameters

Property	Type	Required	Description
animation	Boolean	No	Whether to animate the hiding. Default: `false`
success	Function	No	Callback on success
fail	Function	No	Callback on failure
complete	Function	No	Callback that always executes

Code Example

Basic Usage

my.hideTabBar();

With Animation

my.hideTabBar({
  animation: true
});

With Callbacks

my.hideTabBar({
  animation: true,
  success() {
    console.log('Tab bar hidden');
  },
  fail(err) {
    console.error('Failed to hide tab bar:', err);
  }
});

Use Cases

Fullscreen Content

Hide the tab bar when displaying fullscreen content like videos or images.

Page({
  enterFullscreen() {
    my.hideTabBar({ animation: true });
  },

  exitFullscreen() {
    my.showTabBar({ animation: true });
  }
});

Conditional Display

Hide tab bar based on user role or state.

Page({
  onLoad() {
    if (this.data.isGuest) {
      my.hideTabBar();
    }
  }
});

my.setTabBarStyle

Customize tab bar style

my.switchTab

Navigate to a tab page

my.hideBackHome my.setTabBarStyle

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

Basic Usage

With Animation

With Callbacks

Use Cases

my.setTabBarStyle

my.switchTab

​Parameters

​Code Example

​Basic Usage

​With Animation

​With Callbacks

​Use Cases

​Related APIs

my.setTabBarStyle

my.switchTab

Parameters

Code Example

Basic Usage

With Animation

With Callbacks

Use Cases

Related APIs