fantasy-ngzorro 2.2.7 → 2.2.9

package/README.md

@@ -41,12 +41,14 @@
 | — | 2026-9-22 | `hd-form-lines` 支持列设置（`showColSettings` 默认开）：仅非 hide 的 ViewDom 可显隐，禁止调序；可选 `uuid` 缓存 |
 | — | 2026-9-22 | `hd-tip` 支持右侧展开/收起（`showCollapse` / `[(expanded)]`），暴露 `expand` / `collapse` / `toggle` 供父组件控制其它区块 |
 | — | 2026-9-22 | `hd-form-lines` 勾选提示改为 `tableTotal` 插槽（同 hd-table），组件内不再默认渲染已选中块 |
+| — | 2026-10-1 | `hd-table` 支持轻量行内编辑：`editType`（input / inputNumber / select）+ `(cellChange)`；Select 双写 value/label，事件带 `previous*` 供接口失败回滚 |
 | — | 2026-9-22 | `hd-table` / `hd-detail-form` 字段值后支持编辑笔图标（`editable` + `edit` 回调，图标对齐 Figma） |
 | — | 2026-9-28 | `hd-detail-lines` / `hd-detail-lines-page`：CSS 纵滚场景下提高冻结列表头 z-index，修复横滚盖住冻结列名 |
 | — | 2026-9-28 | `hd-detail-lines` / `hd-detail-lines-page`：仅有 `scroll.x` 时用 CSS `max-height` 做表内纵滚（不补 `nzScroll.y`），修复无列宽多行平铺无法纵滚，同时避免拆表头错位 |
 | — | 2026-9-28 | `hd-filter`：可选筛选组（`enableFilterScheme` / `filterSchemeKey` + `HD_FILTER_SCHEME_STORE`），支持切换/保存为当前/另存为/删除 |
 | — | 2026-9-29 | `hd-filter` 筛选组：弹窗标题「保存筛选组」；操作下拉「删除」红色；操作无左右 padding；选择/另存为改 `hd-form`；长名称省略；按钮顺序与间距对齐稿面 |
 | — | 2026-9-30 | `hd-filter` 筛选组：选择/保存弹窗宽度 560px；筛选组名称 maxLength 50 |
+| — | 2026-10-1 | `hd-accessory-list`：某分组 `accessoryList` 为空时仍展示分组标签，内容显示「暂无附件」（2.2.8） |
 | — | 2026-9-30 | `hd-filter`：筛选组弹窗未打开时不渲染空 `hd-form`；`hd-form` 空 formList 时初始化空 FormGroup，修复列表页 formGroup 报错（2.2.7） |
 | — | 2026-9-24 | `hd-detail-lines` / `hd-detail-lines-page`：恢复历史默认 `scroll={x:'1px'}`；**不再自动补 scroll.y**（仅父组件显式传 y，或 page 虚拟滚动才设 y）；去掉 `table-layout:fixed`。对齐 2.1.64 前无列宽自适应 |
 | — | 2026-9-24 | `hd-detail-lines` / `hd-detail-lines-page`：横滚时加固表头/表体 `scrollLeft` 同步与 `table-layout: fixed`，修复列名与列值不对齐 |
@@ -419,6 +421,7 @@ tableCols: HdTableColumn[] = [{
 | tablePageSizeChangeEvent | EventEmitter | — | pageSize 变化（含缓存恢复），常用于重新查询 |
 | sortEvent | EventEmitter | — | 排序 |
 | selectEvent | EventEmitter | — | 勾选变化 |
+| cellChange | EventEmitter\<HdTableCellChange\> | — | 行内编辑变更（已写回行对象；含 `previous*` 供接口失败回滚） |
 | showSelected | boolean | false | 勾选列 |
 | selectField | string | billNumber | 勾选主键字段 |
 | selectDisabledField | string | — | 行勾选禁用字段名；行数据该字段为 `true` 时禁用勾选（全选也会跳过） |
@@ -858,7 +861,7 @@ onDetailLinesPageSizeChange(pageSize: number) {
 
 ## 17、附件列表（hd-accessory-list）
 
-只读附件分组列表：上方标签（如「营业执照扫描件：」），下方灰色文件行；每行最多 4 个，超出自动换行；点击文件名下载/查看。对齐 Figma「文件列表」样式。
+只读附件分组列表：上方标签（如「营业执照扫描件：」），下方灰色文件行；每行最多 4 个，超出自动换行；点击文件名下载/查看。某分组 `accessoryList` 为空时仍展示该分组标签，内容显示「暂无附件」。对齐 Figma「文件列表」样式。
 
 ### 示例
 
@@ -899,7 +902,7 @@ onAccessoryFileClick(e: { group: HdAccessoryGroup; file: any; path: string }) {
 | 参数 | 类型 | 说明 |
 | ---- | ---- | ---- |
 | name | string | 分组标签 |
-| accessoryList | HdAccessoryFile[] | 附件列表 |
+| accessoryList | HdAccessoryFile[] | 附件列表；空数组时展示「暂无附件」 |
 
 #### HdAccessoryFile
 
@@ -1171,10 +1174,57 @@ onOpenChangeEvent: (open: boolean, line: FormGroup) => void
 | render / click | Function | — | 渲染 / 点击 |
 | canClick | (line) => boolean | — | 按行控制是否可点 |
 | rowNo | boolean \| string | — | 字段值后竖线 + 行号。`true` 为分页连续序号（从 1 起）；字符串为行数据字段名。前面的字段仍可用 `click` 做成超链接，行号不可点 |
-| editable | boolean \| (line) => boolean | — | 值后显示编辑笔图标（Figma 14px）；函数按行控制 |
+| editable | boolean \| (line) => boolean | — | 值后显示编辑笔图标（Figma 14px）；函数按行控制。与 `editType` 互斥 |
 | 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]` |
+| inputNumber | InputNumber | — | `editType=inputNumber` 时的 min/max/step/precision |
+| placeholder | string | — | 输入框 / 下拉占位 |
 | btnList | OperateBtn[] | — | `title` 为「操作」时整列按钮；其他列时显示在单元格文案后的操作按钮 |
 
+#### HdTableCellChange（行内编辑事件）
+
+| 字段 | 说明 |
+| ---- | ---- |
+| line / col / name | 当前行、列配置、字段名 |
+| value / previousValue | 新值 / 变更前值（接口失败回滚用） |
+| label / previousLabel | Select 时新/旧文案字段值 |
+| option / previousOption | Select 时新/旧整条选项 |
+
+接口失败回滚示例：
+
+```typescript
+onTableCellChange(e: HdTableCellChange) {
+  this.api.update(e.line).subscribe({
+    error: () => {
+      e.line[e.name] = e.previousValue;
+      if (e.col.selectOption && e.col.selectOption.label) {
+        e.line[e.col.selectOption.label] = e.previousLabel;
+      }
+    }
+  });
+}
+```
+
+行内编辑列表示例：
+
+```typescript
+{
+  title: '等级',
+  name: 'gradeCode',
+  editType: 'select',
+  selectOption: {
+    value: 'code',
+    label: 'gradeName',
+    selectList: [
+      { code: 'A', gradeName: '一级' },
+      { code: 'B', gradeName: '二级' },
+    ],
+  },
+}
+```
+
 #### OperateBtn（操作列按钮）
 
 | 参数 | 类型 | 默认值 | 说明 |