fantasy-ngzorro 2.2.13 → 2.2.15

package/hd-detail-lines/hd-detail-lines.service.d.ts

@@ -1,6 +1,7 @@
 export declare class TotalOption {
     insertIndex: number;
-    insertValue: any;
+    /** 合计值；hd-table 可不传，按 insertIndex 对应列对 content 自动求和 */
+    insertValue?: any;
     align?: string;
     showDecimal?: boolean;
     preserveNumber?: number;

package/hd-table/hd-table.component.d.ts

@@ -1,12 +1,14 @@
-import { ChangeDetectorRef, EventEmitter, OnInit, SimpleChange, TemplateRef } from "@angular/core";
+import { ChangeDetectorRef, ElementRef, EventEmitter, OnDestroy, OnInit, SimpleChange, TemplateRef } from "@angular/core";
 import { NzFormatBeforeDropEvent, NzFormatEmitEvent } from "ng-zorro-antd/core";
 import { NzResizeEvent } from "ng-zorro-antd/resizable";
 import { NzTableComponent } from "ng-zorro-antd/table";
 import { Observable } from "rxjs";
 import { Page } from "../model/common-type";
 import { CommonSessionService } from "../service/common-session.service";
-import { HdTableCellChange, HdTableColumn, HdTableTotalOption, OperateBtn, TableCacheOption, TreeGrid } from "./hd-table.service";
-export declare class HdTableComponent implements OnInit {
+import { TotalOption } from "../hd-detail-lines/hd-detail-lines.service";
+import { HdTableCellChange, HdTableColumn, OperateBtn, TableCacheOption, TreeGrid } from "./hd-table.service";
+export declare class HdTableComponent implements OnInit, OnDestroy {
+    private hostEl;
     private cdr;
     private commonSessionService;
     uuid: string;
@@ -29,7 +31,12 @@ export declare class HdTableComponent implements OnInit {
      */
     rowInvalidField: string;
     showTableTotal: boolean;
-    tableTotalOption: Array<HdTableTotalOption>;
+    tableTotalOption: Array<TotalOption>;
+    /**
+     * 合计列总数（含序号列，与 hd-detail-lines 一致）；
+     * 不传则按当前可见数据列数 + 1（序号）推算。
+     */
+    columnsNumber: number | string;
     sortEvent: EventEmitter<{}>;
     selectEvent: EventEmitter<{}>;
     tableSearchEvent: EventEmitter<{}>;
@@ -90,14 +97,25 @@ export declare class HdTableComponent implements OnInit {
     /** 记录当前是否处于虚拟滚动模式，用于切换 pageSize 时重建表格 */
     private virtualScrollActive;
     /** 可见列总宽，用于判断是否需要横向滚动 */
-    private tableColWidthTotal;
+    /** 列宽合计（含勾选/序号），footer 表宽与横向 scroll 共用 */
+    tableColWidthTotal: number;
     /** 数据更新后待复位纵向滚动位置 */
     private pendingResetScrollTop;
     /** 当前排序，表格重建后用于恢复表头排序态 */
     private currentSortKey;
     private currentSortValue;
     nzTableComponent: NzTableComponent;
-    constructor(cdr: ChangeDetectorRef, commonSessionService: CommonSessionService);
+    private totalFooterScrollBoundBody;
+    private totalFooterScrollHandler;
+    private totalFooterSyncRetry;
+    /** 表体有竖滚条时合计 footer 才预留右侧滚动条槽 */
+    totalFooterNeedYGutter: boolean;
+    /** 视口/容器尺寸变化时重算 scroll.x 与合计对齐 */
+    private viewportResizeTimer;
+    private boundOnViewportResize;
+    private hostResizeObserver;
+    constructor(hostEl: ElementRef, cdr: ChangeDetectorRef, commonSessionService: CommonSessionService);
+    ngOnDestroy(): void;
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChange): void;
     /** 是否走前端分页（对 content 切片，不请求后端） */
@@ -126,6 +144,23 @@ export declare class HdTableComponent implements OnInit {
     readonly useVirtualScroll: boolean;
     getRightSticky(col: HdTableColumn): string | null;
     getLeftSticky(col: HdTableColumn): string | null;
+    /**
+     * 序号列固定宽（含 padding，可容纳 6 位如 199995）。
+     * 不锁死时表体会随位数变宽（1→~64px，199995→~67px），合计行对不齐。
+     */
+    readonly lineNumberColWidth = 72;
+    /** 开启合计时序号列的 left（勾选列占 40px） */
+    readonly lineNumberLeft: string;
+    readonly lineNumberColWidthPx: string;
+    /**
+     * 列总宽未超出容器：无横向 scroll，表体列会被撑满，合计走 fluid（width:100%）。
+     * 列总宽超出：有 scroll.x，合计走固定表宽 + 横滚同步。
+     */
+    readonly isTotalFooterFluid: boolean;
+    /** fluid → 100%；固定 → scroll.x（与表体同一套横向宽度） */
+    readonly totalFooterTableWidth: string;
+    /** 当前页行号（跨页连续，从 1 开始） */
+    getLineNumber(index: number): number;
     trackByRow: (index: number, data: any) => string;
     /** 虚拟滚动按数组下标追踪，避免业务主键 trackBy 导致 CDK 行复用错位 */
     virtualTrackByRow: (index: number) => number;
@@ -170,15 +205,50 @@ export declare class HdTableComponent implements OnInit {
     /** 虚拟滚动开启时使用视口最大高度 */
     private getVirtualScrollY;
     private hasTableData;
-    /** 列总宽超出外层容器才启用横向 scroll（不能用 table 自身宽度，会被 scroll.x 撑宽） */
+    /**
+     * 列总宽超出外层容器才启用横向 scroll。
+     * 以 dealScroll 累计的声明列宽为准，不用 DOM 自然测宽（内容不截断会偏大，导致列能放下也开横滚）。
+     */
     private resolveScrollX;
     /** 表格渲染后按实际容器宽度校正横向 scroll（只改 x，避免触发表头结构变化） */
     private syncHorizontalScroll;
-    /** 手动把表体横向滚动同步到表头（兜底 ng-zorro 监听丢失的情况） */
+    /** 手动把表体横向滚动同步到表头 / 合计 footer（兜底 ng-zorro 监听丢失的情况） */
     private syncHeaderBodyScrollLeft;
+    /** 取表体横向滚动容器（虚拟滚动优先 viewport） */
+    private getTableBodyScrollEl;
+    private getTotalFooterScrollEl;
+    /** 表体是否出现纵向滚动条（含滚动条槽宽） */
+    private bodyHasVerticalScrollbar;
+    /**
+     * 合计 footer 与表体联动：
+     * - fluid（列未撑满）：不横滚、不测宽，表宽 100% 与表体同比例拉伸；
+     * - fixed（有 scroll.x）：同步 scrollLeft；
+     * - 仅当表体有竖滚条时预留右侧槽，行少无竖滚时不占位。
+     */
+    private syncTotalFooterWithBody;
+    private syncTotalFooterScrollLeft;
+    private bindTotalFooterScrollSync;
+    private unbindTotalFooterScrollSync;
+    /**
+     * 监听窗口 / 容器宽度变化：重新判定 scroll.x（fluid↔fixed）与合计右侧竖滚槽，
+     * 避免拉宽/缩窄屏幕后合计行宽与表体错位。
+     */
+    private bindViewportResizeSync;
+    private unbindViewportResizeSync;
+    private scheduleViewportScrollSync;
     dealScroll(): void;
     currentPageDataChange($event: any): void;
     search(reset: boolean): void;
+    /**
+     * 底部合计：与 hd-detail-lines 相同，使用 TotalOption（insertIndex / insertValue）。
+     * 开启后强制展示序号列，「合计」落在序号列下；
+     * insertIndex 从 1 起对应可见数据列；未传 insertValue 时按该列 name 对 content 求和。
+     */
+    calculateTableTotal(): void;
+    private getTableTotalCellMeta;
+    /** 合计单元格展示文案（对齐 detail-lines 小数规则） */
+    getTableTotalCellValue(col: HdTableColumn, colIndex: number): any;
+    getTableTotalCellAlign(col: HdTableColumn, colIndex: number): string;
     /** 底部「共 n 条」：非分页/前端分页用 content.length，服务端分页用 totalElements */
     getTableTotalCount(): number;
     resetStatus(): void;

package/hd-table/hd-table.service.d.ts

@@ -72,11 +72,6 @@ export declare class OperateBtn {
     click?: (value: any) => void;
     permission?: (value: any) => boolean;
 }
-export declare class HdTableTotalOption {
-    columnNumber: number;
-    insertIndex: number;
-    insertName: string;
-}
 export declare class TableCacheOption {
     pageSize: number;
     colWidths: Map<string, number>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "fantasy-ngzorro",
-  "version": "2.2.13",
-  "description": "fix：hd-form-lines enableKeyboardOperate=false 时 Select 选中后不再自动跳格",
+  "version": "2.2.15",
+  "description": "fix：hd-table 列能放下不误开横滚；合计行按竖滚条显隐预留右槽，窗口缩放自动对齐",
   "peerDependencies": {
     "moment": "^2.24.0",
     "ng-zorro-antd": "^8.5.2",

package/utils/hd-table-scroll.util.d.ts

@@ -5,6 +5,12 @@ export interface HdTableScrollConfig {
 }
 export declare function getTableViewportWidth(nzTable: NzTableComponent, hostClass?: string): number;
 export declare function measureTableColWidth(nzTable: NzTableComponent): number;
+/**
+ * 用于判断是否需要 scroll.x 的视口宽。
+ * 有纵向滚动条时 clientWidth 会少一截，若直接拿去比列宽，会「竖滚条导致误开横滚」；
+ * 这里用 offsetWidth（含滚动条槽）作为屏幕可展示宽度。
+ */
+export declare function getTableScrollXViewportWidth(nzTable: NzTableComponent, hostClass?: string): number;
 /** 无数据或列宽未超出容器时不启用横向 scroll */
 export declare function resolveAutoTableScroll(nzTable: NzTableComponent, hasData: boolean, colWidth?: number): HdTableScrollConfig | null;
 /** 取 ng-zorro 分体表头 / 表体滚动容器（含虚拟滚动） */