Todos os produtos
Search
Central de documentação

SuperApp:Barra de navegação

Última atualização: Jul 10, 2026

Este documento descreve as JSAPIs da barra de navegação do miniapp para personalização da aparência.

WVNavigationBar.atualize

Define dinamicamente a barra de navegação da página atual.

Parâmetros de entrada:

  • [string] title: Opcional. Define o título da página.

  • [string] titleColor: Opcional. Cor do título da página no formato RGB.

  • [string] barStyle: Opcional. Estilo da barra de navegação. Valores válidos: 'float' (barra flutuante sobre o conteúdo) e 'normal' (conteúdo inicia abaixo da barra).

  • [string] backgroundColor: Opcional. Cor de fundo da barra de navegação em valor RGB.

  • [boolean] isShowBackBtn: Opcional. Controla a exibição do botão Voltar. Exibido por padrão. Defina como false para ocultar.

  • [string] theme: Opcional. Tema dos botões no lado direito da barra de navegação. Valores válidos: 'light' e 'dark'. Padrão: 'dark'.

  • [boolean] isShowCloseBtn: Opcional. Controla a exibição do botão Fechar. Exibido por padrão. Defina como false para ocultar.

  • [boolean] isShowMoreBtn: Opcional. Controla a exibição do botão Mais. Exibido por padrão. Defina como false para ocultar.

  • [float] titleSize: Opcional. Tamanho da fonte do título da página.

  • [string] titleStyle: Opcional. Estilo da fonte do título da página. Valores aceitos: 'normal', 'bold' e 'italic'.

  • [string] capsuleBgColor: Opcional. Cor de fundo do botão cápsula.

  • [string] capsuleBorderColor: Opcional. Cor da borda do botão cápsula.

Parâmetros de callback:

As funções de callback não recebem parâmetros. O callback success é acionado em caso de êxito, enquanto o callback failure é acionado em caso de falha.

var params = {
  title: 'Home',
  titleColor: '#FF00FF',
  barStyle: 'float',
  backgroundColor: '#00FFFF',
  isShowBackBtn: false,
  isShowMoreBtn: false,
  isShowCloseBtn: false,
  titleSize:16,
  titleStyle:"bold",
  capsuleBgColor:"#00FFFF",
  capsuleBorderColor:"#00FFFF"
  
};

window.WindVane.call('WVNavigationBar', 'update', params, function(e) {
}, function(e) {
  alert('failure: ' + JSON.stringify(e));
});

WVNavigationBar.getHeight

Obtém a altura da barra de navegação do miniapp.

Parâmetros de entrada:

Nenhum.

Parâmetros de callback:

  • [int] height: Altura atual da barra de navegação.

  • [int] screenWidth: Largura atual da tela.

  • [int] screenHeight: Altura atual da tela.

window.WindVane.call('WVNavigationBar', 'getHeight', {}, function(e) {
        alert('success:' + JSON.stringify(e));
}, function(e) {
        alert('failure:' + JSON.stringify(e));
});