umi-plugin-panel-tabs

演示地址 [https://vibrant-leakey-d5b34a.netlify.app]

如何使用

安装依赖即可, 以umi-plugin开头的插件会被自动加载

配置项

在 config/config.ts - defineConfig 方法中进行配置

export default defineConfig({
  panelTab: {
    use404: true,
    useAuth: true,
    autoI18n: true,
    tabsLimit: 10,
    tabsLimitWait: 500,
    tabsLimitWarnTitle: '提示',
    tabsLimitWarnContent: '您当前打开页面过多, 请关闭不使用的页面以减少卡顿!',
    tabsBarBackgroundColor: '#FFFFFF',
    tabsTagColor: '#1890ff',
    closeAllConfirm: false,
    closeAllConfirmTitle: '提示',
    closeAllConfirmContent: '确认要关闭所有标签吗?',
  },
});

配置项	类型	默认值	说明	版本
use404	boolean	true	使用内置的 404 页面, 该页面会在 tab 中显示	-
useAuth	boolean	false	使用内置的 403 页面, 加载内置的权限判断 wrapper, 该页面会在 tab 中显示	-
autoI18n	boolean	false (0.0.25之前的版本默认为 true)	自动开启国际化, 仅当 ant-design-pro 的 locale 不为 false 且不为空时生效	-
tabsLimit	number	10	用户打开多少页签时弹出提示	-
tabsLimitWait	number	500	页签数量检查防抖时间, 如果一次弹出了多个提示框, 可以适当延长此时间, 单位毫秒	-
tabsLimitWarnTitle	string	提示	[配置国际化后此项不生效] 页签数量超限弹窗的标题	-
tabsLimitWarnContent	string	您当前打开页面过多, 请关闭不使用的页面以减少卡顿!	[配置国际化后此项不生效] 页签数量超限弹窗的内容	-
tabsBarBackgroundColor	string	#FFFFFF	标签栏背景色	0.0.26+
tabsTagColor	string	#1890ff	标签颜色,优先级高于自动使用主题色	0.0.26+
closeAllConfirm	boolean	false	操作关闭所有标签是否弹出确认框	0.0.29+
closeAllConfirmTitle	string	提示	[配置国际化后此项不生效] 关闭所有标签弹窗的标题	0.0.29+
closeAllConfirmContent	string	确认要关闭所有标签吗?	[配置国际化后此项不生效] 关闭所有标签弹窗的内容	0.0.29+

国际化配置项

国际化配置 key	国际化配置 value
panelTab.403.subTitle	抱歉，你无权访问该页面
panelTab.404.subTitle	抱歉，您访问的页面不存在
panelTab.closePage	关闭页面
panelTab.close	关闭
panelTab.closeOther	关闭其他
panelTab.closeAll	关闭所有
panelTab.refresh	刷新
panelTab.tabsLimitWarnTitle	提示
panelTab.tabsLimitWarnContent	您当前打开页面过多, 请关闭不使用的页面以减少卡顿!
panelTab.closeAllConfirmTitle	提示
panelTab.closeAllConfirmContent	确认要关闭所有标签吗?

额外的配置项

在config/route.ts中所有具有 name 属性的路由默认都会在标签页中显示, 如果不希望在标签也中出现此路由有两种方式:

1. 移除 route 中此路由配置的 name 属性
2. 在该路由中配置属性hideInPanelTab, 将其设置为true, 此路由就不会在标签页中显示
3. 开启后路由里配置的菜单名会被当作菜单名国际化的 key，插件会去 locales 文件中查找 menu.[key]对应的文案，默认值为该 key, 配置可参照 ant-design-pro 菜单国际化

export default [
  {
    path: '/welcome',
    name: 'welcome',
    icon: 'smile',
    component: './Welcome',
    hideInPanelTab: true,
  },
];

自定义场景使用

提供了 hook 方便在其他组件中使用

方法	作用
close	关闭指定标签
closeCurrent	关闭当前激活的标签
closeOther	关闭除当前激活外其他标签
refresh	刷新指定标签
refreshCurrent	刷新当前标签
closeAll	关闭所有
refreshAndCloseCurrent	关闭当前标签时,刷新指定标签
refreshAndCloseCurrentAndSwitch	关闭当前标签时,刷新并切换到指定标签

import { Button, Result } from 'antd';
import React from 'react';
import { usePanelTab } from 'umi';

export default () => {
  const {
    close,
    closeCurrent,
    closeOther,
    refresh,
    refreshCurrent,
    closeAll,
    refreshAndCloseCurrent,
    refreshAndCloseCurrentAndSwitch,
  } = usePanelTab();
  return (
    <Result
      status="404"
      title="404"
      subTitle="抱歉，您访问的页面不存在。"
      extra={
        <Button type="primary" onClick={closeCurrent}>
          关闭页面
        </Button>
      }
    />
  );
};

常见问题

看这里 -> https://github.com/fangzhengjin/umi-plugin-panel-tabs/issues/26

LICENSE

MIT