class
Proporciona un conjunto de validadores integrados que pueden usar los controles de formulario.
Ver más…
classValidatorsnull
Ver también
-
Validación de formulario
Descripción
Un validador es una función que procesa un FormControl
o colección de controles y devuelve un mapa de error o null. A null map significa que la validación ha pasado.
Métodos estáticos
min () | |||
---|---|---|---|
Validador que requiere que el valor del control sea mayor o igual al número proporcionado. Ver también:
|
|||
|
min |
number |
Devoluciones
ValidatorFn
: Una función de validación que devuelve un mapa de errores con el min
propiedad si falla la verificación de validación, de lo contrario null
.
Notas de uso
Validar con un mínimo de 3
const control =newFormControl(2, Validators.min(3));console.log(control.errors);// min: min: 3, actual: 2
max () | |||
---|---|---|---|
Validador que requiere que el valor del control sea menor o igual al número proporcionado. Ver también:
|
|||
|
max |
number |
Devoluciones
ValidatorFn
: Una función de validación que devuelve un mapa de errores con el max
propiedad si falla la verificación de validación, de lo contrario null
.
Notas de uso
Validar con un máximo de 15
const control =newFormControl(16, Validators.max(15));console.log(control.errors);// max: max: 15, actual: 16
requerido() | |||
---|---|---|---|
El validador que requiere el control tiene un valor no vacío. Ver también:
|
|||
|
control |
AbstractControl |
Devoluciones
ValidationErrors | null
: Un mapa de errores con el required
propiedad si falla la verificación de validación, de lo contrario null
.
Notas de uso
Validar que el campo no esté vacío
const control =newFormControl('', Validators.required);console.log(control.errors);// required: true
requiredTrue () | |||
---|---|---|---|
Validador que requiere que el valor del control sea true. Este validador se usa comúnmente para las casillas de verificación requeridas. Ver también:
|
|||
|
control |
AbstractControl |
Devoluciones
ValidationErrors | null
: Un mapa de errores que contiene el required
propiedad establecida en true
si la verificación de validación falla, de lo contrario null
.
Notas de uso
Validar que el valor del campo sea true
const control =newFormControl('', Validators.requiredTrue);console.log(control.errors);// required: true
Email() | |||
---|---|---|---|
Validador que requiere que el valor del control pase una prueba de validación por correo electrónico. Ver también:
|
|||
|
control |
AbstractControl |
Devoluciones
ValidationErrors | null
: Un mapa de errores con el email
propiedad si falla la verificación de validación, de lo contrario null
.
Prueba el valor usando un expresión regular patrón adecuado para casos de uso comunes. El patrón se basa en la definición de una dirección de correo electrónico válida en el Especificación HTML WHATWG con algunas mejoras para incorporar más reglas RFC (como las reglas relacionadas con los nombres de dominio y las longitudes de las diferentes partes de la dirección).
Las diferencias con la versión WHATWG incluyen:
- Rechazar
local-part
(la parte antes de la@
símbolo) para comenzar o terminar con un punto (.
). - Rechazar
local-part
tener más de 64 caracteres. - No permita que la dirección completa tenga más de 254 caracteres.
Si este patrón no satisface sus necesidades comerciales, puede utilizar Validators.pattern()
para validar el valor con un patrón diferente.
Notas de uso
Validar que el campo coincida con un patrón de correo electrónico válido
const control =newFormControl('[email protected]', Validators.email);console.log(control.errors);// email: true
longitud mínima() | |||
---|---|---|---|
Validador que requiere que la longitud del valor del control sea mayor o igual que la longitud mínima proporcionada. Este validador también se proporciona de forma predeterminada si utiliza el HTML5 Ver también:
|
|||
|
minLength |
number |
Devoluciones
ValidatorFn
: Una función de validación que devuelve un mapa de errores con el minlength
propiedad si falla la verificación de validación, de lo contrario null
.
Notas de uso
Validar que el campo tenga un mínimo de 3 caracteres
const control =newFormControl('ng', Validators.minLength(3));console.log(control.errors);// minlength: requiredLength: 3, actualLength: 2
<inputminlength="5">
longitud máxima() | |||
---|---|---|---|
Validador que requiere que la longitud del valor del control sea menor o igual que la longitud máxima proporcionada. Este validador también se proporciona de forma predeterminada si utiliza el HTML5 Ver también:
|
|||
|
maxLength |
number |
Devoluciones
ValidatorFn
: Una función de validación que devuelve un mapa de errores con el maxlength
propiedad si la verificación de validación falla, de lo contrario null
.
Notas de uso
Validar que el campo tenga un máximo de 5 caracteres
const control =newFormControl('Angular', Validators.maxLength(5));console.log(control.errors);// maxlength: requiredLength: 5, actualLength: 7
<inputmaxlength="5">
patrón() | |||
---|---|---|---|
Validador que requiere que el valor del control coincida con un patrón de expresiones regulares. Este validador también se proporciona de forma predeterminada si utiliza HTML5 Ver también:
|
|||
|
pattern |
string | RegExp |
Una expresión regular que se utilizará tal cual para probar los valores, o una string. Si un string se pasa, el |
Devoluciones
ValidatorFn
: Una función de validación que devuelve un mapa de errores con el pattern
propiedad si falla la verificación de validación, de lo contrario null
.
Notas de uso
Validar que el campo solo contenga letras o espacios
const control = new FormControl('1', Validators.pattern('[a-zA-Z ]*')); console.log(control.errors); // pattern: requiredPattern: '^[a-zA-Z ]*$', actualValue: '1'
Patrón de coincidencia con la bandera global o adhesiva
RegExp
objetos creados con el g
o y
banderas que se pasan a Validators.pattern
puede producir resultados diferentes en la misma entrada cuando las validaciones se ejecutan consecutivamente. Esto se debe a cómo el comportamiento de RegExp.prototype.test
se especifica en ECMA-262 (RegExp
conserva el índice de la última coincidencia cuando se utiliza la bandera global o pegajosa). Debido a este comportamiento, se recomienda que al usar Validators.pattern
usted no pasar en un RegExp
objeto con el indicador global o fijo habilitado.
// Not recommended (since the `g` flag is used) const controlOne = new FormControl('1', Validators.pattern(/foo/g)); // Good const controlTwo = new FormControl('1', Validators.pattern(/foo/));
nullValidator () | |||
---|---|---|---|
Validador que no realiza ninguna operación. Ver también:
|
|||
|
control |
AbstractControl |
Devoluciones
ValidationErrors | null
componer() | |||
---|---|---|---|
Componga varios validadores en una única función que devuelva la unión de los mapas de error individuales para el control proporcionado.
|
validators |
null |
Devoluciones
null
: Una función de validación que devuelve un mapa de errores con los mapas de errores combinados de los validadores si falla la verificación de validación; de lo contrario null
.
static compose(validators: ValidatorFn[]): ValidatorFn | null
Parámetros
validators |
ValidatorFn[] |
Devoluciones
ValidatorFn | null
composeAsync () | |||
---|---|---|---|
Componga varios validadores asíncronos en una única función que devuelva la unión de los objetos de error individuales para el control proporcionado. Ver también:
|
|||
|
validators |
AsyncValidatorFn[] |
Devoluciones
AsyncValidatorFn | null
: Una función de validación que devuelve un mapa de errores con los objetos de error combinados de los validadores asíncronos si la comprobación de validación falla, de lo contrario null
.
Si crees que ha resultado útil este post, sería de mucha ayuda si lo compartieras con otros programadores y nos ayudes a difundir este contenido.