Exibir Notificação / Show Notification

Exibir Notificação / Show Notification

Apresenta uma notificação temporária em formato de banner.

Figura 1 - Bloco Exibir Notificação

Compatibilidade

  • Bloco cliente: cronapi.screen.notify()

  • Bloco servidor: cronapi.screen.notify() - executado a partir da chamada do bloco cliente.

Retorno

O bloco não possui retorno.

Parâmetros

Tipo

Tipo da notificação que será exibida, podendo ser: Sucesso, Informação, Aviso ou Erro. Cada notificação será exibida com uma cor diferente de acordo com as opções selecionadas. Confira na figura 2.1.

  • Posição: 1

  • Inglês: Type

  • Tipo: Texto / String

  • Exemplo: "Sucesso"

  • Opções

    • Sucesso: indica que uma ação foi bem sucedida. Por exemplo: "Cadastro realizado com sucesso!". 

    • Informação: pode ser utilizada pra informar o usuário sobre uma ação que o sistema executará. Por exemplo, após um período de ociosidade, o sistema informa que o usuário será desconectado.

    • Aviso: alerta o usuário sobre alguma condição que em geral não garante o levantamento de uma exceção ou o encerramento do programa. Por exemplo, emitir um aviso quando um programa usa um módulo obsoleto.

    • Erro: indica que uma ação não foi bem sucedida. Por exemplo: "Senha ou usuário incorreto!".

Mensagem

Mensagem que será exibida para o usuário na notificação.

  • Posição: 2

  • Inglês: Message

  • Tipo: Texto / String

  • Exemplo: "Produto cadastrado com sucesso!"

Exemplo

A função da figura abaixo exibe uma notificação do tipo Sucesso.

Figura 2 - Função que exibe uma notificação de sucesso

 

Associamos a função ao evento Ao Clicar, em um botão presente na view, o resultado da execução da função da figura 2 pode ser conferido abaixo na notificação de cor verde. A imagem abaixo foi editada para exibir todos os tipos de notificação disponíveis no parâmetro "Tipo". 

Figura 2.1 - Resultado da execução da função da figura 2