說明

英文

Tracks the value and validity state of an array of FormControl, FormGroup or FormArray instances.

中文(翻譯)

追蹤 FornControl、FormGroup、FormArray 實體的 值 和 狀態

屬性

controls
AbstractControl 的 陣列集合

controls[n]
取得陣列第 n 個 AbstractControl

length: number
取的目前陣列數量

方法

at(index: number): AbstractControl
取得陣列第 index 的項目

push(control: AbstractControl): void
將 AbstractControl 放進陣列最放面
注意： AbstractControl 並不是 單純的值 ，而是 AbstractControl ，像是 new FormControl()

setControl(index: number, control: AbstractControl): void
替換 第 index 個陣列位置的 AbstractControl

insert(index: number, control: AbstractControl): void
在陣列第 index 的項目插入 AbstractControl

removeAt(index: number): void
移除陣列第 index 的項目

reset(value: any = [], options: { onlySelf?: boolean; emitEvent?: boolean; } = {}): void
重新設定陣列內容，無設定則為空陣列

clear(): void
清空到空陣列

setValue(value: any[], options: { onlySelf?: boolean; emitEvent?: boolean; } = {}): void
設定符合 目前陣列數量 的陣列內容

patchValue(value: any[], options: { onlySelf?: boolean; emitEvent?: boolean; } = {}): void
設定符合陣列格式的內容，可以不符合 目前陣列數量

getRawValue(): any[]
取得陣列內的集合值，包含 disabled AbstractControl

參考來源

https://angular.io/api/forms/FormArray#description