Détermine si un champ est obligatoire dans un formulaire ou s’il peut être laissé vide.
La propriété
nullTest
peut être utilisée pour les validations. Une validation
nullTest
n’est évaluée qu’en tant que résultat d’une validation de pré-événement, comme preSubmit, prePrint, preSave ou preExecute, en fonction de la valeur de
$config.present.validate
ou d’un appel de script explicite de
execValidate
.
Un conteneur devient non valide suite à l’évaluation du premier test ayant échoué. Un conteneur devient valide si aucun test d’évaluation n’échoue. Un conteneur est valide lorsque qu’aucun test d’évaluation n’est évalué pour ce conteneur. Dans ce contexte de validation,
nullTest
n’est pas évalué et il n’y a aucun autre test d’évaluation.
Par exemple, un champ actuellement non valide suite à une validation
nullTest
peut devenir valide du fait qu’une valeur a été saisie. Le fait de revenir au champ et de saisir une valeur vide ne provoque pas l’exécution automatique de la validation
nullTest
; le champ peut ainsi redevenir valide. Une nouvelle tentative d’envoi du formulaire impliquerait que le champ redevienne non valide en raison de
nullTest
.
Si
rawValue
pour un champ valide est affecté d’une valeur nulle ou vide, la validation
nullTest
a échoué.
Syntaxe
Reference_Syntax.nullTest = "disabled | error | warning"
Valeurs
|
Type
|
Valeurs
|
|
Chaîne
|
-
disabled
(par défaut)
-
error
-
warning
-
dismiss
: l’utilisateur comprend la recommandation et souhaite revenir au formulaire afin de satisfaire à cette contrainte.
-
override
: l’utilisateur comprend la recommandation, mais choisit de ne pas respecter cette contrainte.
N’effectue pas ce test (par défaut). L’objet de formulaire peut être affecté d’une valeur nulle. Il est possible de laisser le champ sans valeur sans que cela n’affecte la validité du formulaire. Cette valeur désactive le test de validation.
-
error
-
warning
-
dismiss
: l’utilisateur comprend la recommandation et souhaite revenir au formulaire afin de satisfaire à cette contrainte.
-
override
: l’utilisateur comprend la recommandation, mais choisit de ne pas respecter cette contrainte.
Génère un message d’erreur et refuse de valider un champ vide. L’objet de formulaire doit être affecté d’une valeur non nulle.
-
warning
-
dismiss
: l’utilisateur comprend la recommandation et souhaite revenir au formulaire afin de satisfaire à cette contrainte.
-
override
: l’utilisateur comprend la recommandation, mais choisit de ne pas respecter cette contrainte.
Génère un message d’avertissement lorsque le champ est vide, mais autorise l’utilisateur à passer au champ suivant. Le message doit informer l’utilisateur que l’objet de formulaire doit, de préférence, être affecté d’une valeur, et propose deux options :
-
dismiss
: l’utilisateur comprend la recommandation et souhaite revenir au formulaire afin de satisfaire à cette contrainte.
-
override
: l’utilisateur comprend la recommandation, mais choisit de ne pas respecter cette contrainte.
|
JavaScript
TextField1.validate.nullTest = "error";
FormCalc
TextField1.validate.nullTest = "error"
