@angular/forms/signals

minLength

function

stablesince v22.0

Binds a validator to the given path that requires the length of the value to be greater than or equal to the given minLength. This function can only be called on string or array paths. In addition to binding a validator, this function adds MIN_LENGTH property to the field.

API

function minLength<
  TValue extends ValueWithLengthOrSize,
  TPathKind extends PathKind = PathKind.Root,
>(
  path: SchemaPath<TValue, 1, TPathKind>,
  minLength: number | LogicFn<TValue, number | undefined, TPathKind>,
  config?: BaseValidatorConfig<TValue, TPathKind> | undefined,
): void;

@parampathSchemaPath<TValue, 1, TPathKind>

Path of the field to validate

@paramminLengthnumber | LogicFn<TValue, number | undefined, TPathKind>

The minimum length, or a LogicFn that returns the minimum length.

@paramconfigBaseValidatorConfig<TValue, TPathKind> | undefined

Optional, allows providing any of the following options:

error: Custom validation error(s) to be used instead of the default minLengthError() or a function that receives the FieldContext and returns custom validation error(s).

@returnsvoid