/
Exibe notificação simples / Displays simple notification

Exibe notificação simples / Displays simple notification

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