Merge pull request #4936 from VisActor/release/1.22.11

[Auto release] release 1.22.11

Author: fangsmile

README.md

@@ -181,7 +181,7 @@ $ rush update
 
 ## 🔗 Related Links
 
-- [Official website](https://visactor.io/vtable)
+- [Official website](https://visactor.com/vtable)
 - [Usage Trend](https://npm-compare.com/@visactor/vtable)
 
 # 💫 Ecosystem
@@ -192,16 +192,17 @@ $ rush update
 
 # ⭐️ Star History
 
-## Star History
 
-<a href="https://gitdata.xuanhun520.com/#visactor/vtable&Date">
+<a href="https://gitdata.xuanhun520.com/?repos=visactor/vtable&type=Date">
 <picture >
-
+  <source media="(prefers-color-scheme: dark) and (max-width: 800px)" srcset="https://gitdata.xuanhun520.com/api/starimg?repos=visactor/vtable&type=Date&theme=dark" />
+  <source  media="(prefers-color-scheme: light) and (max-width: 800px)" srcset="https://gitdata.xuanhun520.com/api/starimg?repos=visactor/vtable&type=Date&theme=light" />
   <img style="width: 800px; height: 533px;" alt="Star History Chart" src="https://gitdata.xuanhun520.com/api/starimg?repos=visactor/vtable&type=Date&theme=dark" />
 </picture>
 </a>
 
 
+
 # 🤝 Contribution
 
 If you would like to contribute, please read the [Code of Conduct ](./CODE_OF_CONDUCT.md) and [ Guide](./CONTRIBUTING.md) first。

common/config/rush/version-policies.json

@@ -1 +1 @@
-[{"definitionName":"lockStepVersion","policyName":"vtableMain","version":"1.22.10","mainProject":"@visactor/vtable","nextBump":"patch"}]
+[{"definitionName":"lockStepVersion","policyName":"vtableMain","version":"1.22.11","mainProject":"@visactor/vtable","nextBump":"patch"}]

docs/assets/api/en/methods.md

@@ -2324,3 +2324,35 @@ Usage:
 // Collapse all column header tree nodes
 tableInstance.collapseAllForColumnTree();
 ```
+
+## updateCellContent(Function)
+
+Update the content of a single cell. This interface only refreshes the content of the scenegraph node, not rendering. The render() interface will not actively update the content of the scenegraph node.
+
+```ts
+  /**
+   * Update the content of a single cell
+   */
+  updateCellContent: (col: number, row: number) => void;
+```
+## updateCellContentRange(Function)
+
+Update the content of a range of cells. This interface only refreshes the content of the scenegraph node, not rendering. The render() interface will not actively update the content of the scenegraph node.
+
+```ts
+  /**
+   * Update the content of a range of cells
+   */
+  updateCellContentRange: (startCol: number, startRow: number, endCol: number, endRow: number) => void;
+```
+
+## updateCellContentRanges(Function)
+
+Update the content of a range of cells. This interface only refreshes the content of the scenegraph node, not rendering. The render() interface will not actively update the content of the scenegraph node.
+
+```ts
+  /**
+   * Update the content of a range of cells
+   */
+  updateCellContentRanges: (ranges: CellRange[]) => void;
+```

docs/assets/api/zh/methods.md

@@ -2326,3 +2326,35 @@ tableInstance.expandAllForColumnTree();
 // 折叠列表头树的所有节点
 tableInstance.collapseAllForColumnTree();
 ```
+## updateCellContent(Function)
+
+更新某个单元格内容. 这个接口仅是刷新场景树节点内容而非渲染。重新渲染接口render()不会主动更新场景树节点内容。
+
+```ts
+  /**
+   * 更新某个单元格内容
+   */
+  updateCellContent: (col: number, row: number) => void;
+```
+
+## updateCellContentRange(Function)
+
+更新某个区域单元格内容. 这个接口仅是刷新场景树节点内容而非渲染。重新渲染接口render()不会主动更新场景树节点内容。
+
+```ts
+  /**
+   * 更新某个区域单元格内容
+   */
+  updateCellContentRange: (startCol: number, startRow: number, endCol: number, endRow: number) => void;
+```
+
+## updateCellContentRanges(Function)
+
+更新某个区域单元格内容. 这个接口仅是刷新场景树节点内容而非渲染。重新渲染接口render()不会主动更新场景树节点内容。
+
+```ts
+  /**
+   * 更新某个区域单元格内容
+   */
+  updateCellContentRanges: (ranges: CellRange[]) => void;
+```

docs/assets/changelog/en/release.md

@@ -1,3 +1,23 @@
+# v1.22.10
+
+2026-01-05
+
+
+**🐛 Bug fix**
+
+- **@visactor/vtable**: fix prepareEdit logic occor some bug
+- **@visactor/vtable-plugins**: fix delete and backbase key cann't delete cells
+- **@visactor/vtable**: rose pivotchart show indicator title problem
+
+
+**🆕 New feature**
+
+- **@visactor/vtable-gantt**: feat: support distanceToTaskBar config
+
+
+
+[more detail about v1.22.10](https://github.com/VisActor/VTable/releases/tag/v1.22.10)
+
 # v1.22.9
 
 2025-12-28

docs/assets/changelog/zh/release.md

@@ -1,3 +1,23 @@
+# v1.22.10
+
+2026-01-05
+
+
+**🐛 功能修复**
+
+- **@visactor/vtable**: 修复 prepareEdit 逻辑造成的一些问题
+- **@visactor/vtable-plugins**: 修复del和backspace键不能删除单元格的问题
+- **@visactor/vtable**: 修复透视图非笛卡尔坐标系的图表类型中显示指标标题问题
+
+
+**🆕 新增功能**
+
+- **@visactor/vtable-gantt**: 甘特图依赖性支持自定义拐点距离taskbar的长度
+
+
+
+[更多详情请查看 v1.22.10](https://github.com/VisActor/VTable/releases/tag/v1.22.10)
+
 # v1.22.9
 
 2025-12-28

docs/assets/guide/en/data_analysis/pivot_table_dataAnalysis.md

@@ -84,14 +84,16 @@ dataConfig: {
           subTotalsDimensions: ['province'],
           grandTotalLabel: 'row total',
           subTotalLabel: 'Subtotal',
-          showGrandTotalsOnTop: true //totals show on top
+          showGrandTotalsOnTop: true, //totals show on top
+          showSubTotalsOnTreeNode: false // When subtotals are disabled in pivot tables, this option allows aggregated values to be displayed on collapsed tree nodes. Default value is false.
         },
         column: {
           showGrandTotals: true,
           showSubTotals: true,
           subTotalsDimensions: ['quarter'],
           grandTotalLabel: 'column total',
-          subTotalLabel: 'Subtotal'
+          subTotalLabel: 'Subtotal',
+          showSubTotalsOnTreeNode: false // When subtotals are disabled in pivot tables, this option allows aggregated values to be displayed on collapsed tree nodes. Default value is false.
         }
       }
     },
@@ -250,9 +252,10 @@ dataConfig:{
   }]
 }
 ```
-  In this data record, the sales indicator is a non-numeric value. If the product requirement is to directly display `"NULL"` in the table cell, then the aggregation rule can be set to `VTable.TYPES.AggregationType.NONE`, so that VTable's internal will not perform aggregation calculations, but directly take the `sales` field value as the display value of the cell.
 
-  2. AggregationType.RECORD usage scenario is mainly used to match all data based on the user's input data record and use it as the display data of the cell. Usage scenarios include: needing to collect data sets for mini-chart displays, specific demo see: https://visactor.io/vtable/demo/cell-type/pivot-sparkline
+In this data record, the sales indicator is a non-numeric value. If the product requirement is to directly display `"NULL"` in the table cell, then the aggregation rule can be set to `VTable.TYPES.AggregationType.NONE`, so that VTable's internal will not perform aggregation calculations, but directly take the `sales` field value as the display value of the cell.
+
+2. AggregationType.RECORD usage scenario is mainly used to match all data based on the user's input data record and use it as the display data of the cell. Usage scenarios include: needing to collect data sets for mini-chart displays, specific demo see: https://visactor.io/vtable/demo/cell-type/pivot-sparkline
 
 #### Custom Aggregation Type Introduction
 
@@ -313,7 +316,7 @@ const option={
         {
           indicatorKey: 'Average Product Price (Registered Aggregation Class)', //Indicator name
           field: 'sales', //Indicator based field
-          aggregationType: 'avgPrice', //Registered aggregation type 
+          aggregationType: 'avgPrice', //Registered aggregation type
         }
       ]
   }
@@ -323,6 +326,7 @@ const option={
 VTable's internal aggregation rules code address: https://github.com/VisActor/VTable/blob/develop/packages/vtable/src/ts-types/dataset/aggregation.ts, can be referred to!
 
 The methods that need to be implemented for the aggregation type are:
+
 - constructor: The constructor function, used to initialize the aggregator.
 - push: Add data records to the aggregator, used to calculate the aggregated value.
 - deleteRecord: Delete records from the aggregator and update the aggregated value, called by VTable's delete interface deleteRecords.
@@ -591,4 +595,4 @@ Interface definition:
  * @param isResetTree Whether to reset the table header tree structure. When true, the table header tree structure will be reset, when false, the table header tree structure will remain unchanged
  */
 updateFilterRules(filterRules: FilterRules, isResetTree: boolean = false) => void
-```
+```

docs/assets/guide/zh/data_analysis/pivot_table_dataAnalysis.md

@@ -84,14 +84,16 @@ dataConfig: {
           subTotalsDimensions: ['province'],
           grandTotalLabel: '行总计',
           subTotalLabel: '小计',
-          showGrandTotalsOnTop: true //汇总值显示在上
+          showGrandTotalsOnTop: true, //汇总值显示在上
+          showSubTotalsOnTreeNode: false // 当在透视表中禁用小计时，此选项允许在折叠的树节点上显示聚合值。默认值为 false
         },
         column: {
           showGrandTotals: true,
           showSubTotals: true,
           subTotalsDimensions: ['quarter'],
           grandTotalLabel: '列总计',
-          subTotalLabel: '小计'
+          subTotalLabel: '小计',
+          showSubTotalsOnTreeNode: false // 当在透视表中禁用小计时，此选项允许在折叠的树节点上显示聚合值。默认值为 false
         }
       }
     },
@@ -163,7 +165,7 @@ dataConfig: {
 
 通常情况下指标应该是 `number` 类型，这样内部才能进行计算。
 
-如果指标是字符串型或者 `null`，且需要在单元格中进行展示，可以配置 `aggregationType` 为 `VTable.TYPES.AggregationType.NONE` 来显示数据源字段的原始值; 或者在指标format函数中结合接口`getCellOriginRecord`获取到单元格对应的数据源条目，然后进行特殊处理。
+如果指标是字符串型或者 `null`，且需要在单元格中进行展示，可以配置 `aggregationType` 为 `VTable.TYPES.AggregationType.NONE` 来显示数据源字段的原始值; 或者在指标 format 函数中结合接口`getCellOriginRecord`获取到单元格对应的数据源条目，然后进行特殊处理。
 
 如果用到了自定义渲染 `customLayout`，在 `customLayout` 函数中想获取单元格对应的所有数据 `records`，可以配置 `aggregationType` 为 `VTable.TYPES.AggregationType.RECORD`。
 
@@ -218,7 +220,7 @@ dataConfig: {
         {
           indicatorKey: '商品均价（注册聚合类）', //指标名称
           field: 'sales', //指标依据字段
-          aggregationType: 'avgPrice', //自己注册的聚合类型 
+          aggregationType: 'avgPrice', //自己注册的聚合类型
         }
       ]
 }
@@ -252,7 +254,7 @@ dataConfig:{
 }
 ```
 
-  其中该条数据 record 中 sales 指标是个非数值型的值，如果产品需求要将`"NULL"`直接显示到表格单元格中，那么可以设置聚合规则为`VTable.TYPES.AggregationType.NONE`，这样 VTable 的内部不会进行聚合计算，而是直接取`sales`字段值作为单元格展示值。
+其中该条数据 record 中 sales 指标是个非数值型的值，如果产品需求要将`"NULL"`直接显示到表格单元格中，那么可以设置聚合规则为`VTable.TYPES.AggregationType.NONE`，这样 VTable 的内部不会进行聚合计算，而是直接取`sales`字段值作为单元格展示值。
 
 2. AggregationType.RECORD 使用场景主要用于根据用户传入数据 record 匹配到所有数据，将其作为单元格的展示数据，用法场景如：需要搜集数据集作为迷你图展示，具体 demo 见：https://visactor.io/vtable/demo/cell-type/pivot-sparkline
 
@@ -315,20 +317,21 @@ const option={
         {
           indicatorKey: '商品均价（注册聚合类）', //指标名称
           field: 'sales', //指标依据字段
-          aggregationType: 'avgPrice', //自己注册的聚合类型 
+          aggregationType: 'avgPrice', //自己注册的聚合类型
         }
       ]
   }
 }
 ```
 
-VTable内部的几种聚合规则代码地址：https://github.com/VisActor/VTable/blob/develop/packages/vtable/src/ts-types/dataset/aggregation.ts，可予以参考！
+VTable 内部的几种聚合规则代码地址：https://github.com/VisActor/VTable/blob/develop/packages/vtable/src/ts-types/dataset/aggregation.ts，可予以参考！
 
 其中聚合类型需要实现的几个方法分别为：
+
 - constructor：构造函数，用于初始化聚合器。
 - push：将数据记录添加到聚合器中，用于计算聚合值。
-- deleteRecord：从聚合器中删除记录，并更新聚合值，调用vtable的删除接口deleteRecords会调用该接口。
-- updateRecord：更新数据记录，并更新聚合值，调用接口updateRecords会调用该接口。
+- deleteRecord：从聚合器中删除记录，并更新聚合值，调用 vtable 的删除接口 deleteRecords 会调用该接口。
+- updateRecord：更新数据记录，并更新聚合值，调用接口 updateRecords 会调用该接口。
 - recalculate：重新计算聚合值，目前复制粘贴单元格值会调用该方法。
 - value：获取聚合值。
 - reset：重置聚合器。
@@ -593,4 +596,4 @@ VTable 官网示例：https://visactor.io/vtable/demo/table-type/pivot-table.
  * @param isResetTree 是否重置表头树结构。 当为true时，会重置表头树结构，当为false时，表头树结构维持不变
  */
 updateFilterRules(filterRules: FilterRules, isResetTree: boolean = false) => void
-```
+```

docs/assets/option/en/table/pivotTable.md

@@ -229,6 +229,8 @@ export interface Total {
   grandTotalLabel?: string;
   //Default 'Subtotal'
   subTotalLabel?: string;
+  // When subtotals are disabled in pivot tables, this option allows aggregated values to be displayed on collapsed tree nodes. Default value is false.
+  showSubTotalsOnTreeNode?: boolean;
 }
 ```
 
@@ -268,6 +270,7 @@ export interface CalculatedFieldRule {
   calculateFun?: (dependFieldsValue: any) => any;
 }
 ```
+
 ### updateAggregationOnEditCell (boolean)
 
 Whether to update total and subtotal after editing cell value. Default value is false.
@@ -460,4 +463,5 @@ columnWidthConfigForRowHeader": [
     }
   ]
 ```
-Matching key is the key of the row dimension: dimensionKey。
+
+Matching key is the key of the row dimension: dimensionKey。

docs/assets/option/zh/table/pivotTable.md

@@ -233,6 +233,8 @@ export interface Total {
   grandTotalLabel?: string;
   // 默认'小计'
   subTotalLabel?: string;
+  // 当在透视表中禁用小计时，此选项允许在折叠的树节点上显示聚合值。默认值为 false
+  showSubTotalsOnTreeNode?: boolean;
 }
 ```
 
@@ -272,9 +274,10 @@ export interface CalculateddFieldRule {
   calculateFun?: (dependFieldsValue: any) => any;
 }
 ```
+
 ### updateAggregationOnEditCell (boolean)
 
-是否在修改单元格后更新小计和总计。默认值为false.
+是否在修改单元格后更新小计和总计。默认值为 false.
 
 具体情况请参考[demo](../demo/data-analysis/pivot-analysis-updateTotalData)
 
@@ -450,6 +453,7 @@ export interface IIndicatorHeaderNode {
 ## columnWidthConfigForRowHeader(Array)
 
 依据行维度信息设置行表头列宽, 设置示例：
+
 ```
 columnWidthConfigForRowHeader": [
     {
@@ -463,5 +467,5 @@ columnWidthConfigForRowHeader": [
     }
   ]
 ```
-匹配关键是行维度的key：dimensionKey。
 
+匹配关键是行维度的 key：dimensionKey。