Files
eip4-web/src/modeler/useSelectedElement.ts
zhengwr 6dc9075648 feat(modeler): EIP4 侧板五控件(办理人meta透传/会签/formKey/扩展属性/监听器)
选中 userTask 时在标准属性面板上方叠加 React 侧板(§0.5 P5),全部写操作经
modeling.updateProperties(element,{...}),undo/redo 天然生效:
- 办理人:activiti:candidateUsers 经 codec parse→items 表格→build 写回,
  🔴 codec 外层业务 meta(taskSuccessService 等)存 ref、写回原样带回(硬要求用例覆盖)
- 会签:loopCharacteristics 开关(moddle.create MultiInstanceLoopCharacteristics,
  activiti:collection multiInstance 变体+elementVariable=assignee+completionCondition
  全票/过半/指定数 N 三预设);关→undefined
- formKey:GET /api/workflow/wftemplates 下拉写 activiti:formKey(裸 UUID),「无」清除
- 扩展属性:长尾 $attrs(activiti:/flowable:)增删改
- 任务监听器:activiti:taskListener event+class/delegateExpression 互斥;已有 field
  子元素显示徽标并原样保留(moddle 元素引用不动)

新增 useSelectedElement hook(订阅 selection.changed,单选返 element/多选空选 null/卸载解绑)。
ProcessModelerPage 右栏上方挂 Eip4Panel(modeler 入 state 驱动订阅)。
📌 红线回归:ProcessModelerPage 断言 moddleExtensions 键恰 ['activiti']、
additionalModules 长度 2(防双包冲突静默丢 userTask)。

测试:Eip4Panel 20 + useSelectedElement 5 + ProcessModelerPage 10(+1 红线);
全量 vitest 164 绿 / tsc -b 干净 / npm run build 成功。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 11:35:13 +08:00

57 lines
1.8 KiB
TypeScript

// 订阅 bpmn-js 'selection.changed',返回当前单选 element(多选/空选返 null)。
// 卸载时解绑;modeler 为 null 时不订阅、恒返 null。
import { useEffect, useState } from 'react';
/** bpmn-js businessObject 的最小契约(本侧板用到的读法)。 */
export interface BpmnBusinessObject {
$type?: string;
/** 未在 moddle 描述符中声明的长尾扩展属性(命名空间键→字符串值)。 */
$attrs?: Record<string, string>;
/** 读取声明属性(如 'activiti:candidateUsers'/'loopCharacteristics'/'extensionElements')。 */
get(name: string): unknown;
}
/** bpmn-js diagram element 的最小契约。 */
export interface BpmnElement {
id: string;
/** moddle 类型,如 'bpmn:UserTask'。 */
type: string;
businessObject: BpmnBusinessObject;
}
/** 订阅所需的最小 modeler 契约(bpmn-js Modeler 天然满足)。 */
export interface SelectionModeler {
on(event: string, cb: (e: unknown) => void): void;
off?(event: string, cb: (e: unknown) => void): void;
}
interface SelectionChangedEvent {
newSelection?: unknown[];
}
/**
* 返回当前单选的 bpmn element;多选或空选返 null。modeler 变更/卸载自动重订阅、解绑。
*/
export function useSelectedElement(
modeler: SelectionModeler | null | undefined,
): BpmnElement | null {
const [element, setElement] = useState<BpmnElement | null>(null);
useEffect(() => {
if (!modeler) {
setElement(null);
return;
}
const handler = (e: unknown) => {
const sel = ((e as SelectionChangedEvent | undefined)?.newSelection ?? []) as BpmnElement[];
setElement(sel.length === 1 ? sel[0] : null);
};
modeler.on('selection.changed', handler);
return () => {
modeler.off?.('selection.changed', handler);
};
}, [modeler]);
return element;
}