Version: Next

ExtendedFormArray

ExtendedFormArray extends FormArray. Tracks the value and validity state of its elements - FormControl, FormGroup, FormStore or FormArray instances.

Constructor#

constructor(
    controls: Array<AbstractControl>,
    validatorOrOpts?: ValidatorFn | Array<ValidatorFn> | AbstractControlOptions | null,
    asyncValidator?: AsyncValidatorFn | Array<AsyncValidatorFn> | null,
    propertyOptions?: PropertyOptions
)

Properties#

get isChanged#

Returns true if current value is not equal to initial value, false otherwise.

Property	Return type
`get isChanged()`	`boolean`

get currentValue#

Returns the current value of the control.

Property	Return type
`get currentValue()`	`Array<any>`

get currentRawValue#

Returns the current value of the array, regardless of the disabled status of its controls .

Property	Return type
`get currentRawValue()`	`Array<any>`

initialValue#

Getter and setter for initial value of the control.

Property	Return type
`get initialValue()`	`Array<any>`
`set initialValue()`	`Array<any>`

Methods#

clearValue()#

Removes all controls from the array. If clearFlags is true it also resets the array making it pristine and untouched, and sets the current value to [].

Method	Return type
`clearValue(clearFlags?: boolean)`	`void`

replaceWith()#

Replaces all controls from the array with new ones. If clearFlags is true it also resets the array making it pristine and untouched.

Method	Return type
`replaceWith(newItems: Array<any>, clearFlags?: boolean)`	`void`

resetValue()#

Resets the underlying form control, marking it pristine and untouched and sets the current and initial value to the one provided. If no value argument is provided, sets those values to control.currentValue.

Method	Return type
`resetValue(value?: any)`	`value: any`