fix(form:checkbox): make deprecated of span property (#1916)

cipchk · web-flow · commit 7619ca25b01f · 2025-06-24T15:42:26.000+08:00
diff --git a/packages/form/src/widgets/checkbox/checkbox.widget.ts b/packages/form/src/widgets/checkbox/checkbox.widget.ts
@@ -54,7 +54,7 @@ import { ControlUIWidget } from '../../widget';
         } @else {
           @if (grid_span === 0) {
             <ng-template [ngTemplateOutlet]="all" />
-            <nz-checkbox-group [ngModel]="value" [nzOptions]="$any(data)" (ngModelChange)="notifySet()" />
+            <nz-checkbox-group [ngModel]="value" [nzOptions]="$any(data)" (ngModelChange)="groupInGridChange($event)" />
           } @else {
             <nz-checkbox-wrapper class="sf__checkbox-list" (nzOnChange)="groupInGridChange($event)">
               <div nz-row>
diff --git a/packages/form/src/widgets/checkbox/index.en-US.md b/packages/form/src/widgets/checkbox/index.en-US.md
@@ -22,7 +22,7 @@ Property        | Description                                 | Type
 Property | Description | Type | Default
 -------- | ----------- | ---- | -------
 `[asyncData]` | Async data source, render checkbox group when the value exists  | `() => Observable<SFSchemaEnumType[]>` | -
-`[span]` | Raster number of cells to occupy, refer to [layout](https://ng.ant.design/components/checkbox/en#components-checkbox-demo-layout) | `number` | -
+(deprecated) `[span]` | Raster number of cells to occupy, refer to [layout](https://ng.ant.design/components/checkbox/en#components-checkbox-demo-layout) | `number` | -
 `[styleType]` | Style of the `nz-checkbox` | `default, button` | `default`
 `[checkAll]` | Whether to select all  | `boolean` | -
 `[checkAllText]` | Select all button text  | `string` | `全选`
diff --git a/packages/form/src/widgets/checkbox/index.zh-CN.md b/packages/form/src/widgets/checkbox/index.zh-CN.md
@@ -22,7 +22,7 @@ type: Widgets
 成员 | 说明 | 类型 | 默认值
 ----|------|-----|------
 `[asyncData]` | 异步数据源  | `() => Observable<SFSchemaEnumType[]>` | -
-`[span]` | 指定每个选框单元格数量，参考[布局](https://ng.ant.design/components/checkbox/zh#components-checkbox-demo-layout) | `number` | -
+(deprecated) `[span]` | 指定每个选框单元格数量，参考[布局](https://ng.ant.design/components/checkbox/zh#components-checkbox-demo-layout) | `number` | -
 `[styleType]` | radio的样式  | `default, button` | `default`
 `[checkAll]` | 是否需要全选  | `boolean` | -
 `[checkAllText]` | 全选按钮文本  | `string` | `全选`
diff --git a/packages/form/src/widgets/checkbox/schema.ts b/packages/form/src/widgets/checkbox/schema.ts
@@ -11,6 +11,7 @@ export interface SFCheckboxWidgetSchema extends SFUISchemaItem {
 
   /**
    * 指定每个选框单元格数量，参考[布局](https://ng.ant.design/components/checkbox/zh#components-checkbox-demo-layout)
+   * @deprecated Will be removed in v21. `nz-checkbox-wrapper` has been deprecated, so the `span` attribute is no longer needed
    */
   span?: number;
 
