iwtraining

Existe uma maneira simples de emitir notificações sonoras, físicas ou visuais ao usuário sem grande esforço.

Abaixo uma listagem das possibilidades:

  • notification.alert – caixa de diálogo padrão para informar algo ao usuário.
  • notification.confirm – caixa de diálogo de confirmação.
  • notification.prompt – caixa de diálogo de pergunta ao usuário.
  • notification.beep – emissão de som padrão do dispositivo do usuário.
  • notification.vibrate – vibração padrão do dispositivo do usuário.

Plugin

Lembre-se de importar o plugin antes de usar.

$ cordova plugin add org.apache.cordova.dialogs
$ cordova plugin add org.apache.cordova.vibration

Exibindo um alerta simples

Para exibir um alerta simples, chame a função alert, passando, nesta ordem, a mensagem, a função de callback, o título e o texto do botão positivo padrão.

function exibirAlerta() {
    navigator.notification.alert( "Você ganhou nada!", onAlertDismiss, "Parabéns!", "Okay" );
}

function onAlertDismiss() {
    // Faça algo
}

Emitindo um bip e vibrando o dispositivo

Uma forma de complementar o código anterior, é adicionando na função de callback dois recursos simples: o vibrate e o beep. Veja como ficaria:

function onAlertDismiss() {
    navigator.notification.beep(5);
    navigator.notification.vibrate(3000);
}

A função beep recebe (dentro dos parênteses) a quantidade de beeps que serão emitidos. A função vibrate recebe a duração, em milissegundos, da vibração do dispotivio.

Fazendo uma pergunta ao usuário

Uma outra necessidade que podemos ter é a de questionar algo específico ao usuário, inclusive, permitindo que ele digite algo como resposta. Para isso, utilizaremos a função prompt.

navigator.notification.prompt( "Digite seu nome:", onPromptDismiss, "Cadastro", ["Cancelar", "Salvar", "Gritar"], "" );

Esta função exige os parâmetros, em ordem: mensagem, callback, título, [botões (que é um array)] e um texto padrão, que em nosso exemplo acima foi deixado como vazio.

Abaixo um exemplo de como você poderia capturar o que o usuário digitou e também qual botão foi clicado.

function onPromptDismiss( results ) {
    msg.innerHTML = "Botão: " + results.buttonIndex + " Texto: " + results.input1;
}

Lembre-se: index refere a posição do botão, sempre iniciando de 0.

Posts Relacionados

Deixe um comentário