Exibe uma notificação simples para informar sobre uma ação realizada no sistema. É possível personalizar a posição da notificação na tela, definir o tipo de animação a ser aplicada e ajustar outras configurações para melhorar a experiência do usuário.


Figura 1 - Bloco Exibe notificação simples


Vale ressaltar que a notificação exibida tem como finalidade apresentar um texto curto. Caso tenha a necessidade de utilizar um texto maior, recomendamos o bloco Modal de confirmação.



Compatibilidade

  • Bloco cliente: cronapi.notification.customNotify()

Retorno

O bloco não possui retorno.

Parâmetros

Estado

Tipo da notificação a ser exibida.

  • Posição: 1
  • Inglês: Status
  • Tipo: Objeto / Object
  • Exemplo: "Erro"
  • Opções: 
    • Erro: indica que uma ação não foi bem sucedida. Por exemplo: "Senha ou usuário incorreto!".
    • Sucesso: indica que uma ação foi bem sucedida. Por exemplo: "Cadastro realizado com sucesso!".
    • 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: "Preencha todos os campos do formulário!".
    • Informação: pode ser utilizada pra informar o usuário sobre uma ação que o sistema executará. Por exemplo: "Este site utiliza cookies".

Mensagem

Mensagem que será exibida ao usuário.

  • Posição: 2
  • Inglês: Message
  • Tipo: Texto / String
  • Exemplo: "Produto cadastrado!"

Animação

Define como será exibida a notificação.

  • Posição: 3
  • Inglês: Animation
  • Tipo: Objeto / Object
  • Exemplo: "Desaparecer"
  • Opções: 
    • Desaparecer: a notificação aparece gradualmente.
    • Zoom: a notificação aparece com um efeito de aumento gradual de tamanho.
    • Deslizar: a notificação é exibida como se deslizasse.

Posição vertical

Define a posição vertical onde a notificação será exibida na tela, permitindo que ela apareça na parte superior ou inferior.

  • Posição: 4
  • Inglês: Vertical Position
  • Tipo: Objeto / Object
  • Exemplo: "Topo"
  • Opções: 
    • Topo: a notificação é exibida na parte superior.
    • Embaixo: a notificação é exibida na parte inferior.

Posição horizontal

Define a posição horizontal em que a notificação será exibida na tela, permitindo que ela seja posicionada à direita, ao centro ou à esquerda.

  • Posição: 5
  • Inglês: Horizontal Position
  • Tipo: Objeto / Object
  • Exemplo: "Direita"
  • Opções: 
    • Esquerda: a notificação é exibida à esquerda.
    • Central: a notificação é exibida na parte central.
    • Direita: a notificação é exibida à direita.

Ocultar notificação automaticamente

Define se a notificação será ocultada manualmente pelo usuário ou desaparecerá automaticamente após um determinado período.

  • Posição: 6
  • Inglês: Hide notification automatically
  • Tipo: Objeto / Object
  • Exemplo: "Sim"
  • Opções: 
    • Sim: a notificação é ocultada automaticamente após um período.
    • Não: a notificação é ocultada apenas após o clique do usuário.

Exemplo

A função a seguir apresenta um exemplo de uso do bloco Exibe notificação simples. Essa função irá exibir uma notificação após o clique em um componente botão. O resultado de execução pode ser visualizado na Figura 2.1.


Figura 2 - Exemplo de uso do bloco Exibe notificação simples


Na imagem a seguir, podemos visualizar o resultado de execução da função da Figura 2.


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

Nesta página