fantasy-ngzorro 2.0.4 → 2.0.6

package/README.md

@@ -35,6 +35,7 @@
 | MC | 2023-2-13 | 表单、明细表单、间隔、小标题文档；组件字段增加必填说明 |
 | — | 2026-5-20 | 补充 hd-table、hd-detail-lines-page 等组件；完善公共子类型（SelectOption、FormItem 等）文档 |
 | — | 2026-6-23 | hd-table 状态列支持 `stateField` 自定义取值字段、`isState` 按列名取值；hd-form Input 支持 `prefix` / `prefixIcon`；hd-detail-lines-page 支持 `isCrossPageSelect` 跨页勾选开关 |
+| — | 2026-7-6 | hd-form 支持 `FormListType.Checkbox`（单个复选框 / 复选框组）及 `CheckboxOption` 配置 |
 
 ## 前言
 
@@ -297,6 +298,8 @@ tableCols: HdTableColumn[] = [{
   name: 'operate',
   width: ColWidth.operateColWidth,
   btnList: [{ name: '删除', showConfirm: true, click: (line) => this.remove(line) }]
+  // showConfirm 也可传函数，按行属性决定是否二次确认
+  // btnList: [{ name: '删除', showConfirm: (line) => line.state !== 'draft', click: (line) => this.remove(line) }]
 }];
 ```
 
@@ -363,6 +366,24 @@ formInput: FormItem[] = [{
   label: '数量',
   name: 'qty',
   inputNumber: { min: 0, max: 9999, step: 1, precision: 2 }
+}, {
+  type: FormListType.Checkbox,
+  label: '是否启用',
+  name: 'enabled',
+  value: false // 单个复选框，值为 boolean
+}, {
+  type: FormListType.Checkbox,
+  label: '权限',
+  name: 'permissions',
+  value: ['read'],
+  checkboxOption: {
+    label: 'name',
+    value: 'code',
+    optionList: [
+      { code: 'read', name: '查看' },
+      { code: 'edit', name: '编辑' }
+    ]
+  }
 }];
 
 formChangeEvent(validateForm: FormGroup) {
@@ -377,7 +398,7 @@ formChangeEvent(validateForm: FormGroup) {
 
 #### FormItem 配置
 
-表单项使用 [FormItem](#formitem表单项) 类型，下拉/数字等子配置见 [SelectOption](#selectoption下拉选项配置)、[InputNumber](#inputnumber数字输入配置)。
+表单项使用 [FormItem](#formitem表单项) 类型，下拉/数字等子配置见 [SelectOption](#selectoption下拉选项配置)、[InputNumber](#inputnumber数字输入配置)、[RadioOption](#radiooption单选配置)、[CheckboxOption](#checkboxoption复选框配置)。
 
 ---
 
@@ -676,6 +697,28 @@ selectOption: {
 | ---- | ---- | ---- |
 | options | any[] | 级联数据源（ng-zorro cascader 格式） |
 
+### RadioOption（单选配置）
+
+用于 `FormItem.radioOption`（`FormListType.Radio`）。
+
+| 参数 | 类型 | 默认值 | 说明 |
+| ---- | ---- | ------ | ---- |
+| label | string | — | optionList 中作为显示文案的字段名 |
+| value | string | — | optionList 中作为绑定值的字段名 |
+| optionList | any[] | — | 选项列表 |
+| showLabelAndValue | boolean | false | 选项展示为 `[value]label` |
+
+### CheckboxOption（复选框配置）
+
+用于 `FormItem.checkboxOption`（`FormListType.Checkbox` 多选组）。未配置 `checkboxOption` 时渲染单个复选框，值为 `boolean`，默认 `false`；配置后为复选框组，值为选中项 `value` 组成的数组，默认 `[]`。
+
+| 参数 | 类型 | 默认值 | 说明 |
+| ---- | ---- | ------ | ---- |
+| label | string | — | optionList 中作为显示文案的字段名 |
+| value | string | — | optionList 中作为绑定值的字段名 |
+| optionList | any[] | — | 选项列表 |
+| showLabelAndValue | boolean | false | 选项展示为 `[value]label` |
+
 ### HdOption（键值展示项）
 
 用于 `hd-detail-form` 的 `formCols`。
@@ -736,6 +779,8 @@ selectOption: {
 | showTime | boolean | false | Date 含时间 |
 | format | string | — | 时间格式化 |
 | selectOption | SelectOption | — | 下拉配置 |
+| radioOption | RadioOption | — | 单选配置 |
+| checkboxOption | CheckboxOption | — | 复选框组配置；不传则为单个复选框 |
 | inputNumber | InputNumber | — | 数字框配置 |
 | cascaderOption | CascaderOption | — | 级联配置 |
 | defaultLabel | string \| string[] | — | Select 默认展示文案 |
@@ -748,7 +793,7 @@ selectOption: {
 
 #### FormListType 枚举
 
-`Input` \| `Select` \| `MultipleSelect` \| `Date` \| `DateRange` \| `TextArea` \| `InputNumber` \| `ViewDom` \| `Switch` \| `Time` \| `Cascader`
+`Input` \| `Select` \| `MultipleSelect` \| `Date` \| `DateRange` \| `TextArea` \| `InputNumber` \| `ViewDom` \| `Switch` \| `Time` \| `Cascader` \| `Radio` \| `Checkbox`
 
 #### ValidatorKey
 
@@ -816,7 +861,7 @@ onSearchEvent: (keyword, line?: FormGroup) => void
 | 参数 | 类型 | 默认值 | 说明 |
 | ---- | ---- | ------ | ---- |
 | name | string | — | 按钮文案 |
-| showConfirm | boolean | false | popconfirm 确认 |
+| showConfirm | boolean \| (line) => boolean | false | 是否 popconfirm 确认；传函数时按行数据判断 |
 | isRepeat | boolean | false | 与其他按钮互斥显示 |
 | click | (line) => void | — | 点击回调 |
 | permission | (line) => boolean | — | 是否显示 |