@zat-design/sisyphus-react 4.5.6-beta.1 → 4.5.6-beta.3

package/es/ProConfigProvider/demo/locale.js

@@ -0,0 +1,58 @@
+/**
+ * iframe: 400
+ */
+
+import { useState } from 'react';
+import { Button, Space } from 'antd';
+import { ProConfigProvider, ProForm } from '@zat-design/sisyphus-react';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+const LocaleDemo = () => {
+  const [locale, setLocale] = useState(localStorage.getItem('locale') || 'zh-CN');
+  const handleChange = value => {
+    setLocale(value);
+    localStorage.setItem('locale', value);
+    window.location.reload();
+  };
+  return /*#__PURE__*/_jsxs(Space, {
+    direction: "vertical",
+    size: 16,
+    style: {
+      width: '100%'
+    },
+    children: [/*#__PURE__*/_jsxs(Space, {
+      children: [/*#__PURE__*/_jsx(Button, {
+        type: locale === 'zh-CN' ? 'primary' : 'default',
+        onClick: () => handleChange('zh-CN'),
+        children: "\u4E2D\u6587"
+      }), /*#__PURE__*/_jsx(Button, {
+        type: locale === 'en-US' ? 'primary' : 'default',
+        onClick: () => handleChange('en-US'),
+        children: "English"
+      })]
+    }), /*#__PURE__*/_jsx(ProConfigProvider, {
+      locale: locale,
+      children: /*#__PURE__*/_jsx(ProForm, {
+        columns: [{
+          type: 'Input',
+          label: locale === 'zh-CN' ? '姓名' : 'Name',
+          name: 'name',
+          required: true
+        }, {
+          type: 'Select',
+          label: locale === 'zh-CN' ? '状态' : 'Status',
+          name: 'status',
+          fieldProps: {
+            options: [{
+              label: locale === 'zh-CN' ? '启用' : 'Enabled',
+              value: '1'
+            }, {
+              label: locale === 'zh-CN' ? '禁用' : 'Disabled',
+              value: '0'
+            }]
+          }
+        }]
+      })
+    })]
+  });
+};
+export default LocaleDemo;

package/es/ProForm/components/base/RangePicker/index.js

@@ -9,6 +9,7 @@ import dayjs from 'dayjs';
 import React from 'react';
 import { useProConfig } from "../../../../ProConfigProvider";
 import locale from "../../../../locale";
+import enUS from "../../../../locale/en_US";
 import ProForm from "../../../../ProForm";
 import Container from "../../Container";
 import { useDateRange } from "./useDateRange";
@@ -35,13 +36,7 @@ const getDefaultFormat = picker => {
 
 // 获取默认快捷选项（presets 格式）
 const getDefaultPresets = () => {
-  const rangeLabels = locale?.RangePicker?.ranges || {
-    today: '今天',
-    lastWeek: '近1周',
-    lastMonth: '近1月',
-    last3Months: '近3月',
-    lastYear: '近1年'
-  };
+  const rangeLabels = locale?.RangePicker?.ranges || enUS.RangePicker.ranges;
   return [{
     label: rangeLabels.today,
     value: [dayjs().startOf('day'), dayjs().endOf('day')]

package/es/ProForm/components/render/ConfirmWrapper.js

@@ -3,10 +3,11 @@ import _isFunction from "lodash/isFunction";
 import React from 'react';
 import { Modal } from 'antd';
 import ProForm from "../../index";
+import locale from "../../../locale";
 import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
 const defaultConfirmProps = {
-  title: '操作提示',
-  content: '确定要修改该字段吗？'
+  title: locale.ProForm.confirmTitle,
+  content: locale.ProForm.confirmContent
 };
 const ConfirmWrapper = props => {
   const {

package/es/ProForm/components/render/RenderFields.js

@@ -115,7 +115,7 @@ const RenderFields = props => {
     }
     if (component && /*#__PURE__*/React.isValidElement(component)) {
       const newComponent = component;
-      const isProEditTable = newComponent?.props?.onlyOneLineMsg === '请先保存数据';
+      const isProEditTable = newComponent?.props?.onlyOneLineMsg != null;
       TargetComponent = _isView ? viewRenderHandle || '' : component;
       // 可编辑表格内部支持
       if (isProEditTable) {

package/es/ProLayout/components/ProHeader/PropTypes.d.ts

@@ -172,7 +172,7 @@ export interface ProHeaderType {
      */
     fixedTop?: string | number;
     /**
-     * @description      是否显示返回按钮
+     * @description      是否显示返回按钮。显式传值优先；不传时若有 onBack 则显示，否则由 autoBack 按浏览器历史长度判断
      * @default           -
      */
     showBack?: boolean;
@@ -198,8 +198,8 @@ export interface ProHeaderType {
      */
     zIndex?: number;
     /**
-     * @description      返回
-     * @default           100
+     * @description      返回按钮点击回调；不传时默认执行 window.history.back()
+     * @default           -
      */
     onBack?: () => void;
     [key: string]: any;

package/es/ProLayout/components/ProHeader/components/Describe/index.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+import type { DescribeColumnType } from '../../PropTypes';
+/** 描述项里的单条值（link / copyable / tag 组合），对应 items 数组元素 */
+type DescribeValueItem = Pick<DescribeColumnType, 'tag' | 'link' | 'value' | 'copyable'>;
+/**
+ * 标签渲染：数组 tag 逐个渲染，单值渲染一个，空则不渲染
+ */
+export declare const DescribeTag: ({ tag, parentKey, }: {
+    tag?: DescribeColumnType["tag"];
+    parentKey: string;
+}) => import("react/jsx-runtime").JSX.Element;
+/**
+ * 单行值渲染：link → <a>，copyable+字符串 → 复制按钮，末尾追加 tag
+ */
+export declare const DescribeValue: ({ value, link, copyable, tag, parentKey, }: DescribeValueItem & {
+    parentKey: string;
+}) => import("react/jsx-runtime").JSX.Element;
+/**
+ * 多值渲染：以「、」连接；超 3 个显示「共N个，」前缀；内容溢出时显示「...」并用 Tooltip 展示全部
+ */
+export declare const DescribeItems: ({ items, parentKey, containerRef, }: {
+    items: DescribeValueItem[];
+    parentKey: string;
+    containerRef: React.RefObject<HTMLDivElement>;
+}) => import("react/jsx-runtime").JSX.Element;
+export {};

package/es/ProLayout/components/ProHeader/components/Describe/index.js

@@ -0,0 +1,109 @@
+import _isString from "lodash/isString";
+import React from 'react';
+import { Space, Tooltip } from 'antd';
+import classnames from 'classnames';
+import Copy from "../Copy";
+import { checkDescribeItemsHidden, getTagKey, getDescribeValueKey } from "../../utils";
+import locale, { formatMessage } from "../../../../../locale";
+
+/** 描述项里的单条值（link / copyable / tag 组合），对应 items 数组元素 */
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * 标签渲染：数组 tag 逐个渲染，单值渲染一个，空则不渲染
+ */
+export const DescribeTag = ({
+  tag,
+  parentKey
+}) => {
+  if (Array.isArray(tag) && tag.length) {
+    return /*#__PURE__*/_jsx(Space, {
+      size: 4,
+      children: tag.map((tagItem, tagIndex) => /*#__PURE__*/_jsx("div", {
+        className: "pro-header-tag",
+        children: tagItem
+      }, getTagKey(tagItem, parentKey, tagIndex)))
+    });
+  }
+  return tag ? /*#__PURE__*/_jsx("div", {
+    className: "pro-header-tag",
+    children: tag
+  }) : null;
+};
+
+/**
+ * 单行值渲染：link → <a>，copyable+字符串 → 复制按钮，末尾追加 tag
+ */
+export const DescribeValue = ({
+  value,
+  link,
+  copyable,
+  tag,
+  parentKey
+}) => {
+  return /*#__PURE__*/_jsxs(Space, {
+    size: 4,
+    align: tag ? 'baseline' : 'center',
+    children: [link ? /*#__PURE__*/_jsx("a", {
+      onClick: () => {
+        const newWindow = window.open(link);
+        newWindow.opener = null;
+      },
+      children: value
+    }) : value, copyable && _isString(value) ? /*#__PURE__*/_jsx(Copy, {
+      text: value
+    }) : null, /*#__PURE__*/_jsx(DescribeTag, {
+      tag: tag,
+      parentKey: parentKey
+    })]
+  });
+};
+
+/**
+ * 多值渲染：以「、」连接；超 3 个显示「共N个，」前缀；内容溢出时显示「...」并用 Tooltip 展示全部
+ */
+export const DescribeItems = ({
+  items,
+  parentKey,
+  containerRef
+}) => {
+  // items 配置是否超长，超长则展示 ... + tip 提示
+  const itemsHidden = checkDescribeItemsHidden(containerRef?.current);
+  const result = /*#__PURE__*/_jsxs("div", {
+    ref: containerRef,
+    className: classnames({
+      'pro-header-describe-items': true,
+      'pro-header-describe-items-more': items.length >= 2
+    }),
+    children: [items?.length > 3 ? formatMessage(locale.ProHeader.itemsCountPrefix, {
+      count: items.length
+    }) : null, items.map((item, itemIndex) => /*#__PURE__*/_jsxs("span", {
+      children: [/*#__PURE__*/_jsx(DescribeValue, {
+        ...item,
+        parentKey: parentKey
+      }), items?.length !== itemIndex + 1 ? locale.ProHeader.itemsSeparator : null]
+    }, getDescribeValueKey(item, parentKey, itemIndex))), itemsHidden ? /*#__PURE__*/_jsx("span", {
+      className: "pro-header-describe-items-omit",
+      children: "..."
+    }) : null]
+  });
+  if (itemsHidden) {
+    const tipResult = /*#__PURE__*/_jsx(_Fragment, {
+      children: items.map((item, itemIndex) => /*#__PURE__*/_jsx("p", {
+        className: "pro-header-describe-items-tip-value",
+        children: /*#__PURE__*/_jsx(DescribeValue, {
+          ...item,
+          parentKey: parentKey
+        })
+      }, getDescribeValueKey(item, parentKey, itemIndex)))
+    });
+    return /*#__PURE__*/_jsx(Tooltip, {
+      placement: "bottomLeft",
+      classNames: {
+        root: 'pro-header-describe-items-tip'
+      },
+      title: tipResult,
+      children: result
+    });
+  }
+  return result;
+};

package/es/ProLayout/components/ProHeader/index.js

@@ -7,26 +7,18 @@ import React, { memo, useEffect, useState, useRef } from 'react';
 import { tools } from '@zat-design/utils';
 import classnames from 'classnames';
 import dayjs from 'dayjs';
-import { useToggle, useSize } from 'ahooks';
+import { useToggle } from 'ahooks';
 import { ReactSVG } from 'react-svg';
 import foldSvg from "../../../assets/arrow.svg";
 import { Copy, ProBackBtn } from "./components";
+import { DescribeItems, DescribeValue } from "./components/Describe";
 import getEnumLabel from "../../../ProEnum/utils/getEnumLabel";
 import locale from "../../../locale";
-import { checkDescribeItemsHidden } from "./utils";
+import { toKeyPart, getDescribeColumnKey, getTagKey, getSubDescribeKey } from "./utils";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 const {
   formatAmount
 } = tools;
-const toKeyPart = value => {
-  if (value == null || value === '') return undefined;
-  if (typeof value === 'string' || typeof value === 'number') return String(value);
-  return undefined;
-};
-const getDescribeColumnKey = (item, index) => toKeyPart(item.label) ?? toKeyPart(item.value) ?? `describe-${index}`;
-const getDescribeValueKey = (item, parentKey, index) => toKeyPart(item.link) ?? toKeyPart(item.value) ?? `${parentKey}-value-${index}`;
-const getTagKey = (tagItem, parentKey, index) => toKeyPart(tagItem) ?? `${parentKey}-tag-${index}`;
-const getSubDescribeKey = (item, index) => toKeyPart(item.label) ?? toKeyPart(item.code) ?? `sub-describe-${index}`;
 const ProHeader = props => {
   const {
     breadcrumbColumns,
@@ -37,7 +29,6 @@ const ProHeader = props => {
     className,
     bodyOverFlowHidden = false,
     fixedTop,
-    showBack = true,
     showShadow = false,
     zIndex = 98,
     title,
@@ -47,19 +38,32 @@ const ProHeader = props => {
     isConfirmBack = false,
     isConfirmBackModalProps = {}
   } = props;
-  const [backState, setBackState] = useState(showBack);
+
+  // 返回按钮是否显示。
+  // 显式意图优先于 autoBack 启发式：
+  // 1) 用户显式传了 showBack → 完全尊重该值；
+  // 2) 传了 onBack（返回不依赖浏览器历史，如 tab 内返回 / 自定义跳转）→ 显示；
+  // 3) 都没传（纯默认，返回兜底走 window.history.back）→ 由 autoBack 按历史长度智能判断：
+  //    新开页面(history.length <= autoBack)无处可返回，则隐藏。
+  const computeBackState = () => {
+    if (props.showBack !== undefined) return props.showBack;
+    if (onBack) return true;
+    return window.history.length > autoBack;
+  };
+  const [backState, setBackState] = useState(computeBackState);
   const [fold, {
     toggle
   }] = useToggle(collapsed);
   const ref = useRef(null);
-  const size = useSize(ref);
-  let _title = title;
+
+  // 最终用于渲染的标题（title + showBack 时会被转成面包屑，此处置空）
+  let finalTitle = title;
 
   // 面包屑配置数据源
-  const _breadcrumbColumns = breadcrumbColumns || [];
+  const finalBreadcrumbColumns = breadcrumbColumns || [];
 
   // 次级配置数据源
-  const _subDescribeColumns = subDescribeColumns || [];
+  const finalSubDescribeColumns = subDescribeColumns || [];
   useEffect(() => {
     if (bodyOverFlowHidden) {
       const bodyElement = document.querySelector('body');
@@ -70,13 +74,11 @@ const ProHeader = props => {
       bodyElement.style.overflow = '';
     };
   }, [bodyOverFlowHidden]);
+
+  // showBack / onBack / autoBack 变化时同步 backState（避免 props 更新后按钮显隐不同步）
   useEffect(() => {
-    const isNewPage = window.history.length;
-    // history的记录，默认2，代办新开页面
-    if (isNewPage <= autoBack) {
-      setBackState(false);
-    }
-  }, []);
+    setBackState(computeBackState());
+  }, [props.showBack, onBack, autoBack]);
 
   /**
    * 主级描述数据渲染
@@ -108,82 +110,6 @@ const ProHeader = props => {
           return null;
         }
         const onlyTag = tag && !label && !value;
-        const tagRender = params => {
-          if (Array.isArray(params?.tag) && params?.tag.length) {
-            return /*#__PURE__*/_jsx(Space, {
-              size: 4,
-              children: params.tag.map((tagItem, tagIndex) => {
-                return /*#__PURE__*/_jsx("div", {
-                  className: "pro-header-tag",
-                  children: tagItem
-                }, getTagKey(tagItem, describeItemKey, tagIndex));
-              })
-            });
-          }
-          return params?.tag ? /*#__PURE__*/_jsx("div", {
-            className: "pro-header-tag",
-            children: params?.tag
-          }) : null;
-        };
-
-        /** 单行渲染 */
-        const valueRender = params => {
-          return /*#__PURE__*/_jsxs(Space, {
-            size: 4,
-            align: params?.tag ? 'baseline' : 'center',
-            children: [params?.link ? /*#__PURE__*/_jsx("a", {
-              onClick: () => {
-                const newWindow = window.open(params.link);
-                newWindow.opener = null;
-              },
-              children: params?.value
-            }) : params?.value, params?.copyable && _isString(params?.value) ? /*#__PURE__*/_jsx(Copy, {
-              text: params.value
-            }) : null, tagRender({
-              tag: params?.tag
-            })]
-          });
-        };
-
-        /** 多行渲染 */
-        const itemsRender = () => {
-          // items配置是否超长，超长配置... + tip 提示
-          const itemsHidden = checkDescribeItemsHidden(ref?.current);
-          const result = /*#__PURE__*/_jsxs("div", {
-            ref: ref,
-            className: classnames({
-              'pro-header-describe-items': true,
-              'pro-header-describe-items-more': items.length >= 2
-            }),
-            children: [items?.length > 3 ? `共${items?.length}个，` : null, items.map((item, itemIndex) => {
-              return /*#__PURE__*/_jsxs("span", {
-                children: [valueRender(item), items?.length !== itemIndex + 1 ? ' 、' : null]
-              }, getDescribeValueKey(item, describeItemKey, itemIndex));
-            }), itemsHidden ? /*#__PURE__*/_jsx("span", {
-              className: "pro-header-describe-items-omit",
-              children: "..."
-            }) : null]
-          });
-          if (itemsHidden) {
-            const tipResult = /*#__PURE__*/_jsx(_Fragment, {
-              children: items.map((item, itemIndex) => {
-                return /*#__PURE__*/_jsx("p", {
-                  className: "pro-header-describe-items-tip-value",
-                  children: valueRender(item)
-                }, getDescribeValueKey(item, describeItemKey, itemIndex));
-              })
-            });
-            return /*#__PURE__*/_jsx(Tooltip, {
-              placement: "bottomLeft",
-              classNames: {
-                root: 'pro-header-describe-items-tip'
-              },
-              title: tipResult,
-              children: result
-            });
-          }
-          return result;
-        };
         const tagCls = classnames({
           'pro-header-only-tag': onlyTag,
           'pro-header-describe-items-calc': _isString(width) ? width.includes('calc') : false
@@ -200,12 +126,17 @@ const ProHeader = props => {
               children: label
             }) : null, /*#__PURE__*/_jsx("span", {
               className: "pro-header-describe-value",
-              children: items?.length ? itemsRender() : /*#__PURE__*/_jsx("span", {
-                children: valueRender({
-                  value,
-                  copyable,
-                  tag,
-                  link
+              children: items?.length ? /*#__PURE__*/_jsx(DescribeItems, {
+                items: items,
+                parentKey: describeItemKey,
+                containerRef: ref
+              }) : /*#__PURE__*/_jsx("span", {
+                children: /*#__PURE__*/_jsx(DescribeValue, {
+                  value: value,
+                  copyable: copyable,
+                  tag: tag,
+                  link: link,
+                  parentKey: describeItemKey
                 })
               })
             })]
@@ -302,10 +233,10 @@ const ProHeader = props => {
    * 总结信息面板渲染
    */
   const breadcrumbRender = () => {
-    if (Array.isArray(_breadcrumbColumns) && !_breadcrumbColumns.length) {
+    if (Array.isArray(finalBreadcrumbColumns) && !finalBreadcrumbColumns.length) {
       return [];
     }
-    const list = _breadcrumbColumns?.filter(item => {
+    const list = finalBreadcrumbColumns?.filter(item => {
       return item.type === 'breadcrumb';
     });
     return list.map((item, index) => {
@@ -355,10 +286,10 @@ const ProHeader = props => {
    * 头部左侧导航栏后业务信息
    */
   const infoRender = () => {
-    if (!Array.isArray(_breadcrumbColumns)) {
+    if (!Array.isArray(finalBreadcrumbColumns)) {
       return '';
     }
-    const list = _breadcrumbColumns?.filter(item => {
+    const list = finalBreadcrumbColumns?.filter(item => {
       return item.type !== 'breadcrumb';
     });
     if (!list.length) {
@@ -436,24 +367,29 @@ const ProHeader = props => {
       })
     });
   };
+
+  // 说明：以下两个 class 的判断沿用原有等价逻辑（去掉了原表达式里对 describeColumns 的重复判断）。
+  // has = 有次级描述 或 有主级描述；no = 无主级描述。二者非严格互斥（原实现即如此，未改动其行为）。
+  const noDescribe = _isEmpty(describeColumns);
+  const hasDescribe = !_isEmpty(finalSubDescribeColumns) || !noDescribe;
   const cls = classnames({
     'pro-header': true,
     'pro-header-fixed': fixedTop,
     'pro-header-shadow': showShadow,
     // 内部窗口滚动自带阴影场景
     'pro-header-no-back': !backState,
-    'pro-header-has-describe': !_isEmpty(_subDescribeColumns) || !_isEmpty(describeColumns) || !_isEmpty(describeColumns),
-    'pro-header-no-describe': _isEmpty(_subDescribeColumns) && _isEmpty(describeColumns) || _isEmpty(describeColumns),
+    'pro-header-has-describe': hasDescribe,
+    'pro-header-no-describe': noDescribe,
     [`${className}`]: className
   });
-  if (title && !_isEmpty(_breadcrumbColumns)) {
+  if (title && !_isEmpty(finalBreadcrumbColumns)) {
     console.error('warning: The title and the breadcrumbList cannot be used together');
   }
 
   // title默认不显示返回按钮，只有showBack设置为true时才显示
   if (title && props.showBack) {
-    _title = null;
-    _breadcrumbColumns.push({
+    finalTitle = null;
+    finalBreadcrumbColumns.push({
       type: 'breadcrumb',
       value: title
     });
@@ -492,9 +428,9 @@ const ProHeader = props => {
       top: fixedTop,
       zIndex
     },
-    children: _title ? /*#__PURE__*/_jsx("div", {
+    children: finalTitle ? /*#__PURE__*/_jsx("div", {
       className: "pro-header-title",
-      children: _title
+      children: finalTitle
     }) : /*#__PURE__*/_jsxs(_Fragment, {
       children: [/*#__PURE__*/_jsxs("div", {
         className: "pro-header-top",
@@ -516,14 +452,14 @@ const ProHeader = props => {
           className: "pro-header-right",
           children: actionsRender()
         })]
-      }), describeRender(describeColumns), !_isEmpty(_subDescribeColumns) ? /*#__PURE__*/_jsxs("div", {
+      }), describeRender(describeColumns), !_isEmpty(finalSubDescribeColumns) ? /*#__PURE__*/_jsxs("div", {
         className: classnames({
           'pro-header-nav': true,
           'pro-header-nav-open': fold,
           'pro-header-nav-hidden': !fold
         }),
         children: [/*#__PURE__*/_jsx("ul", {
-          children: _subDescribeColumns.map((item, index) => {
+          children: finalSubDescribeColumns.map((item, index) => {
             return /*#__PURE__*/_jsx("li", {
               children: subDescribeRender(item)
             }, getSubDescribeKey(item, index));

package/es/ProLayout/components/ProHeader/utils/index.d.ts

@@ -1,5 +1,20 @@
+import type React from 'react';
+import type { DescribeColumnType, SubDescribeColumnType } from '../PropTypes';
 /**
  * 检查描述dom是否部分隐藏
  * @param ele  dom节点
  */
 export declare const checkDescribeItemsHidden: (ele?: any) => boolean;
+/**
+ * 将值转为可用于 React key 的字符串片段
+ * 仅 string / number 有效，其余（含 ReactNode、对象、数组、boolean）返回 undefined
+ */
+export declare const toKeyPart: (value: unknown) => string | undefined;
+/** 主级描述项 key：label → value → describe-${index} */
+export declare const getDescribeColumnKey: (item: DescribeColumnType, index: number) => string;
+/** 描述值 key：link → value → ${parentKey}-value-${index} */
+export declare const getDescribeValueKey: (item: Pick<DescribeColumnType, "tag" | "link" | "value" | "copyable">, parentKey: string, index: number) => string;
+/** 标签 key：tagItem → ${parentKey}-tag-${index} */
+export declare const getTagKey: (tagItem: string | React.ReactNode, parentKey: string, index: number) => string;
+/** 次级描述项 key：label → code → sub-describe-${index} */
+export declare const getSubDescribeKey: (item: SubDescribeColumnType, index: number) => string;

package/es/ProLayout/components/ProHeader/utils/index.js

@@ -11,4 +11,26 @@ export const checkDescribeItemsHidden = ele => {
   const itemsScrollWidth = element.scrollWidth;
   const itemsClientWidth = element.clientWidth;
   return itemsScrollWidth > itemsClientWidth;
-};
+};
+
+/**
+ * 将值转为可用于 React key 的字符串片段
+ * 仅 string / number 有效，其余（含 ReactNode、对象、数组、boolean）返回 undefined
+ */
+export const toKeyPart = value => {
+  if (value == null || value === '') return undefined;
+  if (typeof value === 'string' || typeof value === 'number') return String(value);
+  return undefined;
+};
+
+/** 主级描述项 key：label → value → describe-${index} */
+export const getDescribeColumnKey = (item, index) => toKeyPart(item.label) ?? toKeyPart(item.value) ?? `describe-${index}`;
+
+/** 描述值 key：link → value → ${parentKey}-value-${index} */
+export const getDescribeValueKey = (item, parentKey, index) => toKeyPart(item.link) ?? toKeyPart(item.value) ?? `${parentKey}-value-${index}`;
+
+/** 标签 key：tagItem → ${parentKey}-tag-${index} */
+export const getTagKey = (tagItem, parentKey, index) => toKeyPart(tagItem) ?? `${parentKey}-tag-${index}`;
+
+/** 次级描述项 key：label → code → sub-describe-${index} */
+export const getSubDescribeKey = (item, index) => toKeyPart(item.label) ?? toKeyPart(item.code) ?? `sub-describe-${index}`;

package/es/ProLayout/components/TabsManager/components/TabContextMenu.js

@@ -1,9 +1,11 @@
 import { useState, useCallback } from 'react';
 import { Dropdown } from 'antd';
-import { jsx as _jsx } from "react/jsx-runtime";
+import locale from "../../../../locale";
+
 /**
  * 右键菜单组件 - 兼容Antd 4.x和5.x
  */
+import { jsx as _jsx } from "react/jsx-runtime";
 function TabContextMenu({
   tabId,
   children,
@@ -53,17 +55,17 @@ function TabContextMenu({
   // 默认右键菜单配置 - 统一使用items方式（antd 4.20+都支持）
   const defaultMenuItems = [{
     key: 'close',
-    label: '关闭',
+    label: locale.ProLayout.tabMenuClose,
     disabled: !closable
   }, {
     key: 'closeOthers',
-    label: '关闭其他'
+    label: locale.ProLayout.tabMenuCloseOthers
   }, {
     key: 'closeRight',
-    label: '关闭右侧标签页'
+    label: locale.ProLayout.tabMenuCloseRight
   }, {
     key: 'closeAll',
-    label: '关闭全部'
+    label: locale.ProLayout.tabMenuCloseAll
   }];
 
   // 合并自定义菜单项和默认菜单项