Exibir mensagens do campo

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 1 min. de leitura
  • Em vez de usar o alerta JavaScript(), para uma aparência mais limpa, você pode exibir um erro no próprio formulário. Os métodos showFieldMsg() e hideFieldMsg() podem ser usados para exibir uma mensagem logo abaixo do próprio campo.

    showFieldMsg e hideFieldMsg são métodos que podem ser usados com o objeto g_form.

    Esses métodos são usados para mudar a exibição do formulário de registros (formulários de Incidente, Problema e Mudança). Esses métodos também podem estar disponíveis em outros client scripts, mas devem ser testados para determinar se funcionam conforme o esperado.

    Quando uma mensagem de campo é exibida em um formulário ao carregar, o formulário rola para garantir que a mensagem do campo esteja visível. Garantir que os usuários não percam uma mensagem de campo porque ela estava fora da tela.

    A propriedade global glide.ui.scroll_to_message_field controla a rolagem automática de mensagens quando o campo do formulário está fora da tela (rola o formulário para o controle ou campo).

    Tabela 1. Detalhe do método
    Detalhe do método Parâmetros Exemplo
    showFieldMsg(entrada, mensagem, tipo, [scrollform])
    • entrada — nome do campo ou controle
    • mensagem — mensagem que você deseja que apareça
    • tipo — 'info', 'erro' ou 'aviso'; o padrão é info se não for fornecido
    • formulário de rolagem - (opcional) defina rollForm como falso para impedir a rolagem para a mensagem de campo fora da tela

    Mensagem de erro

    g_form.showFieldMsg('impact','Low impact not allowed with High priority','error');

    Mensagem Informativa

    g_form.showFieldMsg('impact','Low impact response time can be one week','info');
    //or this defaults to info type
    //g_form.showFieldMsg('impact','Low impact response time can be one week');

    hideFieldMsg(entrada)
    • entrada — nome do campo ou controle
    • clearAll — parâmetro booliano (opcional) que indica se todas as mensagens devem ser limpas. Se verdadeiro, todas as mensagens do campo serão apagadas. Se falso ou vazio, somente a primeira mensagem será removida

    Removendo uma mensagem

    //this will clear the first message printed to the field
    g_form.hideFieldMsg('impact');

    Suporte legado

    O showErrorBox() e o hideErrorBox() ainda estão disponíveis, mas basta chamar os novos métodos com o tipo de erro. Você deve usar os novos métodos.