feat(form:cascader): add multiple (#1895)

cipchk · web-flow · commit 0575b22fe389 · 2025-04-11T12:44:21.000+08:00
diff --git a/packages/form/widgets/cascader/demo/simple.md b/packages/form/widgets/cascader/demo/simple.md
@@ -69,6 +69,7 @@ export class DemoComponent {
         title: 'RealTime',
         ui: {
           widget: 'cascader',
+          multiple: true,
           asyncData: (node, index) => {
             return new Promise(resolve => {
               setTimeout(() => {
@@ -95,7 +96,7 @@ export class DemoComponent {
     }
   };
 
-  submit(value: {}): void {
+  submit(value: Record<string, unknown>): void {
     this.msg.success(JSON.stringify(value));
   }
 }
diff --git a/packages/form/widgets/cascader/index.en-US.md b/packages/form/widgets/cascader/index.en-US.md
@@ -58,7 +58,8 @@ Every select triggers a HTTP request, data source is from `asyncData`; includes
 | `[triggerAction]` | Trigger action to show menu | `('click', 'hover')[]` | `['click']` |
 | `[valueProperty]` | Property of `value` | `string` | `value` |
 | `[labelProperty]` | Property of `label` | `string` | `label` |
-| `[visibleChange]` | Asynchronous load event | `(value: boolean) => void` | - |
-| `[change]` | Selected value changed event | `(values: any[]) => void` | - |
-| `[selectionChange]` | Select option changed event | `(values: NzCascaderOption[]) => void` | - |
-| `[clear]` | Content clear event | `() => void` | - |
+| `[multiple]` | Support multiple | `boolean` | `false` |
+| `(visibleChange)` | Asynchronous load event | `(value: boolean) => void` | - |
+| `(change)` | Selected value changed event | `(values: any[]) => void` | - |
+| `(selectionChange)` | Select option changed event | `(values: NzCascaderOption[]) => void` | - |
+| `(clear)` | Content clear event | `() => void` | - |
diff --git a/packages/form/widgets/cascader/index.zh-CN.md b/packages/form/widgets/cascader/index.zh-CN.md
@@ -58,7 +58,8 @@ type: Non-built-in widgets
 | `[triggerAction]` | 触发菜单出现的行为 | `('click', 'hover')[]` | `['click']` |
 | `[valueProperty]` | 值 `value` 的属性名称 | `string` | `value` |
 | `[labelProperty]` | 值 `label` 的属性名称 | `string` | `label` |
-| `[visibleChange]` | 异步加载事件 | `(value: boolean) => void` | - |
-| `[change]` | 选项值变更事件 | `(values: any[]) => void` | - |
-| `[selectionChange]` | 选项变更事件 | `(values: NzCascaderOption[]) => void` | - |
-| `[clear]` | 内容被清空事件 | `() => void` | - |
+| `[multiple]` | 是否多选 | `boolean` | `false` |
+| `(visibleChange)` | 异步加载事件 | `(value: boolean) => void` | - |
+| `(change)` | 选项值变更事件 | `(values: any[]) => void` | - |
+| `(selectionChange)` | 选项变更事件 | `(values: NzCascaderOption[]) => void` | - |
+| `(clear)` | 内容被清空事件 | `() => void` | - |
diff --git a/packages/form/widgets/cascader/schema.ts b/packages/form/widgets/cascader/schema.ts
@@ -106,6 +106,11 @@ export interface SFCascaderWidgetSchema extends SFUISchemaItem {
    */
   labelProperty?: string;
 
+  /**
+   * 是否多选，默认：`false`
+   */
+  multiple?: boolean;
+
   /**
    * 异步加载事件
    */
diff --git a/packages/form/widgets/cascader/widget.ts b/packages/form/widgets/cascader/widget.ts
@@ -40,6 +40,7 @@ import type { SFCascaderWidgetSchema } from './schema';
       [nzShowArrow]="showArrow"
       [nzShowInput]="showInput"
       [nzShowSearch]="ui.showSearch!"
+      [nzMultiple]="ui.multiple"
       (nzClear)="_clear()"
       (nzVisibleChange)="_visibleChange($event)"
       (nzSelectionChange)="_selectionChange($event)"

Original file line number	Diff line number	Diff line change
`@@ -69,6 +69,7 @@ export class DemoComponent {`
`69`	`69`	`title: 'RealTime',`
`70`	`70`	`ui: {`
`71`	`71`	`widget: 'cascader',`
	`72`	`+ multiple: true,`
`72`	`73`	`asyncData: (node, index) => {`
`73`	`74`	`return new Promise(resolve => {`
`74`	`75`	`setTimeout(() => {`
`@@ -95,7 +96,7 @@ export class DemoComponent {`
`95`	`96`	`}`
`96`	`97`	`};`
`97`	`98`
`98`		`- submit(value: {}): void {`
	`99`	`+ submit(value: Record<string, unknown>): void {`
`99`	`100`	`this.msg.success(JSON.stringify(value));`
`100`	`101`	`}`
`101`	`102`	`}`