stk-table-vue 0.6.0 → 0.6.2

package/README.md

@@ -295,12 +295,12 @@ export type StkProps = {
    * 低版本浏览器只能为'relative', 
    */
   cellFixedMode?: 'sticky' | 'relative';
-   /**
-     * 是否平滑滚动
-     * - default: chrome < 85 ? true : false
-     * - false: 使用 wheel 事件滚动。为了防止滚动过快导致白屏。
-     * - true: 不使用 wheel 事件滚动。滚轮滚动时更加平滑。滚动过快时会白屏。
-     */
+  /**
+   * 是否平滑滚动
+   * - default: chrome < 85 ? true : false
+   * - false: 使用 wheel 事件滚动。为了防止滚动过快导致白屏。
+   * - true: 不使用 wheel 事件滚动。滚轮滚动时更加平滑。滚动过快时会白屏。
+   */
   smoothScroll?: boolean;
 };
 ```
@@ -398,11 +398,11 @@ export type StkProps = {
      * ```(dragStartKey: string, targetRowKey: string)```
      */
     (e: 'row-order-change', dragStartKey: string, targetRowKey: string): void;
-     /**
+    /**
      * 列宽变动时触发
      */
     (e: 'col-resize', cols: StkTableColumn<DT>): void;
-     /**
+    /**
      * 展开行触发
      * ```( data: { expanded: boolean; row: DT; col: StkTableColumn<DT> })```
      */

package/lib/src/StkTable/StkTable.vue.d.ts

@@ -185,37 +185,116 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<{
      */
     smoothScroll?: boolean | undefined;
 }, {
-    /** @see {@link initVirtualScroll} */
+    /**
+     * 重新计算虚拟列表宽高
+     *
+     * en: calc virtual scroll x & y info
+     * @see {@link initVirtualScroll}
+     */
     initVirtualScroll: (height?: number | undefined) => void;
-    /** @see {@link initVirtualScrollX} */
+    /**
+     * 重新计算虚拟列表宽度
+     *
+     * en: calc virtual scroll x
+     * @see {@link initVirtualScrollX}
+     */
     initVirtualScrollX: () => void;
-    /** @see {@link initVirtualScrollY} */
+    /**
+     * 重新计算虚拟列表高度
+     *
+     * en: calc virtual scroll y
+     * @see {@link initVirtualScrollY}
+     */
     initVirtualScrollY: (height?: number | undefined) => void;
-    /** @see {@link setCurrentRow} */
+    /**
+     * 选中一行
+     *
+     * en：select a row
+     * @see {@link setCurrentRow}
+     */
     setCurrentRow: typeof setCurrentRow;
-    /** @see {@link setSelectedCell} */
+    /**
+     * 取消选中单元格
+     *
+     * en: set highlight active cell (props.cellActive=true)
+     * @see {@link setSelectedCell}
+     */
     setSelectedCell: typeof setSelectedCell;
-    /** @see {@link setHighlightDimCell} */
+    /**
+     * 设置高亮单元格
+     *
+     * en: Set highlight cell
+     * @see {@link setHighlightDimCell}
+     */
     setHighlightDimCell: (rowKeyValue: import('./types/index').UniqKey, dataIndex: string, option?: import('./types/highlightDimOptions').HighlightDimCellOption) => void;
-    /** @see {@link setHighlightDimRow} */
+    /**
+     * 设置高亮行
+     *
+     * en: Set highlight row
+     * @see {@link setHighlightDimRow}
+     */
     setHighlightDimRow: (rowKeyValues: import('./types/index').UniqKey[], option?: import('./types/highlightDimOptions').HighlightDimRowOption) => void;
-    /** 表格排序列dataIndex */
+    /**
+     * 表格排序列dataIndex
+     *
+     * en: Table sort column dataIndex
+     */
     sortCol: import('vue').Ref<string | number | symbol | undefined, string | number | symbol | undefined>;
-    /** @see {@link getSortColumns} */
+    /**
+     * 表格排序列顺序
+     *
+     * en: get current sort info
+     * @see {@link getSortColumns}
+     */
     getSortColumns: typeof getSortColumns;
-    /** @see {@link setSorter} */
+    /**
+     * 设置表头排序状态
+     *
+     * en: Set the sort status of the table header
+     * @see {@link setSorter}
+     */
     setSorter: typeof setSorter;
-    /** @see {@link resetSorter} */
+    /**
+     * 重置sorter状态
+     *
+     * en: Reset the sorter status
+     * @see {@link resetSorter}
+     */
     resetSorter: typeof resetSorter;
-    /** @see {@link scrollTo} */
+    /**
+     * 滚动至
+     *
+     * en: Scroll to
+     * @see {@link scrollTo}
+     */
     scrollTo: typeof scrollTo;
-    /** @see {@link getTableData} */
+    /**
+     * 获取表格数据
+     *
+     * en: Get table data
+     * @see {@link getTableData}
+     */
     getTableData: typeof getTableData;
-    /** @see {@link setRowExpand} */
+    /**
+     * 设置展开的行
+     *
+     * en: Set expanded rows
+     * @see {@link setRowExpand}
+     */
     setRowExpand: typeof setRowExpand;
-    /** @see {@link setAutoHeight} */
+    /**
+     * 不定行高时，如果行高有变化，则调用此方法更新行高。
+     *
+     * en: When the row height is not fixed, call this method to update the row height if the row height changes.
+     * @see {@link setAutoHeight}
+     */
     setAutoHeight: (rowKey: import('./types/index').UniqKey, height?: number | null | undefined) => void;
-    /** @see {@link clearAllAutoHeight} */
+    /**
+     * 清除所有行高
+     *
+     * en: Clear all row heights
+     * @see {@link clearAllAutoHeight}
+     */
     clearAllAutoHeight: () => void;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     [x: string]: any;

package/lib/src/StkTable/useThDrag.d.ts

@@ -14,6 +14,6 @@ export declare function useThDrag<DT extends Record<string, any>>({ props, emits
     onThDragOver: (e: DragEvent) => void;
     onThDrop: (e: DragEvent) => void;
     /** 是否可拖拽 */
-    isHeaderDraggable: any;
+    isHeaderDraggable: (col: StkTableColumn<DT>) => boolean;
 };
 export {};

package/lib/stk-table-vue.js

@@ -879,7 +879,7 @@ function useThDrag({ props, emits, colKeyGen }) {
     return {
       draggable,
       mode: "insert",
-      disabled: () => !draggable,
+      disabled: () => false,
       ...headerDrag
     };
   });
@@ -939,7 +939,7 @@ function useThDrag({ props, emits, colKeyGen }) {
     onThDragOver,
     onThDrop,
     /** 是否可拖拽 */
-    isHeaderDraggable: dragConfig.value.disabled
+    isHeaderDraggable: (col) => !dragConfig.value.disabled(col)
   };
 }
 const TR_DRAGGING_CLASS = "tr-dragging";
@@ -1675,7 +1675,9 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       return col.title || "";
     }
     function onColumnSort(col, click = true, options = {}) {
-      if (!(col == null ? void 0 : col.sorter)) return;
+      if (!(col == null ? void 0 : col.sorter) && click) {
+        return;
+      }
       options = { force: false, emit: false, ...options };
       if (sortCol.value !== col.dataIndex) {
         sortCol.value = col.dataIndex;
@@ -1887,7 +1889,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       if (!sortOrder) return [];
       return [{ dataIndex: sortCol.value, order: sortOrder }];
     }
-    function toggleExpandRow(row, col, expand) {
+    function toggleExpandRow(row, col) {
       const isExpand = (row == null ? void 0 : row.__EXPANDED__) === col ? !(row == null ? void 0 : row.__EXPANDED__) : true;
       setRowExpand(row, isExpand, { col });
     }
@@ -1933,37 +1935,116 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       }
     }
     __expose({
-      /** @see {@link initVirtualScroll} */
+      /**
+       * 重新计算虚拟列表宽高
+       *
+       * en: calc virtual scroll x & y info
+       * @see {@link initVirtualScroll}
+       */
       initVirtualScroll,
-      /** @see {@link initVirtualScrollX} */
+      /**
+       * 重新计算虚拟列表宽度
+       *
+       * en: calc virtual scroll x
+       * @see {@link initVirtualScrollX}
+       */
       initVirtualScrollX,
-      /** @see {@link initVirtualScrollY} */
+      /**
+       * 重新计算虚拟列表高度
+       *
+       * en: calc virtual scroll y
+       * @see {@link initVirtualScrollY}
+       */
       initVirtualScrollY,
-      /** @see {@link setCurrentRow} */
+      /**
+       * 选中一行
+       *
+       * en：select a row
+       * @see {@link setCurrentRow}
+       */
       setCurrentRow,
-      /** @see {@link setSelectedCell} */
+      /**
+       * 取消选中单元格
+       *
+       * en: set highlight active cell (props.cellActive=true)
+       * @see {@link setSelectedCell}
+       */
       setSelectedCell,
-      /** @see {@link setHighlightDimCell} */
+      /**
+       * 设置高亮单元格
+       *
+       * en: Set highlight cell
+       * @see {@link setHighlightDimCell}
+       */
       setHighlightDimCell,
-      /** @see {@link setHighlightDimRow} */
+      /**
+       * 设置高亮行
+       *
+       * en: Set highlight row
+       * @see {@link setHighlightDimRow}
+       */
       setHighlightDimRow,
-      /** 表格排序列dataIndex */
+      /**
+       * 表格排序列dataIndex
+       *
+       * en: Table sort column dataIndex
+       */
       sortCol,
-      /** @see {@link getSortColumns} */
+      /**
+       * 表格排序列顺序
+       *
+       * en: get current sort info
+       * @see {@link getSortColumns}
+       */
       getSortColumns,
-      /** @see {@link setSorter} */
+      /**
+       * 设置表头排序状态
+       *
+       * en: Set the sort status of the table header
+       * @see {@link setSorter}
+       */
       setSorter,
-      /** @see {@link resetSorter} */
+      /**
+       * 重置sorter状态
+       *
+       * en: Reset the sorter status
+       * @see {@link resetSorter}
+       */
       resetSorter,
-      /** @see {@link scrollTo} */
+      /**
+       * 滚动至
+       *
+       * en: Scroll to
+       * @see {@link scrollTo}
+       */
       scrollTo,
-      /** @see {@link getTableData} */
+      /**
+       * 获取表格数据
+       *
+       * en: Get table data
+       * @see {@link getTableData}
+       */
       getTableData,
-      /** @see {@link setRowExpand} */
+      /**
+       * 设置展开的行
+       *
+       * en: Set expanded rows
+       * @see {@link setRowExpand}
+       */
       setRowExpand,
-      /** @see {@link setAutoHeight} */
+      /**
+       * 不定行高时，如果行高有变化，则调用此方法更新行高。
+       *
+       * en: When the row height is not fixed, call this method to update the row height if the row height changes.
+       * @see {@link setAutoHeight}
+       */
       setAutoHeight,
-      /** @see {@link clearAllAutoHeight} */
+      /**
+       * 清除所有行高
+       *
+       * en: Clear all row heights
+       * @see {@link clearAllAutoHeight}
+       */
       clearAllAutoHeight
     });
     return (_ctx, _cache) => {

package/package.json

@@ -1,65 +1,65 @@
-{
-    "name": "stk-table-vue",
-    "version": "0.6.0",
-    "description": "Simple realtime virtual table for vue3 and vue2.7",
-    "main": "./lib/stk-table-vue.js",
-    "types": "./lib/src/StkTable/index.d.ts",
-    "packageManager": "pnpm@8.14.3",
-    "directories": {
-        "test": "test"
-    },
-    "type": "module",
-    "scripts": {
-        "dev": "vite",
-        "build": "vite build",
-        "test": "vitest"
-    },
-    "keywords": [
-        "virtual table",
-        "vue",
-        "vue2",
-        "vue3",
-        "highlight",
-        "sticky",
-        "virtual",
-        "table",
-        "list"
-    ],
-    "files": [
-        "lib",
-        "src"
-    ],
-    "author": "japlus",
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/ja-plus/stk-table-vue"
-    },
-    "license": "MIT",
-    "devDependencies": {
-        "@types/d3-interpolate": "^3.0.4",
-        "@types/node": "^20.12.10",
-        "@typescript-eslint/eslint-plugin": "^7.7.0",
-        "@typescript-eslint/parser": "^7.7.0",
-        "@vitejs/plugin-vue": "^5.1.4",
-        "@vue/test-utils": "2.4.4",
-        "eslint": "^8.57.0",
-        "eslint-config-prettier": "^9.1.0",
-        "eslint-plugin-html": "^8.1.0",
-        "eslint-plugin-prettier": "^5.1.3",
-        "eslint-plugin-vue": "^9.25.0",
-        "happy-dom": "^12.10.3",
-        "less": "^4.2.0",
-        "postcss-discard-comments": "^6.0.2",
-        "postcss-preset-env": "^9.5.11",
-        "prettier": "^3.2.5",
-        "typescript": "^5.4.5",
-        "vite": "^5.4.10",
-        "vite-plugin-dts": "^4.3.0",
-        "vitest": "^2.1.3",
-        "vue": "^3.5.12",
-        "vue-eslint-parser": "^9.4.2"
-    },
-    "dependencies": {
-        "d3-interpolate": "^3.0.1"
-    }
+{
+    "name": "stk-table-vue",
+    "version": "0.6.2",
+    "description": "Simple realtime virtual table for vue3 and vue2.7",
+    "main": "./lib/stk-table-vue.js",
+    "types": "./lib/src/StkTable/index.d.ts",
+    "packageManager": "pnpm@8.14.3",
+    "directories": {
+        "test": "test"
+    },
+    "type": "module",
+    "scripts": {
+        "dev": "vite",
+        "build": "vite build",
+        "test": "vitest"
+    },
+    "keywords": [
+        "virtual table",
+        "vue",
+        "vue2",
+        "vue3",
+        "highlight",
+        "sticky",
+        "virtual",
+        "table",
+        "list"
+    ],
+    "files": [
+        "lib",
+        "src"
+    ],
+    "author": "japlus",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/ja-plus/stk-table-vue"
+    },
+    "license": "MIT",
+    "devDependencies": {
+        "@types/d3-interpolate": "^3.0.4",
+        "@types/node": "^20.12.10",
+        "@typescript-eslint/eslint-plugin": "^7.7.0",
+        "@typescript-eslint/parser": "^7.7.0",
+        "@vitejs/plugin-vue": "^5.1.4",
+        "@vue/test-utils": "2.4.4",
+        "eslint": "^8.57.0",
+        "eslint-config-prettier": "^9.1.0",
+        "eslint-plugin-html": "^8.1.0",
+        "eslint-plugin-prettier": "^5.1.3",
+        "eslint-plugin-vue": "^9.25.0",
+        "happy-dom": "^12.10.3",
+        "less": "^4.2.0",
+        "postcss-discard-comments": "^6.0.2",
+        "postcss-preset-env": "^9.5.11",
+        "prettier": "^3.2.5",
+        "typescript": "^5.4.5",
+        "vite": "^5.4.10",
+        "vite-plugin-dts": "^4.3.0",
+        "vitest": "^2.1.3",
+        "vue": "^3.5.12",
+        "vue-eslint-parser": "^9.4.2"
+    },
+    "dependencies": {
+        "d3-interpolate": "^3.0.1"
+    }
 }

package/src/StkTable/StkTable.vue

@@ -466,101 +466,121 @@ const props = withDefaults(
 const emits = defineEmits<{
     /**
      * 排序变更触发。defaultSort.dataIndex 找不到时，col 将返回null。
+     *
      * ```(col: StkTableColumn<DT> | null, order: Order, data: DT[], sortConfig: SortConfig<DT>)```
      */
     (e: 'sort-change', col: StkTableColumn<DT> | null, order: Order, data: DT[], sortConfig: SortConfig<DT>): void;
     /**
      * 一行点击事件
+     *
      * ```(ev: MouseEvent, row: DT)```
      */
     (e: 'row-click', ev: MouseEvent, row: DT): void;
     /**
      * 选中一行触发。ev返回null表示不是点击事件触发的
+     *
      * ```(ev: MouseEvent | null, row: DT | undefined, data: { select: boolean })```
      */
     (e: 'current-change', ev: MouseEvent | null, row: DT | undefined, data: { select: boolean }): void;
     /**
      * 选中单元格触发。ev返回null表示不是点击事件触发的
+     *
      * ```(ev: MouseEvent | null, data: { select: boolean; row: DT | undefined; col: StkTableColumn<DT> | null })```
      */
     (e: 'cell-selected', ev: MouseEvent | null, data: { select: boolean; row: DT | undefined; col: StkTableColumn<DT> | undefined }): void;
     /**
      * 行双击事件
+     *
      * ```(ev: MouseEvent, row: DT)```
      */
     (e: 'row-dblclick', ev: MouseEvent, row: DT): void;
     /**
      * 表头右键事件
+     *
      * ```(ev: MouseEvent)```
      */
     (e: 'header-row-menu', ev: MouseEvent): void;
     /**
      * 表体行右键点击事件
+     *
      * ```(ev: MouseEvent, row: DT)```
      */
     (e: 'row-menu', ev: MouseEvent, row: DT): void;
     /**
      * 单元格点击事件
+     *
      * ```(ev: MouseEvent, row: DT, col: StkTableColumn<DT>)```
      */
     (e: 'cell-click', ev: MouseEvent, row: DT, col: StkTableColumn<DT>): void;
     /**
      * 单元格鼠标进入事件
+     *
      * ```(ev: MouseEvent, row: DT, col: StkTableColumn<DT>)```
      */
     (e: 'cell-mouseenter', ev: MouseEvent, row: DT, col: StkTableColumn<DT>): void;
     /**
      * 单元格鼠标移出事件
+     *
      * ```(ev: MouseEvent, row: DT, col: StkTableColumn<DT>)```
      */
     (e: 'cell-mouseleave', ev: MouseEvent, row: DT, col: StkTableColumn<DT>): void;
     /**
      * 单元格悬浮事件
+     *
      * ```(ev: MouseEvent, row: DT, col: StkTableColumn<DT>)```
      */
     (e: 'cell-mouseover', ev: MouseEvent, row: DT, col: StkTableColumn<DT>): void;
     /**
      * 表头单元格点击事件
+     *
      * ```(ev: MouseEvent, col: StkTableColumn<DT>)```
      */
     (e: 'header-cell-click', ev: MouseEvent, col: StkTableColumn<DT>): void;
     /**
      * 表格滚动事件
+     *
      * ```(ev: Event, data: { startIndex: number; endIndex: number })```
      */
     (e: 'scroll', ev: Event, data: { startIndex: number; endIndex: number }): void;
     /**
      * 表格横向滚动事件
+     *
      * ```(ev: Event)```
      */
     (e: 'scroll-x', ev: Event): void;
     /**
      * 表头列拖动事件
+     *
      * ```(dragStartKey: string, targetColKey: string)```
      */
     (e: 'col-order-change', dragStartKey: string, targetColKey: string): void;
     /**
      * 表头列拖动开始
+     *
      * ```(dragStartKey: string)```
      */
     (e: 'th-drag-start', dragStartKey: string): void;
     /**
      * 表头列拖动drop
+     *
      * ```(targetColKey: string)```
      */
     (e: 'th-drop', targetColKey: string): void;
     /**
      * 行拖动事件
+     *
      * ```(dragStartKey: string, targetRowKey: string)```
      */
     (e: 'row-order-change', dragStartKey: string, targetRowKey: string): void;
     /**
      * 列宽变动时触发
+     *
      *  ```(cols: StkTableColumn<DT>)```
      */
     (e: 'col-resize', cols: StkTableColumn<DT>): void;
     /**
      * 展开行触发
+     *
      * ```( data: { expanded: boolean; row: DT; col: StkTableColumn<DT> })```
      */
     (e: 'toggle-row-expand', data: { expanded: boolean; row: DT; col: StkTableColumn<DT> | null }): void;
@@ -980,7 +1000,14 @@ function getHeaderTitle(col: StkTableColumn<DT>): string {
  * @param options.emit 是否触发回调
  */
 function onColumnSort(col: StkTableColumn<DT> | undefined | null, click = true, options: { force?: boolean; emit?: boolean } = {}) {
-    if (!col?.sorter) return;
+    if (!col) {
+        console.warn('onColumnSort: col is not found');
+        return;
+    }
+    if (!col.sorter && click) {
+        // 点击表头触发的排序，如果列没有配置sorter则不处理。setSorter 触发的排序则保持通行。
+        return;
+    }
     options = { force: false, emit: false, ...options };
     if (sortCol.value !== col.dataIndex) {
         // 改变排序的列时，重置排序
@@ -1271,8 +1298,8 @@ function getSortColumns(): Partial<SortState<DT>>[] {
     return [{ dataIndex: sortCol.value, order: sortOrder }];
 }
 
-/** click expended icon to toggleg expand row */
-function toggleExpandRow(row: DT, col: StkTableColumn<DT>, expand?: boolean) {
+/** click expended icon to toggle expand row */
+function toggleExpandRow(row: DT, col: StkTableColumn<DT>) {
     const isExpand = row?.__EXPANDED__ === col ? !row?.__EXPANDED__ : true;
     setRowExpand(row, isExpand, { col });
 }
@@ -1334,37 +1361,116 @@ function setRowExpand(rowKeyOrRow: string | undefined | DT, expand?: boolean, da
 }
 
 defineExpose({
-    /** @see {@link initVirtualScroll} */
+    /**
+     * 重新计算虚拟列表宽高
+     *
+     * en: calc virtual scroll x & y info
+     * @see {@link initVirtualScroll}
+     */
     initVirtualScroll,
-    /** @see {@link initVirtualScrollX} */
+    /**
+     * 重新计算虚拟列表宽度
+     *
+     * en: calc virtual scroll x
+     * @see {@link initVirtualScrollX}
+     */
     initVirtualScrollX,
-    /** @see {@link initVirtualScrollY} */
+    /**
+     * 重新计算虚拟列表高度
+     *
+     * en: calc virtual scroll y
+     * @see {@link initVirtualScrollY}
+     */
     initVirtualScrollY,
-    /** @see {@link setCurrentRow} */
+    /**
+     * 选中一行
+     *
+     * en：select a row
+     * @see {@link setCurrentRow}
+     */
     setCurrentRow,
-    /** @see {@link setSelectedCell} */
+    /**
+     * 取消选中单元格
+     *
+     * en: set highlight active cell (props.cellActive=true)
+     * @see {@link setSelectedCell}
+     */
     setSelectedCell,
-    /** @see {@link setHighlightDimCell} */
+    /**
+     * 设置高亮单元格
+     *
+     * en: Set highlight cell
+     * @see {@link setHighlightDimCell}
+     */
     setHighlightDimCell,
-    /** @see {@link setHighlightDimRow} */
+    /**
+     * 设置高亮行
+     *
+     * en: Set highlight row
+     * @see {@link setHighlightDimRow}
+     */
     setHighlightDimRow,
-    /** 表格排序列dataIndex */
+    /**
+     * 表格排序列dataIndex
+     *
+     * en: Table sort column dataIndex
+     */
     sortCol,
-    /** @see {@link getSortColumns} */
+    /**
+     * 表格排序列顺序
+     *
+     * en: get current sort info
+     * @see {@link getSortColumns}
+     */
     getSortColumns,
-    /** @see {@link setSorter} */
+    /**
+     * 设置表头排序状态
+     *
+     * en: Set the sort status of the table header
+     * @see {@link setSorter}
+     */
     setSorter,
-    /** @see {@link resetSorter} */
+    /**
+     * 重置sorter状态
+     *
+     * en: Reset the sorter status
+     * @see {@link resetSorter}
+     */
     resetSorter,
-    /** @see {@link scrollTo} */
+    /**
+     * 滚动至
+     *
+     * en: Scroll to
+     * @see {@link scrollTo}
+     */
     scrollTo,
-    /** @see {@link getTableData} */
+    /**
+     * 获取表格数据
+     *
+     * en: Get table data
+     * @see {@link getTableData}
+     */
     getTableData,
-    /** @see {@link setRowExpand} */
+    /**
+     * 设置展开的行
+     *
+     * en: Set expanded rows
+     * @see {@link setRowExpand}
+     */
     setRowExpand,
-    /** @see {@link setAutoHeight} */
+    /**
+     * 不定行高时，如果行高有变化，则调用此方法更新行高。
+     *
+     * en: When the row height is not fixed, call this method to update the row height if the row height changes.
+     * @see {@link setAutoHeight}
+     */
     setAutoHeight,
-    /** @see {@link clearAllAutoHeight} */
+    /**
+     * 清除所有行高
+     *
+     * en: Clear all row heights
+     * @see {@link clearAllAutoHeight}
+     */
     clearAllAutoHeight,
 });
 </script>

package/src/StkTable/useThDrag.ts

@@ -19,7 +19,7 @@ export function useThDrag<DT extends Record<string, any>>({ props, emits, colKey
         return {
             draggable,
             mode: 'insert',
-            disabled: () => !draggable,
+            disabled: () => false,
             ...headerDrag,
         };
     });
@@ -97,6 +97,6 @@ export function useThDrag<DT extends Record<string, any>>({ props, emits, colKey
         onThDragOver,
         onThDrop,
         /** 是否可拖拽 */
-        isHeaderDraggable: dragConfig.value.disabled,
+        isHeaderDraggable: (col: StkTableColumn<DT>) => !dragConfig.value.disabled(col),
     };
 }