---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Exibir mensagens do campo

# Exibir mensagens do campo {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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 <var class="keyword varname">g_form</var>.

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 <var class="keyword varname">glide.ui.scroll_to_message_field</var> 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).
{#r_DisplayFieldMessages__table_bgp_bwq_bp__entry__3}

| 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'); |
[Tabela 1. Detalhe do método]

{#r_DisplayFieldMessages__table_bgp_bwq_bp}

## 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.