@zat-design/sisyphus-react 3.13.24-beta.1 → 3.14.0-beta.2

package/es/ProLayout/components/TabsManager/style/index.less

@@ -0,0 +1,179 @@
+.pro-layout-tabs {
+  --pro-layout-tabs-primary: var(--ant-primary-color, #1677ff);
+  --pro-layout-tabs-active-bg: var(--ant-color-success, #00b578);
+  --pro-layout-tabs-text-color: var(--ant-color-text, #1f1f1f);
+
+  display: flex;
+  flex-direction: column;
+  height: 100%;
+
+  &-header {
+    display: flex;
+    align-items: center;
+    min-height: 48px;
+    padding: 12px 0;
+    border-bottom: none;
+
+    .pro-layout-tab-list {
+      display: flex;
+      flex: 1;
+      gap: 12px;
+      overflow-x: auto;
+      overflow-y: hidden;
+
+      &::-webkit-scrollbar {
+        height: 3px;
+      }
+
+      &::-webkit-scrollbar-track {
+        background: transparent;
+      }
+
+      &::-webkit-scrollbar-thumb {
+        background: #d9d9d9;
+        border-radius: 3px;
+
+        &:hover {
+          background: #bfbfbf;
+        }
+      }
+    }
+
+    &-extra {
+      flex-shrink: 0;
+      padding: 0 16px;
+    }
+  }
+
+  &-content {
+    .tab-pane {
+      &.hidden {
+        display: none;
+      }
+    }
+  }
+}
+
+.pro-layout-tab-item {
+  position: relative;
+  display: flex;
+  flex-shrink: 0;
+  align-items: center;
+  min-height: 36px;
+  padding: 0;
+  background: #ffffff;
+  border: 1px solid transparent;
+  border-radius: 8px;
+  cursor: pointer;
+  transition: all 0.3s cubic-bezier(0.645, 0.045, 0.355, 1);
+  user-select: none;
+
+  &:hover {
+    background: #ffffff;
+    border-color: rgba(0, 0, 0, 0.06);
+  }
+
+  &.active {
+    z-index: 2;
+    background: var(--zaui-primary);
+    border-color: transparent;
+
+    &::before {
+      display: none;
+    }
+  }
+
+  .pro-layout-tab-content {
+    display: flex;
+    align-items: center;
+    min-width: 100px;
+    padding: 6px 12px;
+    text-align: left;
+
+    .pro-layout-tab-icon {
+      display: flex;
+      flex-shrink: 0;
+      align-items: center;
+      margin-right: 8px;
+
+      .iconfont {
+        color: inherit;
+        font-size: 14px;
+      }
+
+      img {
+        width: 16px;
+        height: 16px;
+        object-fit: contain;
+      }
+    }
+
+    .pro-layout-tab-title {
+      flex: 1;
+      overflow: hidden;
+      color: var(--pro-layout-tabs-text-color);
+      font-weight: 500;
+      font-size: 14px;
+      white-space: nowrap;
+      text-overflow: ellipsis;
+      transition: color 0.3s;
+    }
+
+    .pro-layout-tab-close {
+      display: flex;
+      flex-shrink: 0;
+      align-items: center;
+      justify-content: center;
+      margin-left: 8px;
+      padding: 3px;
+      color: rgba(0, 0, 0, 0.45);
+      border-radius: 4px;
+      opacity: 0.7;
+      transition: all 0.3s;
+
+      &:hover {
+        color: #ff4d4f;
+        background: rgba(255, 77, 79, 0.15);
+        opacity: 1;
+      }
+    }
+  }
+
+  &.active .pro-layout-tab-content {
+    .pro-layout-tab-title {
+      color: #ffffff;
+      font-weight: 600;
+    }
+
+    .pro-layout-tab-icon {
+      .iconfont {
+        color: #ffffff;
+      }
+    }
+
+    .pro-layout-tab-close {
+      color: #ffffff;
+
+      &:hover {
+        background: rgba(255, 255, 255, 0.2);
+      }
+    }
+  }
+}
+
+.pro-layout-dark .pro-layout-tabs {
+  --pro-layout-tabs-text-color: rgba(255, 255, 255, 0.85);
+}
+
+// 响应式适配
+@media (max-width: 768px) {
+  .pro-layout-tab-item {
+    .pro-layout-tab-content {
+      padding: 6px 8px;
+
+      .pro-layout-tab-title {
+        max-width: 80px;
+      }
+    }
+  }
+}

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

@@ -0,0 +1,38 @@
+import { TabItem, MenusType } from '../../../propTypes';
+/**
+ * 根据菜单项生成TabItem
+ */
+export declare const createTabFromMenu: (menuItem: MenusType, index?: number) => TabItem;
+/**
+ * 生成唯一的tab ID
+ */
+export declare const generateTabId: (menuItem: MenusType, existingIds: string[]) => string;
+/**
+ * 检查菜单项是否应该外部跳转
+ */
+export declare const shouldOpenExternal: (menuItem: MenusType, target?: string) => boolean;
+/**
+ * 处理外部跳转
+ */
+export declare const handleExternalOpen: (menuItem: MenusType) => void;
+/**
+ * 检查是否超出最大标签页限制
+ */
+export declare const checkTabLimit: (currentTabs: TabItem[], maxTabs: number) => boolean;
+/**
+ * 移除最旧的标签页（根据访问时间或创建时间）
+ */
+export declare const removeOldestTab: (tabs: TabItem[]) => TabItem[];
+/**
+ * 获取右侧标签页
+ */
+export declare const getRightTabs: (tabs: TabItem[], currentTabId: string) => TabItem[];
+/**
+ * 扁平化菜单数据
+ */
+export declare const flattenMenuData: (menus?: MenusType[]) => MenusType[];
+/**
+ * 判断菜单项是否为最后一级（叶子节点）
+ * 只有当菜单项没有子菜单或子菜单为空时，才认为是叶子节点
+ */
+export declare const isLeafMenuItem: (menuItem: MenusType) => boolean;

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

@@ -0,0 +1,106 @@
+/**
+ * 根据菜单项生成TabItem
+ */
+export var createTabFromMenu = function createTabFromMenu(menuItem) {
+  var index = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
+  return {
+    id: String(menuItem.id || menuItem.code || menuItem.url || index),
+    code: menuItem.code,
+    name: menuItem.name,
+    title: menuItem.name,
+    url: menuItem.url,
+    closable: true,
+    menuItem,
+    icon: menuItem.icon || menuItem.imgUrl
+  };
+};
+
+/**
+ * 生成唯一的tab ID
+ */
+export var generateTabId = (menuItem, existingIds) => {
+  var baseId = String(menuItem.id || menuItem.code || menuItem.url);
+  var finalId = baseId;
+  var counter = 1;
+
+  // 如果ID已存在，则添加数字后缀
+  while (existingIds.includes(finalId)) {
+    finalId = `${baseId}_${counter}`;
+    counter += 1;
+  }
+  return finalId;
+};
+
+/**
+ * 检查菜单项是否应该外部跳转
+ */
+export var shouldOpenExternal = (menuItem, target) => {
+  return target === '_blank' || menuItem.redirectUrl && menuItem.redirectUrl !== menuItem.url || menuItem.type === 'EXTERNAL';
+};
+
+/**
+ * 处理外部跳转
+ */
+export var handleExternalOpen = menuItem => {
+  var url = menuItem.redirectUrl || menuItem.url;
+  if (url) {
+    window.open(url, '_blank');
+  }
+};
+
+/**
+ * 检查是否超出最大标签页限制
+ */
+export var checkTabLimit = (currentTabs, maxTabs) => {
+  return currentTabs.length >= maxTabs;
+};
+
+/**
+ * 移除最旧的标签页（根据访问时间或创建时间）
+ */
+export var removeOldestTab = tabs => {
+  if (tabs.length === 0) return tabs;
+
+  // 找到可关闭的最旧标签页
+  var closableTabs = tabs.filter(tab => tab.closable);
+  if (closableTabs.length === 0) return tabs;
+
+  // 移除第一个可关闭的标签页
+  var oldestTab = closableTabs[0];
+  return tabs.filter(tab => tab.id !== oldestTab.id);
+};
+
+/**
+ * 获取右侧标签页
+ */
+export var getRightTabs = (tabs, currentTabId) => {
+  var currentIndex = tabs.findIndex(tab => tab.id === currentTabId);
+  if (currentIndex === -1) return [];
+  return tabs.slice(currentIndex + 1);
+};
+
+/**
+ * 扁平化菜单数据
+ */
+export var flattenMenuData = function flattenMenuData() {
+  var menus = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
+  var flatMenus = [];
+  menus.forEach(item => {
+    flatMenus.push(item);
+    if (item.children) {
+      flatMenus = [...flatMenus, ...flattenMenuData(item.children)];
+    }
+  });
+  return flatMenus;
+};
+
+/**
+ * 判断菜单项是否为最后一级（叶子节点）
+ * 只有当菜单项没有子菜单或子菜单为空时，才认为是叶子节点
+ */
+export var isLeafMenuItem = menuItem => {
+  var _ref = menuItem || {},
+    children = _ref.children;
+  // 如果 children 不存在、为 null、为 undefined，或者为空数组，则认为是叶子节点
+  return !children || Array.isArray(children) && children.length === 0;
+};

package/es/ProLayout/index.d.ts

@@ -1,10 +1,13 @@
 /// <reference types="react" />
-import type { ProLayoutType } from './propTypes';
-export declare const LayoutContext: import("react").Context<{
+import type { ProLayoutStatesType, ProLayoutType } from './propTypes';
+import { useProLayoutTabs } from './components/TabsManager/hooks/useProLayoutTabs';
+import { useActiveTab } from './components/TabsManager/hooks/useActiveTab';
+interface LayoutContextValue {
     selectedPath: string;
-    onSelected: (params: any) => void;
+    onSelected: (params: Partial<ProLayoutStatesType>) => void;
     target: '_blank' | '_parent' | '_self' | '_top';
-}>;
+}
+export declare const LayoutContext: import("react").Context<LayoutContextValue>;
 declare const ProLayout: {
     (props: ProLayoutType): import("react/jsx-runtime").JSX.Element;
     defaultProps: {
@@ -21,5 +24,8 @@ declare const ProLayout: {
     ProCollapse: (props: import("./components/ProCollapse/PropTypes").ProCollapseType) => import("react/jsx-runtime").JSX.Element;
     ProFooter: import("react").MemoExoticComponent<(props: import("./components/ProFooter/PropTypes").ProFooterType) => import("react/jsx-runtime").JSX.Element>;
     ProHeader: import("react").MemoExoticComponent<(props: import("./components/ProHeader/PropTypes").ProHeaderType) => import("react/jsx-runtime").JSX.Element>;
+    useProLayoutTabs: typeof useProLayoutTabs;
+    useActiveTab: () => import("./propTypes").TabItem;
 };
+export { useProLayoutTabs, useActiveTab };
 export default ProLayout;

package/es/ProLayout/index.js

@@ -2,13 +2,20 @@ import _objectSpread from "@babel/runtime/helpers/esm/objectSpread2";
 import "antd/es/message/style";
 import _message from "antd/es/message";
 import _slicedToArray from "@babel/runtime/helpers/esm/slicedToArray";
-import { createContext } from 'react';
+/* eslint-disable func-call-spacing */
+/* eslint-disable no-spaced-func */
+import { createContext, useCallback, useMemo, useRef } from 'react';
 import classNames from 'classnames';
 import { useSetState, useToggle, useDeepCompareEffect } from 'ahooks';
 import { ProWaterMark } from "../index";
 import { ProCollapse, ProFooter, ProHeader } from "./components";
 import { Header, Notice, Menu } from "./components/Layout/index";
+import TabsManager from "./components/TabsManager";
+import { isTabsMode, validateTabsProps } from "./propTypes";
+import { useProLayoutTabs } from "./components/TabsManager/hooks/useProLayoutTabs";
+import { useActiveTab } from "./components/TabsManager/hooks/useActiveTab";
 import { transformMenus } from "./utils";
+import { isLeafMenuItem } from "./components/TabsManager/utils";
 
 // 全局上下文
 import { jsx as _jsx } from "react/jsx-runtime";
@@ -32,7 +39,13 @@ var ProLayout = props => {
     theme = props.theme,
     target = props.target,
     onCollapsedChange = props.onCollapsedChange,
-    onMenuClick = props.onMenuClick;
+    onMenuClick = props.onMenuClick,
+    _props$mode = props.mode,
+    mode = _props$mode === void 0 ? 'normal' : _props$mode,
+    tabs = props.tabs;
+  var isTabsLayout = isTabsMode(props);
+  validateTabsProps(mode, tabs);
+  var tabsManagerRef = useRef(null);
   var _useSetState = useSetState({
       notice: headerNotice || noticeIn,
       menus: [],
@@ -64,6 +77,65 @@ var ProLayout = props => {
       menus: menuData
     });
   }, [dataSource]);
+  var menuDataSource = useMemo(() => Array.isArray(menus) ? {
+    menus
+  } : menus, [menus]);
+  var handleMenuClick = useCallback(params => {
+    if (isTabsLayout) {
+      var _tabsManagerRef$curre, _tabsManagerRef$curre2;
+      // 只有最后一级菜单（叶子节点）才设置选中路径
+      if (params.item && isLeafMenuItem(params.item)) {
+        var _params$item, _params$item2, _params$item3;
+        var targetPath = ((_params$item = params.item) === null || _params$item === void 0 ? void 0 : _params$item.url) || ((_params$item2 = params.item) === null || _params$item2 === void 0 ? void 0 : _params$item2.redirectUrl) || ((_params$item3 = params.item) === null || _params$item3 === void 0 ? void 0 : _params$item3.router);
+        if (targetPath && targetPath !== selectedPath) {
+          setState({
+            selectedPath: targetPath
+          });
+        }
+      }
+      (_tabsManagerRef$curre = tabsManagerRef.current) === null || _tabsManagerRef$curre === void 0 || (_tabsManagerRef$curre2 = _tabsManagerRef$curre.handleMenuClick) === null || _tabsManagerRef$curre2 === void 0 || _tabsManagerRef$curre2.call(_tabsManagerRef$curre, params);
+      return;
+    }
+    onMenuClick === null || onMenuClick === void 0 || onMenuClick(params);
+  }, [isTabsLayout, onMenuClick, selectedPath, setState]);
+  var enhancedTabsConfig = useMemo(() => {
+    if (!isTabsLayout || !tabs) {
+      return tabs;
+    }
+    return _objectSpread(_objectSpread({}, tabs), {}, {
+      onTabChange: (activeKey, activeTab, allTabs) => {
+        var _activeTab$menuItem, _activeTab$menuItem2, _activeTab$menuItem3, _tabs$onTabChange;
+        if (!allTabs || allTabs.length === 0) {
+          // 使用一个不可能匹配的路径来清除选中状态，避免 OpenMenu fallback 到 window.location.pathname
+          setState({
+            selectedPath: '##EMPTY##'
+          });
+          return;
+        }
+        var targetPath = (activeTab === null || activeTab === void 0 ? void 0 : activeTab.url) || (activeTab === null || activeTab === void 0 || (_activeTab$menuItem = activeTab.menuItem) === null || _activeTab$menuItem === void 0 ? void 0 : _activeTab$menuItem.router) || (activeTab === null || activeTab === void 0 || (_activeTab$menuItem2 = activeTab.menuItem) === null || _activeTab$menuItem2 === void 0 ? void 0 : _activeTab$menuItem2.url) || (activeTab === null || activeTab === void 0 || (_activeTab$menuItem3 = activeTab.menuItem) === null || _activeTab$menuItem3 === void 0 ? void 0 : _activeTab$menuItem3.redirectUrl);
+        if (targetPath && targetPath !== selectedPath) {
+          setState({
+            selectedPath: targetPath
+          });
+        }
+        (_tabs$onTabChange = tabs.onTabChange) === null || _tabs$onTabChange === void 0 || _tabs$onTabChange.call(tabs, activeKey, activeTab, allTabs);
+      }
+    });
+  }, [isTabsLayout, tabs, selectedPath, setState]);
+  var renderContent = () => {
+    if (!isTabsLayout || !enhancedTabsConfig) {
+      return /*#__PURE__*/_jsx("div", {
+        children: children
+      });
+    }
+    return /*#__PURE__*/_jsx(TabsManager, {
+      ref: tabsManagerRef,
+      config: enhancedTabsConfig,
+      dataSource: menuDataSource,
+      originalOnMenuClick: onMenuClick,
+      children: children
+    });
+  };
 
   /**
    * 关闭提示框
@@ -94,12 +166,10 @@ var ProLayout = props => {
     })), /*#__PURE__*/_jsxs("div", {
       className: contentCls,
       children: [/*#__PURE__*/_jsx(Menu, _objectSpread(_objectSpread({}, props), {}, {
-        dataSource: Array.isArray(menus) ? {
-          menus
-        } : menus,
+        dataSource: menuDataSource,
         notice: notice,
         collapsed: collapsed,
-        onMenuClick: onMenuClick,
+        onMenuClick: handleMenuClick,
         onToggle: () => {
           toggle();
           onCollapsedChange && onCollapsedChange(!collapsed);
@@ -109,9 +179,7 @@ var ProLayout = props => {
         style: _objectSpread(_objectSpread({}, contentStyle), {}, {
           marginTop: headerHeight + noticeHeight
         }),
-        children: /*#__PURE__*/_jsx("div", {
-          children: children
-        })
+        children: renderContent()
       })]
     })]
   });
@@ -140,4 +208,9 @@ ProLayout.defaultProps = {
 ProLayout.ProCollapse = ProCollapse;
 ProLayout.ProFooter = ProFooter;
 ProLayout.ProHeader = ProHeader;
+ProLayout.useProLayoutTabs = useProLayoutTabs;
+ProLayout.useActiveTab = useActiveTab;
+
+// 同时导出Hook供直接使用
+export { useProLayoutTabs, useActiveTab };
 export default ProLayout;

package/es/ProLayout/propTypes.d.ts

@@ -94,7 +94,7 @@ type pureKey = boolean | {
     topMenu?: boolean;
     leftMenu?: boolean;
 };
-export interface ProLayoutType {
+interface ProLayoutBaseProps {
     /**
      * @description 左侧logo
      * @default -
@@ -237,6 +237,144 @@ export interface ProLayoutStatesType {
 }
 export type MenusProps = MenusType;
 export type DataSourceProps = DataSourceType;
+export interface TabItem {
+    /**
+     * @description 标签唯一标识
+     */
+    id: string;
+    /**
+     * @description 组件标识码
+     */
+    code: string;
+    /**
+     * @description 标签名称
+     */
+    name: string;
+    /**
+     * @description 标签标题（废弃，保留兼容）
+     */
+    title: string;
+    /**
+     * @description 标签关联路由
+     */
+    url?: string;
+    /**
+     * @description 是否可关闭
+     */
+    closable: boolean;
+    /**
+     * @description 关联菜单项
+     */
+    menuItem?: MenusType;
+    /**
+     * @description 额外扩展数据
+     */
+    extra?: Record<string, any>;
+    /**
+     * @description 图标
+     */
+    icon?: ReactNode | string;
+}
+export interface TabsState {
+    tabsList: TabItem[];
+    activeKey: string;
+    activeTabInfo?: TabItem;
+    newTabIndex: number;
+    activeComponent?: string;
+}
+export type TabsStorageStrategy = 'localStorage' | 'sessionStorage';
+/**
+ * @description 添加标签页的业务参数
+ */
+export interface AddTabParams {
+    /**
+     * @description 组件标识码，用于映射到具体的 React 组件
+     */
+    code: string;
+    /**
+     * @description 标签页显示名称
+     */
+    name: string;
+    /**
+     * @description 额外的业务数据
+     */
+    extra?: Record<string, any>;
+}
+/**
+ * @description 添加标签页的选项
+ */
+export interface AddTabOptions {
+    /**
+     * @description 是否强制创建新标签页（忽略已存在的相同标签页），默认 false
+     */
+    forceNew?: boolean;
+}
+/**
+ * @description 获取标签页信息返回值
+ */
+export interface TabsInfoResult {
+    /** 标签页列表 */
+    tabsList: TabItem[];
+    /** 当前激活的标签页信息 */
+    activeTabInfo?: TabItem;
+    /** 当前激活的组件标识 */
+    activeComponent: string;
+}
+/**
+ * @description ProLayout 标签页实例接口（类似 FormInstance）
+ */
+export interface ProLayoutTabsInstance {
+    /**
+     * @description 添加标签页
+     */
+    addTab: (params: AddTabParams, options?: AddTabOptions) => void;
+    /**
+     * @description 删除标签页
+     */
+    removeTab: (tabId: string) => void;
+    /**
+     * @description 获取标签页信息
+     */
+    getTabInfo: () => TabsInfoResult;
+}
+export interface TabsConfig {
+    max?: number;
+    storage?: TabsStorageStrategy;
+    cacheKey?: string;
+    onTabChange?: (activeKey: string, activeTab: TabItem | undefined, allTabs: TabItem[]) => void;
+    /**
+     * @description 激活组件解析函数，根据 component 标识返回对应的 React 组件
+     */
+    activeComponent?: (component: string) => React.ComponentType<any> | null;
+    /**
+     * @description 空状态组件，当没有标签页时显示
+     */
+    empty?: ReactNode;
+    /**
+     * @description 自定义右键菜单项，会替换默认菜单项
+     */
+    menuItems?: import('antd').MenuProps['items'];
+    /**
+     * @description 自定义菜单项点击回调
+     */
+    tabMenuClick?: (params: {
+        key: string;
+        tab: TabItem;
+        tabs: TabItem[];
+    }) => void;
+}
+export type ProLayoutMode = 'normal' | 'tabs';
+export interface ProLayoutTabsProps extends ProLayoutBaseProps {
+    mode: 'tabs';
+    tabs: TabsConfig;
+}
+export interface ProLayoutNormalProps extends ProLayoutBaseProps {
+    mode?: 'normal';
+    tabs?: never;
+}
+export type ProLayoutType = ProLayoutTabsProps | ProLayoutNormalProps;
 export type ProLayoutProps = ProLayoutType;
 export type ProLayoutStates = ProLayoutStatesType;
+export declare const isTabsMode: (props: ProLayoutType) => props is ProLayoutTabsProps;
+export declare const validateTabsProps: (mode?: ProLayoutMode, tabs?: TabsConfig) => void;
 export {};

package/es/ProLayout/propTypes.js

@@ -1 +1,37 @@
-export {};
+/**
+ * @description 主题枚举类型
+ */
+
+/**
+ * @description 是否带有菜单界面的配置
+ */
+
+// 为了向后兼容，保留旧的类型名称但使用新的类型定义
+
+/**
+ * @description 添加标签页的业务参数
+ */
+
+/**
+ * @description 添加标签页的选项
+ */
+
+/**
+ * @description 获取标签页信息返回值
+ */
+
+/**
+ * @description ProLayout 标签页实例接口（类似 FormInstance）
+ */
+
+export var isTabsMode = props => props.mode === 'tabs';
+export var validateTabsProps = function validateTabsProps() {
+  var mode = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'normal';
+  var tabs = arguments.length > 1 ? arguments[1] : undefined;
+  if (mode === 'tabs' && !tabs) {
+    throw new Error('ProLayout: tabs configuration is required when mode="tabs"，例如 <ProLayout mode="tabs" tabs={{ max: 10 }} />');
+  }
+  if (mode !== 'tabs' && tabs) {
+    console.warn('ProLayout: tabs configuration is ignored because mode is not "tabs"');
+  }
+};