@cfmm/umi-plugins-ui-v2 0.0.27 → 0.0.28

package/dist/cjs/components/CrudTable.tpl

@@ -404,7 +404,7 @@ function CrudTable<T extends Record<string, any>, U = {}, C = {}>(
    * 通用操作处理
    */
   const handleAction = useMemoizedFn(async (method: API.MethodTypes, fields: any): Promise<boolean> => {
-    if(!api.handle) return false;
+    if(!apis.handle) return false;
 
     // 自定义操作前处理
     if (onBeforeAction) {

package/dist/cjs/components/ImportExecl.less

@@ -7,4 +7,24 @@
   :global(.mainAnt-upload-list) {
     display: none;
   }
-}
+}
+
+// children 自定义触发区时撑满父容器（如下拉菜单 label），扩大可点击范围
+.importExexlFill {
+  display: block;
+  width: 100%;
+  :global(.ant-upload) {
+    display: block;
+    width: 100%;
+  }
+  :global(.ant-upload-select) {
+    display: block;
+    width: 100%;
+  }
+}
+.importTrigger {
+  display: inline-flex;
+  align-items: center;
+  gap: 8px;
+  width: 100%;
+}

package/dist/cjs/components/ImportExecl.tpl

@@ -2,6 +2,7 @@ import { UploadOutlined } from '@ant-design/icons';
 import { useIntl } from '@umijs/max';
 import type { UploadFile, UploadProps } from 'antd';
 import { Button, message, Modal, Upload } from 'antd';
+import classNames from 'classnames';
 import React from 'react';
 import { ImportExeclProps } from '../types';
 import { importExexl } from '../utils/importHelper';
@@ -20,6 +21,7 @@ const ImportExecl = <T,>(props: ImportExeclProps<T>) => {
     buttonProps,
     children,
     showDefautlMessage = true,
+    fillContainer = false,
     onChange,
   } = props;
 
@@ -134,16 +136,18 @@ const ImportExecl = <T,>(props: ImportExeclProps<T>) => {
     }
   };
 
+  const useFillLayout = fillContainer && !!children;
+
   return (
     <Upload
       accept={accept}
-      className={styles.importExexl}
+      className={classNames(styles.importExexl, useFillLayout && styles.importExexlFill, uploadProps?.className)}
       maxCount={1}
       customRequest={handleCustomRequest}
       {...uploadProps}
     >
-      {children ? (
-        children
+       {children ? (
+        useFillLayout ? <span className={styles.importTrigger}>{children}</span> : children
       ) : (
         <Button type="primary" icon={<UploadOutlined />} {...buttonProps}>
           {title ? title : formatMessage({ id: 'cfmmUI.File.import', defaultMessage: '导入' })}

package/dist/cjs/types/ImportExeclTypes.d.ts

@@ -1 +1 @@
-export declare const ImportExeclTypes = "\nexport interface ImportExeclProps<T = any[]> {\n  accept?: string;\n  /**\n   * \u4E0A\u4F20\u4E8B\u4EF6\uFF0C\u83B7\u53D6execl\u6570\u636E\u5217\u8868\uFF0C\u51FD\u6570\u8FD4\u56DEpromise\u5E76\u4E14showDefautlMessage\u4E0D\u662Ffalse\u65F6\u6709\u9ED8\u8BA4message\u63D0\u793A\n   */\n  onChange: (list: T, fileInfo: Pick<UploadFile, 'name' | 'size' | 'type' | 'uid'>) => Promise<{\n    success: boolean; failMsg?: string; data?: {\n      success: boolean;\n      insertCount: number;\n      updateCount: number;\n      deleteCount: number;\n    } | number\n  } | void> | void;\n  /**\n   * \u663E\u793A\u9ED8\u8BA4\u7684\u63D0\u793A\n   */\n  showDefautlMessage?: boolean;\n  /**\n   * \u6309\u94AE\u6587\u672C\n   */\n  title?: string;\n  /**\n   * \u8BFB\u53D6\u5DE5\u4F5C\u7C3F\u6570\u91CF\uFF0C\u9ED8\u8BA41\n   */\n  max?: number;\n  /**\n   * \u4EE5\u7B2C\u51E0\u884C\u4E3A\u8868\u5934\uFF0C\u9ED8\u8BA4\u7B2C\u4E00\u884C\n   */\n  header?: number;\n  /**\n   * \u4EE5\u7B2C\u51E0\u5217\u7B2C\u51E0\u884C\u5F00\u59CB\u8BFB\u53D6\uFF0C\u9ED8\u8BA4\u7B2C\u4E00\u884C\u7B2C\u4E00\u5217\n   */\n  rangeStart?: { c: number; r: number };\n  /**\n   * \u7A7A\u5355\u5143\u683C\u5360\u4F4D\u503C\uFF1B\u4F20\u5165\u540E\u6BCF\u884C\u5BF9\u8C61\u4F1A\u5305\u542B\u4E0E\u8868\u5934\u5BF9\u9F50\u7684\u5168\u90E8 key\uFF08\u7A7A\u5355\u5143\u683C\u4E3A\u8BE5\u503C\uFF09\uFF0C\u5426\u5219 SheetJS \u4F1A\u7701\u7565\u7A7A\u5355\u5143\u683C\u5BF9\u5E94\u5B57\u6BB5\n   */\n  defval?: unknown;\n  /**\n   * \u4FDD\u7559\u7A7A\u884C\uFF0C\u9ED8\u8BA4false\n   */\n  blankrows?: boolean;\n  /**\n   * \u81EA\u5B9A\u4E49\u6309\u94AE\u5185\u5BB9\n   */\n  children?: React.ReactNode;\n  /**\n   * Upload\u7EC4\u4EF6\u5C5E\u6027\n   */\n  uploadProps?: UploadProps;\n  /**\n   * Button\u7EC4\u4EF6\u5C5E\u6027\n   */\n  buttonProps?: ButtonProps;\n}\n";
+export declare const ImportExeclTypes = "\nexport interface ImportExeclProps<T = any[]> {\n  accept?: string;\n  /**\n   * \u4E0A\u4F20\u4E8B\u4EF6\uFF0C\u83B7\u53D6execl\u6570\u636E\u5217\u8868\uFF0C\u51FD\u6570\u8FD4\u56DEpromise\u5E76\u4E14showDefautlMessage\u4E0D\u662Ffalse\u65F6\u6709\u9ED8\u8BA4message\u63D0\u793A\n   */\n  /**\n   * \u81EA\u5B9A\u4E49 children \u65F6\u662F\u5426\u6491\u6EE1\u7236\u5BB9\u5668\uFF08\u5982\u4E0B\u62C9\u83DC\u5355 label\uFF09\uFF0C\u6269\u5927\u53EF\u70B9\u51FB\u8303\u56F4\n   */\n  fillContainer?: boolean;\n  onChange: (list: T, fileInfo: Pick<UploadFile, 'name' | 'size' | 'type' | 'uid'>) => Promise<{\n    success: boolean; failMsg?: string; data?: {\n      success: boolean;\n      insertCount: number;\n      updateCount: number;\n      deleteCount: number;\n    } | number\n  } | void> | void;\n  /**\n   * \u663E\u793A\u9ED8\u8BA4\u7684\u63D0\u793A\n   */\n  showDefautlMessage?: boolean;\n  /**\n   * \u6309\u94AE\u6587\u672C\n   */\n  title?: string;\n  /**\n   * \u8BFB\u53D6\u5DE5\u4F5C\u7C3F\u6570\u91CF\uFF0C\u9ED8\u8BA41\n   */\n  max?: number;\n  /**\n   * \u4EE5\u7B2C\u51E0\u884C\u4E3A\u8868\u5934\uFF0C\u9ED8\u8BA4\u7B2C\u4E00\u884C\n   */\n  header?: number;\n  /**\n   * \u4EE5\u7B2C\u51E0\u5217\u7B2C\u51E0\u884C\u5F00\u59CB\u8BFB\u53D6\uFF0C\u9ED8\u8BA4\u7B2C\u4E00\u884C\u7B2C\u4E00\u5217\n   */\n  rangeStart?: { c: number; r: number };\n  /**\n   * \u7A7A\u5355\u5143\u683C\u5360\u4F4D\u503C\uFF1B\u4F20\u5165\u540E\u6BCF\u884C\u5BF9\u8C61\u4F1A\u5305\u542B\u4E0E\u8868\u5934\u5BF9\u9F50\u7684\u5168\u90E8 key\uFF08\u7A7A\u5355\u5143\u683C\u4E3A\u8BE5\u503C\uFF09\uFF0C\u5426\u5219 SheetJS \u4F1A\u7701\u7565\u7A7A\u5355\u5143\u683C\u5BF9\u5E94\u5B57\u6BB5\n   */\n  defval?: unknown;\n  /**\n   * \u4FDD\u7559\u7A7A\u884C\uFF0C\u9ED8\u8BA4false\n   */\n  blankrows?: boolean;\n  /**\n   * \u81EA\u5B9A\u4E49\u6309\u94AE\u5185\u5BB9\n   */\n  children?: React.ReactNode;\n  /**\n   * Upload\u7EC4\u4EF6\u5C5E\u6027\n   */\n  uploadProps?: UploadProps;\n  /**\n   * Button\u7EC4\u4EF6\u5C5E\u6027\n   */\n  buttonProps?: ButtonProps;\n}\n";

package/dist/cjs/types/ImportExeclTypes.js

@@ -4,4 +4,4 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.ImportExeclTypes = void 0;
-var ImportExeclTypes = exports.ImportExeclTypes = "\nexport interface ImportExeclProps<T = any[]> {\n  accept?: string;\n  /**\n   * \u4E0A\u4F20\u4E8B\u4EF6\uFF0C\u83B7\u53D6execl\u6570\u636E\u5217\u8868\uFF0C\u51FD\u6570\u8FD4\u56DEpromise\u5E76\u4E14showDefautlMessage\u4E0D\u662Ffalse\u65F6\u6709\u9ED8\u8BA4message\u63D0\u793A\n   */\n  onChange: (list: T, fileInfo: Pick<UploadFile, 'name' | 'size' | 'type' | 'uid'>) => Promise<{\n    success: boolean; failMsg?: string; data?: {\n      success: boolean;\n      insertCount: number;\n      updateCount: number;\n      deleteCount: number;\n    } | number\n  } | void> | void;\n  /**\n   * \u663E\u793A\u9ED8\u8BA4\u7684\u63D0\u793A\n   */\n  showDefautlMessage?: boolean;\n  /**\n   * \u6309\u94AE\u6587\u672C\n   */\n  title?: string;\n  /**\n   * \u8BFB\u53D6\u5DE5\u4F5C\u7C3F\u6570\u91CF\uFF0C\u9ED8\u8BA41\n   */\n  max?: number;\n  /**\n   * \u4EE5\u7B2C\u51E0\u884C\u4E3A\u8868\u5934\uFF0C\u9ED8\u8BA4\u7B2C\u4E00\u884C\n   */\n  header?: number;\n  /**\n   * \u4EE5\u7B2C\u51E0\u5217\u7B2C\u51E0\u884C\u5F00\u59CB\u8BFB\u53D6\uFF0C\u9ED8\u8BA4\u7B2C\u4E00\u884C\u7B2C\u4E00\u5217\n   */\n  rangeStart?: { c: number; r: number };\n  /**\n   * \u7A7A\u5355\u5143\u683C\u5360\u4F4D\u503C\uFF1B\u4F20\u5165\u540E\u6BCF\u884C\u5BF9\u8C61\u4F1A\u5305\u542B\u4E0E\u8868\u5934\u5BF9\u9F50\u7684\u5168\u90E8 key\uFF08\u7A7A\u5355\u5143\u683C\u4E3A\u8BE5\u503C\uFF09\uFF0C\u5426\u5219 SheetJS \u4F1A\u7701\u7565\u7A7A\u5355\u5143\u683C\u5BF9\u5E94\u5B57\u6BB5\n   */\n  defval?: unknown;\n  /**\n   * \u4FDD\u7559\u7A7A\u884C\uFF0C\u9ED8\u8BA4false\n   */\n  blankrows?: boolean;\n  /**\n   * \u81EA\u5B9A\u4E49\u6309\u94AE\u5185\u5BB9\n   */\n  children?: React.ReactNode;\n  /**\n   * Upload\u7EC4\u4EF6\u5C5E\u6027\n   */\n  uploadProps?: UploadProps;\n  /**\n   * Button\u7EC4\u4EF6\u5C5E\u6027\n   */\n  buttonProps?: ButtonProps;\n}\n";
+var ImportExeclTypes = exports.ImportExeclTypes = "\nexport interface ImportExeclProps<T = any[]> {\n  accept?: string;\n  /**\n   * \u4E0A\u4F20\u4E8B\u4EF6\uFF0C\u83B7\u53D6execl\u6570\u636E\u5217\u8868\uFF0C\u51FD\u6570\u8FD4\u56DEpromise\u5E76\u4E14showDefautlMessage\u4E0D\u662Ffalse\u65F6\u6709\u9ED8\u8BA4message\u63D0\u793A\n   */\n  /**\n   * \u81EA\u5B9A\u4E49 children \u65F6\u662F\u5426\u6491\u6EE1\u7236\u5BB9\u5668\uFF08\u5982\u4E0B\u62C9\u83DC\u5355 label\uFF09\uFF0C\u6269\u5927\u53EF\u70B9\u51FB\u8303\u56F4\n   */\n  fillContainer?: boolean;\n  onChange: (list: T, fileInfo: Pick<UploadFile, 'name' | 'size' | 'type' | 'uid'>) => Promise<{\n    success: boolean; failMsg?: string; data?: {\n      success: boolean;\n      insertCount: number;\n      updateCount: number;\n      deleteCount: number;\n    } | number\n  } | void> | void;\n  /**\n   * \u663E\u793A\u9ED8\u8BA4\u7684\u63D0\u793A\n   */\n  showDefautlMessage?: boolean;\n  /**\n   * \u6309\u94AE\u6587\u672C\n   */\n  title?: string;\n  /**\n   * \u8BFB\u53D6\u5DE5\u4F5C\u7C3F\u6570\u91CF\uFF0C\u9ED8\u8BA41\n   */\n  max?: number;\n  /**\n   * \u4EE5\u7B2C\u51E0\u884C\u4E3A\u8868\u5934\uFF0C\u9ED8\u8BA4\u7B2C\u4E00\u884C\n   */\n  header?: number;\n  /**\n   * \u4EE5\u7B2C\u51E0\u5217\u7B2C\u51E0\u884C\u5F00\u59CB\u8BFB\u53D6\uFF0C\u9ED8\u8BA4\u7B2C\u4E00\u884C\u7B2C\u4E00\u5217\n   */\n  rangeStart?: { c: number; r: number };\n  /**\n   * \u7A7A\u5355\u5143\u683C\u5360\u4F4D\u503C\uFF1B\u4F20\u5165\u540E\u6BCF\u884C\u5BF9\u8C61\u4F1A\u5305\u542B\u4E0E\u8868\u5934\u5BF9\u9F50\u7684\u5168\u90E8 key\uFF08\u7A7A\u5355\u5143\u683C\u4E3A\u8BE5\u503C\uFF09\uFF0C\u5426\u5219 SheetJS \u4F1A\u7701\u7565\u7A7A\u5355\u5143\u683C\u5BF9\u5E94\u5B57\u6BB5\n   */\n  defval?: unknown;\n  /**\n   * \u4FDD\u7559\u7A7A\u884C\uFF0C\u9ED8\u8BA4false\n   */\n  blankrows?: boolean;\n  /**\n   * \u81EA\u5B9A\u4E49\u6309\u94AE\u5185\u5BB9\n   */\n  children?: React.ReactNode;\n  /**\n   * Upload\u7EC4\u4EF6\u5C5E\u6027\n   */\n  uploadProps?: UploadProps;\n  /**\n   * Button\u7EC4\u4EF6\u5C5E\u6027\n   */\n  buttonProps?: ButtonProps;\n}\n";

package/dist/cjs/utils/excelHelper.tpl

@@ -270,6 +270,12 @@ export interface ExcelExportOptions {
   sheetPassword?: string;
   /** 是否锁定基础行（数据行前的行），默认为 true */
   lockHeaderRows?: boolean;
+  /**
+   * 是否锁定数据填写区（含 columnValidations 预留行）。
+   * - 默认 false：数据区可编辑（表头仍由 lockHeaderRows 锁定）
+   * - true：整表只读，需配合 lockHeaderRows（默认已 true）启用工作表保护
+   */
+  lockDataRows?: boolean;
   /** 自定义合并单元格范围数组（如 ['A1:B2', 'C1:D1']） */
   mergeCells?: string[];
   /** 数据行高度，默认 22 */
@@ -382,6 +388,35 @@ const applyColumnValidations = (
   });
 };
 
+/**
+ * 工作表保护开启前，解锁数据填写区。
+ * Excel 新建单元格默认 protection.locked=true；仅锁表头并 protect 后，未显式解锁的数据区也不可编辑。
+ */
+const unlockDataEntryArea = (
+  workSheet: ExcelJS.Worksheet,
+  headerRowCount: number,
+  colCount: number,
+  maxDataRows: number,
+  dataRowCount: number,
+  hasColumnValidations: boolean,
+  lockedColumns: number[],
+) => {
+  const rowSpan = hasColumnValidations ? Math.max(dataRowCount, maxDataRows) : dataRowCount;
+  if (rowSpan <= 0) return;
+
+  const startRow = headerRowCount + 1;
+  const endRow = startRow + rowSpan - 1;
+
+  for (let row = startRow; row <= endRow; row++) {
+    for (let col = 1; col <= colCount; col++) {
+      const colIndex = col - 1;
+      if (!lockedColumns.includes(colIndex)) {
+        workSheet.getCell(row, col).protection = { locked: false };
+      }
+    }
+  }
+};
+
 function buildDataCellBorder(style: ExcelJS.BorderStyle): ExcelJS.Borders {
   const side = { style } as ExcelJS.Border;
   return {
@@ -538,6 +573,8 @@ export const genExcelAdvanced = async (
 
   // 是否锁定基础行（默认为 true）
   const lockHeaderRows = options?.lockHeaderRows !== false;
+  // 是否锁定数据填写区（整表只读），默认 false
+  const lockDataRows = options?.lockDataRows === true;
   // 物理行号：追加行时递增，用于 mergeCells 与「第几行」对应
   let currentRowIndex = 0;
 
@@ -569,11 +606,9 @@ export const genExcelAdvanced = async (
       bottom: { style: 'thin' },
       right: { style: 'thin' },
     };
-    if (lockHeaderRows) {
-      titleRow.eachCell((cell) => {
-        cell.protection = { locked: true };
-      });
-    }
+    titleRow.eachCell((cell) => {
+      cell.protection = { locked: lockHeaderRows };
+    });
   }
 
   // ========== 第二行：注意事项（可选） ==========
@@ -607,11 +642,9 @@ export const genExcelAdvanced = async (
       bottom: { style: 'thin' },
       right: { style: 'thin' },
     };
-    if (lockHeaderRows) {
-      noticeRow.eachCell((cell) => {
-        cell.protection = { locked: true };
-      });
-    }
+    noticeRow.eachCell((cell) => {
+      cell.protection = { locked: lockHeaderRows };
+    });
   }
 
   // ========== 编号行（可选，隐藏） ==========
@@ -625,9 +658,7 @@ export const genExcelAdvanced = async (
         bottom: { style: 'thin' },
         right: { style: 'thin' },
       };
-      if (lockHeaderRows) {
-        cell.protection = { locked: true };
-      }
+      cell.protection = { locked: lockHeaderRows };
     });
     codeColumnRow.alignment = { horizontal: 'center', vertical: 'middle' };
     codeColumnRow.hidden = true;
@@ -649,9 +680,7 @@ export const genExcelAdvanced = async (
           bottom: { style: 'thin' },
           right: { style: 'thin' },
         };
-        if (lockHeaderRows) {
-          cell.protection = { locked: true };
-        }
+        cell.protection = { locked: lockHeaderRows };
       });
     });
   } else {
@@ -672,9 +701,7 @@ export const genExcelAdvanced = async (
         bottom: { style: 'thin' },
         right: { style: 'thin' },
       };
-      if (lockHeaderRows) {
-        cell.protection = { locked: true };
-      }
+      cell.protection = { locked: lockHeaderRows };
     });
     columnHeaderRow.height = 25;
   }
@@ -706,8 +733,14 @@ export const genExcelAdvanced = async (
         if (colNumber <= colCount) {
           const colIndex = colNumber - 1;
           applyDataCellAppearance(cell, dataRowIndex, colIndex, options);
-          if (hasLockedColumns) {
+          if (lockDataRows) {
+            // 整表只读：数据行也锁定，不必显式写（ExcelJS 默认 locked=true），这里写明意图
+            cell.protection = { locked: true };
+          } else if (hasLockedColumns) {
             cell.protection = { locked: lockedColumns.includes(colIndex) };
+          } else if (lockHeaderRows) {
+            // 仅锁表头时，数据行显式解锁，避免 protect 后整表不可编辑
+            cell.protection = { locked: false };
           }
         }
       });
@@ -720,8 +753,20 @@ export const genExcelAdvanced = async (
     applyColumnValidations(workBook, workSheet, options.columnValidations, currentRowIndex, options.maxDataRows ?? 500);
   }
 
-  // ========== 工作表保护：锁定表头区或部分列时启用（密码可选） ==========
-  if (lockHeaderRows || hasLockedColumns) {
+  // ========== 工作表保护：锁定表头/数据区或部分列时启用（密码可选） ==========
+  if (lockHeaderRows || hasLockedColumns || lockDataRows) {
+    // lockDataRows=true 时整表只读，数据区保持默认 locked=true，不需要解锁
+    if (!lockDataRows) {
+      unlockDataEntryArea(
+        workSheet,
+        currentRowIndex,
+        colCount,
+        options?.maxDataRows ?? 500,
+        rows?.length ?? 0,
+        !!(options?.columnValidations?.length),
+        lockedColumns,
+      );
+    }
     workSheet.protect(options?.sheetPassword ?? '', {
       selectLockedCells: true,
       selectUnlockedCells: true,

package/dist/esm/components/CrudTable.tpl

@@ -404,7 +404,7 @@ function CrudTable<T extends Record<string, any>, U = {}, C = {}>(
    * 通用操作处理
    */
   const handleAction = useMemoizedFn(async (method: API.MethodTypes, fields: any): Promise<boolean> => {
-    if(!api.handle) return false;
+    if(!apis.handle) return false;
 
     // 自定义操作前处理
     if (onBeforeAction) {

package/dist/esm/components/ImportExecl.less

@@ -7,4 +7,24 @@
   :global(.mainAnt-upload-list) {
     display: none;
   }
-}
+}
+
+// children 自定义触发区时撑满父容器（如下拉菜单 label），扩大可点击范围
+.importExexlFill {
+  display: block;
+  width: 100%;
+  :global(.ant-upload) {
+    display: block;
+    width: 100%;
+  }
+  :global(.ant-upload-select) {
+    display: block;
+    width: 100%;
+  }
+}
+.importTrigger {
+  display: inline-flex;
+  align-items: center;
+  gap: 8px;
+  width: 100%;
+}

package/dist/esm/components/ImportExecl.tpl

@@ -2,6 +2,7 @@ import { UploadOutlined } from '@ant-design/icons';
 import { useIntl } from '@umijs/max';
 import type { UploadFile, UploadProps } from 'antd';
 import { Button, message, Modal, Upload } from 'antd';
+import classNames from 'classnames';
 import React from 'react';
 import { ImportExeclProps } from '../types';
 import { importExexl } from '../utils/importHelper';
@@ -20,6 +21,7 @@ const ImportExecl = <T,>(props: ImportExeclProps<T>) => {
     buttonProps,
     children,
     showDefautlMessage = true,
+    fillContainer = false,
     onChange,
   } = props;
 
@@ -134,16 +136,18 @@ const ImportExecl = <T,>(props: ImportExeclProps<T>) => {
     }
   };
 
+  const useFillLayout = fillContainer && !!children;
+
   return (
     <Upload
       accept={accept}
-      className={styles.importExexl}
+      className={classNames(styles.importExexl, useFillLayout && styles.importExexlFill, uploadProps?.className)}
       maxCount={1}
       customRequest={handleCustomRequest}
       {...uploadProps}
     >
-      {children ? (
-        children
+       {children ? (
+        useFillLayout ? <span className={styles.importTrigger}>{children}</span> : children
       ) : (
         <Button type="primary" icon={<UploadOutlined />} {...buttonProps}>
           {title ? title : formatMessage({ id: 'cfmmUI.File.import', defaultMessage: '导入' })}

package/dist/esm/types/ImportExeclTypes.d.ts

@@ -1 +1 @@
-export declare const ImportExeclTypes = "\nexport interface ImportExeclProps<T = any[]> {\n  accept?: string;\n  /**\n   * \u4E0A\u4F20\u4E8B\u4EF6\uFF0C\u83B7\u53D6execl\u6570\u636E\u5217\u8868\uFF0C\u51FD\u6570\u8FD4\u56DEpromise\u5E76\u4E14showDefautlMessage\u4E0D\u662Ffalse\u65F6\u6709\u9ED8\u8BA4message\u63D0\u793A\n   */\n  onChange: (list: T, fileInfo: Pick<UploadFile, 'name' | 'size' | 'type' | 'uid'>) => Promise<{\n    success: boolean; failMsg?: string; data?: {\n      success: boolean;\n      insertCount: number;\n      updateCount: number;\n      deleteCount: number;\n    } | number\n  } | void> | void;\n  /**\n   * \u663E\u793A\u9ED8\u8BA4\u7684\u63D0\u793A\n   */\n  showDefautlMessage?: boolean;\n  /**\n   * \u6309\u94AE\u6587\u672C\n   */\n  title?: string;\n  /**\n   * \u8BFB\u53D6\u5DE5\u4F5C\u7C3F\u6570\u91CF\uFF0C\u9ED8\u8BA41\n   */\n  max?: number;\n  /**\n   * \u4EE5\u7B2C\u51E0\u884C\u4E3A\u8868\u5934\uFF0C\u9ED8\u8BA4\u7B2C\u4E00\u884C\n   */\n  header?: number;\n  /**\n   * \u4EE5\u7B2C\u51E0\u5217\u7B2C\u51E0\u884C\u5F00\u59CB\u8BFB\u53D6\uFF0C\u9ED8\u8BA4\u7B2C\u4E00\u884C\u7B2C\u4E00\u5217\n   */\n  rangeStart?: { c: number; r: number };\n  /**\n   * \u7A7A\u5355\u5143\u683C\u5360\u4F4D\u503C\uFF1B\u4F20\u5165\u540E\u6BCF\u884C\u5BF9\u8C61\u4F1A\u5305\u542B\u4E0E\u8868\u5934\u5BF9\u9F50\u7684\u5168\u90E8 key\uFF08\u7A7A\u5355\u5143\u683C\u4E3A\u8BE5\u503C\uFF09\uFF0C\u5426\u5219 SheetJS \u4F1A\u7701\u7565\u7A7A\u5355\u5143\u683C\u5BF9\u5E94\u5B57\u6BB5\n   */\n  defval?: unknown;\n  /**\n   * \u4FDD\u7559\u7A7A\u884C\uFF0C\u9ED8\u8BA4false\n   */\n  blankrows?: boolean;\n  /**\n   * \u81EA\u5B9A\u4E49\u6309\u94AE\u5185\u5BB9\n   */\n  children?: React.ReactNode;\n  /**\n   * Upload\u7EC4\u4EF6\u5C5E\u6027\n   */\n  uploadProps?: UploadProps;\n  /**\n   * Button\u7EC4\u4EF6\u5C5E\u6027\n   */\n  buttonProps?: ButtonProps;\n}\n";
+export declare const ImportExeclTypes = "\nexport interface ImportExeclProps<T = any[]> {\n  accept?: string;\n  /**\n   * \u4E0A\u4F20\u4E8B\u4EF6\uFF0C\u83B7\u53D6execl\u6570\u636E\u5217\u8868\uFF0C\u51FD\u6570\u8FD4\u56DEpromise\u5E76\u4E14showDefautlMessage\u4E0D\u662Ffalse\u65F6\u6709\u9ED8\u8BA4message\u63D0\u793A\n   */\n  /**\n   * \u81EA\u5B9A\u4E49 children \u65F6\u662F\u5426\u6491\u6EE1\u7236\u5BB9\u5668\uFF08\u5982\u4E0B\u62C9\u83DC\u5355 label\uFF09\uFF0C\u6269\u5927\u53EF\u70B9\u51FB\u8303\u56F4\n   */\n  fillContainer?: boolean;\n  onChange: (list: T, fileInfo: Pick<UploadFile, 'name' | 'size' | 'type' | 'uid'>) => Promise<{\n    success: boolean; failMsg?: string; data?: {\n      success: boolean;\n      insertCount: number;\n      updateCount: number;\n      deleteCount: number;\n    } | number\n  } | void> | void;\n  /**\n   * \u663E\u793A\u9ED8\u8BA4\u7684\u63D0\u793A\n   */\n  showDefautlMessage?: boolean;\n  /**\n   * \u6309\u94AE\u6587\u672C\n   */\n  title?: string;\n  /**\n   * \u8BFB\u53D6\u5DE5\u4F5C\u7C3F\u6570\u91CF\uFF0C\u9ED8\u8BA41\n   */\n  max?: number;\n  /**\n   * \u4EE5\u7B2C\u51E0\u884C\u4E3A\u8868\u5934\uFF0C\u9ED8\u8BA4\u7B2C\u4E00\u884C\n   */\n  header?: number;\n  /**\n   * \u4EE5\u7B2C\u51E0\u5217\u7B2C\u51E0\u884C\u5F00\u59CB\u8BFB\u53D6\uFF0C\u9ED8\u8BA4\u7B2C\u4E00\u884C\u7B2C\u4E00\u5217\n   */\n  rangeStart?: { c: number; r: number };\n  /**\n   * \u7A7A\u5355\u5143\u683C\u5360\u4F4D\u503C\uFF1B\u4F20\u5165\u540E\u6BCF\u884C\u5BF9\u8C61\u4F1A\u5305\u542B\u4E0E\u8868\u5934\u5BF9\u9F50\u7684\u5168\u90E8 key\uFF08\u7A7A\u5355\u5143\u683C\u4E3A\u8BE5\u503C\uFF09\uFF0C\u5426\u5219 SheetJS \u4F1A\u7701\u7565\u7A7A\u5355\u5143\u683C\u5BF9\u5E94\u5B57\u6BB5\n   */\n  defval?: unknown;\n  /**\n   * \u4FDD\u7559\u7A7A\u884C\uFF0C\u9ED8\u8BA4false\n   */\n  blankrows?: boolean;\n  /**\n   * \u81EA\u5B9A\u4E49\u6309\u94AE\u5185\u5BB9\n   */\n  children?: React.ReactNode;\n  /**\n   * Upload\u7EC4\u4EF6\u5C5E\u6027\n   */\n  uploadProps?: UploadProps;\n  /**\n   * Button\u7EC4\u4EF6\u5C5E\u6027\n   */\n  buttonProps?: ButtonProps;\n}\n";

package/dist/esm/types/ImportExeclTypes.js

@@ -1 +1 @@
-export var ImportExeclTypes = "\nexport interface ImportExeclProps<T = any[]> {\n  accept?: string;\n  /**\n   * \u4E0A\u4F20\u4E8B\u4EF6\uFF0C\u83B7\u53D6execl\u6570\u636E\u5217\u8868\uFF0C\u51FD\u6570\u8FD4\u56DEpromise\u5E76\u4E14showDefautlMessage\u4E0D\u662Ffalse\u65F6\u6709\u9ED8\u8BA4message\u63D0\u793A\n   */\n  onChange: (list: T, fileInfo: Pick<UploadFile, 'name' | 'size' | 'type' | 'uid'>) => Promise<{\n    success: boolean; failMsg?: string; data?: {\n      success: boolean;\n      insertCount: number;\n      updateCount: number;\n      deleteCount: number;\n    } | number\n  } | void> | void;\n  /**\n   * \u663E\u793A\u9ED8\u8BA4\u7684\u63D0\u793A\n   */\n  showDefautlMessage?: boolean;\n  /**\n   * \u6309\u94AE\u6587\u672C\n   */\n  title?: string;\n  /**\n   * \u8BFB\u53D6\u5DE5\u4F5C\u7C3F\u6570\u91CF\uFF0C\u9ED8\u8BA41\n   */\n  max?: number;\n  /**\n   * \u4EE5\u7B2C\u51E0\u884C\u4E3A\u8868\u5934\uFF0C\u9ED8\u8BA4\u7B2C\u4E00\u884C\n   */\n  header?: number;\n  /**\n   * \u4EE5\u7B2C\u51E0\u5217\u7B2C\u51E0\u884C\u5F00\u59CB\u8BFB\u53D6\uFF0C\u9ED8\u8BA4\u7B2C\u4E00\u884C\u7B2C\u4E00\u5217\n   */\n  rangeStart?: { c: number; r: number };\n  /**\n   * \u7A7A\u5355\u5143\u683C\u5360\u4F4D\u503C\uFF1B\u4F20\u5165\u540E\u6BCF\u884C\u5BF9\u8C61\u4F1A\u5305\u542B\u4E0E\u8868\u5934\u5BF9\u9F50\u7684\u5168\u90E8 key\uFF08\u7A7A\u5355\u5143\u683C\u4E3A\u8BE5\u503C\uFF09\uFF0C\u5426\u5219 SheetJS \u4F1A\u7701\u7565\u7A7A\u5355\u5143\u683C\u5BF9\u5E94\u5B57\u6BB5\n   */\n  defval?: unknown;\n  /**\n   * \u4FDD\u7559\u7A7A\u884C\uFF0C\u9ED8\u8BA4false\n   */\n  blankrows?: boolean;\n  /**\n   * \u81EA\u5B9A\u4E49\u6309\u94AE\u5185\u5BB9\n   */\n  children?: React.ReactNode;\n  /**\n   * Upload\u7EC4\u4EF6\u5C5E\u6027\n   */\n  uploadProps?: UploadProps;\n  /**\n   * Button\u7EC4\u4EF6\u5C5E\u6027\n   */\n  buttonProps?: ButtonProps;\n}\n";
+export var ImportExeclTypes = "\nexport interface ImportExeclProps<T = any[]> {\n  accept?: string;\n  /**\n   * \u4E0A\u4F20\u4E8B\u4EF6\uFF0C\u83B7\u53D6execl\u6570\u636E\u5217\u8868\uFF0C\u51FD\u6570\u8FD4\u56DEpromise\u5E76\u4E14showDefautlMessage\u4E0D\u662Ffalse\u65F6\u6709\u9ED8\u8BA4message\u63D0\u793A\n   */\n  /**\n   * \u81EA\u5B9A\u4E49 children \u65F6\u662F\u5426\u6491\u6EE1\u7236\u5BB9\u5668\uFF08\u5982\u4E0B\u62C9\u83DC\u5355 label\uFF09\uFF0C\u6269\u5927\u53EF\u70B9\u51FB\u8303\u56F4\n   */\n  fillContainer?: boolean;\n  onChange: (list: T, fileInfo: Pick<UploadFile, 'name' | 'size' | 'type' | 'uid'>) => Promise<{\n    success: boolean; failMsg?: string; data?: {\n      success: boolean;\n      insertCount: number;\n      updateCount: number;\n      deleteCount: number;\n    } | number\n  } | void> | void;\n  /**\n   * \u663E\u793A\u9ED8\u8BA4\u7684\u63D0\u793A\n   */\n  showDefautlMessage?: boolean;\n  /**\n   * \u6309\u94AE\u6587\u672C\n   */\n  title?: string;\n  /**\n   * \u8BFB\u53D6\u5DE5\u4F5C\u7C3F\u6570\u91CF\uFF0C\u9ED8\u8BA41\n   */\n  max?: number;\n  /**\n   * \u4EE5\u7B2C\u51E0\u884C\u4E3A\u8868\u5934\uFF0C\u9ED8\u8BA4\u7B2C\u4E00\u884C\n   */\n  header?: number;\n  /**\n   * \u4EE5\u7B2C\u51E0\u5217\u7B2C\u51E0\u884C\u5F00\u59CB\u8BFB\u53D6\uFF0C\u9ED8\u8BA4\u7B2C\u4E00\u884C\u7B2C\u4E00\u5217\n   */\n  rangeStart?: { c: number; r: number };\n  /**\n   * \u7A7A\u5355\u5143\u683C\u5360\u4F4D\u503C\uFF1B\u4F20\u5165\u540E\u6BCF\u884C\u5BF9\u8C61\u4F1A\u5305\u542B\u4E0E\u8868\u5934\u5BF9\u9F50\u7684\u5168\u90E8 key\uFF08\u7A7A\u5355\u5143\u683C\u4E3A\u8BE5\u503C\uFF09\uFF0C\u5426\u5219 SheetJS \u4F1A\u7701\u7565\u7A7A\u5355\u5143\u683C\u5BF9\u5E94\u5B57\u6BB5\n   */\n  defval?: unknown;\n  /**\n   * \u4FDD\u7559\u7A7A\u884C\uFF0C\u9ED8\u8BA4false\n   */\n  blankrows?: boolean;\n  /**\n   * \u81EA\u5B9A\u4E49\u6309\u94AE\u5185\u5BB9\n   */\n  children?: React.ReactNode;\n  /**\n   * Upload\u7EC4\u4EF6\u5C5E\u6027\n   */\n  uploadProps?: UploadProps;\n  /**\n   * Button\u7EC4\u4EF6\u5C5E\u6027\n   */\n  buttonProps?: ButtonProps;\n}\n";

package/dist/esm/utils/excelHelper.tpl

@@ -270,6 +270,12 @@ export interface ExcelExportOptions {
   sheetPassword?: string;
   /** 是否锁定基础行（数据行前的行），默认为 true */
   lockHeaderRows?: boolean;
+  /**
+   * 是否锁定数据填写区（含 columnValidations 预留行）。
+   * - 默认 false：数据区可编辑（表头仍由 lockHeaderRows 锁定）
+   * - true：整表只读，需配合 lockHeaderRows（默认已 true）启用工作表保护
+   */
+  lockDataRows?: boolean;
   /** 自定义合并单元格范围数组（如 ['A1:B2', 'C1:D1']） */
   mergeCells?: string[];
   /** 数据行高度，默认 22 */
@@ -382,6 +388,35 @@ const applyColumnValidations = (
   });
 };
 
+/**
+ * 工作表保护开启前，解锁数据填写区。
+ * Excel 新建单元格默认 protection.locked=true；仅锁表头并 protect 后，未显式解锁的数据区也不可编辑。
+ */
+const unlockDataEntryArea = (
+  workSheet: ExcelJS.Worksheet,
+  headerRowCount: number,
+  colCount: number,
+  maxDataRows: number,
+  dataRowCount: number,
+  hasColumnValidations: boolean,
+  lockedColumns: number[],
+) => {
+  const rowSpan = hasColumnValidations ? Math.max(dataRowCount, maxDataRows) : dataRowCount;
+  if (rowSpan <= 0) return;
+
+  const startRow = headerRowCount + 1;
+  const endRow = startRow + rowSpan - 1;
+
+  for (let row = startRow; row <= endRow; row++) {
+    for (let col = 1; col <= colCount; col++) {
+      const colIndex = col - 1;
+      if (!lockedColumns.includes(colIndex)) {
+        workSheet.getCell(row, col).protection = { locked: false };
+      }
+    }
+  }
+};
+
 function buildDataCellBorder(style: ExcelJS.BorderStyle): ExcelJS.Borders {
   const side = { style } as ExcelJS.Border;
   return {
@@ -538,6 +573,8 @@ export const genExcelAdvanced = async (
 
   // 是否锁定基础行（默认为 true）
   const lockHeaderRows = options?.lockHeaderRows !== false;
+  // 是否锁定数据填写区（整表只读），默认 false
+  const lockDataRows = options?.lockDataRows === true;
   // 物理行号：追加行时递增，用于 mergeCells 与「第几行」对应
   let currentRowIndex = 0;
 
@@ -569,11 +606,9 @@ export const genExcelAdvanced = async (
       bottom: { style: 'thin' },
       right: { style: 'thin' },
     };
-    if (lockHeaderRows) {
-      titleRow.eachCell((cell) => {
-        cell.protection = { locked: true };
-      });
-    }
+    titleRow.eachCell((cell) => {
+      cell.protection = { locked: lockHeaderRows };
+    });
   }
 
   // ========== 第二行：注意事项（可选） ==========
@@ -607,11 +642,9 @@ export const genExcelAdvanced = async (
       bottom: { style: 'thin' },
       right: { style: 'thin' },
     };
-    if (lockHeaderRows) {
-      noticeRow.eachCell((cell) => {
-        cell.protection = { locked: true };
-      });
-    }
+    noticeRow.eachCell((cell) => {
+      cell.protection = { locked: lockHeaderRows };
+    });
   }
 
   // ========== 编号行（可选，隐藏） ==========
@@ -625,9 +658,7 @@ export const genExcelAdvanced = async (
         bottom: { style: 'thin' },
         right: { style: 'thin' },
       };
-      if (lockHeaderRows) {
-        cell.protection = { locked: true };
-      }
+      cell.protection = { locked: lockHeaderRows };
     });
     codeColumnRow.alignment = { horizontal: 'center', vertical: 'middle' };
     codeColumnRow.hidden = true;
@@ -649,9 +680,7 @@ export const genExcelAdvanced = async (
           bottom: { style: 'thin' },
           right: { style: 'thin' },
         };
-        if (lockHeaderRows) {
-          cell.protection = { locked: true };
-        }
+        cell.protection = { locked: lockHeaderRows };
       });
     });
   } else {
@@ -672,9 +701,7 @@ export const genExcelAdvanced = async (
         bottom: { style: 'thin' },
         right: { style: 'thin' },
       };
-      if (lockHeaderRows) {
-        cell.protection = { locked: true };
-      }
+      cell.protection = { locked: lockHeaderRows };
     });
     columnHeaderRow.height = 25;
   }
@@ -706,8 +733,14 @@ export const genExcelAdvanced = async (
         if (colNumber <= colCount) {
           const colIndex = colNumber - 1;
           applyDataCellAppearance(cell, dataRowIndex, colIndex, options);
-          if (hasLockedColumns) {
+          if (lockDataRows) {
+            // 整表只读：数据行也锁定，不必显式写（ExcelJS 默认 locked=true），这里写明意图
+            cell.protection = { locked: true };
+          } else if (hasLockedColumns) {
             cell.protection = { locked: lockedColumns.includes(colIndex) };
+          } else if (lockHeaderRows) {
+            // 仅锁表头时，数据行显式解锁，避免 protect 后整表不可编辑
+            cell.protection = { locked: false };
           }
         }
       });
@@ -720,8 +753,20 @@ export const genExcelAdvanced = async (
     applyColumnValidations(workBook, workSheet, options.columnValidations, currentRowIndex, options.maxDataRows ?? 500);
   }
 
-  // ========== 工作表保护：锁定表头区或部分列时启用（密码可选） ==========
-  if (lockHeaderRows || hasLockedColumns) {
+  // ========== 工作表保护：锁定表头/数据区或部分列时启用（密码可选） ==========
+  if (lockHeaderRows || hasLockedColumns || lockDataRows) {
+    // lockDataRows=true 时整表只读，数据区保持默认 locked=true，不需要解锁
+    if (!lockDataRows) {
+      unlockDataEntryArea(
+        workSheet,
+        currentRowIndex,
+        colCount,
+        options?.maxDataRows ?? 500,
+        rows?.length ?? 0,
+        !!(options?.columnValidations?.length),
+        lockedColumns,
+      );
+    }
     workSheet.protect(options?.sheetPassword ?? '', {
       selectLockedCells: true,
       selectUnlockedCells: true,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cfmm/umi-plugins-ui-v2",
   "author": "ysj <411367308@qq.com>",
-  "version": "0.0.27",
+  "version": "0.0.28",
   "main": "dist/cjs/index.js",
   "types": "dist/cjs/index.d.ts",
   "publishConfig": {