k-vtable 1.0.32 → 1.0.33

package/es/ListTable.d.ts

@@ -37,7 +37,7 @@ export declare class ListTable extends BaseTable implements ListTableAPI {
     getRecordIndexByCell(col: number, row: number): number | number[];
     getTableIndexByRecordIndex(recordIndex: number | number[]): number;
     getTableIndexByField(field: FieldDef): number;
-    getCellAddrByFieldRecord(field: FieldDef, recordIndex: number): CellAddress;
+    getCellAddrByFieldRecord(field: FieldDef, recordIndex: number | number[]): CellAddress;
     getCellOriginRecord(col: number, row: number): MaybePromiseOrUndefined;
     getCellRawRecord(col: number, row: number): MaybePromiseOrUndefined;
     _canResizeColumn(col: number, row: number): boolean;
@@ -92,12 +92,39 @@ export declare class ListTable extends BaseTable implements ListTableAPI {
     cancelEditCell(): void;
     getEditor(col: number, row: number): IEditor<any, any>;
     isHasEditorDefine(col: number, row: number): boolean;
-    changeCellValue(col: number, row: number, value: string | number | null, workOnEditableCell?: boolean, triggerEvent?: boolean): void;
-    changeCellValues(startCol: number, startRow: number, values: (string | number)[][], workOnEditableCell?: boolean, triggerEvent?: boolean): Promise<boolean[][]>;
-    addRecord(record: any, recordIndex?: number | number[]): void;
-    addRecords(records: any[], recordIndex?: number | number[]): void;
-    deleteRecords(recordIndexs: number[] | number[][]): void;
-    updateRecords(records: any[], recordIndexs: (number | number[])[]): void;
+    changeCellValue(col: number, row: number, value: string | number | null, workOnEditableCell?: boolean, triggerEvent?: boolean, noTriggerChangeCellValuesEvent?: boolean): void;
+    changeCellValues(startCol: number, startRow: number, values: (string | number)[][], workOnEditableCell?: boolean, triggerEvent?: boolean, noTriggerChangeCellValuesEvent?: boolean): Promise<boolean[][]>;
+    changeCellValuesByRanges(ranges: CellRange[], value: string | number | null, workOnEditableCell?: boolean, triggerEvent?: boolean, noTriggerChangeCellValuesEvent?: boolean): Promise<void>;
+    changeSourceCellValue(recordIndex: number | number[], field: FieldDef, value: string | number | null): void;
+    changeCellValueByRecord(recordIndex: number | number[], field: FieldDef, value: string | number | null, options?: {
+        triggerEvent?: boolean;
+        noTriggerChangeCellValuesEvent?: boolean;
+        autoRefresh?: boolean;
+    }): void;
+    changeCellValueBySource(recordIndex: number | number[], field: FieldDef, value: string | number | null, triggerEvent?: boolean, noTriggerChangeCellValuesEvent?: boolean): void;
+    changeCellValuesByRecords(changeValues: {
+        recordIndex: number | number[];
+        field: FieldDef;
+        value: string | number | null;
+    }[], options?: {
+        triggerEvent?: boolean;
+        noTriggerChangeCellValuesEvent?: boolean;
+        autoRefresh?: boolean;
+    }): void;
+    changeCellValuesBySource(changeValues: {
+        recordIndex: number | number[];
+        field: FieldDef;
+        value: string | number | null;
+    }[], triggerEvent?: boolean, noTriggerChangeCellValuesEvent?: boolean): void;
+    refreshAfterSourceChange(options?: {
+        reapplyFilter?: boolean;
+        reapplySort?: boolean;
+        clearRowHeightCache?: boolean;
+    }): void;
+    addRecord(record: any, recordIndex?: number | number[], triggerEvent?: boolean): void;
+    addRecords(records: any[], recordIndex?: number | number[], triggerEvent?: boolean): void;
+    deleteRecords(recordIndexs: number[] | number[][], triggerEvent?: boolean): void;
+    updateRecords(records: any[], recordIndexs: (number | number[])[], triggerEvent?: boolean): void;
     _hasCustomRenderOrLayout(): boolean;
     getAggregateValuesByField(field: string | number): {
         col: number;

package/es/ListTable.js

@@ -32,7 +32,9 @@ import { getGroupByDataConfig } from "./core/group-helper";
 
 import { DataSource } from "./data";
 
-import { listTableAddRecord, listTableAddRecords, listTableChangeCellValue, listTableChangeCellValues, listTableDeleteRecords, listTableUpdateRecords, sortRecords } from "./core/record-helper";
+import { getValueFromDeepArray } from "./data/DataSource";
+
+import { listTableAddRecord, listTableAddRecords, listTableChangeCellValue, listTableChangeCellValues, listTableChangeCellValuesByRanges, listTableDeleteRecords, listTableUpdateRecords, sortRecords } from "./core/record-helper";
 
 import { fixUpdateRowRange } from "./tools/update-row";
 
@@ -71,8 +73,8 @@ export class ListTable extends BaseTable {
             const ListTreeStickCellPlugin = Factory.getComponent("listTreeStickCellPlugin");
             this.listTreeStickCellPlugin = new ListTreeStickCellPlugin(this);
         }
-        setTimeout((() => {
-            this.isReleased || (this.resize(), this.fireListeners(TABLE_EVENT_TYPE.INITIALIZED, null));
+        this.resize(), setTimeout((() => {
+            this.isReleased || this.fireListeners(TABLE_EVENT_TYPE.INITIALIZED, null);
         }), 0);
     }
     isListTable() {
@@ -342,13 +344,13 @@ export class ListTable extends BaseTable {
         }) : (this.refreshRowColCount(), this._resetFrozenColCount(), this.scenegraph.createSceneGraph(), 
         this.render()), options.title) {
             const Title = Factory.getComponent("title");
-            internalProps.title = new Title(options.title, this), this.scenegraph.resize();
+            internalProps.title = new Title(options.title, this);
         }
         if (this.options.emptyTip) if (this.internalProps.emptyTip) null === (_h = this.internalProps.emptyTip) || void 0 === _h || _h.resetVisible(); else {
             const EmptyTip = Factory.getComponent("emptyTip");
             this.internalProps.emptyTip = new EmptyTip(this.options.emptyTip, this), null === (_j = this.internalProps.emptyTip) || void 0 === _j || _j.resetVisible();
         }
-        return this.pluginManager.updatePlugins(options.plugins), setTimeout((() => {
+        return this.pluginManager.updatePlugins(options.plugins), this.resize(), setTimeout((() => {
             this.fireListeners(TABLE_EVENT_TYPE.UPDATED, null);
         }), 0), new Promise((resolve => {
             setTimeout(resolve, 0);
@@ -570,11 +572,11 @@ export class ListTable extends BaseTable {
     updateFilterRules(filterRules, options = {
         clearRowHeightCache: !0
     }) {
-        var _a;
-        this.scenegraph.clearCells(), this.sortState ? (this.dataSource.updateFilterRulesForSorted(filterRules), 
-        sortRecords(this)) : this.dataSource.updateFilterRules(filterRules, null == options ? void 0 : options.onFilterRecordsEnd), 
+        var _a, _b, _c;
+        this.scenegraph.clearCells(), null === (_b = (_a = this.dataSource).clearForceVisibleRecords) || void 0 === _b || _b.call(_a), 
+        this.sortState ? (this.dataSource.updateFilterRulesForSorted(filterRules), sortRecords(this)) : this.dataSource.updateFilterRules(filterRules, null == options ? void 0 : options.onFilterRecordsEnd), 
         this.refreshRowColCount(), this.stateManager.initCheckedState(this.records), this.scenegraph.createSceneGraph(!(null == options ? void 0 : options.clearRowHeightCache)), 
-        null === (_a = this.internalProps.emptyTip) || void 0 === _a || _a.resetVisible(), 
+        null === (_c = this.internalProps.emptyTip) || void 0 === _c || _c.resetVisible(), 
         this.resize();
     }
     getFilteredRecords() {
@@ -626,7 +628,7 @@ export class ListTable extends BaseTable {
         this.setCellCheckboxState(col, row, checked);
     }
     setRecords(records, option) {
-        var _a, _b, _c, _d;
+        var _a, _b, _c, _d, _e;
         let sort;
         clearChartRenderQueue(), null === (_a = this.internalProps.dataSource) || void 0 === _a || _a.release(), 
         this.internalProps.releaseList = null === (_b = this.internalProps.releaseList) || void 0 === _b ? void 0 : _b.filter((item => !item.dataSourceObj)), 
@@ -652,12 +654,16 @@ export class ListTable extends BaseTable {
             }
             this.refreshRowColCount();
         } else _setRecords(this, records);
-        if (this.stateManager.initCheckedState(records), this.clearCellStyleCache(), this.scenegraph.createSceneGraph(), 
-        this.stateManager.updateHoverPos(oldHoverState.col, oldHoverState.row), this._updateSize(), 
-        this.internalProps.title && !this.internalProps.title.isReleased && this.internalProps.title.resize(), 
-        this.scenegraph.resize(), this.options.emptyTip) if (this.internalProps.emptyTip) null === (_c = this.internalProps.emptyTip) || void 0 === _c || _c.resetVisible(); else {
+        this.stateManager.initCheckedState(records), this.clearCellStyleCache(), this.scenegraph.createSceneGraph(), 
+        this.stateManager.updateHoverPos(oldHoverState.col, oldHoverState.row), this._updateSize();
+        if ((null !== (_c = this.options.componentLayoutOrder) && void 0 !== _c ? _c : [ "legend", "title" ]).forEach((component => {
+            var _a, _b;
+            "legend" === component ? null === (_a = this.internalProps.legends) || void 0 === _a || _a.forEach((legend => {
+                null == legend || legend.resize();
+            })) : "title" === component && (null === (_b = this.internalProps.title) || void 0 === _b || _b.resize());
+        })), this.scenegraph.resize(), this.options.emptyTip) if (this.internalProps.emptyTip) null === (_d = this.internalProps.emptyTip) || void 0 === _d || _d.resetVisible(); else {
             const EmptyTip = Factory.getComponent("emptyTip");
-            this.internalProps.emptyTip = new EmptyTip(this.options.emptyTip, this), null === (_d = this.internalProps.emptyTip) || void 0 === _d || _d.resetVisible();
+            this.internalProps.emptyTip = new EmptyTip(this.options.emptyTip, this), null === (_e = this.internalProps.emptyTip) || void 0 === _e || _e.resetVisible();
         }
         this.render(), isValid(oldHoverState.col) && isValid(oldHoverState.row) && oldHoverState.col >= 0 && oldHoverState.row >= 0 && setTimeout((() => {
             var _a;
@@ -721,47 +727,161 @@ export class ListTable extends BaseTable {
         }
         return isValid(editorDefine);
     }
-    changeCellValue(col, row, value, workOnEditableCell = !1, triggerEvent = !0) {
-        return listTableChangeCellValue(col, row, value, workOnEditableCell, triggerEvent, this);
+    changeCellValue(col, row, value, workOnEditableCell = !1, triggerEvent = !0, noTriggerChangeCellValuesEvent) {
+        return listTableChangeCellValue(col, row, value, workOnEditableCell, triggerEvent, this, noTriggerChangeCellValuesEvent);
+    }
+    changeCellValues(startCol, startRow, values, workOnEditableCell = !1, triggerEvent = !0, noTriggerChangeCellValuesEvent) {
+        return listTableChangeCellValues(startCol, startRow, values, workOnEditableCell, triggerEvent, this, noTriggerChangeCellValuesEvent);
+    }
+    changeCellValuesByRanges(ranges, value, workOnEditableCell = !1, triggerEvent = !0, noTriggerChangeCellValuesEvent) {
+        return listTableChangeCellValuesByRanges(ranges, value, workOnEditableCell, triggerEvent, this, noTriggerChangeCellValuesEvent);
+    }
+    changeSourceCellValue(recordIndex, field, value) {
+        const tableIndex = this.getTableIndexByRecordIndex(recordIndex), cellAddr = this.getCellAddrByFieldRecord(field, recordIndex);
+        if (tableIndex < 0 || cellAddr.col < 0 || cellAddr.row < 0) return;
+        this.dataSource.changeFieldValue(value, tableIndex, field, cellAddr.col, cellAddr.row, this);
+        const beforeChangeValue = this.getCellRawValue(cellAddr.col, cellAddr.row), oldValue = this.getCellOriginValue(cellAddr.col, cellAddr.row), changedValue = this.getCellOriginValue(cellAddr.col, cellAddr.row);
+        if (oldValue !== changedValue) {
+            const changeValue = {
+                col: cellAddr.col,
+                row: cellAddr.row,
+                recordIndex: recordIndex,
+                field: field,
+                rawValue: beforeChangeValue,
+                currentValue: oldValue,
+                changedValue: changedValue
+            };
+            this.fireListeners(TABLE_EVENT_TYPE.CHANGE_CELL_VALUE, changeValue), this.fireListeners(TABLE_EVENT_TYPE.CHANGE_CELL_VALUES, {
+                values: [ changeValue ]
+            });
+        }
+    }
+    changeCellValueByRecord(recordIndex, field, value, options) {
+        var _a, _b, _c, _d, _e;
+        const triggerEvent = null === (_a = null == options ? void 0 : options.triggerEvent) || void 0 === _a || _a, noTriggerChangeCellValuesEvent = null == options ? void 0 : options.noTriggerChangeCellValuesEvent, autoRefresh = null === (_b = null == options ? void 0 : options.autoRefresh) || void 0 === _b || _b, records = null === (_c = this.dataSource.dataSourceObj) || void 0 === _c ? void 0 : _c.records;
+        let record, oldValue;
+        if (!Array.isArray(records) || "string" != typeof field && "number" != typeof field || (record = Array.isArray(recordIndex) ? getValueFromDeepArray(records, recordIndex) : records[recordIndex], 
+        oldValue = null == record ? void 0 : record[field]), this.dataSource.changeFieldValueByRecordIndex(value, recordIndex, field, this), 
+        !triggerEvent) return;
+        const changedValue = !record || "string" != typeof field && "number" != typeof field ? value : null == record ? void 0 : record[field];
+        if (oldValue !== changedValue) {
+            const cellAddr = this.getCellAddrByFieldRecord(field, recordIndex), changeValue = {
+                col: null !== (_d = null == cellAddr ? void 0 : cellAddr.col) && void 0 !== _d ? _d : -1,
+                row: null !== (_e = null == cellAddr ? void 0 : cellAddr.row) && void 0 !== _e ? _e : -1,
+                recordIndex: recordIndex,
+                field: field,
+                rawValue: oldValue,
+                currentValue: oldValue,
+                changedValue: changedValue
+            };
+            this.fireListeners(TABLE_EVENT_TYPE.CHANGE_CELL_VALUE, changeValue), noTriggerChangeCellValuesEvent || this.fireListeners(TABLE_EVENT_TYPE.CHANGE_CELL_VALUES, {
+                values: [ changeValue ]
+            });
+        }
+        autoRefresh && this.refreshAfterSourceChange();
+    }
+    changeCellValueBySource(recordIndex, field, value, triggerEvent = !0, noTriggerChangeCellValuesEvent) {
+        return this.changeCellValueByRecord(recordIndex, field, value, {
+            triggerEvent: triggerEvent,
+            noTriggerChangeCellValuesEvent: noTriggerChangeCellValuesEvent,
+            autoRefresh: !0
+        });
+    }
+    changeCellValuesByRecords(changeValues, options) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        const triggerEvent = null === (_a = null == options ? void 0 : options.triggerEvent) || void 0 === _a || _a, noTriggerChangeCellValuesEvent = null == options ? void 0 : options.noTriggerChangeCellValuesEvent, autoRefresh = null === (_b = null == options ? void 0 : options.autoRefresh) || void 0 === _b || _b, resultChangeValues = [];
+        for (let i = 0; i < changeValues.length; i++) {
+            const {recordIndex: recordIndex, field: field, value: value} = changeValues[i], records = null === (_c = this.dataSource.dataSourceObj) || void 0 === _c ? void 0 : _c.records;
+            let record, oldValue;
+            if (!Array.isArray(records) || "string" != typeof field && "number" != typeof field || (record = Array.isArray(recordIndex) ? getValueFromDeepArray(records, recordIndex) : records[recordIndex], 
+            oldValue = null == record ? void 0 : record[field]), this.dataSource.changeFieldValueByRecordIndex(value, recordIndex, field, this), 
+            triggerEvent) {
+                const changedValue = !record || "string" != typeof field && "number" != typeof field ? value : null == record ? void 0 : record[field];
+                if (oldValue !== changedValue) {
+                    const changeValue = {
+                        col: null !== (_e = null === (_d = this.getCellAddrByFieldRecord(field, recordIndex)) || void 0 === _d ? void 0 : _d.col) && void 0 !== _e ? _e : -1,
+                        row: null !== (_g = null === (_f = this.getCellAddrByFieldRecord(field, recordIndex)) || void 0 === _f ? void 0 : _f.row) && void 0 !== _g ? _g : -1,
+                        recordIndex: recordIndex,
+                        field: field,
+                        rawValue: oldValue,
+                        currentValue: oldValue,
+                        changedValue: changedValue
+                    };
+                    this.fireListeners(TABLE_EVENT_TYPE.CHANGE_CELL_VALUE, changeValue), resultChangeValues.push(changeValue);
+                }
+            }
+        }
+        !noTriggerChangeCellValuesEvent && resultChangeValues.length && triggerEvent && this.fireListeners(TABLE_EVENT_TYPE.CHANGE_CELL_VALUES, {
+            values: resultChangeValues
+        }), autoRefresh && this.refreshAfterSourceChange();
+    }
+    changeCellValuesBySource(changeValues, triggerEvent = !0, noTriggerChangeCellValuesEvent) {
+        return this.changeCellValuesByRecords(changeValues, {
+            triggerEvent: triggerEvent,
+            noTriggerChangeCellValuesEvent: noTriggerChangeCellValuesEvent,
+            autoRefresh: !0
+        });
     }
-    changeCellValues(startCol, startRow, values, workOnEditableCell = !1, triggerEvent = !0) {
-        return listTableChangeCellValues(startCol, startRow, values, workOnEditableCell, triggerEvent, this);
+    refreshAfterSourceChange(options) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+        const reapplyFilter = null === (_a = null == options ? void 0 : options.reapplyFilter) || void 0 === _a || _a, reapplySort = null === (_b = null == options ? void 0 : options.reapplySort) || void 0 === _b || _b, clearRowHeightCache = null === (_c = null == options ? void 0 : options.clearRowHeightCache) || void 0 === _c || _c;
+        this.scenegraph.clearCells(), this.sortState && reapplySort && (null === (_e = (_d = this.dataSource).clearSortedIndexMap) || void 0 === _e || _e.call(_d), 
+        null === (_g = null === (_f = this.dataSource.sortedIndexMap) || void 0 === _f ? void 0 : _f.clear) || void 0 === _g || _g.call(_f)), 
+        reapplyFilter ? this.sortState && reapplySort ? (this.dataSource.updateFilterRulesForSorted(null === (_h = this.dataSource.dataConfig) || void 0 === _h ? void 0 : _h.filterRules), 
+        sortRecords(this)) : this.dataSource.updateFilterRules(null === (_j = this.dataSource.dataConfig) || void 0 === _j ? void 0 : _j.filterRules) : this.sortState && reapplySort && sortRecords(this);
+        const traverseColumns = columns => {
+            var _a, _b, _c, _d;
+            for (let i = 0; i < (null !== (_a = null == columns ? void 0 : columns.length) && void 0 !== _a ? _a : 0); i++) {
+                const column = columns[i], aggregators = null == column ? void 0 : column.vtable_aggregator;
+                if (aggregators) if (Array.isArray(aggregators)) for (let j = 0; j < aggregators.length; j++) null === (_c = null === (_b = aggregators[j]) || void 0 === _b ? void 0 : _b.recalculate) || void 0 === _c || _c.call(_b); else null === (_d = null == aggregators ? void 0 : aggregators.recalculate) || void 0 === _d || _d.call(aggregators);
+                (null == column ? void 0 : column.columns) && traverseColumns(column.columns);
+            }
+        };
+        traverseColumns(this.internalProps.columns), this.refreshRowColCount(), this.internalProps.layoutMap.clearCellRangeMap(), 
+        this.internalProps.useOneRowHeightFillAll = !1, this.stateManager.initCheckedState(this.records), 
+        this.scenegraph.createSceneGraph(!clearRowHeightCache), null === (_k = this.internalProps.emptyTip) || void 0 === _k || _k.resetVisible(), 
+        this.resize();
     }
-    addRecord(record, recordIndex) {
+    addRecord(record, recordIndex, triggerEvent = !0) {
         var _a;
         const success = listTableAddRecord(record, recordIndex, this);
         adjustHeightResizedRowMapWithAddRecordIndex(this, recordIndex, [ record ]), null === (_a = this.internalProps.emptyTip) || void 0 === _a || _a.resetVisible(), 
-        success && this.fireListeners(TABLE_EVENT_TYPE.ADD_RECORD, {
+        triggerEvent && success && this.fireListeners(TABLE_EVENT_TYPE.ADD_RECORD, {
             records: [ record ],
             recordIndex: recordIndex,
             recordCount: 1
         });
     }
-    addRecords(records, recordIndex) {
+    addRecords(records, recordIndex, triggerEvent = !0) {
         var _a;
         const success = listTableAddRecords(records, recordIndex, this);
         "number" == typeof recordIndex && adjustHeightResizedRowMapWithAddRecordIndex(this, recordIndex, records), 
         null === (_a = this.internalProps.emptyTip) || void 0 === _a || _a.resetVisible(), 
-        success && this.fireListeners(TABLE_EVENT_TYPE.ADD_RECORD, {
+        triggerEvent && success && this.fireListeners(TABLE_EVENT_TYPE.ADD_RECORD, {
             records: records,
             recordIndex: recordIndex,
             recordCount: records.length
         });
     }
-    deleteRecords(recordIndexs) {
+    deleteRecords(recordIndexs, triggerEvent = !0) {
         var _a;
-        listTableDeleteRecords(recordIndexs, this), adjustHeightResizedRowMapWithDeleteRecordIndex(this, recordIndexs), 
+        const deletedRecords = [];
+        (null == recordIndexs ? void 0 : recordIndexs.length) > 0 && recordIndexs.forEach((index => {
+            let record = null;
+            record = "number" == typeof index ? this.dataSource.get(index) : [], deletedRecords.push(record);
+        })), listTableDeleteRecords(recordIndexs, this), adjustHeightResizedRowMapWithDeleteRecordIndex(this, recordIndexs), 
         null === (_a = this.internalProps.emptyTip) || void 0 === _a || _a.resetVisible();
         const rowIndexs = [];
         for (let i = 0; i < recordIndexs.length; i++) rowIndexs.push(this.getBodyRowIndexByRecordIndex(recordIndexs[i]) + this.columnHeaderLevelCount);
-        this.fireListeners(TABLE_EVENT_TYPE.DELETE_RECORD, {
+        triggerEvent && this.fireListeners(TABLE_EVENT_TYPE.DELETE_RECORD, {
             recordIndexs: recordIndexs,
+            records: deletedRecords,
             rowIndexs: rowIndexs,
             deletedCount: (Array.isArray(recordIndexs[0]), recordIndexs.length)
         });
     }
-    updateRecords(records, recordIndexs) {
-        listTableUpdateRecords(records, recordIndexs, this), this.fireListeners(TABLE_EVENT_TYPE.UPDATE_RECORD, {
+    updateRecords(records, recordIndexs, triggerEvent = !0) {
+        listTableUpdateRecords(records, recordIndexs, this), triggerEvent && this.fireListeners(TABLE_EVENT_TYPE.UPDATE_RECORD, {
             records: records,
             recordIndexs: recordIndexs,
             updateCount: records.length