@dtjoy/dt-design 1.1.2 → 1.1.5

package/es/table/features/resize/ResizeHandle.js

@@ -0,0 +1,99 @@
+import * as React from 'react';
+import TableMeasureRowContext from "../../TableMeasureRowContext";
+/** 键盘步进(px) */
+var KEYBOARD_STEP = 10;
+
+/**
+ * 表头列宽拖拽手柄
+ *
+ * 渲染在 th 右侧边缘：
+ * - 鼠标 hover 时显示高亮粗边框（提示可拖拽）
+ * - 拖拽中由容器内的 ResizeLine 显示竖线
+ * - 键盘可达：Tab 聚焦后用方向键调整列宽
+ */
+var ResizeHandle = function ResizeHandle(_ref) {
+  var _column$minWidth2, _column$maxWidth;
+  var column = _ref.column,
+    onStartResize = _ref.onStartResize,
+    onKeyboardResize = _ref.onKeyboardResize,
+    prefixCls = _ref.prefixCls;
+  var inMeasureRow = React.useContext(TableMeasureRowContext);
+  var handleMouseDown = React.useCallback(function (e) {
+    if (inMeasureRow) {
+      e.preventDefault();
+      return;
+    }
+    // 测量 th 的实际渲染宽度，避免 table-layout: fixed 下的宽度偏差
+    var th = e.currentTarget.closest('th');
+    var actualWidth = th ? th.offsetWidth : undefined;
+    onStartResize(e, column, actualWidth);
+  }, [column, onStartResize]);
+  var handleKeyDown = React.useCallback(function (e) {
+    var _column$minWidth;
+    if (inMeasureRow) {
+      e.preventDefault();
+      return;
+    }
+    var th = e.currentTarget.closest('th');
+    var currentWidth = th ? th.offsetWidth : typeof column.width === 'number' ? column.width : 0;
+    var minWidth = (_column$minWidth = column.minWidth) !== null && _column$minWidth !== void 0 ? _column$minWidth : 60;
+    var maxWidth = column.maxWidth;
+    switch (e.key) {
+      case 'ArrowLeft':
+        e.preventDefault();
+        onKeyboardResize(column, currentWidth - KEYBOARD_STEP);
+        break;
+      case 'ArrowRight':
+        e.preventDefault();
+        onKeyboardResize(column, currentWidth + KEYBOARD_STEP);
+        break;
+      case 'Home':
+        e.preventDefault();
+        onKeyboardResize(column, minWidth);
+        break;
+      case 'End':
+        e.preventDefault();
+        onKeyboardResize(column, maxWidth !== null && maxWidth !== void 0 ? maxWidth : currentWidth * 2);
+        break;
+    }
+  }, [column, onKeyboardResize]);
+
+  // aria 属性需要数值类型
+  var widthNum = typeof column.width === 'number' ? column.width : Number(column.width) || 0;
+  var ariaLabel = typeof column.title === 'string' ? "\u8C03\u6574\u5217\u5BBD: ".concat(column.title) : '调整列宽';
+
+  // 测量行内的手柄对用户不可见，必须从 Tab 顺序和辅助技术中移除，
+  // 避免键盘用户聚焦到隐藏元素。
+  if (inMeasureRow) {
+    return /*#__PURE__*/React.createElement("span", {
+      className: "".concat(prefixCls, "-resize-handle"),
+      "aria-hidden": true,
+      tabIndex: -1,
+      onMouseDown: handleMouseDown,
+      onKeyDown: handleKeyDown,
+      onClick: function onClick(e) {
+        e.stopPropagation();
+      }
+    });
+  }
+  return /*#__PURE__*/React.createElement("span", {
+    className: "".concat(prefixCls, "-resize-handle"),
+    role: "separator"
+    // ARIA window-splitter 模式:可聚焦的 separator 属于 widget(ARIA 1.2),
+    // 键盘调宽需要 tabIndex=0。jsx-a11y 的角色分类滞后于规范,误报为非交互元素。
+    // eslint-disable-next-line jsx-a11y/no-noninteractive-tabindex
+    ,
+    tabIndex: 0,
+    "aria-orientation": "vertical",
+    "aria-label": ariaLabel,
+    "aria-valuenow": widthNum,
+    "aria-valuemin": (_column$minWidth2 = column.minWidth) !== null && _column$minWidth2 !== void 0 ? _column$minWidth2 : 60,
+    "aria-valuemax": (_column$maxWidth = column.maxWidth) !== null && _column$maxWidth !== void 0 ? _column$maxWidth : undefined,
+    onMouseDown: handleMouseDown,
+    onKeyDown: handleKeyDown,
+    onClick: function onClick(e) {
+      e.stopPropagation();
+    }
+  });
+};
+export default ResizeHandle;

package/es/table/features/resize/index.d.ts

@@ -0,0 +1,5 @@
+export { default as ResizeHandle } from './ResizeHandle';
+export { default as transformResizableColumns } from './transformResizableColumns';
+export type { TransformResizableOptions } from './transformResizableColumns';
+export { default as useResize } from './useResize';
+export type { UseResizeOptions } from './useResize';

package/es/table/features/resize/index.js

@@ -0,0 +1,3 @@
+export { default as ResizeHandle } from "./ResizeHandle";
+export { default as transformResizableColumns } from "./transformResizableColumns";
+export { default as useResize } from "./useResize";

package/es/table/features/resize/transformResizableColumns.d.ts

@@ -0,0 +1,11 @@
+import * as React from 'react';
+import type { ColumnsType, ColumnType } from '../../interface';
+export interface TransformResizableOptions {
+    prefixCls: string;
+    enabled: boolean;
+    isColumnResizable: (col: ColumnType) => boolean;
+    onStartResize: (e: React.MouseEvent, col: ColumnType, actualWidth?: number) => void;
+    onKeyboardResize: (col: ColumnType, newWidth: number) => void;
+}
+declare function transformResizableColumns<RecordType = any>(columns: ColumnsType<RecordType>, options: TransformResizableOptions): ColumnsType<RecordType>;
+export default transformResizableColumns;

package/es/table/features/resize/transformResizableColumns.js

@@ -0,0 +1,52 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import * as React from 'react';
+import ResizeHandle from "./ResizeHandle";
+function transformResizableColumns(columns, options) {
+  var prefixCls = options.prefixCls,
+    enabled = options.enabled,
+    isColumnResizable = options.isColumnResizable,
+    onStartResize = options.onStartResize,
+    onKeyboardResize = options.onKeyboardResize;
+  if (!enabled) return columns;
+  var walk = function walk(cols) {
+    return cols.map(function (col) {
+      var groupCol = col;
+      if (groupCol.children && groupCol.children.length > 0) {
+        return _objectSpread(_objectSpread({}, col), {}, {
+          children: walk(groupCol.children)
+        });
+      }
+      var leafCol = col;
+      if (!isColumnResizable(leafCol)) return col;
+      var originTitle = leafCol.title;
+      var title = /*#__PURE__*/React.createElement(React.Fragment, null, originTitle, /*#__PURE__*/React.createElement(ResizeHandle, {
+        column: leafCol,
+        prefixCls: prefixCls,
+        onStartResize: onStartResize,
+        onKeyboardResize: onKeyboardResize
+      }));
+
+      // 注入 cell-resizable class，使 th 获得 overflow: visible
+      // （抵消 cell-ellipsis 的 overflow: hidden，防止 resize handle 被裁剪）
+      var resizableClassName = "".concat(prefixCls, "-cell-resizable");
+      var originOnHeaderCell = leafCol.onHeaderCell;
+      return _objectSpread(_objectSpread({}, leafCol), {}, {
+        title: title,
+        onHeaderCell: function onHeaderCell(column) {
+          var cell = (originOnHeaderCell === null || originOnHeaderCell === void 0 ? void 0 : originOnHeaderCell(column)) || {};
+          var cellClassName = cell.className;
+          return _objectSpread(_objectSpread({}, cell), {}, {
+            className: cellClassName ? "".concat(cellClassName, " ").concat(resizableClassName) : resizableClassName
+          });
+        }
+      });
+    });
+  };
+  return walk(columns);
+}
+export default transformResizableColumns;

package/es/table/features/resize/useResize.d.ts

@@ -0,0 +1,52 @@
+import * as React from 'react';
+import type { ColumnsType, ColumnType, Key } from '../../interface';
+export interface UseResizeOptions {
+    columns: ColumnsType;
+    /** 是否全局启用 resize */
+    enabled?: boolean;
+    /** 全局最小列宽 */
+    defaultMinWidth?: number;
+    /** 表格容器 ref（用于定位竖线） */
+    containerRef?: React.RefObject<HTMLElement>;
+    /** 列宽变化回调 */
+    onColumnResize?: (key: Key, width: number) => void;
+    /** 样式前缀，用于查找表格本体容器 */
+    prefixCls: string;
+}
+/**
+ * 表头拖拽改变列宽的 hook
+ *
+ * 核心交互策略：
+ *
+ * **初始弹性分配**：
+ * - 初始所有列为"弹性列"，按 baseWidth 比例分配容器剩余空间，填满容器
+ * - remainder > 0：弹性列膨胀；remainder < 0：弹性列收缩（不低于 minWidth）
+ *
+ * **拖拽冻结**：
+ * - 松手时，将所有列的 baseWidth 冻结为当前渲染宽度，并全部标记为固定列
+ * - 这样松手后 remainder ≈ 0，不会触发 flex 重分配
+ * - 列边界精确停留在鼠标位置（跟手）
+ * - 总宽 = 渲染宽度之和，可能 ≠ containerWidth（出现滚动条或空白）
+ * - 用户可调用 resetColumnWidths 恢复所有列为弹性列
+ *
+ * **拖拽精度**：
+ * - 使用 th.offsetWidth（实际渲染宽度）作为拖拽起点
+ * - 用户拖 N px → 新宽度 = 渲染宽度 ± N px，松手后冻结，视觉无跳变
+ *
+ * **其他特性**：
+ * - 容器宽度测量滚动区域 clientWidth，自动排除垂直滚动条
+ * - scrollX = 列宽总和，覆盖 scroll.x 避免 table-layout:fixed 下的浏览器重分配
+ * - rAF + 直接 DOM 操作实现高性能拖拽
+ */
+declare function useResize({ columns, enabled, defaultMinWidth, containerRef, onColumnResize, prefixCls, }: UseResizeOptions): {
+    resizingKey: React.Key | null;
+    lineRef: React.RefObject<HTMLDivElement>;
+    renderWidths: Map<React.Key, number>;
+    scrollX: number | null;
+    getColumnRenderWidth: (col: ColumnType) => number | undefined;
+    isColumnResizable: (col: ColumnType) => boolean;
+    onStartResize: (e: React.MouseEvent, col: ColumnType, actualWidth?: number) => void;
+    setColumnWidth: (col: ColumnType, newWidth: number) => void;
+    resetColumnWidths: () => void;
+};
+export default useResize;