Files
eip4-web/src/shell/AppShell.tsx
zhengwr f39661a5dd fix(shell): open 设计中心 as its own tab instead of covering current
顶栏「设计中心」画笔按钮 navigate('/design-center'),但 AppShell 地址同步
useEffect 只为 /page/:id 路由自动建 Tab → /design-center 既不在 tabs、又非
/page/ 开头,两个分支都不命中:不建 Tab、activeKey 不变 → Outlet 渲染设计中心
内容但 Tab 条仍高亮旧页,设计中心「盖」在当前选中 Tab 上(用户反馈)。

修:新增 SINGLETON_TAB_TITLES 映射(/design-center→设计中心),地址同步 useEffect
对这类单例功能路由也自动建并激活独立 Tab(任意入口生效:顶栏/直接URL/前进后退;
prev.some 去重)。实测:从工作台点画笔 → Tab 条新增「设计中心」并激活,原
新闻收藏 Tab 保留不被覆盖,localStorage tabs/activeKey 同步。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-19 22:34:23 +08:00

398 lines
14 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// AppShell — 登录后整体布局:左侧栏 + 顶栏 + Tab 条 + 内容区
// 替代原 AppLayout.tsx;多 Tab 状态存 localStorage 恢复。
//
// 【Tab 设计取舍说明】
// 内容区直接由 react-router <Outlet> 渲染当前路由,切 Tab = navigate(),
// 不做 keep-alive(切 Tab 重新挂载组件)。
// 原因:keep-alive 需要将所有 Tab 内容同时挂载在 DOM 中,对 amis 渲染宿主
// 会产生大量隐藏实例,内存/副作用难以控制。当前阶段优先保证正确性,
// keep-alive 作为后续优化项。
import { useCallback, useEffect, useRef, useState } from 'react';
import { Outlet, useLocation, useNavigate } from 'react-router-dom';
import { getProfile } from '../auth/token';
import { collectLeaves, fetchMenu } from '../api/menu';
import type { MenuLeaf } from '../api/menu';
import { fetchTodo } from '../api/todo';
import { fetchUnreadCount } from '../api/notice';
import {
APPROVAL_COMPLETED_EVENT,
OPEN_APPROVAL_DRAWER_EVENT,
type ApprovalDrawerRequest,
} from '../amis/approvalActionEvents';
import {
MESSAGE_DETAIL_CHANGED_EVENT,
OPEN_MESSAGE_DETAIL_EVENT,
type MessageDetailRequest,
} from '../amis/messageActionEvents';
import { ApprovalDrawer } from '../components/ApprovalDrawer';
import { MessageDetailDialog } from '../components/MessageDetailDialog';
import { ToastHost } from '../components/ui/Toast';
import { Topbar } from './Topbar';
import { SideMenu } from './SideMenu';
import { TabBar } from './TabBar';
import type { Tab } from './TabBar';
import { SettingsDrawer, initTheme } from './SettingsDrawer';
import { NoticeDrawer } from './NoticeDrawer';
import { TabTitleContext } from './TabTitleContext';
const TABS_KEY = 'eip4-tabs';
const ACTIVE_KEY = 'eip4-active-tab';
// 待办 badge 轮询间隔(毫秒),每 60 秒刷新一次
const TODO_POLL_INTERVAL = 60_000;
// 初始 Tab:「工作台」作为保底 Tab,不可关闭
const TODO_TAB: Tab = { key: '/workbench', title: '工作台' };
// 非 /page/:id 的单例功能路由 → Tab 标题。navigate 到这些路由时自动开成独立 Tab,
// 避免「盖」在当前选中 Tab 上(见下方地址同步 useEffect)。
const SINGLETON_TAB_TITLES: Record<string, string> = {
'/design-center': '设计中心',
};
function loadTabs(): Tab[] {
try {
const raw = localStorage.getItem(TABS_KEY);
if (raw) {
const parsed = JSON.parse(raw) as Tab[];
if (Array.isArray(parsed) && parsed.length) return parsed;
}
} catch {
// 忽略
}
return [TODO_TAB];
}
function loadActiveKey(tabs: Tab[]): string {
try {
const a = localStorage.getItem(ACTIVE_KEY);
if (a && tabs.some((t) => t.key === a)) return a;
} catch {
// 忽略
}
return tabs[0].key;
}
// 初始化主题(刷新后恢复 localStorage 中的设置)
initTheme();
export function AppShell() {
const navigate = useNavigate();
const location = useLocation();
const [tabs, setTabs] = useState<Tab[]>(loadTabs);
const [activeKey, setActiveKey] = useState<string>(() => loadActiveKey(loadTabs()));
const [collapsed, setCollapsed] = useState(false);
const [showSettings, setShowSettings] = useState(false);
const [leaves, setLeaves] = useState<MenuLeaf[]>([]);
// 顶栏铃铛真实待办数(F1-3:接真实 API)
const [todoBadge, setTodoBadge] = useState<number | undefined>(undefined);
// F2-11 消息未读数
const [noticeBadge, setNoticeBadge] = useState<number | undefined>(undefined);
const [showNotice, setShowNotice] = useState(false);
const [approvalRequest, setApprovalRequest] = useState<ApprovalDrawerRequest | null>(null);
const [messageRequest, setMessageRequest] = useState<MessageDetailRequest | null>(null);
const pollTimer = useRef<ReturnType<typeof setInterval> | null>(null);
const noticePollTimer = useRef<ReturnType<typeof setInterval> | null>(null);
const profile = getProfile();
// 同步 activeKey 跟随浏览器地址(直接输入 URL / 后退前进)
// F2-13:直开 /page/:id 深链接时,若 Tab 不存在则自动新增并激活;title 先用 id 占位,
// PageRenderPage 拉到 schema 后通过 updateTabTitle 回填真实标题。
useEffect(() => {
const path = location.pathname;
if (tabs.some((t) => t.key === path)) {
setActiveKey(path);
} else if (path.startsWith('/page/')) {
const templateId = path.slice('/page/'.length);
setTabs((prev) => {
if (prev.some((t) => t.key === path)) return prev;
return [...prev, { key: path, title: templateId }];
});
setActiveKey(path);
} else {
// 非 /page/ 的单例功能路由(如顶栏「设计中心」入口):也自动开成独立 Tab,
// 否则 navigate() 只换 Outlet 内容、不建 Tab → 设计中心「盖」在当前选中 Tab 上、
// Tab 条仍高亮旧页(用户反馈「覆盖当前选中 tab」)。
const title = SINGLETON_TAB_TITLES[path];
if (title) {
setTabs((prev) => {
if (prev.some((t) => t.key === path)) return prev;
return [...prev, { key: path, title }];
});
setActiveKey(path);
}
}
}, [location.pathname, tabs]);
// 持久化 tabs
useEffect(() => {
try {
localStorage.setItem(TABS_KEY, JSON.stringify(tabs));
} catch {
// 忽略
}
}, [tabs]);
// 持久化 activeKey
useEffect(() => {
try {
localStorage.setItem(ACTIVE_KEY, activeKey);
} catch {
// 忽略
}
}, [activeKey]);
// 加载菜单叶子供全局搜索使用(404/失败时 leaves 为空,搜索框显示空结果)
useEffect(() => {
fetchMenu()
.then((data) => {
const all: MenuLeaf[] = [];
for (const root of data.roots ?? []) {
all.push(...collectLeaves(root.children ?? [], [root.name]));
}
setLeaves(all);
})
.catch(() => {
// 忽略,搜索降级为空结果
});
}, []);
// 顶栏铃铛:每 TODO_POLL_INTERVAL 轮询一次待办数(503 时 badge 清零不报错)
useEffect(() => {
const loadBadge = () => {
fetchTodo(0, 1)
.then((r) => {
if (r.unavailable) {
setTodoBadge(undefined);
return;
}
// 当前 API 无 totalCount,用 items 数量作近似(maxResults=1 不准确)
// 实际拉取少量条目仅做"有无"判断;完整 count 等待后端 GET /api/todo/count 端点
fetchTodo(0, 200).then((full) => {
if (!full.unavailable) setTodoBadge(full.items.length || undefined);
}).catch(() => setTodoBadge(undefined));
})
.catch(() => setTodoBadge(undefined));
};
loadBadge();
pollTimer.current = setInterval(loadBadge, TODO_POLL_INTERVAL);
return () => {
if (pollTimer.current) clearInterval(pollTimer.current);
};
}, []);
// F2-11 消息未读数轮询(60s,与待办同频)
useEffect(() => {
const loadNoticeBadge = () => {
fetchUnreadCount()
.then((n) => setNoticeBadge(n > 0 ? n : undefined))
.catch(() => setNoticeBadge(undefined));
};
loadNoticeBadge();
noticePollTimer.current = setInterval(loadNoticeBadge, TODO_POLL_INTERVAL);
return () => {
if (noticePollTimer.current) clearInterval(noticePollTimer.current);
};
}, []);
// 转换页 amis action → 全局审批抽屉。taskId 走办理/已办详情;businessKey/processInstanceId 走只读历史查看。
useEffect(() => {
const openApprovalDrawer = (event: Event) => {
const detail = (event as CustomEvent<ApprovalDrawerRequest>).detail;
if (!detail?.taskId && !detail?.businessKey && !detail?.processInstanceId) return;
setApprovalRequest(detail);
};
window.addEventListener(OPEN_APPROVAL_DRAWER_EVENT, openApprovalDrawer);
return () => window.removeEventListener(OPEN_APPROVAL_DRAWER_EVENT, openApprovalDrawer);
}, []);
// 转换页 amis action → 全局消息详情弹窗。收到消息打开时由弹窗调用后端置已读。
useEffect(() => {
const openMessageDetail = (event: Event) => {
const detail = (event as CustomEvent<MessageDetailRequest>).detail;
if (!detail) return;
if (detail.kind === 'received' && !detail.receiveId) return;
if (detail.kind === 'sent' && !detail.messageId) return;
setMessageRequest(detail);
};
window.addEventListener(OPEN_MESSAGE_DETAIL_EVENT, openMessageDetail);
return () => window.removeEventListener(OPEN_MESSAGE_DETAIL_EVENT, openMessageDetail);
}, []);
const handleApprovalCompleted = useCallback(() => {
const detail = approvalRequest;
setApprovalRequest(null);
fetchTodo(0, 200)
.then((full) => {
if (!full.unavailable) setTodoBadge(full.items.length || undefined);
})
.catch(() => setTodoBadge(undefined));
window.setTimeout(() => {
window.dispatchEvent(new CustomEvent(APPROVAL_COMPLETED_EVENT, { detail }));
}, 0);
}, [approvalRequest]);
const handleMessageReadChange = useCallback(() => {
fetchUnreadCount()
.then((n) => setNoticeBadge(n > 0 ? n : undefined))
.catch(() => setNoticeBadge(undefined));
window.setTimeout(() => {
window.dispatchEvent(new CustomEvent(MESSAGE_DETAIL_CHANGED_EVENT));
}, 0);
}, []);
// F2-13:回填 Tab 标题(PageRenderPage 拿到 schema title 后调用)
const updateTabTitle = useCallback((path: string, title: string) => {
setTabs((prev) =>
prev.map((t) => (t.key === path && t.title !== title ? { ...t, title } : t)),
);
}, []);
// 打开/激活一个 Tab
const openTab = useCallback(
(key: string, title: string) => {
setTabs((prev) => {
if (prev.some((t) => t.key === key)) return prev;
return [...prev, { key, title }];
});
setActiveKey(key);
navigate(key);
},
[navigate],
);
// 从菜单点击触发(templateId → /page/:templateId)
const handleMenuOpen = useCallback(
(templateId: string) => {
if (templateId === '__todo__') {
openTab('/todo', '待办');
return;
}
if (templateId === '__workbench__') {
openTab('/workbench', '工作台');
return;
}
openTab(`/page/${templateId}`, templateId);
},
[openTab],
);
// 全局搜索点击(叶子 templateId)
const handleSearchOpen = useCallback(
(templateId: string) => {
// 用菜单 leaves 找到真实 title
const leaf = leaves.find((l) => l.templateId === templateId);
openTab(`/page/${templateId}`, leaf?.name ?? templateId);
},
[openTab, leaves],
);
// 切换 Tab(只切换路由,不增删)
const handleActive = useCallback(
(key: string) => {
setActiveKey(key);
navigate(key);
},
[navigate],
);
// 关闭 Tab
const handleClose = useCallback(
(key: string) => {
setTabs((prev) => {
const next = prev.filter((t) => t.key !== key);
// 至少保留「待办」tab
const safe = next.length ? next : [TODO_TAB];
// 若关闭的是当前激活 tab,激活相邻 tab(优先右侧)
if (key === activeKey) {
const idx = prev.findIndex((t) => t.key === key);
const nextActive = safe[Math.min(idx, safe.length - 1)].key;
setActiveKey(nextActive);
navigate(nextActive);
}
return safe;
});
},
[activeKey, navigate],
);
return (
<div className="app">
<Topbar
leaves={leaves}
profile={profile}
todoBadge={todoBadge}
noticeBadge={noticeBadge}
onOpenTodo={() => handleActive('/todo')}
onOpenNotice={() => setShowNotice(true)}
onOpenTemplate={handleSearchOpen}
onOpenSettings={() => setShowSettings(true)}
/>
<div className="app-main">
<SideMenu
collapsed={collapsed}
activePath={activeKey}
onOpen={handleMenuOpen}
onToggle={() => setCollapsed((c) => !c)}
/>
<div className="app-work">
<TabBar
tabs={tabs}
activeKey={activeKey}
onActive={handleActive}
onClose={handleClose}
/>
<div className="app-pages">
{/* react-router Outlet 渲染当前路由内容 */}
<TabTitleContext.Provider value={{ updateTabTitle }}>
<Outlet />
</TabTitleContext.Provider>
</div>
</div>
</div>
<ToastHost />
{showSettings ? <SettingsDrawer onClose={() => setShowSettings(false)} /> : null}
{/* F2-11 消息中心抽屉 */}
{showNotice ? (
<NoticeDrawer
onClose={() => setShowNotice(false)}
onReadChange={() => {
fetchUnreadCount()
.then((n) => setNoticeBadge(n > 0 ? n : undefined))
.catch(() => setNoticeBadge(undefined));
}}
/>
) : null}
{approvalRequest ? (
<ApprovalDrawer
taskId={approvalRequest.taskId}
taskName={approvalRequest.taskName}
processInstanceId={approvalRequest.processInstanceId}
businessKey={approvalRequest.businessKey}
businessTable={approvalRequest.businessTable}
businessSummary={approvalRequest.businessSummary}
readOnly={approvalRequest.readOnly}
onClose={() => setApprovalRequest(null)}
onCompleted={handleApprovalCompleted}
/>
) : null}
{messageRequest ? (
<MessageDetailDialog
request={messageRequest}
onClose={() => setMessageRequest(null)}
onReadChange={handleMessageReadChange}
/>
) : null}
</div>
);
}