VisActor · fangsmile · Mar 12, 2025 · Mar 11, 2025 · Mar 12, 2025 · Mar 12, 2025
diff --git a/docs/assets/api/en/methods.md b/docs/assets/api/en/methods.md
@@ -1587,9 +1587,29 @@ setCanvasSize: (width: number, height: number) => void;
 
 ## setLoadingHierarchyState(Function)
 
-Set the loading state of the tree expansion and collapse of the cell
-
-```
+Set the loading state of the tree expansion and collapse of the cell, Note that you need to manually register the loading icon before using it.
+
+```
+
+// Register the loading icon
+VTable.register.icon('loading', {
+type: 'image',
+width: 16,
+height: 16,
+src: 'https://lf9-dp-fe-cms-tos.byteorg.com/obj/bit-cloud/VTable/media/loading-circle.gif',
+name: 'loading', // Define the name of the icon, which will be used as the key value for caching in the internal cache
+positionType: VTable.TYPES.IconPosition.absoluteRight, // Specify the position, which can be before or after the text, or left or right of the cell
+marginLeft: 0, // The left content interval in the specific position
+marginRight: 4, // The right content interval in the specific position
+visibleTime: 'always', // The display time, 'always' | 'mouseover_cell' | 'click_cell'
+hover: {
+// The size of the hot area
+width: 22,
+height: 22,
+bgColor: 'rgba(101,117,168,0.1)'
+},
+isGif: true
+});
 
 /\*_ Set the loading state of the tree expansion and collapse of the cell _/
 setLoadingHierarchyState: (col: number, row: number) => void;

diff --git a/docs/assets/api/zh/methods.md b/docs/assets/api/zh/methods.md
@@ -1397,11 +1397,31 @@ interface ISortedMapItem {
 
 ## setLoadingHierarchyState(Function)
 
-设置单元格的树形展开收起状态为 loading
-
-```
-  /** 设置单元格的树形展开收起状态为 loading */
-  setLoadingHierarchyState: (col: number, row: number) => void;
+设置单元格的树形展开收起状态为 loading，注意在使用前需要手动注册 loading 图标。
+
+```
+// 注册loading图标
+VTable.register.icon('loading', {
+  type: 'image',
+  width: 16,
+  height: 16,
+  src: 'https://lf9-dp-fe-cms-tos.byteorg.com/obj/bit-cloud/VTable/media/loading-circle.gif',
+  name: 'loading', //定义图标的名称，在内部会作为缓存的key值
+  positionType: VTable.TYPES.IconPosition.absoluteRight, // 指定位置，可以在文本的前后，或者在绝对定位在单元格的左侧右侧
+  marginLeft: 0, // 左侧内容间隔 在特定位置position中起作用
+  marginRight: 4, // 右侧内容间隔 在特定位置position中起作用
+  visibleTime: 'always', // 显示时机， 'always' | 'mouseover_cell' | 'click_cell'
+  hover: {
+    // 热区大小
+    width: 22,
+    height: 22,
+    bgColor: 'rgba(101,117,168,0.1)'
+  },
+  isGif: true
+});
+
+/** 设置单元格的树形展开收起状态为 loading */
+setLoadingHierarchyState: (col: number, row: number) => void;
 ```
 
 ## setPixelRatio(Function)

diff --git a/docs/assets/changelog/en/release.md b/docs/assets/changelog/en/release.md
@@ -1,3 +1,15 @@
+# v1.17.2
+
+2025-03-11
+
+
+**🐛 Bug fix**
+
+- **@visactor/vue-vtable**: custom container value error
+
+
+[more detail about v1.17.2](https://github.com/VisActor/VTable/releases/tag/v1.17.2)
+
 # v1.17.1
 
 2025-03-10

diff --git a/docs/assets/changelog/zh/release.md b/docs/assets/changelog/zh/release.md
@@ -1,8 +1,17 @@
+# v1.17.2
+
+2025-03-11
+
+**🐛 功能修复**
+
+- **@visactor/vue-vtable**: 修复 custom container value 问题
+
+[更多详情请查看 v1.17.2](https://github.com/VisActor/VTable/releases/tag/v1.17.2)
+
 # v1.17.1
 
 2025-03-10
 
-
 **🆕 新增功能**
 
 - **@visactor/vtable**: 透视表新增 setLoadingHierarchyState API [#3469](https://github.com/VisActor/VTable/issues/3469)
@@ -26,17 +35,15 @@
 
 2025-02-26
 
-
-
 **💥 Breaking change**
 
-- **@visactor/vtable**: 删除loading加载图标的自动注册，需要手动注册，具体可以参考教程：/guide/table_type/List_table/tree_list
+- **@visactor/vtable**: 删除 loading 加载图标的自动注册，需要手动注册，具体可以参考教程：/guide/table_type/List_table/tree_list
 
 **🆕 新增功能**
 
-- **@visactor/vtable-gantt**: 甘特图scale时间表头支持可见性设置 [#3098](https://github.com/VisActor/VTable/issues/3098)
+- **@visactor/vtable-gantt**: 甘特图 scale 时间表头支持可见性设置 [#3098](https://github.com/VisActor/VTable/issues/3098)
 - **@visactor/vtable**: 下拉菜单支持函数配置 [#3443](https://github.com/VisActor/VTable/issues/3443)
-- **@visactor/vtable-gantt**: 新增grid网格垂直线依赖于时间轴的配置 [#3467](https://github.com/VisActor/VTable/issues/3467)
+- **@visactor/vtable-gantt**: 新增 grid 网格垂直线依赖于时间轴的配置 [#3467](https://github.com/VisActor/VTable/issues/3467)
 - **@visactor/vtable**: 新增 activateChartInstance 和 replaceChartCacheImage API
 - **@visactor/vtable**: 新增 `specTransformInCell` 配置，支持修改透视表每个单元格的 VChart 规范
 - **@visactor/vtable**: 新增开关和按钮类型单元格
@@ -54,24 +61,19 @@
 
 - **@visactor/vtable**: 更新 Rush 的更新日志
 
-
-
 [更多详情请查看 v1.17.0](https://github.com/VisActor/VTable/releases/tag/v1.17.0)
 
 # v1.16.2
 
 2025-02-19
 
-
 **🐛 功能修复**
 
 - **@visactor/vtable**: 修复字段名包含点号时出现的错误 [#3409](https://github.com/VisActor/VTable/issues/3409)
 - **@visactor/vtable**: 修复 getChartInstance 方法中 vchart updateViewBox 的参数 [#3442](https://github.com/VisActor/VTable/issues/3442)
-- **@visactor/vtable**: 修复 computeAxisComponentWidth 的返回值向上取整 [#3444](https://github.com/VisActor/VTable/issues/3444) 
+- **@visactor/vtable**: 修复 computeAxisComponentWidth 的返回值向上取整 [#3444](https://github.com/VisActor/VTable/issues/3444)
 - **@visactor/vtable**: 修复 getCheckboxState() 中的排序函数 [#3394](https://github.com/VisActor/VTable/issues/3394)
 
-
-
 [更多详情请查看 v1.16.2](https://github.com/VisActor/VTable/releases/tag/v1.16.2)
 
 # v1.16.1