docs(forms): clarify disabled FormArray value behavior

angular-bootstrap · atscott · commit 789c2cd9fbea · 2026-04-03T11:22:33.000-07:00
Document that FormArray.value includes only enabled child controls when the array is enabled, but includes all child values when the FormArray itself is disabled. Fixes #67759
diff --git a/packages/forms/src/model/abstract_model.ts b/packages/forms/src/model/abstract_model.ts
@@ -554,7 +554,8 @@ export abstract class AbstractControl<
    * with a key-value pair for each member of the group.
    * * For a disabled `FormGroup`, the values of all controls as an object
    * with a key-value pair for each member of the group.
-   * * For a `FormArray`, the values of enabled controls as an array.
+   * * For an enabled `FormArray`, the values of enabled controls as an array.
+   * * For a disabled `FormArray`, the values of all controls as an array.
    *
    */
   public readonly value!: TValue;
diff --git a/packages/forms/src/model/form_array.ts b/packages/forms/src/model/form_array.ts
@@ -54,7 +54,8 @@ export type ɵFormArrayRawValue<T extends AbstractControl<any>> = ɵTypedOrUntyp
  *
  * A `FormArray` aggregates the values of each child `FormControl` into an array.
  * It calculates its status by reducing the status values of its children. For example, if one of
- * the controls in a `FormArray` is invalid, the entire array becomes invalid.
+ * the controls in a `FormArray` is invalid, the entire array becomes invalid. Similarly, if all
+ * controls in a `FormArray` are disabled, the entire array becomes disabled.
  *
  * `FormArray` accepts one generic argument, which is the type of the controls inside.
  * If you need a heterogenous array, use {@link UntypedFormArray}.

Original file line number	Diff line number	Diff line change
`@@ -54,7 +54,8 @@ export type ɵFormArrayRawValue<T extends AbstractControl<any>> = ɵTypedOrUntyp`
`54`	`54`	`*`
`55`	`55`	* A `FormArray` aggregates the values of each child `FormControl` into an array.
`56`	`56`	`* It calculates its status by reducing the status values of its children. For example, if one of`
`57`		- * the controls in a `FormArray` is invalid, the entire array becomes invalid.
	`57`	+ * the controls in a `FormArray` is invalid, the entire array becomes invalid. Similarly, if all
	`58`	+ * controls in a `FormArray` are disabled, the entire array becomes disabled.
`58`	`59`	`*`
`59`	`60`	* `FormArray` accepts one generic argument, which is the type of the controls inside.
`60`	`61`	`* If you need a heterogenous array, use {@link UntypedFormArray}.`