Merge pull request #5009 from VisActor/release/1.23.2

[Auto release] release 1.23.2

Author: fangsmile

common/config/rush/version-policies.json

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

docs/assets/api/en/icon/base-icon.md

@@ -65,6 +65,8 @@ enum IconFuncTypeEnum {
   dropDownState = 'dropDownState',
   play = 'play',
   damagePic = 'damagePic',
+  imageDamagePic = 'imageDamagePic',
+  videoDamagePic = 'videoDamagePic',
   expand = 'expand',
   collapse = 'collapse',
   drillDown = 'drillDown',

docs/assets/api/zh/icon/base-icon.md

@@ -65,6 +65,8 @@ enum IconFuncTypeEnum {
   dropDownState = 'dropDownState',
   play = 'play',
   damagePic = 'damagePic',
+  imageDamagePic = 'imageDamagePic',
+  videoDamagePic = 'videoDamagePic',
   expand = 'expand',
   collapse = 'collapse',
   drillDown = 'drillDown',

docs/assets/changelog/en/release.md

@@ -1,25 +1,55 @@
+# v1.23.1
+
+2026-02-05
+
+
+**🆕 New feature**
+
+- **@visactor/vtable**: add componentLayoutOrder api [#4965](https://github.com/VisActor/VTable/issues/4965)
+- **@visactor/vtable**: optimize search latency
+- **@visactor/vtable**: add batch update cell value api and optimize filter state data sync
+- **@visactor/vtable**: add syncRecordOperationsToSourceRecords option to support sync operations to source data
+- **@visactor/vtable-sheet**: add updateOption api and optimize formula calculation
+- **@visactor/vtable-sheet**: add editable option to support edit cell
+
+**🐛 Bug fix**
+
+- **@visactor/vtable**: fix prepareEdit occor error [#4871](https://github.com/VisActor/VTable/issues/4871)
+- **@visactor/vtable**: updateOption run resize logic [#4965](https://github.com/VisActor/VTable/issues/4965)
+- **@visactor/vtable**: fix add record position error in filter state
+- **@visactor/vtable**: handle escape option correctly for CSV export
+- **@visactor/vtable**: set white background for media overlay image
+
+**🔨 Refactor**
+
+- **@visactor/vtable**: legend and title component position calculation logic [#4965](https://github.com/VisActor/VTable/issues/4965)
+
+
+
+[more detail about v1.23.1](https://github.com/VisActor/VTable/releases/tag/v1.23.1)
+
 # v1.23.0
 
 2026-01-29
 
 
 **🆕 New feature**
-
-- **@visactor/vtable-sheet**: add event system for vtable sheet [#4861](https://github.com/VisActor/VTable/issues/4861)
+
+- **@visactor/vtable-sheet**: add event system for vtable sheet [#4861](https://github.com/VisActor/VTable/issues/4861)
 
 **🐛 Bug fix**
-
-- **@visactor/vtable**: when dimension value is empty string should different from no dimension value [#4935](https://github.com/VisActor/VTable/issues/4935)
-- **@visactor/vtable**: when no columnTree to adjust columnWidthConfig [#4935](https://github.com/VisActor/VTable/issues/4935)
-- **@visactor/vtable**: change dimension value to recalculate totalTree [#4953](https://github.com/VisActor/VTable/issues/4953)
-- **@visactor/vtable**: when change dimenison value should update cached changedTree value
-- **@visactor/vtable**: to update formula after add records
-- **@visactor/vtable**: react type define
+
+- **@visactor/vtable**: when dimension value is empty string should different from no dimension value [#4935](https://github.com/VisActor/VTable/issues/4935)
+- **@visactor/vtable**: when no columnTree to adjust columnWidthConfig [#4935](https://github.com/VisActor/VTable/issues/4935)
+- **@visactor/vtable**: change dimension value to recalculate totalTree [#4953](https://github.com/VisActor/VTable/issues/4953)
+- **@visactor/vtable**: when change dimenison value should update cached changedTree value
+- **@visactor/vtable**: to update formula after add records
+- **@visactor/vtable**: react type define
 
 **🔨 Refactor**
-
-- **@visactor/vtable**: pivotTable have to distinguishing no dimension and dimension value is null character string
-
+
+- **@visactor/vtable**: pivotTable have to distinguishing no dimension and dimension value is null character string
+
 
 
 [more detail about v1.23.0](https://github.com/VisActor/VTable/releases/tag/v1.23.0)

docs/assets/changelog/zh/release.md

@@ -1,3 +1,34 @@
+# v1.23.1
+
+2026-02-05
+
+
+**🆕 新增功能**
+
+- **@visactor/vtable**: 新增 componentLayoutOrder 接口 [#4965](https://github.com/VisActor/VTable/issues/4965)
+- **@visactor/vtable**: 优化搜索性能
+- **@visactor/vtable**: 新增基于记录索引的单元格值修改方法及优化范围删除性能
+- **@visactor/vtable**: 新增 syncRecordOperationsToSourceRecords 选项支持同步操作到源数据
+- **@visactor/vtable**: 新增批量修改单元格值接口及优化筛选态数据同步
+- **@visactor/vtable-sheet**: 新增 updateOption 接口 及优化公式计算
+- **@visactor/vtable-sheet**: 新增 editable 选项支持编辑单元格
+
+**🐛 功能修复**
+
+- **@visactor/vtable**: 修复 prepareEdit 方法执行错误问题 [#4871](https://github.com/VisActor/VTable/issues/4871)
+- **@visactor/vtable**: 修复 updateOption 方法执行时触发 resize 逻辑问题 [#4965](https://github.com/VisActor/VTable/issues/4965)
+- **@visactor/vtable**: 修复过滤状态下新增记录位置错误问题
+- **@visactor/vtable**: 修复 CSV 导出时 escape 选项处理错误问题
+- **@visactor/vtable**: 修复媒体覆盖图片背景设置为白色问题
+
+**🔨 功能重构**
+
+- **@visactor/vtable**: 优化图例和标题组件位置计算逻辑 [#4965](https://github.com/VisActor/VTable/issues/4965)
+
+
+
+[更多详情请查看 v1.23.1](https://github.com/VisActor/VTable/releases/tag/v1.23.1)
+
 # v1.23.0
 
 2026-01-29

docs/assets/demo/en/gantt/gantt-datazoom.md

@@ -891,10 +891,27 @@ function createZoomControls(ganttInstance) {
 
       radio.onchange = () => {
         if (radio.checked) {
-          // Switch to middle state of corresponding level
+          // 🎯 Zoom with view center as anchor point
+          // 1. Get the time point corresponding to the current view center
+          const scrollLeft = ganttInstance.stateManager.scrollLeft;
+          const viewportWidth = ganttInstance.tableNoFrameWidth;
+          const centerScrollPos = scrollLeft + viewportWidth / 2;
+          
+          const currentMsPerPixel = ganttInstance.getCurrentMillisecondsPerPixel();
+          const centerTime = ganttInstance.parsedOptions._minDateTime + centerScrollPos * currentMsPerPixel;
+          
+          // 2. Switch to corresponding level
           ganttInstance.zoomScaleManager?.setZoomPosition({
             levelNum: index
           });
+          
+          // 3. Adjust scroll position to keep center time point at view center
+          const newMsPerPixel = ganttInstance.getCurrentMillisecondsPerPixel();
+          const newCenterScrollPos = (centerTime - ganttInstance.parsedOptions._minDateTime) / newMsPerPixel;
+          const newScrollLeft = newCenterScrollPos - viewportWidth / 2;
+          
+          ganttInstance.stateManager.setScrollLeft(Math.max(0, newScrollLeft));
+          
           updateStatusDisplay();
         }
       };

docs/assets/demo/en/gantt/gantt-zoom.md

@@ -911,10 +911,27 @@ function createZoomControls(ganttInstance) {
 
       radio.onchange = () => {
         if (radio.checked) {
-          // Switch to the middle state of the corresponding level
+          // 🎯 Zoom with view center as anchor point
+          // 1. Get the time point corresponding to the current view center
+          const scrollLeft = ganttInstance.stateManager.scrollLeft;
+          const viewportWidth = ganttInstance.tableNoFrameWidth;
+          const centerScrollPos = scrollLeft + viewportWidth / 2;
+          
+          const currentMsPerPixel = ganttInstance.getCurrentMillisecondsPerPixel();
+          const centerTime = ganttInstance.parsedOptions._minDateTime + centerScrollPos * currentMsPerPixel;
+          
+          // 2. Switch to corresponding level
           ganttInstance.zoomScaleManager?.setZoomPosition({
             levelNum: index
           });
+          
+          // 3. Adjust scroll position to keep center time point at view center
+          const newMsPerPixel = ganttInstance.getCurrentMillisecondsPerPixel();
+          const newCenterScrollPos = (centerTime - ganttInstance.parsedOptions._minDateTime) / newMsPerPixel;
+          const newScrollLeft = newCenterScrollPos - viewportWidth / 2;
+          
+          ganttInstance.stateManager.setScrollLeft(Math.max(0, newScrollLeft));
+          
           updateStatusDisplay();
         }
       };

docs/assets/demo/zh/gantt/gantt-datazoom.md

@@ -892,10 +892,27 @@ function createZoomControls(ganttInstance) {
 
       radio.onchange = () => {
         if (radio.checked) {
-          // 切换到对应级别的中间状态
+          // 🎯 以视图中心为缩放中心
+          // 1. 获取当前视图中心对应的时间点
+          const scrollLeft = ganttInstance.stateManager.scrollLeft;
+          const viewportWidth = ganttInstance.tableNoFrameWidth;
+          const centerScrollPos = scrollLeft + viewportWidth / 2;
+          
+          const currentMsPerPixel = ganttInstance.getCurrentMillisecondsPerPixel();
+          const centerTime = ganttInstance.parsedOptions._minDateTime + centerScrollPos * currentMsPerPixel;
+          
+          // 2. 切换到对应级别
           ganttInstance.zoomScaleManager?.setZoomPosition({
             levelNum: index
           });
+          
+          // 3. 调整滚动位置，使中心时间点保持在视图中心
+          const newMsPerPixel = ganttInstance.getCurrentMillisecondsPerPixel();
+          const newCenterScrollPos = (centerTime - ganttInstance.parsedOptions._minDateTime) / newMsPerPixel;
+          const newScrollLeft = newCenterScrollPos - viewportWidth / 2;
+          
+          ganttInstance.stateManager.setScrollLeft(Math.max(0, newScrollLeft));
+          
           updateStatusDisplay();
         }
       };

docs/assets/demo/zh/gantt/gantt-zoom.md

@@ -882,10 +882,27 @@ function createZoomControls(ganttInstance) {
 
       radio.onchange = () => {
         if (radio.checked) {
-          // 切换到对应级别的中间状态
+          // 🎯 以视图中心为缩放中心
+          // 1. 获取当前视图中心对应的时间点
+          const scrollLeft = ganttInstance.stateManager.scrollLeft;
+          const viewportWidth = ganttInstance.tableNoFrameWidth;
+          const centerScrollPos = scrollLeft + viewportWidth / 2;
+          
+          const currentMsPerPixel = ganttInstance.getCurrentMillisecondsPerPixel();
+          const centerTime = ganttInstance.parsedOptions._minDateTime + centerScrollPos * currentMsPerPixel;
+          
+          // 2. 切换到对应级别
           ganttInstance.zoomScaleManager?.setZoomPosition({
             levelNum: index
           });
+          
+          // 3. 调整滚动位置，使中心时间点保持在视图中心
+          const newMsPerPixel = ganttInstance.getCurrentMillisecondsPerPixel();
+          const newCenterScrollPos = (centerTime - ganttInstance.parsedOptions._minDateTime) / newMsPerPixel;
+          const newScrollLeft = newCenterScrollPos - viewportWidth / 2;
+          
+          ganttInstance.stateManager.setScrollLeft(Math.max(0, newScrollLeft));
+          
           updateStatusDisplay();
         }
       };

docs/assets/guide/en/cell_type/cellType.md

@@ -254,6 +254,8 @@ The following shows an example of `cellType: ()=>{}`: (Please refer to [Example]
   }
 ```
 
+The headerType in the rows and columns of the pivot table, and the cellType in the indicators also support the function form.
+
 ## Extension: Custom Column Types (TypeScript)
 
 In real-world applications, in addition to VTable’s built-in `cellType` values (such as `text`, `link`, `image`, `video`, `progressbar`, `sparkline`, and `chart`), it is often necessary to attach **business-specific configurations** to column definitions, for example: