Interface SmiMultiValueControlFormApi

An API of methods and properties for forms on a multiple value control.

interface SmiMultiValueControlFormApi {
    addValidator(validator: (() => null | {
        [errorName: string]: string;
    }), typeAttribute?: string): (() => void);
    getErrors(typeAttribute?: string): null | {
        [error: string]: string;
    };
    getValidationMessageId(): undefined | string;
    isDirty(typeAttribute?: string): boolean;
    isInvalid(typeAttribute?: string): boolean;
    isTouched(typeAttribute?: string): boolean;
    isValid(typeAttribute?: string): boolean;
    markAllAsTouched(): void;
    markAsDirty(typeAttribute?: string): void;
    markAsPristine(typeAttribute?: string): void;
    markAsTouched(typeAttribute?: string): void;
    onShowInvalidChange(callback: ((showInvalid: boolean) => void), typeAttribute?: string): (() => void);
    onValidityChange(callback: ((valid: boolean) => void), typeAttribute?: string): (() => void);
    reset(typeAttribute?: string): void;
    setErrors(errors: null | {
        [error: string]: string;
    }, typeAttribute?: string): void;
    showInvalid(typeAttribute?: string): boolean;
}

Methods

addValidator getErrors getValidationMessageId isDirty isInvalid isTouched isValid markAllAsTouched markAsDirty markAsPristine markAsTouched onShowInvalidChange onValidityChange reset setErrors showInvalid

Methods

addValidator

  • addValidator(validator, typeAttribute?): (() => void)

  • Adds a validator function to the control. Returns an error object, or null if there are no errors. to the control.

    Parameters

    • validator: (() => null | {
          [errorName: string]: string;
      })

      The validator function to add.

        • (): null | {
              [errorName: string]: string;
          }

        • Returns null | {
              [errorName: string]: string;
          }

    • OptionaltypeAttribute: string

      The type attribute with which the form control is associated.

    Returns (() => void)

    A function that removes the validator.

      • (): void

      • Returns void

    Method

getErrors

  • getErrors(typeAttribute?): null | {
        [error: string]: string;
    }

  • Returns all errors for the control.

    Parameters

    • OptionaltypeAttribute: string

      The type attribute with which the form control is associated.

    Returns null | {
        [error: string]: string;
    }

    An object containing the errors or null.

    Method

getValidationMessageId

  • getValidationMessageId(): undefined | string

  • Gives the ID of the element that is showing a validation message for the control. Returns the ID for the element that is showing a validation message for the control. Returns undefined if there is no message shown.

    Returns undefined | string

    The id of the element that is showing a validation message for the control or returns undefined if there is no message being shown.

    Method

isDirty

  • isDirty(typeAttribute?): boolean

  • Returns whether the control is dirty. A control is dirty after the user has changed the value of the control.

    Parameters

    • OptionaltypeAttribute: string

      The type attribute with which the form control is associated.

    Returns boolean

    A boolean value describing if the control is dirty.

    Method

isInvalid

  • isInvalid(typeAttribute?): boolean

  • Gives whether the control is invalid.

    Parameters

    • OptionaltypeAttribute: string

      The type attribute with which the form control is associated.

    Returns boolean

    A boolean value describing if the control is invalid.

    Method

isTouched

  • isTouched(typeAttribute?): boolean

  • Returns whether the control is touched. A control is touched after the user has triggered a blur event on it.

    Parameters

    • OptionaltypeAttribute: string

      The type attribute with which the form control is associated.

    Returns boolean

    A boolean value describing if the control has been touched.

    Method

isValid

  • isValid(typeAttribute?): boolean

  • Returns whether the control is valid.

    Parameters

    • OptionaltypeAttribute: string

      The type attribute with which the form control is associated.

    Returns boolean

    A boolean value describing if the control is valid.

    Method

markAllAsTouched

  • markAllAsTouched(): void

  • Marks the control and all its descendant controls as touched.

    Returns void

    Method

markAsDirty

  • markAsDirty(typeAttribute?): void

  • Marks the control as dirty.

    Parameters

    • OptionaltypeAttribute: string

      The type attribute with which the form control is associated.

    Returns void

    Method

markAsPristine

  • markAsPristine(typeAttribute?): void

  • Marks the control as pristine.

    Parameters

    • OptionaltypeAttribute: string

      The type attribute with which the form control is associated.

    Returns void

    Method

markAsTouched

  • markAsTouched(typeAttribute?): void

  • Marks the control as touched.

    Parameters

    • OptionaltypeAttribute: string

      The type attribute with which the form control is associated.

    Returns void

    Method

onShowInvalidChange

  • onShowInvalidChange(callback, typeAttribute?): (() => void)

  • Runs a callback when the the control's show invalid state changes.

    Parameters

    • callback: ((showInvalid: boolean) => void)
        • (showInvalid): void

        • Parameters

          • showInvalid: boolean

          Returns void

    • OptionaltypeAttribute: string

      The type attribute with which the form control is associated.

    Returns (() => void)

    A function that removes the callback.

      • (): void

      • Returns void

onValidityChange

  • onValidityChange(callback, typeAttribute?): (() => void)

  • Runs a callback when the the control's validity changes.

    Parameters

    • callback: ((valid: boolean) => void)

      A callback that is invoked with the valid state.

        • (valid): void

        • Parameters

          • valid: boolean

          Returns void

    • OptionaltypeAttribute: string

      The type attribute with which the form control is associated.

    Returns (() => void)

    A function that removes the callback.

      • (): void

      • Returns void

reset

  • reset(typeAttribute?): void

  • Resets the form control, marking it pristine and untouched.

    Parameters

    • OptionaltypeAttribute: string

      The type attribute with which the form control is associated.

    Returns void

setErrors

  • setErrors(errors, typeAttribute?): void

  • Sets the given error on the control.

    Parameters

    • errors: null | {
          [error: string]: string;
      }

      The errors object.

    • OptionaltypeAttribute: string

      The type attribute with which the form control is associated.

    Returns void

    Method

showInvalid

  • showInvalid(typeAttribute?): boolean

  • Returns whether the control should show itself as being invalid.

    Parameters

    • OptionaltypeAttribute: string

      The type attribute with which the form control is associated.

    Returns boolean

    A boolean value indicating whether the control should show itself as being invalid.

    Method

Settings

Member Visibility

On This Page

Methods