@veltra/desktop 1.0.8 → 1.0.10

package/dist/components/table/table-row.js

@@ -2,21 +2,68 @@ import _sfc_main from "../icon/icon.js";
 import _sfc_main$1 from "../button/button.js";
 import { TableDIKey } from "./di.js";
 import _sfc_main$2 from "./table-cell.js";
-import { createVNode, defineComponent, inject, isVNode, mergeProps } from "vue";
-import { bem } from "@veltra/utils";
+import { createVNode, defineComponent, inject, isVNode, mergeProps, onUnmounted } from "vue";
 import { ArrowRight } from "@veltra/icons/normal";
 //#region src/components/table/table-row.tsx
+/**
+* A3：行修饰类组合静态查找表。
+*
+* 位模式：bit2 = isCurrent, bit1 = checked, bit0 = expanded。
+* 与 `bem.is('...')` 对于 `'current' | 'checked' | 'expanded'` 的输出完全等价，
+* 直接从 index 读字符串，消除每行渲染期间的字符串拼接和 3 次 bem.is 调用。
+*
+* 放在模块顶层使所有 TableRow 实例共享一份引用（不会随 setup 重建）。
+*/
 function _isSlot(s) {
 	return typeof s === "function" || Object.prototype.toString.call(s) === "[object Object]" && !isVNode(s);
 }
+const ROW_MOD_CLASS = [
+	"",
+	"is-expanded",
+	"is-checked",
+	"is-checked is-expanded",
+	"is-current",
+	"is-current is-expanded",
+	"is-current is-checked",
+	"is-current is-checked is-expanded"
+];
+function rowModCls(row) {
+	return ROW_MOD_CLASS[(row.isCurrent ? 4 : 0) | (row.checked ? 2 : 0) | (row.expanded ? 1 : 0)];
+}
 const UTableRow = defineComponent({
 	name: "TableRow",
-	props: ["row"],
+	props: {
+		row: {
+			type: Object,
+			required: true
+		},
+		index: {
+			type: Number,
+			required: true
+		}
+	},
 	setup(props) {
-		const { row } = props;
-		const { cls, columnConfig, getColumnSlotsNode, toggleTreeRowExpand, getCellCtx, handleRowClick, handleCellClick, tableProps, measureElement } = inject(TableDIKey);
+		const { cls, columnConfig, getColumnSlotsNode, toggleTreeRowExpand, getCellCtx, handleRowClick, handleCellClick, tableProps, measureElement, getCellClass } = inject(TableDIKey);
+		const rowBaseCls = cls.e("row");
+		const expandToggleCls = cls.e("expand-toggle");
+		const expandSpaceCls = cls.e("expand-space");
+		const measureRefCache = /* @__PURE__ */ new Map();
+		const getMeasureRef = (index) => {
+			let ref = measureRefCache.get(index);
+			if (ref === void 0) {
+				ref = (el) => {
+					measureElement(index, el);
+				};
+				measureRefCache.set(index, ref);
+			}
+			return ref;
+		};
+		onUnmounted(() => {
+			measureRefCache.clear();
+		});
 		const { columns, expandColumn } = columnConfig;
 		return () => {
+			const { row } = props;
 			const _expandColumn = expandColumn.value;
 			let expandCell = null;
 			if (_expandColumn) {
@@ -25,13 +72,13 @@ const UTableRow = defineComponent({
 				if (!cellSpan || cellSpan.colspan && cellSpan.rowspan) {
 					const marginLeft = tableProps.tree ? (row.depth - 1) * 14 : 0;
 					expandCell = createVNode(_sfc_main$2, mergeProps({
-						"column": _expandColumn,
+						"cellClass": getCellClass(_expandColumn),
 						"left": _expandColumn.style.left,
 						"right": _expandColumn.style.right,
 						"key": row.uid + _expandColumn.key
 					}, tableProps.mergeCell?.(expandCtx)), { default: () => [!row.isLeaf || tableProps.expandable && !row.isExpandRow ? createVNode(_sfc_main$1, {
 						"text": true,
-						"class": cls.e("expand-toggle"),
+						"class": expandToggleCls,
 						"type": "primary",
 						"size": "small",
 						"circle": true,
@@ -41,19 +88,16 @@ const UTableRow = defineComponent({
 						},
 						"style": `margin-left: ${marginLeft}px`
 					}, { default: () => [createVNode(_sfc_main, null, { default: () => [createVNode(ArrowRight, null, null)] })] }) : createVNode("i", {
-						"class": cls.e("expand-space"),
+						"class": expandSpaceCls,
 						"style": `margin-left: ${marginLeft}px`
 					}, null), getColumnSlotsNode(expandCtx)] });
 				}
 			}
+			const mod = rowModCls(row);
 			return createVNode("tr", {
-				"class": [
-					cls.e("row"),
-					bem.is("expanded", row.expanded),
-					bem.is("checked", row.checked)
-				],
+				"class": mod ? rowBaseCls + " " + mod : rowBaseCls,
 				"onClick": (e) => handleRowClick(row, e),
-				"ref": measureElement,
+				"ref": getMeasureRef(props.index),
 				"key": row.uid
 			}, [expandCell, columns.value.map((column) => {
 				const cellCtx = getCellCtx(row, column);
@@ -61,7 +105,7 @@ const UTableRow = defineComponent({
 				if (cellSpan && (!cellSpan.colspan || !cellSpan.rowspan)) return null;
 				const cellNode = getColumnSlotsNode(cellCtx);
 				return createVNode(_sfc_main$2, mergeProps({
-					"column": column,
+					"cellClass": getCellClass(column),
 					"left": column.style.left,
 					"right": column.style.right,
 					"key": row.uid + column.key,
@@ -73,10 +117,24 @@ const UTableRow = defineComponent({
 });
 const UExpandTableRow = defineComponent({
 	name: "ExpandTableRow",
-	props: ["row"],
+	props: {
+		row: {
+			type: Object,
+			required: true
+		},
+		index: {
+			type: Number,
+			required: true
+		}
+	},
 	setup(props) {
 		const { getExpandRowSlotsNode, cls, measureElement, columnConfig } = inject(TableDIKey);
 		const { leafColumns } = columnConfig;
+		const rowBaseCls = cls.e("row");
+		const cellCls = cls.e("cell");
+		const measureRef = (el) => {
+			measureElement(props.index, el);
+		};
 		return () => {
 			const { row } = props;
 			const node = getExpandRowSlotsNode({
@@ -86,11 +144,11 @@ const UExpandTableRow = defineComponent({
 				rowData: row.data
 			});
 			return createVNode("tr", {
-				"class": cls.e("row"),
-				"ref": measureElement
+				"class": rowBaseCls,
+				"ref": measureRef
 			}, [createVNode("td", {
 				"colspan": leafColumns.value.length,
-				"class": cls.e("cell")
+				"class": cellCls
 			}, [node])]);
 		};
 	}

package/dist/components/table/table-row.js.map

@@ -1 +1 @@
-{"version":3,"file":"table-row.js","names":["ArrowRight","bem","defineComponent","DefineComponent","VNodeRef","inject","JSX","TableRow","ITableRow","UButton","UIcon","TableDIKey","UTabelCell","_isSlot","s","Object","prototype","toString","call","_isVNode","UTableRow","row","name","props","setup","cls","columnConfig","getColumnSlotsNode","toggleTreeRowExpand","getCellCtx","handleRowClick","handleCellClick","tableProps","measureElement","columns","expandColumn","_expandColumn","value","expandCell","Element","expandCtx","cellSpan","mergeCell","colspan","rowspan","marginLeft","tree","depth","_createVNode","_mergeProps","style","left","right","uid","key","default","isLeaf","expandable","isExpandRow","e","stopPropagation","is","expanded","checked","map","column","cellCtx","cellNode","UExpandTableRow","getExpandRowSlotsNode","leafColumns","node","index","rowData","data","length"],"sources":["../../../src/components/table/table-row.tsx"],"sourcesContent":["import { ArrowRight } from '@veltra/icons/normal'\nimport { bem } from '@veltra/utils'\nimport { defineComponent, type DefineComponent, type VNodeRef } from 'vue'\nimport { inject } from 'vue'\nimport type { JSX } from 'vue/jsx-runtime'\n\nimport type { TableRow as ITableRow } from '../../types'\nimport { UButton } from '../button'\nimport { UIcon } from '../icon'\nimport { TableDIKey } from './di'\nimport UTabelCell from './table-cell.vue'\n\nexport const UTableRow: DefineComponent<{ row: ITableRow }> = defineComponent({\n  name: 'TableRow',\n\n  props: ['row'],\n\n  setup(props) {\n    const { row } = props\n\n    const {\n      cls,\n      columnConfig,\n      getColumnSlotsNode,\n      toggleTreeRowExpand,\n      getCellCtx,\n      handleRowClick,\n      handleCellClick,\n      tableProps,\n      measureElement\n    } = inject(TableDIKey)!\n\n    const { columns, expandColumn } = columnConfig\n\n    return () => {\n      const _expandColumn = expandColumn.value\n\n      let expandCell: JSX.Element | null = null\n      if (_expandColumn) {\n        const expandCtx = getCellCtx(row, _expandColumn)\n        const cellSpan = tableProps.mergeCell?.(expandCtx)\n\n        if (!cellSpan || (cellSpan.colspan && cellSpan.rowspan)) {\n          const marginLeft = tableProps.tree ? (row.depth - 1) * 14 : 0\n          expandCell = (\n            <UTabelCell\n              column={_expandColumn}\n              left={_expandColumn.style.left}\n              right={_expandColumn.style.right}\n              key={row.uid + _expandColumn.key}\n              {...tableProps.mergeCell?.(expandCtx)}\n            >\n              {!row.isLeaf || (tableProps.expandable && !row.isExpandRow) ? (\n                <UButton\n                  text\n                  class={cls.e('expand-toggle')}\n                  type='primary'\n                  size='small'\n                  circle\n                  onClick={(e) => {\n                    e.stopPropagation()\n                    toggleTreeRowExpand(row)\n                  }}\n                  style={`margin-left: ${marginLeft}px`}\n                >\n                  <UIcon>\n                    <ArrowRight />\n                  </UIcon>\n                </UButton>\n              ) : (\n                <i class={cls.e('expand-space')} style={`margin-left: ${marginLeft}px`}></i>\n              )}\n\n              {getColumnSlotsNode(expandCtx)}\n            </UTabelCell>\n          )\n        }\n      }\n\n      return (\n        <tr\n          class={[cls.e('row'), bem.is('expanded', row.expanded), bem.is('checked', row.checked)]}\n          onClick={(e) => handleRowClick(row, e)}\n          ref={measureElement as VNodeRef}\n          key={row.uid}\n        >\n          {expandCell}\n\n          {columns.value.map((column) => {\n            const cellCtx = getCellCtx(row, column)\n            const cellSpan = tableProps.mergeCell?.(cellCtx)\n            if (cellSpan && (!cellSpan.colspan || !cellSpan.rowspan)) {\n              return null\n            }\n\n            const cellNode = getColumnSlotsNode(cellCtx)\n\n            return (\n              <UTabelCell\n                column={column}\n                left={column.style.left}\n                right={column.style.right}\n                key={row.uid + column.key}\n                // @ts-ignore\n                onClick={(e) => handleCellClick(row, column, e)}\n                {...cellSpan}\n              >\n                {cellNode}\n              </UTabelCell>\n            )\n          })}\n        </tr>\n      )\n    }\n  }\n})\n\nexport const UExpandTableRow = defineComponent({\n  name: 'ExpandTableRow',\n  props: ['row'],\n  setup(props) {\n    const { getExpandRowSlotsNode, cls, measureElement, columnConfig } = inject(TableDIKey)!\n    const { leafColumns } = columnConfig\n\n    return () => {\n      const { row } = props\n      const node = getExpandRowSlotsNode({\n        row,\n        index: row.index,\n        columns: leafColumns.value,\n        rowData: row.data\n      })\n      return (\n        <tr class={cls.e('row')} ref={measureElement as VNodeRef}>\n          <td colspan={leafColumns.value.length} class={cls.e('cell')}>\n            {node}\n          </td>\n        </tr>\n      )\n    }\n  }\n})\n"],"mappings":"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"}
+{"version":3,"file":"table-row.js","names":["ArrowRight","defineComponent","DefineComponent","inject","onUnmounted","JSX","TableRow","ITableRow","UButton","UIcon","TableDIKey","UTabelCell","_isSlot","s","Object","prototype","toString","call","_isVNode","ROW_MOD_CLASS","const","rowModCls","row","i","isCurrent","checked","expanded","UTableRow","index","name","props","type","required","Number","setup","cls","columnConfig","getColumnSlotsNode","toggleTreeRowExpand","getCellCtx","handleRowClick","handleCellClick","tableProps","measureElement","getCellClass","rowBaseCls","e","expandToggleCls","expandSpaceCls","measureRefCache","Map","el","getMeasureRef","ref","get","undefined","Element","set","clear","columns","expandColumn","_expandColumn","value","expandCell","expandCtx","cellSpan","mergeCell","colspan","rowspan","marginLeft","tree","depth","_createVNode","_mergeProps","style","left","right","uid","key","default","isLeaf","expandable","isExpandRow","stopPropagation","mod","rowCls","map","column","cellCtx","cellNode","UExpandTableRow","getExpandRowSlotsNode","leafColumns","cellCls","measureRef","node","rowData","data","length"],"sources":["../../../src/components/table/table-row.tsx"],"sourcesContent":["import { ArrowRight } from '@veltra/icons/normal'\nimport { defineComponent, type DefineComponent } from 'vue'\nimport { inject, onUnmounted } from 'vue'\nimport type { JSX } from 'vue/jsx-runtime'\n\nimport type { TableRow as ITableRow } from '../../types'\nimport { UButton } from '../button'\nimport { UIcon } from '../icon'\nimport { TableDIKey } from './di'\nimport UTabelCell from './table-cell.vue'\n\n/**\n * A3：行修饰类组合静态查找表。\n *\n * 位模式：bit2 = isCurrent, bit1 = checked, bit0 = expanded。\n * 与 `bem.is('...')` 对于 `'current' | 'checked' | 'expanded'` 的输出完全等价，\n * 直接从 index 读字符串，消除每行渲染期间的字符串拼接和 3 次 bem.is 调用。\n *\n * 放在模块顶层使所有 TableRow 实例共享一份引用（不会随 setup 重建）。\n */\nconst ROW_MOD_CLASS: readonly string[] = [\n  '',\n  'is-expanded',\n  'is-checked',\n  'is-checked is-expanded',\n  'is-current',\n  'is-current is-expanded',\n  'is-current is-checked',\n  'is-current is-checked is-expanded'\n] as const\n\nfunction rowModCls(row: ITableRow): string {\n  const i = (row.isCurrent ? 4 : 0) | (row.checked ? 2 : 0) | (row.expanded ? 1 : 0)\n  return ROW_MOD_CLASS[i]!\n}\n\nexport const UTableRow: DefineComponent<{ row: ITableRow; index: number }> = defineComponent({\n  name: 'TableRow',\n\n  props: {\n    row: { type: Object as () => ITableRow, required: true },\n    index: { type: Number, required: true }\n  },\n\n  setup(props) {\n    const {\n      cls,\n      columnConfig,\n      getColumnSlotsNode,\n      toggleTreeRowExpand,\n      getCellCtx,\n      handleRowClick,\n      handleCellClick,\n      tableProps,\n      measureElement,\n      getCellClass\n    } = inject(TableDIKey)!\n\n    // A1：把 cls.e('row') / cls.e('expand-toggle') 等静态字符串提升到 setup 一次性计算，\n    // 避免每次 render 重新走 `cls.e` 拼接。\n    const rowBaseCls = cls.e('row')\n    const expandToggleCls = cls.e('expand-toggle')\n    const expandSpaceCls = cls.e('expand-space')\n\n    // A2：measureRef 按 index 缓存闭包。\n    // 行虚拟化下，同一 TableRow 实例的 props.index 大多稳定，但在虚拟化重排或展开行切换时\n    // 仍会发生变化；把 (index) → refFn 缓存起来，既保证引用稳定（利于 Vue 的 ref diff），\n    // 又避免在未来可能的\"同实例跨 index 复用\"情形下重复分配闭包。\n    const measureRefCache = new Map<number, (el: unknown) => void>()\n    const getMeasureRef = (index: number): ((el: unknown) => void) => {\n      let ref = measureRefCache.get(index)\n      if (ref === undefined) {\n        ref = (el: unknown) => {\n          measureElement(index, el as Element | null)\n        }\n        measureRefCache.set(index, ref)\n      }\n      return ref\n    }\n    onUnmounted(() => {\n      measureRefCache.clear()\n    })\n\n    const { columns, expandColumn } = columnConfig\n\n    return () => {\n      const { row } = props\n      const _expandColumn = expandColumn.value\n\n      let expandCell: JSX.Element | null = null\n      if (_expandColumn) {\n        const expandCtx = getCellCtx(row, _expandColumn)\n        const cellSpan = tableProps.mergeCell?.(expandCtx)\n\n        if (!cellSpan || (cellSpan.colspan && cellSpan.rowspan)) {\n          const marginLeft = tableProps.tree ? (row.depth - 1) * 14 : 0\n          expandCell = (\n            <UTabelCell\n              cellClass={getCellClass(_expandColumn)}\n              left={_expandColumn.style.left}\n              right={_expandColumn.style.right}\n              key={row.uid + _expandColumn.key}\n              {...tableProps.mergeCell?.(expandCtx)}\n            >\n              {!row.isLeaf || (tableProps.expandable && !row.isExpandRow) ? (\n                <UButton\n                  text\n                  class={expandToggleCls}\n                  type='primary'\n                  size='small'\n                  circle\n                  onClick={(e) => {\n                    e.stopPropagation()\n                    toggleTreeRowExpand(row)\n                  }}\n                  style={`margin-left: ${marginLeft}px`}\n                >\n                  <UIcon>\n                    <ArrowRight />\n                  </UIcon>\n                </UButton>\n              ) : (\n                <i class={expandSpaceCls} style={`margin-left: ${marginLeft}px`}></i>\n              )}\n\n              {getColumnSlotsNode(expandCtx)}\n            </UTabelCell>\n          )\n        }\n      }\n\n      // A3：行 class 由 base + 3-bit 组合查找产出，避免 Vue 的 class 数组归一化开销。\n      const mod = rowModCls(row)\n      const rowCls = mod ? rowBaseCls + ' ' + mod : rowBaseCls\n\n      return (\n        <tr\n          class={rowCls}\n          onClick={(e) => handleRowClick(row, e)}\n          ref={getMeasureRef(props.index)}\n          key={row.uid}\n        >\n          {expandCell}\n\n          {columns.value.map((column) => {\n            const cellCtx = getCellCtx(row, column)\n            const cellSpan = tableProps.mergeCell?.(cellCtx)\n            if (cellSpan && (!cellSpan.colspan || !cellSpan.rowspan)) {\n              return null\n            }\n\n            const cellNode = getColumnSlotsNode(cellCtx)\n\n            return (\n              <UTabelCell\n                cellClass={getCellClass(column)}\n                left={column.style.left}\n                right={column.style.right}\n                key={row.uid + column.key}\n                // @ts-ignore\n                onClick={(e) => handleCellClick(row, column, e)}\n                {...cellSpan}\n              >\n                {cellNode}\n              </UTabelCell>\n            )\n          })}\n        </tr>\n      )\n    }\n  }\n})\n\nexport const UExpandTableRow = defineComponent({\n  name: 'ExpandTableRow',\n  props: {\n    row: { type: Object as () => ITableRow, required: true },\n    index: { type: Number, required: true }\n  },\n  setup(props) {\n    const { getExpandRowSlotsNode, cls, measureElement, columnConfig } = inject(TableDIKey)!\n    const { leafColumns } = columnConfig\n\n    const rowBaseCls = cls.e('row')\n    const cellCls = cls.e('cell')\n\n    const measureRef = (el: unknown) => {\n      measureElement(props.index, el as Element | null)\n    }\n\n    return () => {\n      const { row } = props\n      const node = getExpandRowSlotsNode({\n        row,\n        index: row.index,\n        columns: leafColumns.value,\n        rowData: row.data\n      })\n      return (\n        <tr class={rowBaseCls} ref={measureRef}>\n          <td colspan={leafColumns.value.length} class={cellCls}>\n            {node}\n          </td>\n        </tr>\n      )\n    }\n  }\n})\n"],"mappings":"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"}

package/dist/components/table/table.js

@@ -9,10 +9,21 @@ import { useColumns } from "./use-columns.js";
 import { useFixedColumns } from "./use-fixed-columns.js";
 import { useRows } from "./use-rows.js";
 import { useTable } from "./use-table.js";
-import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createSlots, createVNode, defineComponent, nextTick, normalizeClass, normalizeStyle, openBlock, provide, renderList, renderSlot, shallowRef, toRef, unref, useSlots, useTemplateRef, watch, withCtx } from "vue";
-import { bem, setStyles, withUnit } from "@veltra/utils";
-import { useFallbackProps, useVirtual } from "@veltra/compositions";
+import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createSlots, createVNode, defineComponent, normalizeClass, normalizeStyle, openBlock, provide, renderList, renderSlot, shallowRef, toRef, unref, useSlots, useTemplateRef, watch, withCtx } from "vue";
+import { bem, withUnit } from "@veltra/utils";
+import { useFallbackProps, useVirtualizer } from "@veltra/compositions";
 //#region src/components/table/table.vue
+const _hoisted_1 = {
+	key: 0,
+	"aria-hidden": "true"
+};
+const _hoisted_2 = ["colspan"];
+const _hoisted_3 = {
+	key: 1,
+	"aria-hidden": "true"
+};
+const _hoisted_4 = ["colspan"];
+const LENGTH_DELTA_RATIO_TO_RESET_SCROLL = .5;
 const _sfc_main = /* @__PURE__ */ defineComponent({
 	name: "Table",
 	__name: "table",
@@ -60,9 +71,14 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
 		const slots = useSlots();
 		const cls = bem("table");
 		const { size } = useFallbackProps([props], { size: "default" });
+		const scrollRef = shallowRef();
+		const beforeSpacerRef = useTemplateRef("beforeSpacerRef");
+		const afterSpacerRef = useTemplateRef("afterSpacerRef");
+		const isScrollingRelay = shallowRef(false);
 		const { rows, toggleTreeRowExpand, allExpanded, toggleAllTreeRowExpand, rowForest, handleRowClick, handleCellClick, getRowByData } = useRows({
 			props,
-			emit
+			emit,
+			isScrolling: isScrollingRelay
 		});
 		const { createCheckColumn, createSelectColumn, clearChecked, clearSelected, checkedRows } = useCheck({
 			size,
@@ -80,39 +96,47 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
 			cls
 		});
 		const { leafColumns } = columnConfig;
-		const { handleScroll, leftFixed, rightFixed } = useFixedColumns();
+		const { handleScroll, leftFixed, rightFixed } = useFixedColumns({ isScrolling: isScrollingRelay });
 		const { getColumnSlotsNode, getExpandRowSlotsNode, getHeaderSlotsNode, getCellClass, getCellCtx, getHeaderCellClass } = useTable({
 			props,
 			cls,
 			leftFixed,
 			rightFixed
 		});
-		const scrollRef = shallowRef();
 		const { showResizeLine, resizeLineRef, colgroupRef } = useColResize({
 			scrollRef,
 			leafColumns
 		});
-		const virtualCtx = useVirtual({
+		const { virtualizer, items, isScrolling } = useVirtualizer({
 			count: computed(() => rows.value.length),
-			scrollEl: computed(() => scrollRef.value?.containerRef ?? null),
-			estimateSize: () => 52,
-			virtualThreshold: toRef(props, "virtualThreshold")
+			scrollEl: () => scrollRef.value?.containerRef ?? null,
+			beforeEl: beforeSpacerRef,
+			afterEl: afterSpacerRef,
+			estimateSize: () => 41,
+			getItemKey: (i) => rows.value[i]?.uid ?? i
+		});
+		const virtualEnabled = computed(() => {
+			const t = props.virtualThreshold;
+			return t ? rows.value.length > t : true;
 		});
-		const { virtualList, totalHeight, virtualEnabled } = virtualCtx;
-		const spaceHeight = computed(() => {
-			if (virtualList.value.length) return totalHeight.value - virtualList.value[virtualList.value.length - 1].end + virtualList.value[0].start;
-			return totalHeight.value;
+		watch(isScrolling, (v) => {
+			isScrollingRelay.value = v;
 		});
-		const spaceRef = shallowRef();
-		watch(spaceHeight, (spaceHeight) => {
-			nextTick(() => {
-				spaceRef.value && setStyles(spaceRef.value, { height: spaceHeight ? `${spaceHeight}px` : void 0 });
-			});
-		}, { immediate: true });
-		const tableBodyRef = useTemplateRef("tableBody");
-		watch(() => props.data, () => {
-			tableBodyRef.value?.setBodyTransform(0);
-			scrollRef.value?.scrollTo({ y: 0 });
+		/**
+		* E1：数据替换时的条件置顶。
+		*
+		* 旧实现无差别地 `scrollTo({ y: 0 })`，在「行内增删 / 排序 / 单行更新」等
+		* 场景会把用户当前阅读位置跳走；仅在「翻页 / 显著数据集替换」时才需要复位。
+		*
+		* 判定阈值：|Δlen| / max(newLen, oldLen) ≥ 0.5，即行数变化量超过更大侧的一半时视为显著变化。
+		* 选择 0.5 是因为典型的分页/搜索场景会带来 50% 以上的行数差（通常完全替换数据集），
+		* 而行内追加 / 删除个位数通常只带来 <5% 的变化；两者区分度足够宽。
+		*/
+		watch(() => props.data, (next, prev) => {
+			const nextLen = next?.length ?? 0;
+			const prevLen = prev?.length ?? 0;
+			const denom = Math.max(nextLen, prevLen, 1);
+			if (Math.abs(nextLen - prevLen) / denom >= LENGTH_DELTA_RATIO_TO_RESET_SCROLL) scrollRef.value?.scrollTo({ y: 0 });
 		});
 		provide(TableDIKey, {
 			tableProps: props,
@@ -130,7 +154,9 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
 			getCellCtx,
 			getHeaderCellClass,
 			toggleTreeRowExpand,
-			...virtualCtx
+			virtualList: items,
+			virtualEnabled,
+			measureElement: (index, el) => virtualizer.measureElement(index, el)
 		});
 		const tableFootRef = useTemplateRef("tableFoot");
 		__expose({
@@ -170,7 +196,18 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
 							}, null, 6);
 						}), 128))], 512),
 						createVNode(unref(TableHead)),
-						createVNode(_sfc_main$2, { ref: "tableBody" }, createSlots({
+						createCommentVNode("\n        虚拟滚动上占位：替代 tbody transform，避免 table-layout: fixed 下列宽抖动。\n        高度由 useVirtualizer 命令式写入 `style.height`，不经过模板响应式绑定，\n        因此滚动窗口变化不会引起表格模板重渲染。\n      "),
+						virtualEnabled.value ? (openBlock(), createElementBlock("tbody", _hoisted_1, [createElementVNode("tr", {
+							ref_key: "beforeSpacerRef",
+							ref: beforeSpacerRef
+						}, [createElementVNode("td", {
+							colspan: unref(leafColumns).length,
+							style: {
+								"padding": "0",
+								"border": "none"
+							}
+						}, null, 8, _hoisted_2)], 512)])) : createCommentVNode("v-if", true),
+						createVNode(_sfc_main$2, null, createSlots({
 							default: withCtx(() => [renderSlot(_ctx.$slots, "body", {
 								columns: unref(leafColumns),
 								rows: unref(rows)
@@ -180,14 +217,18 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
 							name: "empty",
 							fn: withCtx(() => [renderSlot(_ctx.$slots, "empty")]),
 							key: "0"
-						} : void 0]), 1536),
-						createCommentVNode(" 占用空间，用来撑开表格高度 "),
-						unref(virtualEnabled) ? (openBlock(), createElementBlock("tbody", {
-							key: 0,
-							ref_key: "spaceRef",
-							ref: spaceRef,
-							style: { width: "1px" }
-						}, null, 512)) : createCommentVNode("v-if", true),
+						} : void 0]), 1024),
+						createCommentVNode(" 虚拟滚动下占位（高度由 useVirtualizer 命令式写入） "),
+						virtualEnabled.value ? (openBlock(), createElementBlock("tbody", _hoisted_3, [createElementVNode("tr", {
+							ref_key: "afterSpacerRef",
+							ref: afterSpacerRef
+						}, [createElementVNode("td", {
+							colspan: unref(leafColumns).length,
+							style: {
+								"padding": "0",
+								"border": "none"
+							}
+						}, null, 8, _hoisted_4)], 512)])) : createCommentVNode("v-if", true),
 						createVNode(_sfc_main$3, { ref: "tableFoot" }, {
 							default: withCtx(() => [renderSlot(_ctx.$slots, "foot", {
 								columns: unref(leafColumns),

package/dist/components/table/table.js.map

@@ -1 +1 @@
-{"version":3,"file":"table.js","names":[],"sources":["../../../src/components/table/table.vue"],"sourcesContent":["<template>\n  <u-scroll\n    :class=\"[\n      cls.b,\n      cls.m(size),\n      bem.is('border', border),\n      bem.is('all-expanded', allExpanded),\n      bem.is('text-ellipsis', textEllipsis)\n    ]\"\n    ref=\"scrollRef\"\n    :content-class=\"cls.e('content')\"\n    @scroll=\"handleScroll\"\n  >\n    <table :class=\"cls.e('wrap')\">\n      <colgroup ref=\"colgroupRef\">\n        <col\n          v-for=\"column of leafColumns\"\n          :key=\"column.key\"\n          :class=\"column.fixed\"\n          :style=\"{\n            width: withUnit(column.width, 'px'),\n            minWidth: withUnit(column.minWidth, 'px')\n          }\"\n        />\n      </colgroup>\n      <UTableHead />\n\n      <u-table-body ref=\"tableBody\">\n        <slot name=\"body\" :columns=\"leafColumns\" :rows=\"rows\" />\n\n        <template #empty v-if=\"slots.empty\">\n          <slot name=\"empty\" />\n        </template>\n      </u-table-body>\n\n      <!-- 占用空间，用来撑开表格高度 -->\n      <tbody v-if=\"virtualEnabled\" ref=\"spaceRef\" :style=\"{ width: '1px' }\"></tbody>\n\n      <u-table-foot ref=\"tableFoot\">\n        <slot name=\"foot\" :columns=\"leafColumns\" :rows=\"rows\" />\n      </u-table-foot>\n    </table>\n\n    <slot name=\"append\" />\n\n    <div v-if=\"showResizeLine\" :class=\"cls.e('resize-line')\" ref=\"resizeLineRef\"></div>\n\n    <!-- <u-tip v-if=\"textEllipsis\" ref=\"tip\"> </u-tip> -->\n  </u-scroll>\n</template>\n\n<script lang=\"ts\" setup>\nimport { useFallbackProps, useVirtual } from '@veltra/compositions'\nimport { bem, setStyles, withUnit } from '@veltra/utils'\nimport { computed, nextTick, provide, shallowRef, toRef, useTemplateRef, watch } from 'vue'\n\nimport type {\n  TableProps,\n  TableEmits,\n  _TableExposed,\n  TableColumnSlotsScope,\n  ComponentSize,\n  ScrollExposed,\n  TableRowSlotsScope\n} from '../../types'\nimport { UScroll } from '../scroll'\nimport { TableDIKey } from './di'\nimport type { ColumnNode } from './node/col'\nimport type { TableRowNode } from './node/row'\nimport UTableBody from './table-body.vue'\nimport UTableFoot from './table-foot.vue'\n// import { UTip } from '../tip'\nimport UTableHead from './table-head'\nimport { useCheck } from './use-check'\nimport { useColResize } from './use-col-resize'\nimport { useColumns } from './use-columns'\nimport { useFixedColumns } from './use-fixed-columns'\nimport { useRows } from './use-rows'\nimport { useTable } from './use-table'\n\ndefineOptions({ name: 'Table' })\n\nconst props = withDefaults(defineProps<TableProps>(), {\n  tree: false,\n  stripe: true,\n  textOverflow: 'line-break',\n  virtualThreshold: 80\n})\nconst emit = defineEmits<TableEmits>()\n\nconst slots = defineSlots<{\n  [key: `column:${string}`]: (props: TableColumnSlotsScope) => any\n  [key: `header:${string}`]: (props: { column: ColumnNode }) => any\n  'row:expand'?: (props: TableRowSlotsScope) => any\n  foot?: (props: { columns: ColumnNode[]; rows: TableRowNode[] }) => any\n  body?: (props: { columns: ColumnNode[]; rows: TableRowNode[] }) => any\n  empty?: () => any\n  append?: () => any\n}>()\n\nconst cls = bem('table')\n\nconst { size } = useFallbackProps([props], { size: 'default' as ComponentSize })\n\n// 行\nconst {\n  rows,\n  toggleTreeRowExpand,\n  allExpanded,\n  toggleAllTreeRowExpand,\n  rowForest,\n  handleRowClick,\n  handleCellClick,\n  getRowByData\n} = useRows({ props, emit })\n\n// 选中\nconst { createCheckColumn, createSelectColumn, clearChecked, clearSelected, checkedRows } =\n  useCheck({ size, props, rows, rowForest, emit, cls })\n\n// 列\nconst columnConfig = useColumns({\n  props,\n  createCheckColumn,\n  createSelectColumn,\n  toggleAllTreeRowExpand,\n  cls\n})\n\nconst { leafColumns } = columnConfig\n\nconst { handleScroll, leftFixed, rightFixed } = useFixedColumns()\n\n// 在表格中提供的通用方法和属性\nconst {\n  getColumnSlotsNode,\n  getExpandRowSlotsNode,\n  getHeaderSlotsNode,\n  getCellClass,\n  getCellCtx,\n  getHeaderCellClass\n} = useTable({ props, cls, leftFixed, rightFixed })\n\nconst scrollRef = shallowRef<ScrollExposed>()\n\nconst { showResizeLine, resizeLineRef, colgroupRef } = useColResize({ scrollRef, leafColumns })\n\nconst virtualCtx = useVirtual({\n  count: computed(() => rows.value.length),\n  scrollEl: computed(() => scrollRef.value?.containerRef ?? null),\n  estimateSize: () => 52,\n  virtualThreshold: toRef(props, 'virtualThreshold')\n})\n\nconst { virtualList, totalHeight, virtualEnabled } = virtualCtx\n\nconst spaceHeight = computed(() => {\n  if (virtualList.value.length) {\n    return (\n      totalHeight.value -\n      virtualList.value[virtualList.value.length - 1]!.end +\n      virtualList.value[0]!.start\n    )\n  }\n  return totalHeight.value\n})\n\nconst spaceRef = shallowRef<HTMLElement>()\n\nwatch(\n  spaceHeight,\n  (spaceHeight) => {\n    nextTick(() => {\n      spaceRef.value &&\n        setStyles(spaceRef.value, { height: spaceHeight ? `${spaceHeight}px` : undefined })\n    })\n  },\n  { immediate: true }\n)\n\nconst tableBodyRef = useTemplateRef('tableBody')\nwatch(\n  () => props.data,\n  () => {\n    tableBodyRef.value?.setBodyTransform(0)\n    scrollRef.value?.scrollTo({ y: 0 })\n  }\n)\n\n// const tipRef = useTemplateRef('tip')\n\nprovide(TableDIKey, {\n  tableProps: props,\n  tableSlots: slots,\n  cls,\n  rows,\n  checkedRows,\n  columnConfig,\n  handleRowClick,\n  handleCellClick,\n  getColumnSlotsNode,\n  getExpandRowSlotsNode,\n  getHeaderSlotsNode,\n  getCellClass,\n  getCellCtx,\n  getHeaderCellClass,\n  // tipRef,\n  toggleTreeRowExpand,\n  ...virtualCtx\n})\n\nconst tableFootRef = useTemplateRef('tableFoot')\n\ndefineExpose<_TableExposed>({\n  el: toRef(() => scrollRef.value?.el),\n  clearChecked,\n  clearSelected,\n  getRowByData,\n  getSummaryRow: () => tableFootRef.value!.getSummaryRow()\n})\n</script>\n"],"mappings":"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"}
+{"version":3,"file":"table.js","names":[],"sources":["../../../src/components/table/table.vue"],"sourcesContent":["<template>\n  <u-scroll\n    :class=\"[\n      cls.b,\n      cls.m(size),\n      bem.is('border', border),\n      bem.is('all-expanded', allExpanded),\n      bem.is('text-ellipsis', textEllipsis)\n    ]\"\n    ref=\"scrollRef\"\n    :content-class=\"cls.e('content')\"\n    @scroll=\"handleScroll\"\n  >\n    <table :class=\"cls.e('wrap')\">\n      <colgroup ref=\"colgroupRef\">\n        <col\n          v-for=\"column of leafColumns\"\n          :key=\"column.key\"\n          :class=\"column.fixed\"\n          :style=\"{\n            width: withUnit(column.width, 'px'),\n            minWidth: withUnit(column.minWidth, 'px')\n          }\"\n        />\n      </colgroup>\n      <UTableHead />\n\n      <!--\n        虚拟滚动上占位：替代 tbody transform，避免 table-layout: fixed 下列宽抖动。\n        高度由 useVirtualizer 命令式写入 `style.height`，不经过模板响应式绑定，\n        因此滚动窗口变化不会引起表格模板重渲染。\n      -->\n      <tbody v-if=\"virtualEnabled\" aria-hidden=\"true\">\n        <tr ref=\"beforeSpacerRef\">\n          <td :colspan=\"leafColumns.length\" style=\"padding: 0; border: none\"></td>\n        </tr>\n      </tbody>\n\n      <u-table-body>\n        <slot name=\"body\" :columns=\"leafColumns\" :rows=\"rows\" />\n\n        <template #empty v-if=\"slots.empty\">\n          <slot name=\"empty\" />\n        </template>\n      </u-table-body>\n\n      <!-- 虚拟滚动下占位（高度由 useVirtualizer 命令式写入） -->\n      <tbody v-if=\"virtualEnabled\" aria-hidden=\"true\">\n        <tr ref=\"afterSpacerRef\">\n          <td :colspan=\"leafColumns.length\" style=\"padding: 0; border: none\"></td>\n        </tr>\n      </tbody>\n\n      <u-table-foot ref=\"tableFoot\">\n        <slot name=\"foot\" :columns=\"leafColumns\" :rows=\"rows\" />\n      </u-table-foot>\n    </table>\n\n    <slot name=\"append\" />\n\n    <div v-if=\"showResizeLine\" :class=\"cls.e('resize-line')\" ref=\"resizeLineRef\"></div>\n\n    <!-- <u-tip v-if=\"textEllipsis\" ref=\"tip\"> </u-tip> -->\n  </u-scroll>\n</template>\n\n<script lang=\"ts\" setup>\nimport { useFallbackProps, useVirtualizer } from '@veltra/compositions'\nimport { bem, withUnit } from '@veltra/utils'\nimport { computed, provide, shallowRef, toRef, useTemplateRef, watch } from 'vue'\n\nimport type {\n  TableProps,\n  TableEmits,\n  _TableExposed,\n  TableColumnSlotsScope,\n  ComponentSize,\n  ScrollExposed,\n  TableRowSlotsScope\n} from '../../types'\nimport { UScroll } from '../scroll'\nimport { TableDIKey } from './di'\nimport type { ColumnNode } from './node/col'\nimport type { TableRowNode } from './node/row'\nimport UTableBody from './table-body.vue'\nimport UTableFoot from './table-foot.vue'\n// import { UTip } from '../tip'\nimport UTableHead from './table-head'\nimport { useCheck } from './use-check'\nimport { useColResize } from './use-col-resize'\nimport { useColumns } from './use-columns'\nimport { useFixedColumns } from './use-fixed-columns'\nimport { useRows } from './use-rows'\nimport { useTable } from './use-table'\n\ndefineOptions({ name: 'Table' })\n\nconst props = withDefaults(defineProps<TableProps>(), {\n  tree: false,\n  stripe: true,\n  textOverflow: 'line-break',\n  virtualThreshold: 80\n})\nconst emit = defineEmits<TableEmits>()\n\nconst slots = defineSlots<{\n  [key: `column:${string}`]: (props: TableColumnSlotsScope) => any\n  [key: `header:${string}`]: (props: { column: ColumnNode }) => any\n  'row:expand'?: (props: TableRowSlotsScope) => any\n  foot?: (props: { columns: ColumnNode[]; rows: TableRowNode[] }) => any\n  body?: (props: { columns: ColumnNode[]; rows: TableRowNode[] }) => any\n  empty?: () => any\n  append?: () => any\n}>()\n\nconst cls = bem('table')\n\nconst { size } = useFallbackProps([props], { size: 'default' as ComponentSize })\n\nconst scrollRef = shallowRef<ScrollExposed>()\n\n// 占位 tr 的 DOM 句柄；交给 useVirtualizer 直接命令式写 style.height。\nconst beforeSpacerRef = useTemplateRef<HTMLElement>('beforeSpacerRef')\nconst afterSpacerRef = useTemplateRef<HTMLElement>('afterSpacerRef')\n\n// 行（useRows / useFixedColumns 需要 isScrolling，而虚拟化 hook 又依赖 rows.length；\n// 先用中继占位，下方 isScrolling 到位后 watch 回灌）。\nconst isScrollingRelay = shallowRef(false)\n\nconst {\n  rows,\n  toggleTreeRowExpand,\n  allExpanded,\n  toggleAllTreeRowExpand,\n  rowForest,\n  handleRowClick,\n  handleCellClick,\n  getRowByData\n} = useRows({ props, emit, isScrolling: isScrollingRelay })\n\nconst { createCheckColumn, createSelectColumn, clearChecked, clearSelected, checkedRows } =\n  useCheck({ size, props, rows, rowForest, emit, cls })\n\nconst columnConfig = useColumns({\n  props,\n  createCheckColumn,\n  createSelectColumn,\n  toggleAllTreeRowExpand,\n  cls\n})\n\nconst { leafColumns } = columnConfig\n\nconst { handleScroll, leftFixed, rightFixed } = useFixedColumns({\n  isScrolling: isScrollingRelay\n})\n\nconst {\n  getColumnSlotsNode,\n  getExpandRowSlotsNode,\n  getHeaderSlotsNode,\n  getCellClass,\n  getCellCtx,\n  getHeaderCellClass\n} = useTable({ props, cls, leftFixed, rightFixed })\n\nconst { showResizeLine, resizeLineRef, colgroupRef } = useColResize({ scrollRef, leafColumns })\n\nconst { virtualizer, items, isScrolling } = useVirtualizer({\n  count: computed(() => rows.value.length),\n  scrollEl: () => scrollRef.value?.containerRef ?? null,\n  beforeEl: beforeSpacerRef,\n  afterEl: afterSpacerRef,\n  estimateSize: () => 41,\n  // 注意：getItemKey 在构造期一次性写入底层 Virtualizer；闭包每次读的是当前 rows.value，\n  // rows 引用整体替换后 key 仍有效（无需再 setOptions）。\n  getItemKey: (i) => rows.value[i]?.uid ?? i\n})\n\nconst virtualEnabled = computed(() => {\n  const t = props.virtualThreshold\n  return t ? rows.value.length > t : true\n})\n\n// 把虚拟化 isScrolling 回灌到中继，供 useRows / useFixedColumns 读取。\nwatch(isScrolling, (v) => {\n  isScrollingRelay.value = v\n})\n\n/**\n * E1：数据替换时的条件置顶。\n *\n * 旧实现无差别地 `scrollTo({ y: 0 })`，在「行内增删 / 排序 / 单行更新」等\n * 场景会把用户当前阅读位置跳走；仅在「翻页 / 显著数据集替换」时才需要复位。\n *\n * 判定阈值：|Δlen| / max(newLen, oldLen) ≥ 0.5，即行数变化量超过更大侧的一半时视为显著变化。\n * 选择 0.5 是因为典型的分页/搜索场景会带来 50% 以上的行数差（通常完全替换数据集），\n * 而行内追加 / 删除个位数通常只带来 <5% 的变化；两者区分度足够宽。\n */\nconst LENGTH_DELTA_RATIO_TO_RESET_SCROLL = 0.5\n\nwatch(\n  () => props.data,\n  (next, prev) => {\n    const nextLen = next?.length ?? 0\n    const prevLen = prev?.length ?? 0\n    const denom = Math.max(nextLen, prevLen, 1)\n    const ratio = Math.abs(nextLen - prevLen) / denom\n    if (ratio >= LENGTH_DELTA_RATIO_TO_RESET_SCROLL) {\n      scrollRef.value?.scrollTo({ y: 0 })\n    }\n  }\n)\n\n// const tipRef = useTemplateRef('tip')\n\nprovide(TableDIKey, {\n  tableProps: props,\n  tableSlots: slots,\n  cls,\n  rows,\n  checkedRows,\n  columnConfig,\n  handleRowClick,\n  handleCellClick,\n  getColumnSlotsNode,\n  getExpandRowSlotsNode,\n  getHeaderSlotsNode,\n  getCellClass,\n  getCellCtx,\n  getHeaderCellClass,\n  // tipRef,\n  toggleTreeRowExpand,\n  virtualList: items,\n  virtualEnabled,\n  measureElement: (index, el) => virtualizer.measureElement(index, el)\n})\n\nconst tableFootRef = useTemplateRef('tableFoot')\n\ndefineExpose<_TableExposed>({\n  el: toRef(() => scrollRef.value?.el),\n  clearChecked,\n  clearSelected,\n  getRowByData,\n  getSummaryRow: () => tableFootRef.value!.getSummaryRow()\n})\n</script>\n"],"mappings":"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"}

package/dist/components/table/table.vue.d.ts

@@ -23,16 +23,16 @@ type __VLS_Slots = {
   append?: () => any;
 };
 declare const __VLS_base: _$vue.DefineComponent<TableProps, _TableExposed, {}, {}, {}, _$vue.ComponentOptionsMixin, _$vue.ComponentOptionsMixin, {} & {
-  "update:checked": (value: Record<string, any>[]) => any;
   "update:selected": (value: Record<string, any> | undefined) => any;
+  "update:checked": (value: Record<string, any>[]) => any;
   "update:rows": (rows: TableRow[]) => any;
   "update:forest": (rows?: _$_cat_kit_core0.Forest<Record<string, unknown>, any> | undefined) => any;
   "update:current": (row?: TableRow | undefined) => any;
   "cell-click": (row: TableRow, column: TableColumn, ev: MouseEvent) => any;
   "row-click": (row: TableRow, ev: MouseEvent) => any;
 }, string, _$vue.PublicProps, Readonly<TableProps> & Readonly<{
-  "onUpdate:checked"?: ((value: Record<string, any>[]) => any) | undefined;
   "onUpdate:selected"?: ((value: Record<string, any> | undefined) => any) | undefined;
+  "onUpdate:checked"?: ((value: Record<string, any>[]) => any) | undefined;
   "onUpdate:rows"?: ((rows: TableRow[]) => any) | undefined;
   "onUpdate:forest"?: ((rows?: _$_cat_kit_core0.Forest<Record<string, unknown>, any> | undefined) => any) | undefined;
   "onUpdate:current"?: ((row?: TableRow | undefined) => any) | undefined;

package/dist/components/table/use-columns.js

@@ -153,9 +153,13 @@ function useColumns(options) {
 		}
 	}, { immediate: true });
 	return {
+		/** 第一列 */
 		expandColumn,
+		/** 所有列 */
 		leafColumns,
+		/** 列 */
 		columns,
+		/** 表格头的分层展示 */
 		headers
 	};
 }

package/dist/components/table/use-columns.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-columns.js","names":["UButton","UIcon"],"sources":["../../../src/components/table/use-columns.ts"],"sourcesContent":["import { Forest, dfs, last } from '@cat-kit/core'\nimport { ArrowRight } from '@veltra/icons/normal'\nimport { type BEM } from '@veltra/utils'\nimport { computed, createVNode, shallowRef, watch, type ComputedRef, type ShallowRef } from 'vue'\n\nimport type { TableColumn, TableProps } from '../../types'\nimport { UButton } from '../button'\nimport { UIcon } from '../icon'\nimport { ColumnNode } from './node/col'\n\n/**\n * 定义表格列\n * @param columns 表格列\n */\nexport function defineTableColumns(\n  columns: TableColumn[],\n  commonProps?: Partial<Pick<TableColumn, 'align' | 'minWidth'>>\n): TableColumn[] {\n  columns.forEach((col) => {\n    dfs(col, (node) => {\n      for (const key in commonProps) {\n        if (node[key] !== undefined) continue\n        node[key] = commonProps[key]\n      }\n    })\n  })\n  return columns\n}\n\nexport interface ColumnConfig {\n  /** 表头 */\n  headers: ComputedRef<ColumnNode[][]>\n\n  /**\n   *  body列, 在body中使用\n   */\n  columns: ShallowRef<ColumnNode[]>\n\n  /** 所有叶子列 */\n  leafColumns: ShallowRef<ColumnNode[]>\n\n  /** 第一列 */\n  expandColumn: ShallowRef<ColumnNode | undefined>\n}\n\ninterface Options {\n  props: TableProps\n  cls: BEM<'table'>\n  /** 创建复选框 */\n  createCheckColumn: () => TableColumn\n  createSelectColumn: () => TableColumn\n  toggleAllTreeRowExpand: () => void\n}\n\nexport function useColumns(options: Options): ColumnConfig {\n  const { props, createCheckColumn, createSelectColumn, toggleAllTreeRowExpand, cls } = options\n\n  /** 前置列 */\n  const preColumns = computed<TableColumn[]>(() => {\n    const { selectable, checkable, showIndex } = props\n\n    const columns: TableColumn[] = []\n\n    if (selectable) {\n      columns.push(createSelectColumn())\n    } else if (checkable) {\n      columns.push(createCheckColumn())\n    }\n    if (showIndex) {\n      columns.push({\n        key: '__index__',\n        name: '#',\n        resizable: false,\n        width: 60,\n        minWidth: 60,\n        align: 'center',\n        fixed: 'left',\n        render({ row }) {\n          return row.index + 1\n        }\n      })\n    }\n\n    return columns\n  })\n\n  const columnForest = shallowRef<Forest<TableColumn, any>>()\n\n  const renderExpandAll = () =>\n    createVNode(\n      UButton,\n      {\n        text: true,\n        title: '展开或收起全部',\n        class: cls.e('expand-all'),\n        type: 'primary',\n        size: 'small',\n        circle: true,\n        onClick: (e) => {\n          e.stopPropagation()\n          toggleAllTreeRowExpand()\n        }\n      },\n      () => [createVNode(UIcon, undefined, () => [createVNode(ArrowRight)])]\n    )\n\n  watch(\n    [preColumns, () => props.columns, () => props.tree, () => props.expandable],\n    ([preColumns, columns, tree, expandable]) => {\n      /** 固定到左侧的列 */\n      const fixedOnLeft: TableColumn[] = [...preColumns]\n      /** 未固定的列 */\n      const unfixed: TableColumn[] = []\n      /** 固定到右侧的列 */\n      const fixedOnRight: TableColumn[] = []\n\n      columns?.forEach((column) => {\n        if (!column.fixed || column.children) {\n          column.fixed = undefined\n          return unfixed.push(column)\n        }\n        if (column.fixed === 'left') {\n          fixedOnLeft.push(column)\n        } else {\n          fixedOnRight.push(column)\n        }\n      })\n\n      if (last(fixedOnLeft)) {\n        last(fixedOnLeft)!.isLastFixed = true\n      }\n      if (fixedOnRight[0]) {\n        fixedOnRight[0].isFirstFixed = true\n      }\n\n      const sortedColumns = [...fixedOnLeft, ...unfixed, ...fixedOnRight]\n      // 操作时避免改变原数据\n      const firstColumn = { ...sortedColumns[0] } as TableColumn\n      sortedColumns[0] = firstColumn\n\n      // 树形表格需要给第一列添加展开按钮\n      // 因此要重新设置第一列的宽度和对齐方式\n      if ((!!tree || expandable) && firstColumn) {\n        firstColumn.align = 'left'\n        firstColumn.width = firstColumn.width ? firstColumn.width + 60 : undefined\n\n        const oldNameRender = firstColumn.nameRender\n\n        firstColumn.nameRender = oldNameRender\n          ? (ctx) => {\n              const oldNodes = oldNameRender!(ctx)\n              return [renderExpandAll(), ...(Array.isArray(oldNodes) ? oldNodes : [oldNodes])]\n            }\n          : () => {\n              return [renderExpandAll(), firstColumn.name]\n            }\n      }\n\n      const result = new Forest<TableColumn, any>({\n        data: sortedColumns,\n        createNode(data, index, depth, _f, parent) {\n          return new ColumnNode(data, index, depth, parent)\n        }\n      })\n\n      columnForest.value = result\n    },\n    { immediate: true }\n  )\n\n  const headers = computed(() => {\n    const headers: ColumnNode[][] = []\n    const forest = columnForest.value\n    if (!forest) return headers\n\n    // Forest.bfs 对每个根单独 BFS，按 depth 拼行会把后续根节点错放到深层，且根节点无 parent，\n    // 回溯 leafs 时会读到 undefined。这里从所有根一次性层序遍历，与多列表头布局一致。\n    const queue: ColumnNode[] = [...forest.roots]\n    while (queue.length > 0) {\n      const size = queue.length\n      const layer: ColumnNode[] = []\n      for (let i = 0; i < size; i++) {\n        const node = queue.shift()!\n        layer.push(node)\n        const ch = node.children\n        if (ch?.length) {\n          for (const c of ch) {\n            queue.push(c)\n          }\n        }\n      }\n      headers.push(layer)\n    }\n\n    // 从叶子节点开始回溯计算每个节点的累计叶子节点数量，叶子节点数量代表表头的宽度\n    for (let i = headers.length - 1; i > 0; i--) {\n      const header = headers[i]!\n\n      header.forEach((node) => {\n        const parent = node.parent\n        if (!parent) return\n        if (parent.leafs !== undefined) return\n        parent.leafs = parent.children!.reduce((sum, node) => {\n          return sum + (node.leafs ?? 1)\n        }, 0)\n      })\n    }\n\n    return headers\n  })\n\n  /** 除展开按钮之外的列 */\n  const columns = shallowRef<ColumnNode[]>([])\n\n  /** 所有叶子节点 */\n  const leafColumns = shallowRef<ColumnNode[]>([])\n\n  const expandColumn = shallowRef<ColumnNode>()\n\n  // 监听列的变化\n  watch(\n    [columnForest, () => props.tree, () => props.expandable],\n    ([forest, tree, expandable]) => {\n      const _columns: ColumnNode[] = []\n\n      forest?.dfs((node) => {\n        if (node.isLeaf) {\n          _columns.push(node)\n        }\n      })\n\n      leafColumns.value = _columns\n\n      if (tree || expandable) {\n        expandColumn.value = _columns[0]\n        columns.value = _columns.slice(1)\n      } else {\n        columns.value = _columns\n        expandColumn.value = undefined\n      }\n    },\n    { immediate: true }\n  )\n\n  return {\n    /** 第一列 */\n    expandColumn,\n    /** 所有列 */\n    leafColumns,\n    /** 列 */\n    columns,\n    /** 表格头的分层展示 */\n    headers\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAcA,SAAgB,mBACd,SACA,aACe;AACf,SAAQ,SAAS,QAAQ;AACvB,MAAI,MAAM,SAAS;AACjB,QAAK,MAAM,OAAO,aAAa;AAC7B,QAAI,KAAK,SAAS,KAAA,EAAW;AAC7B,SAAK,OAAO,YAAY;;IAE1B;GACF;AACF,QAAO;;AA4BT,SAAgB,WAAW,SAAgC;CACzD,MAAM,EAAE,OAAO,mBAAmB,oBAAoB,wBAAwB,QAAQ;;CAGtF,MAAM,aAAa,eAA8B;EAC/C,MAAM,EAAE,YAAY,WAAW,cAAc;EAE7C,MAAM,UAAyB,EAAE;AAEjC,MAAI,WACF,SAAQ,KAAK,oBAAoB,CAAC;WACzB,UACT,SAAQ,KAAK,mBAAmB,CAAC;AAEnC,MAAI,UACF,SAAQ,KAAK;GACX,KAAK;GACL,MAAM;GACN,WAAW;GACX,OAAO;GACP,UAAU;GACV,OAAO;GACP,OAAO;GACP,OAAO,EAAE,OAAO;AACd,WAAO,IAAI,QAAQ;;GAEtB,CAAC;AAGJ,SAAO;GACP;CAEF,MAAM,eAAe,YAAsC;CAE3D,MAAM,wBACJ,YACEA,aACA;EACE,MAAM;EACN,OAAO;EACP,OAAO,IAAI,EAAE,aAAa;EAC1B,MAAM;EACN,MAAM;EACN,QAAQ;EACR,UAAU,MAAM;AACd,KAAE,iBAAiB;AACnB,2BAAwB;;EAE3B,QACK,CAAC,YAAYC,WAAO,KAAA,SAAiB,CAAC,YAAY,WAAW,CAAC,CAAC,CAAC,CACvE;AAEH,OACE;EAAC;QAAkB,MAAM;QAAe,MAAM;QAAY,MAAM;EAAW,GAC1E,CAAC,YAAY,SAAS,MAAM,gBAAgB;;EAE3C,MAAM,cAA6B,CAAC,GAAG,WAAW;;EAElD,MAAM,UAAyB,EAAE;;EAEjC,MAAM,eAA8B,EAAE;AAEtC,WAAS,SAAS,WAAW;AAC3B,OAAI,CAAC,OAAO,SAAS,OAAO,UAAU;AACpC,WAAO,QAAQ,KAAA;AACf,WAAO,QAAQ,KAAK,OAAO;;AAE7B,OAAI,OAAO,UAAU,OACnB,aAAY,KAAK,OAAO;OAExB,cAAa,KAAK,OAAO;IAE3B;AAEF,MAAI,KAAK,YAAY,CACnB,MAAK,YAAY,CAAE,cAAc;AAEnC,MAAI,aAAa,GACf,cAAa,GAAG,eAAe;EAGjC,MAAM,gBAAgB;GAAC,GAAG;GAAa,GAAG;GAAS,GAAG;GAAa;EAEnE,MAAM,cAAc,EAAE,GAAG,cAAc,IAAI;AAC3C,gBAAc,KAAK;AAInB,OAAK,CAAC,CAAC,QAAQ,eAAe,aAAa;AACzC,eAAY,QAAQ;AACpB,eAAY,QAAQ,YAAY,QAAQ,YAAY,QAAQ,KAAK,KAAA;GAEjE,MAAM,gBAAgB,YAAY;AAElC,eAAY,aAAa,iBACpB,QAAQ;IACP,MAAM,WAAW,cAAe,IAAI;AACpC,WAAO,CAAC,iBAAiB,EAAE,GAAI,MAAM,QAAQ,SAAS,GAAG,WAAW,CAAC,SAAS,CAAE;aAE5E;AACJ,WAAO,CAAC,iBAAiB,EAAE,YAAY,KAAK;;;AAWpD,eAAa,QAPE,IAAI,OAAyB;GAC1C,MAAM;GACN,WAAW,MAAM,OAAO,OAAO,IAAI,QAAQ;AACzC,WAAO,IAAI,WAAW,MAAM,OAAO,OAAO,OAAO;;GAEpD,CAAC;IAIJ,EAAE,WAAW,MAAM,CACpB;CAED,MAAM,UAAU,eAAe;EAC7B,MAAM,UAA0B,EAAE;EAClC,MAAM,SAAS,aAAa;AAC5B,MAAI,CAAC,OAAQ,QAAO;EAIpB,MAAM,QAAsB,CAAC,GAAG,OAAO,MAAM;AAC7C,SAAO,MAAM,SAAS,GAAG;GACvB,MAAM,OAAO,MAAM;GACnB,MAAM,QAAsB,EAAE;AAC9B,QAAK,IAAI,IAAI,GAAG,IAAI,MAAM,KAAK;IAC7B,MAAM,OAAO,MAAM,OAAO;AAC1B,UAAM,KAAK,KAAK;IAChB,MAAM,KAAK,KAAK;AAChB,QAAI,IAAI,OACN,MAAK,MAAM,KAAK,GACd,OAAM,KAAK,EAAE;;AAInB,WAAQ,KAAK,MAAM;;AAIrB,OAAK,IAAI,IAAI,QAAQ,SAAS,GAAG,IAAI,GAAG,IACvB,SAAQ,GAEhB,SAAS,SAAS;GACvB,MAAM,SAAS,KAAK;AACpB,OAAI,CAAC,OAAQ;AACb,OAAI,OAAO,UAAU,KAAA,EAAW;AAChC,UAAO,QAAQ,OAAO,SAAU,QAAQ,KAAK,SAAS;AACpD,WAAO,OAAO,KAAK,SAAS;MAC3B,EAAE;IACL;AAGJ,SAAO;GACP;;CAGF,MAAM,UAAU,WAAyB,EAAE,CAAC;;CAG5C,MAAM,cAAc,WAAyB,EAAE,CAAC;CAEhD,MAAM,eAAe,YAAwB;AAG7C,OACE;EAAC;QAAoB,MAAM;QAAY,MAAM;EAAW,GACvD,CAAC,QAAQ,MAAM,gBAAgB;EAC9B,MAAM,WAAyB,EAAE;AAEjC,UAAQ,KAAK,SAAS;AACpB,OAAI,KAAK,OACP,UAAS,KAAK,KAAK;IAErB;AAEF,cAAY,QAAQ;AAEpB,MAAI,QAAQ,YAAY;AACtB,gBAAa,QAAQ,SAAS;AAC9B,WAAQ,QAAQ,SAAS,MAAM,EAAE;SAC5B;AACL,WAAQ,QAAQ;AAChB,gBAAa,QAAQ,KAAA;;IAGzB,EAAE,WAAW,MAAM,CACpB;AAED,QAAO;EAEL;EAEA;EAEA;EAEA;EACD"}
+{"version":3,"file":"use-columns.js","names":["UButton","UIcon"],"sources":["../../../src/components/table/use-columns.ts"],"sourcesContent":["import { Forest, dfs, last } from '@cat-kit/core'\nimport { ArrowRight } from '@veltra/icons/normal'\nimport { type BEM } from '@veltra/utils'\nimport { computed, createVNode, shallowRef, watch, type ComputedRef, type ShallowRef } from 'vue'\n\nimport type { TableColumn, TableProps } from '../../types'\nimport { UButton } from '../button'\nimport { UIcon } from '../icon'\nimport { ColumnNode } from './node/col'\n\n/**\n * 定义表格列\n * @param columns 表格列\n */\nexport function defineTableColumns(\n  columns: TableColumn[],\n  commonProps?: Partial<Pick<TableColumn, 'align' | 'minWidth'>>\n): TableColumn[] {\n  columns.forEach((col) => {\n    dfs(col, (node) => {\n      for (const key in commonProps) {\n        if (node[key] !== undefined) continue\n        node[key] = commonProps[key]\n      }\n    })\n  })\n  return columns\n}\n\nexport interface ColumnConfig {\n  /** 表头 */\n  headers: ComputedRef<ColumnNode[][]>\n\n  /**\n   *  body列, 在body中使用\n   */\n  columns: ShallowRef<ColumnNode[]>\n\n  /** 所有叶子列 */\n  leafColumns: ShallowRef<ColumnNode[]>\n\n  /** 第一列 */\n  expandColumn: ShallowRef<ColumnNode | undefined>\n}\n\ninterface Options {\n  props: TableProps\n  cls: BEM<'table'>\n  /** 创建复选框 */\n  createCheckColumn: () => TableColumn\n  createSelectColumn: () => TableColumn\n  toggleAllTreeRowExpand: () => void\n}\n\nexport function useColumns(options: Options): ColumnConfig {\n  const { props, createCheckColumn, createSelectColumn, toggleAllTreeRowExpand, cls } = options\n\n  /** 前置列 */\n  const preColumns = computed<TableColumn[]>(() => {\n    const { selectable, checkable, showIndex } = props\n\n    const columns: TableColumn[] = []\n\n    if (selectable) {\n      columns.push(createSelectColumn())\n    } else if (checkable) {\n      columns.push(createCheckColumn())\n    }\n    if (showIndex) {\n      columns.push({\n        key: '__index__',\n        name: '#',\n        resizable: false,\n        width: 60,\n        minWidth: 60,\n        align: 'center',\n        fixed: 'left',\n        render({ row }) {\n          return row.index + 1\n        }\n      })\n    }\n\n    return columns\n  })\n\n  const columnForest = shallowRef<Forest<TableColumn, any>>()\n\n  const renderExpandAll = () =>\n    createVNode(\n      UButton,\n      {\n        text: true,\n        title: '展开或收起全部',\n        class: cls.e('expand-all'),\n        type: 'primary',\n        size: 'small',\n        circle: true,\n        onClick: (e) => {\n          e.stopPropagation()\n          toggleAllTreeRowExpand()\n        }\n      },\n      () => [createVNode(UIcon, undefined, () => [createVNode(ArrowRight)])]\n    )\n\n  watch(\n    [preColumns, () => props.columns, () => props.tree, () => props.expandable],\n    ([preColumns, columns, tree, expandable]) => {\n      /** 固定到左侧的列 */\n      const fixedOnLeft: TableColumn[] = [...preColumns]\n      /** 未固定的列 */\n      const unfixed: TableColumn[] = []\n      /** 固定到右侧的列 */\n      const fixedOnRight: TableColumn[] = []\n\n      columns?.forEach((column) => {\n        if (!column.fixed || column.children) {\n          column.fixed = undefined\n          return unfixed.push(column)\n        }\n        if (column.fixed === 'left') {\n          fixedOnLeft.push(column)\n        } else {\n          fixedOnRight.push(column)\n        }\n      })\n\n      if (last(fixedOnLeft)) {\n        last(fixedOnLeft)!.isLastFixed = true\n      }\n      if (fixedOnRight[0]) {\n        fixedOnRight[0].isFirstFixed = true\n      }\n\n      const sortedColumns = [...fixedOnLeft, ...unfixed, ...fixedOnRight]\n      // 操作时避免改变原数据\n      const firstColumn = { ...sortedColumns[0] } as TableColumn\n      sortedColumns[0] = firstColumn\n\n      // 树形表格需要给第一列添加展开按钮\n      // 因此要重新设置第一列的宽度和对齐方式\n      if ((!!tree || expandable) && firstColumn) {\n        firstColumn.align = 'left'\n        firstColumn.width = firstColumn.width ? firstColumn.width + 60 : undefined\n\n        const oldNameRender = firstColumn.nameRender\n\n        firstColumn.nameRender = oldNameRender\n          ? (ctx) => {\n              const oldNodes = oldNameRender!(ctx)\n              return [renderExpandAll(), ...(Array.isArray(oldNodes) ? oldNodes : [oldNodes])]\n            }\n          : () => {\n              return [renderExpandAll(), firstColumn.name]\n            }\n      }\n\n      const result = new Forest<TableColumn, any>({\n        data: sortedColumns,\n        createNode(data, index, depth, _f, parent) {\n          return new ColumnNode(data, index, depth, parent)\n        }\n      })\n\n      columnForest.value = result\n    },\n    { immediate: true }\n  )\n\n  const headers = computed(() => {\n    const headers: ColumnNode[][] = []\n    const forest = columnForest.value\n    if (!forest) return headers\n\n    // Forest.bfs 对每个根单独 BFS，按 depth 拼行会把后续根节点错放到深层，且根节点无 parent，\n    // 回溯 leafs 时会读到 undefined。这里从所有根一次性层序遍历，与多列表头布局一致。\n    const queue: ColumnNode[] = [...forest.roots]\n    while (queue.length > 0) {\n      const size = queue.length\n      const layer: ColumnNode[] = []\n      for (let i = 0; i < size; i++) {\n        const node = queue.shift()!\n        layer.push(node)\n        const ch = node.children\n        if (ch?.length) {\n          for (const c of ch) {\n            queue.push(c)\n          }\n        }\n      }\n      headers.push(layer)\n    }\n\n    // 从叶子节点开始回溯计算每个节点的累计叶子节点数量，叶子节点数量代表表头的宽度\n    for (let i = headers.length - 1; i > 0; i--) {\n      const header = headers[i]!\n\n      header.forEach((node) => {\n        const parent = node.parent\n        if (!parent) return\n        if (parent.leafs !== undefined) return\n        parent.leafs = parent.children!.reduce((sum, node) => {\n          return sum + (node.leafs ?? 1)\n        }, 0)\n      })\n    }\n\n    return headers\n  })\n\n  /** 除展开按钮之外的列 */\n  const columns = shallowRef<ColumnNode[]>([])\n\n  /** 所有叶子节点 */\n  const leafColumns = shallowRef<ColumnNode[]>([])\n\n  const expandColumn = shallowRef<ColumnNode>()\n\n  // 监听列的变化\n  watch(\n    [columnForest, () => props.tree, () => props.expandable],\n    ([forest, tree, expandable]) => {\n      const _columns: ColumnNode[] = []\n\n      forest?.dfs((node) => {\n        if (node.isLeaf) {\n          _columns.push(node)\n        }\n      })\n\n      leafColumns.value = _columns\n\n      if (tree || expandable) {\n        expandColumn.value = _columns[0]\n        columns.value = _columns.slice(1)\n      } else {\n        columns.value = _columns\n        expandColumn.value = undefined\n      }\n    },\n    { immediate: true }\n  )\n\n  return {\n    /** 第一列 */\n    expandColumn,\n    /** 所有列 */\n    leafColumns,\n    /** 列 */\n    columns,\n    /** 表格头的分层展示 */\n    headers\n  }\n}\n"],"mappings":"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"}

package/dist/components/table/use-fixed-columns.js

@@ -1,22 +1,41 @@
-import { ref } from "vue";
+import { ref, watch } from "vue";
 import { debounce } from "@cat-kit/core";
 //#region src/components/table/use-fixed-columns.ts
 /**
 * 固定列
 * @returns
 */
-function useFixedColumns() {
+function useFixedColumns(options = {}) {
+	const { isScrolling } = options;
 	const leftFixed = ref(false);
 	const rightFixed = ref(false);
+	let pendingLeft = null;
+	let pendingRight = null;
+	const applyImmediate = (nextLeft, nextRight) => {
+		if (nextLeft !== leftFixed.value) leftFixed.value = nextLeft;
+		if (nextRight !== rightFixed.value) rightFixed.value = nextRight;
+		pendingLeft = null;
+		pendingRight = null;
+	};
+	const handleScroll = debounce((e) => {
+		const nextLeft = e.x > 0;
+		const nextRight = !(e.cw + e.x + 1 >= e.sw);
+		if (isScrolling?.value) {
+			pendingLeft = nextLeft;
+			pendingRight = nextRight;
+			return;
+		}
+		applyImmediate(nextLeft, nextRight);
+	}, 50);
+	if (isScrolling) watch(isScrolling, (v) => {
+		if (v) return;
+		if (pendingLeft === null && pendingRight === null) return;
+		applyImmediate(pendingLeft ?? leftFixed.value, pendingRight ?? rightFixed.value);
+	});
 	return {
 		leftFixed,
 		rightFixed,
-		handleScroll: debounce((e) => {
-			if (e.x > 0) leftFixed.value = true;
-			else leftFixed.value = false;
-			if (e.cw + e.x + 1 >= e.sw) rightFixed.value = false;
-			else rightFixed.value = true;
-		}, 50)
+		handleScroll
 	};
 }
 //#endregion

package/dist/components/table/use-fixed-columns.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-fixed-columns.js","names":[],"sources":["../../../src/components/table/use-fixed-columns.ts"],"sourcesContent":["import { debounce } from '@cat-kit/core'\nimport { type ShallowRef, ref } from 'vue'\n\nimport type { ScrollPosition } from '../../types'\n\ninterface UseColumnFixedReturned {\n  leftFixed: ShallowRef<boolean>\n  rightFixed: ShallowRef<boolean>\n  handleScroll: (e: Required<ScrollPosition>) => void\n}\n\n/**\n * 固定列\n * @returns\n */\nexport function useFixedColumns(): UseColumnFixedReturned {\n  const leftFixed = ref(false)\n  const rightFixed = ref(false)\n\n  const handleScroll = debounce((e: Required<ScrollPosition>) => {\n    if (e.x > 0) {\n      leftFixed.value = true\n    } else {\n      leftFixed.value = false\n    }\n\n    // 精度修正\n    if (e.cw + e.x + 1 >= e.sw) {\n      rightFixed.value = false\n    } else {\n      rightFixed.value = true\n    }\n  }, 50)\n\n  return { leftFixed, rightFixed, handleScroll }\n}\n"],"mappings":";;;;;;;AAeA,SAAgB,kBAA0C;CACxD,MAAM,YAAY,IAAI,MAAM;CAC5B,MAAM,aAAa,IAAI,MAAM;AAiB7B,QAAO;EAAE;EAAW;EAAY,cAfX,UAAU,MAAgC;AAC7D,OAAI,EAAE,IAAI,EACR,WAAU,QAAQ;OAElB,WAAU,QAAQ;AAIpB,OAAI,EAAE,KAAK,EAAE,IAAI,KAAK,EAAE,GACtB,YAAW,QAAQ;OAEnB,YAAW,QAAQ;KAEpB,GAAG;EAEwC"}
+{"version":3,"file":"use-fixed-columns.js","names":[],"sources":["../../../src/components/table/use-fixed-columns.ts"],"sourcesContent":["import { debounce } from '@cat-kit/core'\nimport { type ShallowRef, type Ref, ref, watch } from 'vue'\n\nimport type { ScrollPosition } from '../../types'\n\ninterface UseColumnFixedReturned {\n  leftFixed: ShallowRef<boolean>\n  rightFixed: ShallowRef<boolean>\n  handleScroll: (e: Required<ScrollPosition>) => void\n}\n\ninterface Options {\n  /**\n   * D1：滚动中 (`true`) 暂缓 `leftFixed` / `rightFixed` 的切换，滚动结束后\n   * 一次性补算。\n   *\n   * 背景：固定列的阴影是通过在 cell 上切换 `is-last-fixed` / `is-first-fixed`\n   * 等 class 实现的，这些 class 会穿透到 `useTable.getCellClass` 的缓存键，\n   * 任何一次切换都会让全表的单元格类名失效重算。滚动本身并不需要实时更新阴影，\n   * 因此把切换推迟到 `isScrolling` 归零时做一次即可。\n   *\n   * 未传入时退化到旧行为（实时切换）。\n   */\n  isScrolling?: Ref<boolean>\n}\n\n/**\n * 固定列\n * @returns\n */\nexport function useFixedColumns(options: Options = {}): UseColumnFixedReturned {\n  const { isScrolling } = options\n\n  const leftFixed = ref(false)\n  const rightFixed = ref(false)\n\n  let pendingLeft: boolean | null = null\n  let pendingRight: boolean | null = null\n\n  const applyImmediate = (nextLeft: boolean, nextRight: boolean): void => {\n    if (nextLeft !== leftFixed.value) leftFixed.value = nextLeft\n    if (nextRight !== rightFixed.value) rightFixed.value = nextRight\n    pendingLeft = null\n    pendingRight = null\n  }\n\n  const handleScroll = debounce((e: Required<ScrollPosition>) => {\n    const nextLeft = e.x > 0\n    // 精度修正：浏览器滚动条最后 1px 的误差\n    const nextRight = !(e.cw + e.x + 1 >= e.sw)\n\n    if (isScrolling?.value) {\n      pendingLeft = nextLeft\n      pendingRight = nextRight\n      return\n    }\n\n    applyImmediate(nextLeft, nextRight)\n  }, 50)\n\n  if (isScrolling) {\n    watch(isScrolling, (v) => {\n      if (v) return\n      if (pendingLeft === null && pendingRight === null) return\n      applyImmediate(pendingLeft ?? leftFixed.value, pendingRight ?? rightFixed.value)\n    })\n  }\n\n  return { leftFixed, rightFixed, handleScroll }\n}\n"],"mappings":";;;;;;;AA8BA,SAAgB,gBAAgB,UAAmB,EAAE,EAA0B;CAC7E,MAAM,EAAE,gBAAgB;CAExB,MAAM,YAAY,IAAI,MAAM;CAC5B,MAAM,aAAa,IAAI,MAAM;CAE7B,IAAI,cAA8B;CAClC,IAAI,eAA+B;CAEnC,MAAM,kBAAkB,UAAmB,cAA6B;AACtE,MAAI,aAAa,UAAU,MAAO,WAAU,QAAQ;AACpD,MAAI,cAAc,WAAW,MAAO,YAAW,QAAQ;AACvD,gBAAc;AACd,iBAAe;;CAGjB,MAAM,eAAe,UAAU,MAAgC;EAC7D,MAAM,WAAW,EAAE,IAAI;EAEvB,MAAM,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,KAAK,EAAE;AAExC,MAAI,aAAa,OAAO;AACtB,iBAAc;AACd,kBAAe;AACf;;AAGF,iBAAe,UAAU,UAAU;IAClC,GAAG;AAEN,KAAI,YACF,OAAM,cAAc,MAAM;AACxB,MAAI,EAAG;AACP,MAAI,gBAAgB,QAAQ,iBAAiB,KAAM;AACnD,iBAAe,eAAe,UAAU,OAAO,gBAAgB,WAAW,MAAM;GAChF;AAGJ,QAAO;EAAE;EAAW;EAAY;EAAc"}

package/dist/components/table/use-rows.js

@@ -4,7 +4,7 @@ import { Forest, o } from "@cat-kit/core";
 import { useModel as useModel$1 } from "@veltra/compositions";
 //#region src/components/table/use-rows.ts
 function useRows(options) {
-	const { props, emit } = options;
+	const { props, emit, isScrolling } = options;
 	/** 所有可见的行 */
 	const rows = shallowRef([]);
 	/** 数据行， 不包括展开和折叠的行 */
@@ -145,7 +145,7 @@ function useRows(options) {
 		}
 	}
 	function handleRowClick(row, e) {
-		currentRow.value = currentRow.value === row ? void 0 : row;
+		if (!isScrolling?.value) currentRow.value = currentRow.value === row ? void 0 : row;
 		emit("row-click", row, e);
 	}
 	function handleCellClick(row, column, e) {