Controla se um campo é obrigatório em um formulário ou se pode ser deixado em branco.
A propriedade nullTest pode ser usada para validações. Uma validação nullTest é avaliada somente como um resultado da validação de evento-pre, tal como preSubmit, prePrint, preSave ou preExecute, dependendo do valor de $config.present.validate ou de uma chamada de script explícita a execValidate.
Um contêiner se torna inválido como resultado da avaliação do primeiro teste de validação que falhar. Um contêiner se torna válido se nenhum teste de validação falhar. Um contêiner é válido quando nenhum teste de validação é avaliado para esse contêiner. Nesse contexto de validação, nullTest não é avaliado e não há outro teste de validação.
Por exemplo, um campo que está inválido no momento devido a uma validação nullTest poderia se tornar válido como resultado de um valor que está sendo inserido. Retornar ao campo e inserir um valor vazio não faz com que a validação nullTest seja executada automaticamente, portanto, o campo poderia se tornar válido novamente. Uma tentativa subsequente de enviar o formulário faria com que o campo se tornasse inválido novamente devido a nullTest.
Se rawValue de um campo for nulo ou vazio, a validação nullTest falhou.
Sintaxe
Reference_Syntax.nullTest = "disabled | error | warning"
Valores
Tipo
|
Valores
|
|---|
String
|
disabled (padrão)
erro
aviso
dismiss: O usuário entende a recomendação do formulário e deseja retornar ao formulário e atender a essa restrição.
override: O usuário entende a recomendação do formulário, mas opta por transgredir essa restrição.
Não realizar esse teste (padrão). O objeto de formulário pode ter um valor nulo. O campo pode ser deixado em branco sem um valor e não afetará negativamente a validade do formulário. Esse valor desativa o teste de validação.
erro
aviso
dismiss: O usuário entende a recomendação do formulário e deseja retornar ao formulário e atender a essa restrição.
override: O usuário entende a recomendação do formulário, mas opta por transgredir essa restrição.
Emite uma mensagem de erro e não aceita um campo em branco. O objeto de formulário deve ter um valor não nulo.
aviso
dismiss: O usuário entende a recomendação do formulário e deseja retornar ao formulário e atender a essa restrição.
override: O usuário entende a recomendação do formulário, mas opta por transgredir essa restrição.
Emite uma mensagem de aviso caso o campo esteja vazio, mas permite que o usuário continue no campo seguinte. A mensagem deve informar o usuário que o objeto de formulário deve ter um valor, fornecendo duas opções:
dismiss: O usuário entende a recomendação do formulário e deseja retornar ao formulário e atender a essa restrição.
override: O usuário entende a recomendação do formulário, mas opta por transgredir essa restrição.
|
JavaScript
TextField1.validate.nullTest = "error";
FormCalc
TextField1.validate.nullTest = "error"
