fantasy-ngzorro 2.2.20 → 2.2.22

package/README.md

@@ -32,6 +32,8 @@
 
 | 更新人 | 更新时间 | 更新内容 |
 | ------ | -------- | -------- |
+| — | 2026-10-20 | `hd-table`：行内 Select 支持 `onOpenChangeEvent` / `onSearchEvent`（对齐 form-lines；可 return 数组/Promise/Observable 由组件写回并刷新）（2.2.22） |
+| — | 2026-10-13 | `hd-table`：`showColSettings`（默认 true）可关闭列设置；`hd-filter`：可见条件 ≤2 自动加宽且整行占满 100%；`hd-form-lines`：全局搜索时左侧按钮紧挨搜索框（2.2.21） |
 | — | 2026-10-12 | `hd-form-lines` / `hd-detail-lines`：全局搜索框 `width` 改挂 `nz-input-group`，修复放大镜贴到最右侧（2.2.20） |
 | — | 2026-10-9 | `hd-button-group`：左侧区域 `flex:1`，`tableLeftButton` 等内容可占满右侧按钮前的剩余宽度（2.2.19） |
 | — | 2026-10-9 | `hd-filter`：新增 `hidePadding`，为 true 时去掉 `.hd-filter-container` 的 padding（2.2.18） |
@@ -284,6 +286,7 @@
 | enableFilterScheme | boolean | 是否启用筛选组，默认 `false` |
 | filterSchemeKey | string | 筛选器标识；开启筛选组时必传 |
 | hidePadding | boolean | 去掉 `.hd-filter-container` 的 padding，默认 `false` |
+| （布局） | — | 可见筛选项 ≤2 个时自动加宽字段列（1 个 → `nzSpan=18`，2 个 → `nzSpan=9`），查询/重置仍占 6；≥3 个与现网一致（`nzSpan=6` + `computeOffset`） |
 | searchEvent | EventEmitter | 查询，带回筛选数据 |
 | resetEvent | EventEmitter | 重置 |
 
@@ -438,6 +441,7 @@ tableCols: HdTableColumn[] = [{
 | selectDisabledField | string | — | 行勾选禁用字段名；行数据该字段为 `true` 时禁用勾选（全选也会跳过） |
 | rowInvalidField | string | — | 行失效字段名；为 `true` 时整行背景 `#F7F8FA`、普通文字 `#868A9C`（操作按钮/超链接颜色不变） |
 | showOperateColWarpButton | boolean | false | 展开/缩略显示换行列 |
+| showColSettings | boolean | true | 是否展示列设置（齿轮）；弹窗等场景可传 `false` 关闭 |
 | virtualScroll | boolean | true | 行数多自动虚拟滚动；横向滚动条按**列总宽是否超出容器**决定 |
 | virtualItemSize | number | — | 虚拟滚动行高（px）；**不传则首屏自动测量** |
 | showTableTotal | boolean | false | 底部合计行（`nzFooter`，固定在表体下方、分页上方，不进虚拟滚动数据）；开启后表内**强制展示序号列**，「合计」对齐序号列 |
@@ -1193,7 +1197,11 @@ onOpenChangeEvent: (open: boolean, line: FormGroup) => void
 | edit | (line) => void | — | 点击编辑笔回调，供父组件处理（如弹窗改值） |
 | editType | `'input'` \| `'inputNumber'` \| `'select'` | — | 行内编辑：该列常显控件；`name` 须为 string |
 | editDisabled | boolean \| (line) => boolean | — | 禁用行内编辑 |
-| selectOption | SelectOption | — | `editType=select` 时用；选中后 `line[name]=option[value]`，若有 `label` 则再写 `line[label]=option[label]` |
+| selectOption | SelectOption | — | `editType=select` 时用；选中后 `line[name]=option[value]`，若有 `label` 则再写 `line[label]=option[label]`；按行选项用 `selectListName`；远程搜索设 `hdServerSearch` |
+| onOpenChangeEvent | (open, line) => any | — | Select 展开回调；展开时先清空再回调；关闭不回调。**可 return 数组 / Promise / Observable**，由组件写回 options 并刷新（OnPush 下不必改 `tableData` 引用） |
+| onOpenChangeEventDebounceTime | number | 0 | 展开回调防抖（ms）；未配或 0 同步 |
+| onSearchEvent | (keyword, line) => any | — | Select 输入搜索；不清空 options；建议配合 `hdServerSearch`。同样可 return 数组 / Promise / Observable |
+| onSearchEventEventDebounceTime | number | 0 | 搜索防抖（ms）；命名对齐 form-lines；未配或 0 同步 |
 | inputNumber | InputNumber | — | `editType=inputNumber` 时的 min/max/step/precision |
 | placeholder | string | — | 输入框 / 下拉占位 |
 | btnList | OperateBtn[] | — | `title` 为「操作」时整列按钮；其他列时显示在单元格文案后的操作按钮 |
@@ -1240,6 +1248,29 @@ onTableCellChange(e: HdTableCellChange) {
 }
 ```
 
+按行动态加载 / 远程搜索（推荐 `selectListName`；**直接 return Observable**，无需业务再刷 `tableData`）：
+
+```typescript
+{
+  title: '等级',
+  name: 'gradeCode',
+  editType: 'select',
+  selectOption: {
+    value: 'code',
+    label: 'gradeName',
+    selectListName: 'gradeOptions',
+    hdServerSearch: true,
+  },
+  onOpenChangeEvent: (open, line) => this.loadGradeOptions(line, ''),
+  onSearchEvent: (keyword, line) => this.loadGradeOptions(line, keyword),
+  onSearchEventEventDebounceTime: 300,
+}
+
+// loadGradeOptions(line, keyword): Observable<Array<any>>
+```
+
+若必须在回调里自行 `line.gradeOptions = list`（不 return），可 `ViewChild` 调 `hdTable.markForCheck()`。
+
 #### OperateBtn（操作列按钮）
 
 | 参数 | 类型 | 默认值 | 说明 |