yc-pro-components 0.0.76 → 0.0.77

package/es/components/index.mjs

@@ -47,6 +47,7 @@ export { useVirtualScroll } from './virtual-table/src/use-virtual-scroll.mjs';
 export { DEFAULT_CDN_CONFIG, DEFAULT_YC_CONFIG, YC_CONFIG_KEY } from './yc-config-provider/src/type.mjs';
 export { useYcAuth, useYcCdn, useYcCdnUrl, useYcComponentConfig, useYcConfig, useYcPerms, useYcShowPageSearch, useYcTranslate } from './yc-config-provider/src/useYcConfig.mjs';
 export { useHeaderFilter } from './yc-plus-page/src/use-header-filter.mjs';
+export { useTableDragScroll } from '../hooks/useTableDragScroll.mjs';
 export { useLocalHeaderFilter } from './yc-plus-page/src/use-local-header-filter.mjs';
 export { DEFAULT_OPERATORS, NO_VALUE_OPERATORS, OPERATOR_CATALOG, OPERATOR_LABELS } from './yc-plus-page/src/constants.mjs';
 export { default as ReSelectV2, default as YcSelectV2 } from './yc-select-v2/src/index.vue.mjs';

package/es/components/yc-plus-page/index.d.ts

@@ -4,6 +4,8 @@ import { DefineComponent } from 'vue';
 export type { YcPlusPageProps, FieldCatalogItem, FieldCatalog, OperatorOption, HeaderFilterConfig, ColumnHeaderFilterConfig, HeaderFilterPayload, HeaderFilterResetPayload, FilterItem, HeaderFiltersState, OrderByItem, RequestResponse } from './src/type';
 export { useHeaderFilter } from './src/use-header-filter';
 export type { UseHeaderFilterOptions, UseHeaderFilterReturn } from './src/use-header-filter';
+export type { UseTableDragScrollOptions, UseTableDragScrollReturn, TableLikeRef } from '../../hooks/useTableDragScroll';
+export { useTableDragScroll } from '../../hooks/useTableDragScroll';
 export { useLocalHeaderFilter } from './src/use-local-header-filter';
 export type { LocalFilterColumnConfig, UseLocalHeaderFilterOptions, UseLocalHeaderFilterReturn } from './src/use-local-header-filter';
 export { OPERATOR_CATALOG, OPERATOR_LABELS, NO_VALUE_OPERATORS, DEFAULT_OPERATORS } from './src/constants';

package/es/components/yc-plus-page/index.mjs

@@ -1,6 +1,7 @@
 import YcPlusPageComponent from './src/index.vue.mjs';
 import YcTableHeaderFilterCellComponent from './src/header-filter-cell.vue.mjs';
 export { useHeaderFilter } from './src/use-header-filter.mjs';
+export { useTableDragScroll } from '../../hooks/useTableDragScroll.mjs';
 export { useLocalHeaderFilter } from './src/use-local-header-filter.mjs';
 export { DEFAULT_OPERATORS, NO_VALUE_OPERATORS, OPERATOR_CATALOG, OPERATOR_LABELS } from './src/constants.mjs';
 

package/es/components/yc-plus-page/src/index.vue.d.ts

@@ -8,6 +8,7 @@ import { RequestResponse, HeaderFilterConfig, HeaderFilterPayload, HeaderFilterR
 import { FieldValues, OmitTypes, CascaderProps, FormItemValueType, FieldValueType } from 'yc-pro-components/es/types/form';
 import { PlusSearchSelfProps } from 'yc-pro-components/es/components/search';
 import { PageInfo, PlusColumn, PropsItemType, OptionsType, RenderTypes, OptionsRow } from 'yc-pro-components/es/types/plus';
+import { UseTableDragScrollOptions } from 'yc-pro-components/es/hooks/useTableDragScroll';
 import { nextTick, DefineComponent, Ref, ComponentInternalInstance, CSSProperties, VNodeProps, AllowedComponentProps, ComponentCustomProps, ExtractPropTypes, PropType, Slot, ComponentPublicInstance, ComponentOptionsBase, Component, ComponentOptionsMixin, DebuggerEvent, WatchOptions, WatchStopHandle, ShallowUnwrapRef, ComponentCustomProperties, ComputedRef, ShallowRef, PublicProps } from 'vue';
 
 /**
@@ -69,6 +70,14 @@ interface Props {
      * @description 不传时使用 YcConfigProvider 的 components.plusPage.columnSettingsText，再缺省为「字段管理」
      */
     columnSettingsText?: string;
+    /**
+     * 是否启用表格横向拖拽滚动
+     * - true: 使用默认配置启用
+     * - 对象: 自定义配置（resizeAreaWidth / scrollContainerSelector 等）
+     * - false / 不传: 关闭（默认）
+     * @default false
+     */
+    dragScroll?: boolean | UseTableDragScrollOptions;
 }
 declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<Props>, {
     isCard: boolean;
@@ -85,6 +94,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
     columnCacheKey: undefined;
     disableColumnCache: boolean;
     columnSettingsText: undefined;
+    dragScroll: boolean;
 }>, {
     plusPageRef: Ref<({
         $: ComponentInternalInstance;
@@ -1201,6 +1211,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                 } & RecordType>>;
                                 readonly formItemProps: PropsItemType< Mutable<FormItemProps> & {
                                     [key: string]: any;
+                                    /**
+                                     * 使用表头筛选 Hook
+                                     * 使用 getter 函数传递 props 以保持响应性
+                                     */
                                     style?: CSSProperties | undefined;
                                 }>;
                                 readonly fieldProps: PropsItemType<Partial<{
@@ -1309,6 +1323,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                 } & RecordType>>;
                                 readonly formItemProps: PropsItemType< Mutable<FormItemProps> & {
                                     [key: string]: any;
+                                    /**
+                                     * 使用表头筛选 Hook
+                                     * 使用 getter 函数传递 props 以保持响应性
+                                     */
                                     style?: CSSProperties | undefined;
                                 }>;
                                 readonly fieldProps: PropsItemType<Partial<{
@@ -2105,6 +2123,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             } & RecordType>>;
                             readonly formItemProps: PropsItemType< Mutable<FormItemProps> & {
                                 [key: string]: any;
+                                /**
+                                 * 使用表头筛选 Hook
+                                 * 使用 getter 函数传递 props 以保持响应性
+                                 */
                                 style?: CSSProperties | undefined;
                             }>;
                             readonly fieldProps: PropsItemType<Partial<{
@@ -2213,6 +2235,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             } & RecordType>>;
                             readonly formItemProps: PropsItemType< Mutable<FormItemProps> & {
                                 [key: string]: any;
+                                /**
+                                 * 使用表头筛选 Hook
+                                 * 使用 getter 函数传递 props 以保持响应性
+                                 */
                                 style?: CSSProperties | undefined;
                             }>;
                             readonly fieldProps: PropsItemType<Partial<{
@@ -2339,6 +2365,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         } & RecordType>>;
                         readonly formItemProps: PropsItemType< Mutable<FormItemProps> & {
                             [key: string]: any;
+                            /**
+                             * 使用表头筛选 Hook
+                             * 使用 getter 函数传递 props 以保持响应性
+                             */
                             style?: CSSProperties | undefined;
                         }>;
                         readonly fieldProps: PropsItemType<Partial<{
@@ -2451,6 +2481,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     columns: PlusColumn[];
                     headerCellStyle: Partial< CSSProperties> | Partial<(data: {
                         row: any[];
+                        /** 分页配置 */
                         rowIndex: number;
                         column: TableColumnCtx<any[]>;
                         columnIndex: number;
@@ -2498,6 +2529,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     readonly columns: PlusColumn[];
                     readonly headerCellStyle: Partial< CSSProperties> | Partial<(data: {
                         row: any[];
+                        /** 分页配置 */
                         rowIndex: number;
                         column: TableColumnCtx<any[]>;
                         columnIndex: number;
@@ -2568,6 +2600,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     headerCellStyle: {
                         type: PropType<Partial< CSSProperties> | Partial<(data: {
                             row: any[];
+                            /** 分页配置 */
                             rowIndex: number;
                             column: TableColumnCtx<any[]>;
                             columnIndex: number;
@@ -2731,6 +2764,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     headerCellStyle: {
                         type: PropType<Partial< CSSProperties> | Partial<(data: {
                             row: any[];
+                            /** 分页配置 */
                             rowIndex: number;
                             column: TableColumnCtx<any[]>;
                             columnIndex: number;
@@ -2885,6 +2919,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     columns: PlusColumn[];
                     headerCellStyle: Partial< CSSProperties> | Partial<(data: {
                         row: any[];
+                        /** 分页配置 */
                         rowIndex: number;
                         column: TableColumnCtx<any[]>;
                         columnIndex: number;
@@ -2962,6 +2997,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 headerCellStyle: {
                     type: PropType<Partial< CSSProperties> | Partial<(data: {
                         row: any[];
+                        /** 分页配置 */
                         rowIndex: number;
                         column: TableColumnCtx<any[]>;
                         columnIndex: number;
@@ -4652,6 +4688,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             } & RecordType>>;
                             readonly formItemProps: PropsItemType< Mutable<FormItemProps> & {
                                 [key: string]: any;
+                                /**
+                                 * 使用表头筛选 Hook
+                                 * 使用 getter 函数传递 props 以保持响应性
+                                 */
                                 style?: CSSProperties | undefined;
                             }>;
                             readonly fieldProps: PropsItemType<Partial<{
@@ -4760,6 +4800,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             } & RecordType>>;
                             readonly formItemProps: PropsItemType< Mutable<FormItemProps> & {
                                 [key: string]: any;
+                                /**
+                                 * 使用表头筛选 Hook
+                                 * 使用 getter 函数传递 props 以保持响应性
+                                 */
                                 style?: CSSProperties | undefined;
                             }>;
                             readonly fieldProps: PropsItemType<Partial<{
@@ -5556,6 +5600,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         } & RecordType>>;
                         readonly formItemProps: PropsItemType< Mutable<FormItemProps> & {
                             [key: string]: any;
+                            /**
+                             * 使用表头筛选 Hook
+                             * 使用 getter 函数传递 props 以保持响应性
+                             */
                             style?: CSSProperties | undefined;
                         }>;
                         readonly fieldProps: PropsItemType<Partial<{
@@ -5664,6 +5712,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         } & RecordType>>;
                         readonly formItemProps: PropsItemType< Mutable<FormItemProps> & {
                             [key: string]: any;
+                            /**
+                             * 使用表头筛选 Hook
+                             * 使用 getter 函数传递 props 以保持响应性
+                             */
                             style?: CSSProperties | undefined;
                         }>;
                         readonly fieldProps: PropsItemType<Partial<{
@@ -5790,6 +5842,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     } & RecordType>>;
                     readonly formItemProps: PropsItemType< Mutable<FormItemProps> & {
                         [key: string]: any;
+                        /**
+                         * 使用表头筛选 Hook
+                         * 使用 getter 函数传递 props 以保持响应性
+                         */
                         style?: CSSProperties | undefined;
                     }>;
                     readonly fieldProps: PropsItemType<Partial<{
@@ -5902,6 +5958,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 columns: PlusColumn[];
                 headerCellStyle: Partial< CSSProperties> | Partial<(data: {
                     row: any[];
+                    /** 分页配置 */
                     rowIndex: number;
                     column: TableColumnCtx<any[]>;
                     columnIndex: number;
@@ -5949,6 +6006,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 readonly columns: PlusColumn[];
                 readonly headerCellStyle: Partial< CSSProperties> | Partial<(data: {
                     row: any[];
+                    /** 分页配置 */
                     rowIndex: number;
                     column: TableColumnCtx<any[]>;
                     columnIndex: number;
@@ -6019,6 +6077,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 headerCellStyle: {
                     type: PropType<Partial< CSSProperties> | Partial<(data: {
                         row: any[];
+                        /** 分页配置 */
                         rowIndex: number;
                         column: TableColumnCtx<any[]>;
                         columnIndex: number;
@@ -6182,6 +6241,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 headerCellStyle: {
                     type: PropType<Partial< CSSProperties> | Partial<(data: {
                         row: any[];
+                        /** 分页配置 */
                         rowIndex: number;
                         column: TableColumnCtx<any[]>;
                         columnIndex: number;
@@ -6336,6 +6396,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 columns: PlusColumn[];
                 headerCellStyle: Partial< CSSProperties> | Partial<(data: {
                     row: any[];
+                    /** 分页配置 */
                     rowIndex: number;
                     column: TableColumnCtx<any[]>;
                     columnIndex: number;
@@ -6413,6 +6474,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
             headerCellStyle: {
                 type: PropType<Partial< CSSProperties> | Partial<(data: {
                     row: any[];
+                    /** 分页配置 */
                     rowIndex: number;
                     column: TableColumnCtx<any[]>;
                     columnIndex: number;
@@ -7140,6 +7202,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 } & RecordType>>;
                 readonly formItemProps: PropsItemType< Mutable<FormItemProps> & {
                     [key: string]: any;
+                    /**
+                     * 使用表头筛选 Hook
+                     * 使用 getter 函数传递 props 以保持响应性
+                     */
                     style?: CSSProperties | undefined;
                 }>;
                 readonly fieldProps: PropsItemType<Partial<{
@@ -7270,6 +7336,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
             columns: PlusColumn[];
             headerCellStyle: Partial< CSSProperties> | Partial<(data: {
                 row: any[];
+                /** 分页配置 */
                 rowIndex: number;
                 column: TableColumnCtx<any[]>;
                 columnIndex: number;
@@ -7317,6 +7384,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
             readonly columns: PlusColumn[];
             readonly headerCellStyle: Partial< CSSProperties> | Partial<(data: {
                 row: any[];
+                /** 分页配置 */
                 rowIndex: number;
                 column: TableColumnCtx<any[]>;
                 columnIndex: number;
@@ -7387,6 +7455,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
             headerCellStyle: {
                 type: PropType<Partial< CSSProperties> | Partial<(data: {
                     row: any[];
+                    /** 分页配置 */
                     rowIndex: number;
                     column: TableColumnCtx<any[]>;
                     columnIndex: number;
@@ -7550,6 +7619,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
             headerCellStyle: {
                 type: PropType<Partial< CSSProperties> | Partial<(data: {
                     row: any[];
+                    /** 分页配置 */
                     rowIndex: number;
                     column: TableColumnCtx<any[]>;
                     columnIndex: number;
@@ -7704,6 +7774,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
             columns: PlusColumn[];
             headerCellStyle: Partial< CSSProperties> | Partial<(data: {
                 row: any[];
+                /** 分页配置 */
                 rowIndex: number;
                 column: TableColumnCtx<any[]>;
                 columnIndex: number;
@@ -7781,6 +7852,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
         headerCellStyle: {
             type: PropType<Partial< CSSProperties> | Partial<(data: {
                 row: any[];
+                /** 分页配置 */
                 rowIndex: number;
                 column: TableColumnCtx<any[]>;
                 columnIndex: number;
@@ -7961,6 +8033,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
     resetAllHeaderFilters: (defaults?: {
         field: string;
         op: string;
+        /** 表格卡片属性配置 */
         value?: string | undefined;
     }[] | undefined) => void;
     getList: () => Promise<void> | undefined;
@@ -7997,6 +8070,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
     columnCacheKey: undefined;
     disableColumnCache: boolean;
     columnSettingsText: undefined;
+    dragScroll: boolean;
 }>>> & {
     "onHeader-filter-confirm"?: ((payload: HeaderFilterPayload) => any) | undefined;
     "onHeader-filter-reset"?: ((payload: HeaderFilterResetPayload) => any) | undefined;
@@ -8011,6 +8085,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
     hideColumnSettingsIcon: boolean;
     columnCacheKey: string;
     disableColumnCache: boolean;
+    dragScroll: boolean | UseTableDragScrollOptions;
 }, {}>, Partial<Record<NonNullable<string | number>, (_: any) => any>> & {
     "column-settings-icon"?(_: {}): any;
     default?(_: {}): any;

package/es/components/yc-plus-page/src/index.vue.mjs

@@ -1,6 +1,6 @@
 import _sfc_main from './index.vue2.mjs';
 import _export_sfc from '../../../_virtual/_plugin-vue_export-helper.mjs';
 
-var YcPlusPageComponent = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-73380467"], ["__file", "index.vue"]]);
+var YcPlusPageComponent = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-3ce473db"], ["__file", "index.vue"]]);
 
 export { YcPlusPageComponent as default };

package/es/components/yc-plus-page/src/index.vue2.mjs

@@ -1,7 +1,8 @@
-import { defineComponent, ref, computed, useSlots, h, watch, onMounted, nextTick, onUnmounted, openBlock, createElementBlock, normalizeClass, createVNode, unref, mergeProps, createSlots, withCtx, renderSlot, createElementVNode, toDisplayString, renderList, normalizeProps, createCommentVNode } from 'vue';
+import { defineComponent, ref, computed, useSlots, h, watch, onMounted, nextTick, onUnmounted, openBlock, createElementBlock, normalizeClass, createCommentVNode, createElementVNode, unref, createVNode, mergeProps, createSlots, withCtx, renderSlot, toDisplayString, renderList, normalizeProps } from 'vue';
 import { merge } from 'lodash-es';
 import { PlusPage } from '../../page/index.mjs';
 import YcSvgIcon from '../../yc-svg-icon/src/index.vue.mjs';
+import { useTableDragScroll } from '../../../hooks/useTableDragScroll.mjs';
 import { useHeaderFilter } from './use-header-filter.mjs';
 import YcTableHeaderFilterCellComponent from './header-filter-cell.vue.mjs';
 import { useYcShowPageSearch, useYcCdnUrl, useYcComponentConfig } from '../../yc-config-provider/src/useYcConfig.mjs';
@@ -35,7 +36,8 @@ var _sfc_main = /* @__PURE__ */ defineComponent({
     hideHeaderFilter: { type: Boolean, default: true },
     columnCacheKey: { default: void 0 },
     disableColumnCache: { type: Boolean, default: false },
-    columnSettingsText: { default: void 0 }
+    columnSettingsText: { default: void 0 },
+    dragScroll: { type: [Boolean, Object], default: false }
   },
   emits: ["header-filter-confirm", "header-filter-reset"],
   setup(__props, { expose: __expose, emit: __emit }) {
@@ -46,6 +48,21 @@ var _sfc_main = /* @__PURE__ */ defineComponent({
     const plusPageConfig = useYcComponentConfig("plusPage");
     const plusPageRef = ref();
     const rootRef = ref();
+    const dragScrollWrapperRef = ref(null);
+    const dragScrollEnabled = computed(() => props.dragScroll !== false && props.dragScroll != null);
+    const dragScrollOptions = computed(() => {
+      const value = props.dragScroll;
+      if (value && typeof value === "object") return value;
+      return {};
+    });
+    const { onMouseDown: onDragScrollMouseDown } = useTableDragScroll(
+      dragScrollWrapperRef,
+      void 0,
+      {
+        ...dragScrollOptions.value,
+        enabled: dragScrollEnabled
+      }
+    );
     const plusTableInstance = computed(() => {
       var _a;
       return (_a = plusPageRef.value) == null ? void 0 : _a.plusTableInstance;
@@ -463,6 +480,7 @@ var _sfc_main = /* @__PURE__ */ defineComponent({
     void resolvedColumnSettingsText.value;
     void hasRequest.value;
     void showDefaultColumnSettingsIcon.value;
+    void dragScrollEnabled.value;
     __expose({
       plusPageRef,
       plusTableInstance,
@@ -520,62 +538,76 @@ var _sfc_main = /* @__PURE__ */ defineComponent({
           class: normalizeClass(["yc-plus-page", { "yc-plus-page--borderless": isBorderless.value }])
         },
         [
-          createVNode(unref(PlusPage), mergeProps({
-            ref_key: "plusPageRef",
-            ref: plusPageRef
-          }, { ...props, ..._ctx.$attrs }, {
-            columns: enhancedColumns.value,
-            "is-card": _ctx.isCard,
-            request: wrappedRequest.value,
-            search: mergedSearch.value,
-            "search-card-props": mergedSearchCardProps.value,
-            "table-card-props": mergedTableCardProps.value,
-            table: mergedTable.value,
-            pagination: mergedPagination.value,
-            "default-page-info": { page: 1, pageSize: DEFAULT_PAGE_SIZE },
-            onFilterTableHeader: handleFilterTableHeader,
-            onHeaderDragend: handleHeaderDragend
-          }), createSlots({
-            default: withCtx(() => [
-              renderSlot(_ctx.$slots, "default", {}, void 0, true)
-            ]),
-            _: 2
-            /* DYNAMIC */
-          }, [
-            _ctx.$slots["column-settings-icon"] ? {
-              name: "column-settings-icon",
-              fn: withCtx(() => [
-                renderSlot(_ctx.$slots, "column-settings-icon", {}, void 0, true)
-              ]),
-              key: "0"
-            } : showDefaultColumnSettingsIcon.value ? {
-              name: "column-settings-icon",
-              fn: withCtx(() => [
-                createElementVNode("div", { class: "column-settings-wrapper" }, [
-                  createVNode(unref(YcSvgIcon), {
-                    src: fieldSettingIconUrl.value,
-                    size: 16
-                  }, null, 8, ["src"]),
-                  createElementVNode(
-                    "span",
-                    { class: "column-settings-text" },
-                    toDisplayString(resolvedColumnSettingsText.value),
-                    1
-                    /* TEXT */
-                  )
-                ])
-              ]),
-              key: "1"
-            } : void 0,
-            renderList(_ctx.$slots, (_, name) => {
-              return {
-                name,
-                fn: withCtx((slotProps) => [
-                  name !== "column-settings-icon" && name !== "default" ? renderSlot(_ctx.$slots, name, normalizeProps(mergeProps({ key: 0 }, slotProps)), void 0, true) : createCommentVNode("v-if", true)
-                ])
-              };
-            })
-          ]), 1040, ["columns", "is-card", "request", "search", "search-card-props", "table-card-props", "table", "pagination", "default-page-info"])
+          createCommentVNode(" \u62D6\u62FD\u6EDA\u52A8\u5305\u88F9\u5C42\uFF1AdragScroll \u542F\u7528\u65F6\u4ECB\u5165\uFF0C\u4F46\u59CB\u7EC8\u4FDD\u7559 ref\uFF0C\n         \u4EE5\u4FDD\u8BC1 mousedown \u900F\u4F20 + hook \u5185\u90E8 DOM \u67E5\u8BE2\u6B63\u5E38 "),
+          createElementVNode(
+            "div",
+            {
+              ref_key: "dragScrollWrapperRef",
+              ref: dragScrollWrapperRef,
+              class: normalizeClass(["yc-plus-page__drag-wrapper", { "yc-plus-page__drag-wrapper--enabled": dragScrollEnabled.value }]),
+              onMousedown: _cache[0] || (_cache[0] = ($event) => dragScrollEnabled.value ? unref(onDragScrollMouseDown)($event) : void 0)
+            },
+            [
+              createVNode(unref(PlusPage), mergeProps({
+                ref_key: "plusPageRef",
+                ref: plusPageRef
+              }, { ...props, ..._ctx.$attrs }, {
+                columns: enhancedColumns.value,
+                "is-card": _ctx.isCard,
+                request: wrappedRequest.value,
+                search: mergedSearch.value,
+                "search-card-props": mergedSearchCardProps.value,
+                "table-card-props": mergedTableCardProps.value,
+                table: mergedTable.value,
+                pagination: mergedPagination.value,
+                "default-page-info": { page: 1, pageSize: DEFAULT_PAGE_SIZE },
+                onFilterTableHeader: handleFilterTableHeader,
+                onHeaderDragend: handleHeaderDragend
+              }), createSlots({
+                default: withCtx(() => [
+                  renderSlot(_ctx.$slots, "default", {}, void 0, true)
+                ]),
+                _: 2
+                /* DYNAMIC */
+              }, [
+                _ctx.$slots["column-settings-icon"] ? {
+                  name: "column-settings-icon",
+                  fn: withCtx(() => [
+                    renderSlot(_ctx.$slots, "column-settings-icon", {}, void 0, true)
+                  ]),
+                  key: "0"
+                } : showDefaultColumnSettingsIcon.value ? {
+                  name: "column-settings-icon",
+                  fn: withCtx(() => [
+                    createElementVNode("div", { class: "column-settings-wrapper" }, [
+                      createVNode(unref(YcSvgIcon), {
+                        src: fieldSettingIconUrl.value,
+                        size: 16
+                      }, null, 8, ["src"]),
+                      createElementVNode(
+                        "span",
+                        { class: "column-settings-text" },
+                        toDisplayString(resolvedColumnSettingsText.value),
+                        1
+                        /* TEXT */
+                      )
+                    ])
+                  ]),
+                  key: "1"
+                } : void 0,
+                renderList(_ctx.$slots, (_, name) => {
+                  return {
+                    name,
+                    fn: withCtx((slotProps) => [
+                      name !== "column-settings-icon" && name !== "default" ? renderSlot(_ctx.$slots, name, normalizeProps(mergeProps({ key: 0 }, slotProps)), void 0, true) : createCommentVNode("v-if", true)
+                    ])
+                  };
+                })
+              ]), 1040, ["columns", "is-card", "request", "search", "search-card-props", "table-card-props", "table", "pagination", "default-page-info"])
+            ],
+            34
+            /* CLASS, NEED_HYDRATION */
+          )
         ],
         2
         /* CLASS */

package/es/components/yc-plus-page/src/type.d.ts

@@ -1,3 +1,4 @@
+import { UseTableDragScrollOptions } from 'yc-pro-components/es/hooks/useTableDragScroll';
 import { PlusPageProps } from 'yc-pro-components/es/components/page';
 import { FieldValues } from 'yc-pro-components/es/types/form';
 import { PlusColumn, PageInfo } from 'yc-pro-components/es/types/plus';
@@ -178,6 +179,14 @@ export interface YcPlusPageProps extends /* @vue-ignore */ Omit<Partial<PlusPage
      * @default true（默认隐藏）
      */
     hideHeaderFilter?: boolean;
+    /**
+     * 是否启用表格横向拖拽滚动
+     * - true: 使用默认配置启用
+     * - 对象: 自定义 useTableDragScroll 配置（resizeAreaWidth / scrollContainerSelector 等）
+     * - false / 不传: 关闭（默认）
+     * @default false
+     */
+    dragScroll?: boolean | UseTableDragScrollOptions;
 }
 /**
  * 列设置缓存数据

package/es/hooks/index.d.ts

@@ -7,3 +7,4 @@ export * from './useSortableDrag';
 export * from './usePlusFormReset';
 export * from './useSelectWithPagination';
 export * from './useDictInjection';
+export * from './useTableDragScroll';

package/es/hooks/index.mjs

@@ -7,3 +7,4 @@ export { useSortableDrag } from './useSortableDrag.mjs';
 export { usePlusFormClearValidate, usePlusFormFullReset, usePlusFormReset } from './usePlusFormReset.mjs';
 export { useSelectWithPagination } from './useSelectWithPagination.mjs';
 export { useDictInjection } from './useDictInjection.mjs';
+export { useTableDragScroll } from './useTableDragScroll.mjs';

package/es/hooks/useTableDragScroll.d.ts

@@ -0,0 +1,35 @@
+import { Ref } from 'vue';
+
+/** Element Plus 表格 ref 形状（只用到 $el） */
+export interface TableLikeRef {
+    $el?: HTMLElement;
+}
+/** useTableDragScroll 配置项 */
+export interface UseTableDragScrollOptions {
+    /** 是否启用，默认 true */
+    enabled?: Ref<boolean> | boolean;
+    /** resize 检测区域宽度（px），默认 12 */
+    resizeAreaWidth?: number;
+    /** 列宽 resize 时高亮边框颜色，默认 var(--theme-color) */
+    resizeBorderColor?: string;
+    /** 滚动容器选择器，默认 .el-scrollbar__wrap */
+    scrollContainerSelector?: string;
+}
+/** useTableDragScroll 返回值 */
+export interface UseTableDragScrollReturn {
+    /** 绑定到外层 wrapper 的 mousedown 处理函数 */
+    onMouseDown: (e: MouseEvent) => void;
+    /** 是否处于拖拽中 */
+    isDragging: Ref<boolean>;
+    /** 是否处于列宽 resize 中 */
+    isResizing: Ref<boolean>;
+    /** 手动刷新内部 scroll 容器（异步渲染时可用） */
+    refreshScrollContainer: () => void;
+}
+/**
+ * 表格横向拖拽滚动 Hook
+ * @param wrapperRef 外层包裹元素 ref（绑定 mousedown）
+ * @param tableRef 可选：Element Plus el-table 的 ref；不传时在 wrapper 内查找 .el-table
+ * @param options 可选配置
+ */
+export declare function useTableDragScroll(wrapperRef: Ref<HTMLElement | null | undefined>, tableRef?: Ref<TableLikeRef | null | undefined>, options?: UseTableDragScrollOptions): UseTableDragScrollReturn;