选中 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>
57 lines
1.8 KiB
TypeScript
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;
|
|
}
|