wangziqi
a32c0a0731
由 OCR（open-codereview.ai，deepseek-v4-flash）审查驱动修复： - Roles 多组勾选、Schedules 月视图新建、useDirtyGuard 稳定引用 - JinshujuMatchModal success:false、Attendance store 订阅、EditableCell Enter、DynamicChart 空数据、渲染期 ref - AttachmentsTab 附件预览不再 window.open（防存储型 XSS）+ 请求乱序防护 - 考勤 late 计入出勤率与主状态 Reviewed-by: OCR (open-codereview.ai)
90 lines
3.0 KiB
TypeScript
90 lines
3.0 KiB
TypeScript
import { useCallback, useRef, useState } from 'react';
|
||
import { useLayoutEffect } from 'react';
|
||
import type { XAgentCommand_v0_9 } from '@ant-design/x-card';
|
||
|
||
/**
|
||
* 提交状态管理：收敛 DynamicForm / DynamicReview 中重复的
|
||
* submitting / submitted / error 状态与「防重复提交 + 失败可重试」逻辑。
|
||
*
|
||
* 用法：
|
||
* const { submitting, submitted, error, run } = useSubmissionState();
|
||
* const handleSubmit = (values) => run(async () => { await onSubmit(values); });
|
||
*/
|
||
export function useSubmissionState() {
|
||
const [submitting, setSubmitting] = useState(false);
|
||
const [submitted, setSubmitted] = useState(false);
|
||
const [error, setError] = useState<string | null>(null);
|
||
const submittingRef = useRef(false);
|
||
|
||
const run = useCallback(async (task: () => Promise<void> | void) => {
|
||
if (submittingRef.current) return;
|
||
submittingRef.current = true;
|
||
setSubmitting(true);
|
||
setError(null);
|
||
try {
|
||
await task();
|
||
setSubmitted(true);
|
||
} catch (reason) {
|
||
setError(reason instanceof Error ? reason.message : '提交失败，请稍后重试');
|
||
} finally {
|
||
submittingRef.current = false;
|
||
setSubmitting(false);
|
||
}
|
||
}, []);
|
||
|
||
const reset = useCallback(() => {
|
||
setSubmitted(false);
|
||
setError(null);
|
||
}, []);
|
||
|
||
return { submitting, submitted, error, run, reset };
|
||
}
|
||
|
||
/**
|
||
* A2UI surface 的 XCard commands 增量更新生命周期：
|
||
* 每个 surface 只创建一次，后续通过 updateDataModel / updateComponents 增量更新。
|
||
*
|
||
* 用法：
|
||
* const { pushCommands } = useXCardSurface(surfaceId);
|
||
* useEffect(() => {
|
||
* pushCommands([
|
||
* { version: 'v0.9', createSurface: { surfaceId, catalogId } },
|
||
* { version: 'v0.9', updateDataModel: { surfaceId, path: '/x', value } },
|
||
* { version: 'v0.9', updateComponents: { surfaceId, components } },
|
||
* ]);
|
||
* }, [value]);
|
||
*/
|
||
export function useXCardSurface(surfaceId: string) {
|
||
const commandsRef = useRef<XAgentCommand_v0_9[]>([]);
|
||
const [commands, setCommands] = useState<XAgentCommand_v0_9[]>([]);
|
||
const idRef = useRef<string>('');
|
||
|
||
const pushCommands = useCallback(
|
||
(cmds: XAgentCommand_v0_9[]) => {
|
||
if (cmds.length === 0) return;
|
||
// 同一 surface 的 createSurface 命令只允许出现一次，自动去重
|
||
const hasSurface = commandsRef.current.some(
|
||
(c) => 'createSurface' in c && c.createSurface.surfaceId === surfaceId,
|
||
);
|
||
const filtered = hasSurface
|
||
? cmds.filter((c) => !('createSurface' in c))
|
||
: cmds;
|
||
commandsRef.current = [...commandsRef.current, ...filtered];
|
||
setCommands([...commandsRef.current]);
|
||
},
|
||
[surfaceId],
|
||
);
|
||
|
||
const surfaceKey = surfaceId;
|
||
// 渲染期保持纯函数：ref 变更放到 layout effect 里
|
||
useLayoutEffect(() => {
|
||
if (idRef.current !== surfaceKey) {
|
||
// 组件复用到新 surface 时，清空历史命令重新初始化
|
||
commandsRef.current = [];
|
||
idRef.current = surfaceKey;
|
||
}
|
||
}, [surfaceKey]);
|
||
|
||
return { commands, pushCommands };
|
||
}
|