Controla si un campo es obligatorio en un formulario o si se puede dejar vacío.
La propiedad nullTest se puede utilizar para las validaciones. Una validación nullTest solo se evalúa como resultado de una validación de un suceso previo, como preSubmit, prePrint, preSave o preExecute, en función del valor de $config.present.validate o de una llamada explícita de una secuencia de comandos a execValidate.
Un contenedor pasa a estado no válido como resultado de la evaluación de la primera prueba de validación que falla. Un contenedor pasa a estado válido si ninguna de las pruebas de validación falla. Un contenedor pasa a estado válido si no se evalúa ninguna prueba de validación para el mismo. En ese contexto de validación, nullTest no se evalúa y no se lleva a cabo ninguna otra prueba de validación.
Por ejemplo, un campo que actualmente no sea válido a causa de una validación nullTest podría pasar a ser válido si se introduce un valor. Si se vuelve al campo y se introduce un valor vacío, la validación nullTest no se ejecuta automáticamente, por lo que el campo podría ser válido de nuevo. Un intento posterior de enviar el formulario podría hacer que el campo volviese al estado no válido debido a nullTest.
Si el valor de rawValue de un campo es nulo o está vacío, significa que la validación nullTest ha fallado.
Sintaxis
Reference_Syntax.nullTest = "disabled | error | warning"
Valores
Tipo
|
Valores
|
Cadena
|
disabled (predeterminado)
error
advertencia
dismiss: el usuario comprende la recomendación del formulario y desea regresar al formulario para cumplir esta restricción.
override: el usuario comprende la recomendación del formulario pero decide contravenir esta restricción.
No se realiza esta prueba (predeterminado). El objeto de formulario puede tener un valor nulo. El campo se puede dejar sin valor y no afectará de manera negativa la validez del formulario. Este valor desactiva la prueba de validación.
error
advertencia
dismiss: el usuario comprende la recomendación del formulario y desea regresar al formulario para cumplir esta restricción.
override: el usuario comprende la recomendación del formulario pero decide contravenir esta restricción.
Emite un error y rechaza la aceptación de un campo vacío. El objeto de formulario debe tener un valor no nulo.
advertencia
dismiss: el usuario comprende la recomendación del formulario y desea regresar al formulario para cumplir esta restricción.
override: el usuario comprende la recomendación del formulario pero decide contravenir esta restricción.
Emite un mensaje de advertencia si el campo está vacío, pero permite al usuario seguir con el campo siguiente. El mensaje debe informar al usuario sobre la recomendación de la existencia de un valor para el objeto de formulario. Hay dos opciones:
dismiss: el usuario comprende la recomendación del formulario y desea regresar al formulario para cumplir esta restricción.
override: el usuario comprende la recomendación del formulario pero decide contravenir esta restricción.
|
JavaScript
TextField1.validate.nullTest = "error";
FormCalc
TextField1.validate.nullTest = "error"