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:

  • updateValueAndValidity()

static min(min: number): ValidatorFn

Parámetros
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:

  • updateValueAndValidity()

static max(max: number): ValidatorFn

Parámetros
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:

  • updateValueAndValidity()

static required(control: AbstractControl): ValidationErrors | null

Parámetros
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:

  • updateValueAndValidity()

static requiredTrue(control: AbstractControl): ValidationErrors | null

Parámetros
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:

  • updateValueAndValidity()

static email(control: AbstractControl): ValidationErrors | null

Parámetros
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 minlength attribute. Tenga en cuenta que el minLength El validador está diseñado para usarse solo para tipos que tienen un valor numérico length propiedad, como cadenas o matrices. los minLength La lógica del validador tampoco se invoca para valores cuando su length propiedad es 0 (por ejemplo, en el caso de un string o un vacio array), para admitir controles opcionales. Puedes usar el estándar required validador si los valores vacíos no deben considerarse válidos.

Ver también:

  • updateValueAndValidity()

static minLength(minLength: number): ValidatorFn

Parámetros
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 maxlength attribute. Tenga en cuenta que el maxLength El validador está diseñado para usarse solo para tipos que tienen un valor numérico length propiedad, como cadenas o matrices.

Ver también:

  • updateValueAndValidity()

static maxLength(maxLength: number): ValidatorFn

Parámetros
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 pattern attribute.

Ver también:

  • updateValueAndValidity()

static pattern(pattern: string | RegExp): ValidatorFn

Parámetros
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 ^ se antepone el carácter y el $ el carácter se agrega al proporcionado string (si aún no está presente), y la expresión regular resultante se usa para probar los valores.

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:

  • updateValueAndValidity()

static nullValidator(control: AbstractControl): ValidationErrors | null

Parámetros
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.

static compose(validators: null): null

Parámetros
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:

  • updateValueAndValidity()

static composeAsync(validators: AsyncValidatorFn[]): AsyncValidatorFn | null

Parámetros
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.