SuperApp:Dialog

Use a API WVUIDialog para exibir diálogos de alerta, confirmação, prompt e orientação de permissões em aplicativos HTML5 e MiniApps. Este tópico também aborda a API WVUIDatePicker para seleção de datas.

WVUIDialog.alert

Exibe um alerta.

Parâmetros de entrada

• message (string): Mensagem exibida no alerta.

• okbutton (string): Texto do botão OK.

• identifier (string): Identificador do alerta.

Eventos

O evento WV.Event.Alert é disparado quando o usuário responde ao alerta.

Parâmetros do evento

• identifier (string): Identificador do alerta.

Parâmetros de callback

O callback success é acionado quando o alerta é exibido. O callback failure é acionado em caso de erro. Nenhum dos callbacks retorna parâmetros.

var params = {
        // The message to display in the alert.
        message: 'Hello World!',
        // The text for the OK button.
        okbutton: 'OK'
};
window.WindVane.call('WVUIDialog', 'alert', params, function(e) {
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

WVUIDialog.confirm

Exibe uma caixa de diálogo de confirmação.

Parâmetros de entrada

• message (string): Mensagem exibida na caixa de diálogo de confirmação.

• okbutton (string): Texto do botão OK.

• cancelbutton (string): Texto do botão Cancelar.

• _index (int): Índice exclusivo para identificar a caixa de diálogo de confirmação.

Parâmetros de callback

O callback success é acionado quando a caixa de diálogo é exibida. O callback failure é acionado em caso de erro. Nenhum dos callbacks retorna parâmetros.

Eventos

O evento wv.dialog é disparado quando o usuário responde à caixa de diálogo de confirmação.

Parâmetros do evento

• type (string): Texto do botão tocado, correspondente ao parâmetro de entrada okbutton ou cancelbutton.

• _index (int): Índice da caixa de diálogo de confirmação, correspondente ao parâmetro de entrada _index.

document.addEventListener('wv.dialog', function(e) {
alert(JSON.stringify(e.param));
}, false);

var params = {
// The message to display in the confirm dialog.
message: 'Are you really really sure?',
// The text for the OK button.
 okbutton: 'OK',
// The text for the Cancel button.
cancelbutton: 'Cancel',
// The index of the confirm dialog.
_index: 10086
};
window.WindVane.call('WVUIDialog', 'confirm', params, function(e) {
}, function(e) {
alert('failure: ' + JSON.stringify(e));
});

WVUIDialog.enableAlertBeforeUnload

Ativa um alerta de confirmação de saída para páginas de MiniApp. Após a ativação, pressionar o botão Voltar dispara esse alerta.

Parâmetros de entrada

• message (string): Opcional. Mensagem da caixa de diálogo. Padrão: "Leave this page?".

Parâmetros de callback

Callback de sucesso:

• Nenhum.

Callback de falha:

• msg (string): Mensagem de erro.

var params = {
    // The content of the dialog.
    message: 'Are you sure you want to leave this page?',
};

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

WVUIDialog.disableAlertBeforeUnload

Desativa o alerta de confirmação de saída para páginas de MiniApp.

Parâmetros de entrada

• Nenhum.

Parâmetros de callback

Callback de sucesso:

• Nenhum.

Callback de falha:

• msg (string): Mensagem de erro.

window.WindVane.call('WVUIDialog', 'disableAlertBeforeUnload', {}, function(e) {
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

WVUIDialog.prompt

Exibe um prompt para entrada de texto.

Parâmetros de entrada

• title (string): Opcional. Título do prompt.

• message (string): Mensagem exibida no prompt. Padrão: "Please enter content."

• hint (string): Opcional. Texto de espaço reservado no campo de entrada.

• okbutton (string): Opcional. Texto do botão OK. Padrão: "OK".

• cancelbutton (string): Opcional. Texto do botão Cancelar. Padrão: "Cancel".

Parâmetros de callback

Callback de sucesso:

• ok (boolean): Retorna true se o botão OK for tocado ou false se o botão Cancelar for tocado.

• inputValue (string): Se ok for true, este parâmetro contém o texto inserido pelo usuário.

Callback de falha:

• msg (string): Mensagem de erro.

var params = {
  	    title: 'Prompt',
        message: 'Please enter xxx',
  		  hint: 'Please enter xxx',
        okbutton: 'OK',
  		  cancelbutton: 'Cancel'
};
window.WindVane.call('WVUIDialog', 'prompt', params, function(e) {
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

WVUIDialog.showAuthGuide

Exibe uma caixa de diálogo de orientação de permissões que solicita ao usuário a concessão de permissões específicas.

Parâmetros de entrada

• permission (string): Nome da permissão, como camera ou address book.

• okbutton (string): Texto do botão OK.

• jumpToSettings (string): Opcional. Defina como 1 para redirecionar à página de detalhes do aplicativo após o usuário tocar em OK, ou 0 para ignorar. Padrão: 0.

Parâmetros de callback

Callback de sucesso:

• Nenhum.

Callback de falha:

• msg (string): Mensagem de erro.

var params = {
  	    permission: 'address book',
  		  cancelbutton: 'Cancel',
  		  okbutton:'OK'
};
window.WindVane.call('WVUIDialog', 'showAuthGuide', params, function(e) {
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

WVUIDatePicker.show

Exibe um seletor de data. Usa a data atual como padrão se nenhuma data inicial for especificada.

Parâmetros de entrada

• year (string): Ano selecionado por padrão.

• month (string): Mês selecionado por padrão.

• dayOfMonth (string): Dia do mês selecionado por padrão.

• minYear (string): Ano mínimo selecionável.

• minMonth (string): Mês mínimo selecionável.

• minDayOfMonth (string): Dia do mês mínimo selecionável.

• maxYear (string): Ano máximo selecionável.

• maxMonth (string): Mês máximo selecionável.

• maxDayOfMonth (string): Dia do mês máximo selecionável.

Parâmetros de callback

O callback success retorna a data selecionada. O callback failure é acionado se a operação falhar.

• year (string): Ano selecionado.

• month (string): Mês selecionado.

• dayOfMonth (string): Dia do mês selecionado.

var params = {
  	    year: 2022,
  		  month: 11,
  			dayOfMonth: 15
};
window.WindVane.call('WVUIDatePicker', 'show', params, function(e) {
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});