nz-checkbox-group not working with Reactive Forms

[monsieur-ricky]

Reproduction link

https://stackblitz.com/edit/dx6v718q?file=src%2Fapp%2Fapp.component.ts

Steps to reproduce

1. Create or open an app with "nz-checkbox-group" using Reactive Forms
2. Update to Angular 19.0.6 and Ng Zorro 19.0.1
3. Check if the "nz-checkbox-group" in the Reactive Form doesn't show any data

What is expected?

The "nz-checkbox-group" to work correctly with reactive Forms using "formControlName".

What is actually happening?

After updating to the latest version of Angular (19.0.6) and NG Zorro (19.0.1), all of the nz-checkbox-group controls that were being used in a Reactive Form with formControlName stopped working (i.e., don't show any data).

<form nz-form [formGroup]="demoForm">
    <h1>Options:</h1>
    <nz-checkbox-group formControlName="options" />
  </form>

@Component({})
export class NzDemoCheckboxLayoutComponent {
  demoForm = new FormGroup({
    options: new FormControl([
      { label: 'Apple', value: 'Apple' },
      { label: 'Pear', value: 'Pear' },
      { label: 'Orange', value: 'Orange' },
    ]),
  });
}

Environment	Info
ng-zorro-antd	19.0.1
Browser	Chrome 131.0.6778.205

[Laffery]

hi @monsieur-ricky , please refer to the show case

1. should set [options] first
2. the value of the formControl should be NzCheckboxOption['value'][], such as ['Apple']

[monsieur-ricky]

hi @monsieur-ricky , please refer to the show case

1. should set [options] first
2. the value of the formControl should be NzCheckboxOption['value'][], such as ['Apple']

Thanks for the feedback @Laffery

I've managed to make it work following your suggestion:

<nz-checkbox-group
    formControlName="selectedOptions"
    [nzOptions]="listOfOptions"
  />

Since this was a breaking change, it would be useful to update the docs with examples using Reactive Forms.

[HyperLife1119]

Hi, I think this is already noted in the changelog and the documentation has been updated, although the docs use ngModel as an example, it's pretty much the same with ReactiveForms.
I'll close this.