gzkx-package 0.1.48 → 0.1.49

package/README.md

@@ -155,6 +155,9 @@ import type {
   AddItemConfig,       // 新增/编辑表单配置类型
   ValidateConfig,      // 验证配置类型
   CommonPageHandle,    // CommonPage Ref 类型
+  CustomTableHandle,   // CustomTable Ref 类型
+  CustomColumnType,    // 自定义表格列类型
+  CustomColumnsType,   // 自定义表格列数组类型
 } from 'gzkx-package';
 ```
 
@@ -252,6 +255,10 @@ interface CommonPageHandle {
   reload: () => void;                               // 重新加载列表
   getSearchFieldsValue: () => any;                  // 获取搜索表单值
   setSearchFieldsValue: (values: any) => void;      // 设置搜索表单值
+  /** 打开表格配置弹窗 */
+  openSettingModal: () => void;                     // 打开表格配置弹窗
+  /** 关闭表格配置弹窗 */
+  closeSettingModal: () => void;                    // 关闭表格配置弹窗
 }
 ```
 
@@ -428,7 +435,45 @@ export default DemoPage;
 3. **树形数据支持**：支持展开/收起树形数据。
 4. **Tooltip 支持**：单元格内容过长时自动显示 Tooltip。
 
-### 2.4 使用示例
+### 2.4 Ref 暴露的方法
+
+使用 `ref` 可以调用组件内部方法：
+
+```typescript
+interface CustomTableHandle {
+  openSettingModal: () => void;   // 打开表格配置弹窗
+  closeSettingModal: () => void;  // 关闭表格配置弹窗
+}
+```
+
+**使用示例：**
+
+```tsx
+import { useRef } from 'react';
+import CustomTable, { CustomTableHandle } from '@/components/customComponents/CustomTable';
+
+const Demo = () => {
+  const tableRef = useRef<CustomTableHandle>(null);
+
+  const handleOpenConfig = () => {
+    tableRef.current?.openSettingModal();
+  };
+
+  return (
+    <>
+      <Button onClick={handleOpenConfig}>打开表格配置</Button>
+      <CustomTable
+        ref={tableRef}
+        columns={columns}
+        dataSource={dataSource}
+        tableId="my-table"
+      />
+    </>
+  );
+};
+```
+
+### 2.5 使用示例
 
 ```tsx
 import CustomTable from '@/components/customComponents/CustomTable';
@@ -483,7 +528,7 @@ const DemoTable = () => {
 };
 ```
 
-### 2.5 列配置弹窗说明
+### 2.6 列配置弹窗说明
 
 当 `showTableConfig={true}` 时，序号列旁边会显示设置图标，点击后打开配置弹窗，可以配置：
 

package/dist/components/customComponents/CustomTable.d.ts

@@ -11,6 +11,12 @@ interface CustomColumnType<T = any> extends ColumnType<T> {
     contentAlignment?: 'left' | 'center' | 'right';
 }
 type CustomColumnsType<T = any> = CustomColumnType<T>[];
+export interface CustomTableHandle {
+    /** 打开表格配置弹窗 */
+    openSettingModal: () => void;
+    /** 关闭表格配置弹窗 */
+    closeSettingModal: () => void;
+}
 interface CustomTableProps {
     columns: CustomColumnsType;
     dataSource: any[];
@@ -24,6 +30,6 @@ interface CustomTableProps {
     showTableConfig?: boolean;
     [key: string]: any;
 }
-declare const CustomTable: React.FC<CustomTableProps>;
+declare const CustomTable: React.ForwardRefExoticComponent<Omit<CustomTableProps, "ref"> & React.RefAttributes<CustomTableHandle>>;
 export default CustomTable;
 export type { CustomColumnType, CustomColumnsType };

package/dist/components/customComponents/commonPage/index.d.ts

@@ -9,6 +9,10 @@ export interface CommonPageHandle {
     reload: () => void;
     getSearchFieldsValue: () => any;
     setSearchFieldsValue: (values: any) => void;
+    /** 打开表格配置弹窗 */
+    openSettingModal: () => void;
+    /** 关闭表格配置弹窗 */
+    closeSettingModal: () => void;
 }
 interface CommonPageProps {
     onSearchFormChange?: (name: string, value: any) => void;