W3cubDocs

/Angular 11

Validators

class

Provides a set of built-in validators that can be used by form controls.

See more...

class Validators {
  static min(min: number): ValidatorFn
  static max(max: number): ValidatorFn
  static required(control: AbstractControl): ValidationErrors | null
  static requiredTrue(control: AbstractControl): ValidationErrors | null
  static email(control: AbstractControl): ValidationErrors | null
  static minLength(minLength: number): ValidatorFn
  static maxLength(maxLength: number): ValidatorFn
  static pattern(pattern: string | RegExp): ValidatorFn
  static nullValidator(control: AbstractControl): ValidationErrors | null
  static compose(validators: ValidatorFn[]): ValidatorFn | null
  static composeAsync(validators: AsyncValidatorFn[]): AsyncValidatorFn | null
}

See also

Description

A validator is a function that processes a FormControl or collection of controls and returns an error map or null. A null map means that validation has passed.

Static methods

Validator that requires the control's value to be greater than or equal to the provided number.

See also:

  • updateValueAndValidity()

static min(min: number): ValidatorFn

Parameters
min number
Returns

ValidatorFn: A validator function that returns an error map with the min property if the validation check fails, otherwise null.

Usage Notes

Validate against a minimum of 3
const control = new FormControl(2, Validators.min(3));

console.log(control.errors); // {min: {min: 3, actual: 2}}

Validator that requires the control's value to be less than or equal to the provided number.

See also:

  • updateValueAndValidity()

static max(max: number): ValidatorFn

Parameters
max number
Returns

ValidatorFn: A validator function that returns an error map with the max property if the validation check fails, otherwise null.

Usage Notes

Validate against a maximum of 15
const control = new FormControl(16, Validators.max(15));

console.log(control.errors); // {max: {max: 15, actual: 16}}

Validator that requires the control have a non-empty value.

See also:

  • updateValueAndValidity()

static required(control: AbstractControl): ValidationErrors | null

Parameters
control AbstractControl
Returns

ValidationErrors | null: An error map with the required property if the validation check fails, otherwise null.

Usage Notes

Validate that the field is non-empty
const control = new FormControl('', Validators.required);

console.log(control.errors); // {required: true}

Validator that requires the control's value be true. This validator is commonly used for required checkboxes.

See also:

  • updateValueAndValidity()

static requiredTrue(control: AbstractControl): ValidationErrors | null

Parameters
control AbstractControl
Returns

ValidationErrors | null: An error map that contains the required property set to true if the validation check fails, otherwise null.

Usage Notes

Validate that the field value is true
const control = new FormControl('', Validators.requiredTrue);

console.log(control.errors); // {required: true}

Validator that requires the control's value pass an email validation test.

See also:

  • updateValueAndValidity()

static email(control: AbstractControl): ValidationErrors | null

Parameters
control AbstractControl
Returns

ValidationErrors | null: An error map with the email property if the validation check fails, otherwise null.

Tests the value using a regular expression pattern suitable for common usecases. The pattern is based on the definition of a valid email address in the WHATWG HTML specification with some enhancements to incorporate more RFC rules (such as rules related to domain names and the lengths of different parts of the address).

The differences from the WHATWG version include:

  • Disallow local-part (the part before the @ symbol) to begin or end with a period (.).
  • Disallow local-part to be longer than 64 characters.
  • Disallow the whole address to be longer than 254 characters.

If this pattern does not satisfy your business needs, you can use Validators.pattern() to validate the value against a different pattern.

Usage Notes

Validate that the field matches a valid email pattern
const control = new FormControl('bad@', Validators.email);

console.log(control.errors); // {email: true}

Validator that requires the length of the control's value to be greater than or equal to the provided minimum length. This validator is also provided by default if you use the the HTML5 minlength attribute. Note that the minLength validator is intended to be used only for types that have a numeric length property, such as strings or arrays. The minLength validator logic is also not invoked for values when their length property is 0 (for example in case of an empty string or an empty array), to support optional controls. You can use the standard required validator if empty values should not be considered valid.

See also:

  • updateValueAndValidity()

static minLength(minLength: number): ValidatorFn

Parameters
minLength number
Returns

ValidatorFn: A validator function that returns an error map with the minlength property if the validation check fails, otherwise null.

Usage Notes

Validate that the field has a minimum of 3 characters
const control = new FormControl('ng', Validators.minLength(3));

console.log(control.errors); // {minlength: {requiredLength: 3, actualLength: 2}}
<input minlength="5">

Validator that requires the length of the control's value to be less than or equal to the provided maximum length. This validator is also provided by default if you use the the HTML5 maxlength attribute. Note that the maxLength validator is intended to be used only for types that have a numeric length property, such as strings or arrays.

See also:

  • updateValueAndValidity()

static maxLength(maxLength: number): ValidatorFn

Parameters
maxLength number
Returns

ValidatorFn: A validator function that returns an error map with the maxlength property if the validation check fails, otherwise null.

Usage Notes

Validate that the field has maximum of 5 characters
const control = new FormControl('Angular', Validators.maxLength(5));

console.log(control.errors); // {maxlength: {requiredLength: 5, actualLength: 7}}
<input maxlength="5">

Validator that requires the control's value to match a regex pattern. This validator is also provided by default if you use the HTML5 pattern attribute.

See also:

  • updateValueAndValidity()

static pattern(pattern: string | RegExp): ValidatorFn

Parameters
pattern string | RegExp

A regular expression to be used as is to test the values, or a string. If a string is passed, the ^ character is prepended and the $ character is appended to the provided string (if not already present), and the resulting regular expression is used to test the values.

Returns

ValidatorFn: A validator function that returns an error map with the pattern property if the validation check fails, otherwise null.

Usage Notes

Validate that the field only contains letters or spaces
const control = new FormControl('1', Validators.pattern('[a-zA-Z ]*'));

console.log(control.errors); // {pattern: {requiredPattern: '^[a-zA-Z ]*$', actualValue: '1'}}
<input pattern="[a-zA-Z ]*">
Pattern matching with the global or sticky flag

RegExp objects created with the g or y flags that are passed into Validators.pattern can produce different results on the same input when validations are run consecutively. This is due to how the behavior of RegExp.prototype.test is specified in ECMA-262 (RegExp preserves the index of the last match when the global or sticky flag is used). Due to this behavior, it is recommended that when using Validators.pattern you do not pass in a RegExp object with either the global or sticky flag enabled.

// 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/));

Validator that performs no operation.

See also:

  • updateValueAndValidity()

static nullValidator(control: AbstractControl): ValidationErrors | null

Parameters
control AbstractControl
Returns

ValidationErrors | null

Compose multiple validators into a single function that returns the union of the individual error maps for the provided control.

static compose(validators: null): null

Parameters
validators null
Returns

null: A validator function that returns an error map with the merged error maps of the validators if the validation check fails, otherwise null.

static compose(validators: ValidatorFn[]): ValidatorFn | null

Parameters
validators ValidatorFn[]
Returns

ValidatorFn | null

Compose multiple async validators into a single function that returns the union of the individual error objects for the provided control.

See also:

  • updateValueAndValidity()

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

Parameters
validators AsyncValidatorFn[]
Returns

AsyncValidatorFn | null: A validator function that returns an error map with the merged error objects of the async validators if the validation check fails, otherwise null.

© 2010–2021 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://v11.angular.io/api/forms/Validators