Todos os produtos
Search
Central de documentação

SuperApp:Outros recursos

Última atualização: Jun 29, 2026

Este tópico descreve recursos adicionais da JSAPI para desenvolvimento de aplicativos H5 e mini programas.

Evento WindVaneReady

O WindVane dispara o evento WindVaneReady após o carregamento da página. Monitore esse evento para acompanhar o status de carregamento. O evento também é disparado ao atualizar a página ou quando o usuário navega para trás no histórico.

document.addEventListener('WindVaneReady', function(e) {
        alert('WindVaneReady');
}, false);

Evento de segundo plano

O WindVane dispara o evento WV.Event.APP.Background quando um aplicativo passa para o segundo plano (por exemplo, ao alternar para outro aplicativo ou abrir a barra de notificações). Monitore esse evento para detectar quando o aplicativo entra em segundo plano.

Comportamento por plataforma

  • [Android] O evento também é disparado quando o usuário muda da WebView atual para outra Activity, não apenas quando o aplicativo vai para o segundo plano.

  • [iOS v5.6.0 e posterior] Para alinhar com o comportamento do Android, o evento também é disparado quando o usuário muda da WebView atual para outro componente nativo ou WebView.

Parâmetros do evento (iOS v5.6.0 e posterior)

O parâmetro to especifica o destino da navegação do usuário a partir da WebView atual:

  • 'background': O aplicativo foi movido para o segundo plano.

Se to estiver ausente, não será possível determinar o destino.

Importante

Operações em segundo plano podem ser limitadas ou atrasadas até que a página seja reativada. Não chame alert() neste manipulador de eventos. Em alguns dispositivos Android, isso causa um bug crítico que deixa todas as páginas em branco.

document.addEventListener('WV.Event.APP.Background', function(e) {
        // On some devices, calling alert() when the app enters the background causes issues.
        console.log('Event Background');
}, false);

Evento ativo

O WindVane dispara o evento WV.Event.APP.Active quando um aplicativo retorna ao primeiro plano. Monitore esse evento para detectar quando o aplicativo se torna ativo.

Comportamento por plataforma

  • [Android] O evento também é disparado quando o usuário muda de outra Activity para a WebView atual, não apenas quando o aplicativo retorna do segundo plano.

  • [iOS v5.6.0 e posterior] Assim como no Android, o evento também é disparado quando o usuário muda de outro componente nativo ou WebView para a WebView atual.

Parâmetros do evento (iOS v5.6.0 e posterior)

O parâmetro from indica a origem da navegação do usuário:

  • 'background': O aplicativo retornou do segundo plano.

  • 'webview': O usuário mudou de outra WebView.

Caso from esteja ausente, a origem não pode ser determinada.

WindVane v6.3.0 e posterior

Um parâmetro data está disponível para recuperar dados passados por WebAppInterface.pop.

document.addEventListener('WV.Event.APP.Active', function(e) {
        alert('Event Active');
}, false);