Angular Word Count Validator

word-count.validator.ts

import { AbstractControl, ValidationErrors, ValidatorFn } from '@angular/forms';

export class WordCountValidators {
  /**
   * The Regex used to seperate words from white space characters.
   */
  private static seperator = /\s+/gmu;

  /**
   * @description
   * Validator that requires the control word count to be greater than or equal to the provided number.
   *
   * @usageNotes
   *
   * ### Validate against a minimum of 3
   * ```typescript
   * const control = new FormControl('once upon', WordCountValidator.min(3));
   *
   * console.log(control.errors); // {minword: {min: 3, actual: 2}}
   * ```
   *
   * @returns A validator function that returns an error map with the
   * `minword` property if the validation check fails, otherwise `null`.
   *
   * @see `updateValueAndValidity()`
   *
   */
  static min(min: number, seperator: string | RegExp = WordCountValidators.seperator): ValidatorFn {
    return (control: AbstractControl): ValidationErrors | null => {
      // Check that the control has a value and if that value is a string.
      if (control.value && typeof control.value === 'string') {
        // Remove any leading and trailing whitespace
        const value = control.value.trim();
        const words = value.split(seperator);
        const actual = words.length;
        if (actual < min) {
          return { minword: { min, actual } };
        }
      }
      return null;
    };
  }

  /**
   * @description
   * Validator that requires the control word count to be less than or equal to the provided number.
   *
   * @usageNotes
   *
   * ### Validate against a maximum of 3
   * ```typescript
   * const control = new FormControl('once upon a time', WordCountValidator.max(3));
   *
   * console.log(control.errors); // {minword: {min: 3, actual: 4}}
   * ```
   *
   * @returns A validator function that returns an error map with the
   * `maxword` property if the validation check fails, otherwise `null`.
   *
   * @see `updateValueAndValidity()`
   *
   */
  static max(max: number, seperator: string | RegExp = WordCountValidators.seperator): ValidatorFn {
    return (control: AbstractControl): ValidationErrors | null => {
      // Check that the control has a value and if that value is a string.
      if (control.value && typeof control.value === 'string') {
        // Remove any leading and trailing whitespace.
        const value = control.value.trim();
        const words = value.split(seperator);
        const actual = words.length;
        if (actual > max) {
          return { maxword: { max, actual } };
        }
      }
      return null;
    };
  }
}

Word Count Validator

Use to validate the word count of controls for Angular.

I created this because some light searching found only results for validators for Angular.JS and didn't look like there was version for Angular 2+

It should work with most versions of Angular, but is guaranteed to work at least for Angular 10 and TypeScript 3.9.

Please let me know of any issues you find.

I added the option to use your own separator rather being stuck with the default.