Exibir mensagens de campo

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. 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 eles funcionam conforme o esperado.

    Quando uma mensagem de campo é exibida em um formulário no carregamento, o formulário rola para garantir que a mensagem de 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 de 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(input, message, type, [scrollform])
    • entrada — nome do campo ou controle
    • message — mensagem que você deseja exibir
    • tipo — "informações", "erro" ou "aviso"; assume como padrão informações se não for fornecido
    • formulário de rolagem - (opcional) defina scrollForm 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
    • limparTudo — parâmetro booliano (opcional) que indica se todas as mensagens devem ser limpas. Se for verdadeiro, todas as mensagens do campo serão apagadas. Se falso ou vazio, somente a última mensagem será removida

    Removendo uma mensagem

    //this will clear the last 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.