fantasy-ngzorro 2.2.12 → 2.2.14

package/README.md

@@ -32,6 +32,8 @@
 
 | 更新人 | 更新时间 | 更新内容 |
 | ------ | -------- | -------- |
+| — | 2026-10-8 | `hd-table`：底部合计行走 `nzFooter`（分页之上、不进虚拟滚动）；`tableTotalOption` 共用 `TotalOption`；列未撑满与横滚两套对齐；序号列固定宽（2.2.14） |
+| — | 2026-10-3 | `hd-form-lines`：`enableKeyboardOperate=false` 时 Select 选中后不再自动聚焦下一个控件（2.2.13） |
 | — | 2026-10-3 | `hd-table`：横向滚动时表头/表体 table 改为 `table-layout: fixed`，修复表体单元格内容超宽把列撑开导致表头表体列线错位（2.2.12） |
 | — | 2026-10-3 | `hd-filter`：筛选组进页只请求一次（跳过 ngOnChanges firstChange，避免与 ngOnInit 重复导致首次请求被取消）（2.2.11） |
 | — | 2026-10-3 | `hd-status`：补充对账/登记/付款状态色（未对账、对账中、已对账、未登记、已登记、未付款、可付款、可对账）（2.2.10） |
@@ -432,8 +434,9 @@ tableCols: HdTableColumn[] = [{
 | showOperateColWarpButton | boolean | false | 展开/缩略显示换行列 |
 | virtualScroll | boolean | true | 行数多自动虚拟滚动；横向滚动条按**列总宽是否超出容器**决定 |
 | virtualItemSize | number | — | 虚拟滚动行高（px）；**不传则首屏自动测量** |
-| showTableTotal | boolean | false | 底部合计行 |
-| tableTotalOption | HdTableTotalOption[] | — | 合计配置 |
+| showTableTotal | boolean | false | 底部合计行（`nzFooter`，固定在表体下方、分页上方，不进虚拟滚动数据）；开启后表内**强制展示序号列**，「合计」对齐序号列 |
+| tableTotalOption | TotalOption[] | — | 合计配置，与 `hd-detail-lines` 共用 [TotalOption](#totaloption明细合计行)；未传 `insertValue` 时按 `insertIndex` 对应列对 content 求和 |
+| columnsNumber | number \| string | — | 合计列总数（**含序号列**，与 detail-lines 一致）；不传则按可见数据列数 + 1 |
 | isFirstEntrySearch | boolean | — | 首次进入是否自动查询 |
 | isCrossPageSelect | boolean | — | 跨页勾选 |
 | uuid | string | — | 列缓存唯一标识（必填，用于 IndexedDB 缓存） |
@@ -460,7 +463,7 @@ linesPage = { content: lines, totalElements: lines.length };
 
 #### HdTableColumn 配置
 
-列定义见 [HdTableColumn](#hdtablecolumn表格列)、[OperateBtn](#operatebtn操作列按钮)、[HdTableTotalOption](#hdtabletotaloptionhd-table-底部合计)。
+列定义见 [HdTableColumn](#hdtablecolumn表格列)、[OperateBtn](#operatebtn操作列按钮)、[TotalOption](#totaloption明细合计行)。
 
 当 `name` 为 `state` 或 `isState` 为 `true` 时，列内容使用 `hd-status` 渲染。取值规则：`isState` 时取 `data[name]`；否则可通过 `stateField` 指定字段，未配置时默认取 `state`。
 
@@ -600,6 +603,7 @@ formChangeEvent(validateForm: FormGroup) {
 | showCheckbox | boolean | false | 行勾选列（用于批量操作） |
 | showColSettings | boolean | true | 是否展示列设置（齿轮，位置同 hd-table）；仅 **非 hide 的 ViewDom** 可配置显示/隐藏，**不可拖拽调序** |
 | uuid | string | — | 列设置缓存标识；有值时按用户+路由持久化到 IndexedDB |
+| enableKeyboardOperate | boolean | true | 键盘操作（方向键 / 回车跳格、Select 选中后自动跳到下一个控件）；为 `false` 时全部关闭 |
 | showKeyboardOperateTip | boolean | false | 键盘操作提示 |
 | showLineNumber | boolean | true | 序号列 |
 | tableLoading | boolean | false | 加载状态 |
@@ -1238,22 +1242,16 @@ onTableCellChange(e: HdTableCellChange) {
 | click | (line) => void | — | 点击回调 |
 | permission | (line) => boolean | — | 是否显示 |
 
-#### HdTableTotalOption（hd-table 底部合计）
-
-| 参数 | 类型 | 说明 |
-| ---- | ---- | ---- |
-| columnNumber | number | 总列数 |
-| insertIndex | number | 插入列下标 |
-| insertName | string | 合计字段名 |
+#### TotalOption（明细合计行 / hd-table 底部合计）
 
-#### TotalOption（明细合计行）
+用于 `hd-detail-lines`、`hd-detail-lines-page`、`hd-form-lines`、`hd-table`（`tableTotalOption`）。
 
-用于 `hd-detail-lines`、`hd-detail-lines-page`、`hd-form-lines`。
+`hd-table` 开启 `showTableTotal` 后左侧固定增加「序号」列；合计通过 `nzFooter` 固定在表体下方、分页上方。「合计」对齐序号列；`insertIndex` 从 1 起对应可见数据列。未传 `insertValue` 时按该列 `name` 对当前 `content` 数值求和。
 
 | 参数 | 类型 | 说明 |
 | ---- | ---- | ---- |
 | insertIndex | number | 插入列下标（从 1 开始） |
-| insertValue | any | 合计值 |
+| insertValue | any | 合计值；`hd-table` 可不传，按列自动求和 |
 | align | string | 对齐方式 |
 | showDecimal | boolean | 始终显示小数 |
 | preserveNumber | number | 保留小数位数，不传默认 2 |