[{"data":1,"prerenderedAt":7},["ShallowReactive",2],{"example-markdown-content:zh:switchable-node-slot-templates":3},{"markdown":4,"isPaidExample":5,"isTruncated":5,"charLimit":6},"# 在同一张图中切换节点插槽模板\n\n## 这个示例构建了什么\n\n这个示例构建了一个居中的 relation-graph 场景，复用同一份小型人物数据集，同时在多个自定义插槽模板之间切换可见的节点主体。查看者会看到同一套拓扑分别以绿色徽章、全息资料卡、图标胶囊、黄色指标卡或圆形借阅者徽章的形式呈现，并且画布上方还有一个浮动 mini view 和一个浮动工具窗口。\n\n这张图在结构上是只读的。主要交互是模板切换：辅助窗口中的标签页会重写每个在线节点的 `type`，随后图谱会重新居中并再次适配视口，使 `300 x 450` 资料卡这类较大的模板仍然易于阅读。这个示例最重要的启发在于，它把节点插槽定制视为一种运行时编排模式，而不是五个彼此独立的图谱示例。\n\n## 数据是如何组织的\n\n这个示例从 `users01.json` 中导入一份共享的 `RGJsonData` 数据。它使用 `rootId: 'a'`，定义了七个节点，并通过六条连线把 `a` 与 `b` 到 `g` 连接成一个轮辐式结构。\n\n在调用 `setJsonData()` 之前没有任何预处理。JSON 会直接交给 relation-graph，后续插槽渲染器再读取 `node.data.pic`、`node.data.name` 和 `node.data.myicon`，用于头像、标签和图标选择。数据加载完成后，运行时更新只会修改 `node.type`；图结构和业务字段保持不变。\n\n在真实产品中，这同一套结构可以表示员工、客户、资产、设备或案例。自定义数据字段可以承载头像 URL、显示名称、角色图标、评分或状态元数据，以便在同一张图中应用多种可视化呈现方式。\n\n## relation-graph 是如何使用的\n\n这个示例把布局和图机制保留在 relation-graph 内部，同时把几乎所有节点外观都放进插槽和 SCSS 中。`MyGraph.tsx` 配置了一个 `center` 布局，并显式设置 `levelGaps`、居中对齐、`force_node_repulsion`、`force_line_elastic` 和 `maxLayoutTimes`；与此同时，又通过 `RGNodeShape.rect` 和 `defaultNodeBorderWidth: 0` 让默认节点主体变为透明。这样一来，插槽渲染器就成为实际可见的节点表面。\n\n`RGHooks.useGraphInstance()` 驱动整个生命周期。在挂载时，它通过 `setJsonData()` 加载导入的 JSON，然后调用 `moveToCenter()` 和 `zoomToFit()`。同一个实例随后还承担图级别的 `getNodes()` 与 `updateNode(...)` 变更、尺寸变化期间的临时画布动画，以及 `CanvasSettingsPanel` 中共享的导出流程。\n\n定制逻辑被拆分到两个插槽中。`RGSlotOnNode` 会根据 `node.type` 分支，选择 `NodeSlot1` 到 `NodeSlot5`；`RGSlotOnView` 则挂载 `RGMiniView` 作为视口叠加层。在图谱外围，`RGProvider` 提供上下文，`DraggableWindow` 承载选择器与设置外壳，`SimpleUIVTabs` 渲染插槽标签页，而包装类 `slot-style-${slotTeamplateId}` 会在 SCSS 中激活特定插槽的选中态和主题覆盖。\n\n这仍然是一个查看器示例，而不是编辑器。运行时 API 会改变表现形式和交互选项，但不会新增、删除或重新连接图元素。\n\n## 关键交互\n\n- 选择 `Slot2`、`Slot3`、`Slot4`、`Slot5` 或 `Random` 时，会重写每个在线节点的 `type`，然后在短暂的动画辅助延迟后重新居中并再次适配图谱。\n- `Random` 模式会从同一组标签页列表中抽样，因此当抽中的值字面量就是 `random` 时，某些节点仍可能回退到默认的 `NodeSlot1` 分支。\n- 浮动窗口可以从标题栏拖动、最小化，并切换到设置叠加层，而无需卸载图谱。\n- 设置叠加层会修改在线图实例上的 `wheelEventAction` 和 `dragEventAction`，因此同一个画布可以在滚动、缩放、选择、移动或禁用输入处理之间切换。\n- `Download Image` 操作会先为导出准备图谱 DOM，再借助 `modern-screenshot` 将其渲染为 blob 并下载，之后恢复图谱。\n- `NodeSlot3` 会响应 relation-graph 的 `checked` 标记，并添加动画渐变和自定义光环，因此选中反馈会随着当前插槽族而变化。\n- 当节点尺寸显著变大时，`RGMiniView` 会为较大的卡片模式提供稳定的导航辅助。\n\n## 关键代码片段\n\n这个片段说明，该示例隐藏了内置节点表面，从而让插槽渲染器成为可见主体。\n\n```tsx\nconst graphOptions: RGOptions = {\n    debug: true,\n    defaultJunctionPoint: RGJunctionPoint.border,\n    defaultNodeColor: 'transparent',\n    defaultNodeShape: RGNodeShape.rect,\n    defaultNodeBorderWidth: 0,\n    defaultLineShape: RGLineShape.StandardStraight,\n    // ...\n};\n```\n\n这个片段展示了居中布局配置，它为较大的节点主体模板画廊提供了足够的间距。\n\n```tsx\nlayout: {\n    layoutName: 'center',\n    levelGaps: [500, 500, 500],\n    alignItemsX: 'center',\n    alignItemsY: 'center',\n    force_node_repulsion: 2,\n    force_line_elastic: 0.1,\n    maxLayoutTimes: Number.MAX_VALUE\n}\n```\n\n这个片段说明，共享数据集只会加载一次，并且在任何插槽切换发生之前，视口就会先被归一化。\n\n```tsx\nconst initializeGraph = async () => {\n    const myJsonData: RGJsonData = graphJsonData;\n    await graphInstance.setJsonData(myJsonData);\n    graphInstance.moveToCenter();\n    graphInstance.zoomToFit();\n    await changeNodeSlot(slotTeamplateId);\n};\n```\n\n这个片段展示了图级别的变更模式：每个在线节点都会获得一个新的渲染器类型，然后在尺寸变化稳定后重新适配图谱。\n\n```tsx\nconst allNodes: RGNode[] = graphInstance.getNodes();\nfor (const node of allNodes) {\n    const randomSlot = allSlotIds[Math.floor(Math.random() * allSlotIds.length)];\n    graphInstance.updateNode(node, {\n        type: newSlotId === 'random' ? randomSlot.value : newSlotId\n    });\n}\ngraphInstance.enableCanvasAnimation();\nawait graphInstance.sleep(50);\ngraphInstance.moveToCenter();\ngraphInstance.zoomToFit();\n```\n\n这个片段说明，一个 `RGSlotOnNode` 分支可以分发到五种互不相同的节点主体，而不是只对应一个固定的自定义节点。\n\n```tsx\n\u003CRGSlotOnNode>\n    {({ node, checked }: RGNodeSlotProps) => {\n        switch (node.type) {\n        case 'slot2': return \u003CNodeSlot2 node={node} />;\n        case 'slot3': return \u003CNodeSlot3 node={node} checked={checked} />;\n        case 'slot4': return \u003CNodeSlot4 node={node} />;\n        case 'slot5': return \u003CNodeSlot5 node={node} />;\n        default: return \u003CNodeSlot1 node={node} />;\n        }\n    }}\n\u003C/RGSlotOnNode>\n```\n\n这个片段说明，slot 3 中的选中态样式依赖 relation-graph 的 `checked` 状态，而不是单独的本地标记。\n\n```tsx\nexport const NodeSlot3: React.FC\u003CRGNodeSlotProps> = ({ node, checked }) => {\n    return (\n        \u003Cdiv className={`my-slot-3-content ${checked ? 'my-node-animation-01 text-white' : ''}`}>\n            \u003CIconSwitcher iconName={node.data?.myicon} size={60} />\n        \u003C/div>\n    );\n};\n```\n\n这个片段展示了包装类如何改变图谱外壳以及当前插槽族的选中态表现。\n\n```scss\n.slot-style-slot2 {\n    .relation-graph {\n        background-color: #050505;\n        font-family: 'Orbitron', 'Noto Sans SC', sans-serif;\n        --rg-checked-item-bg-color: rgba(244, 60, 229, 0.3);\n        .rg-toolbar {\n            background-color: rgba(248, 246, 246, 0.53);\n            border: none;\n        }\n        .rg-miniview {\n            background-color: #050505;\n        }\n    }\n}\n```\n\n这个片段说明，导出流程使用的是 relation-graph 提供的准备与恢复 API，而不是盲目地直接截图画布。\n\n```tsx\nconst canvasDom = await graphInstance.prepareForImageGeneration();\nlet graphBackgroundColor = graphInstance.getOptions().backgroundColor;\nif (!graphBackgroundColor || graphBackgroundColor === 'transparent') {\n    graphBackgroundColor = '#ffffff';\n}\nconst imageBlob = await domToImageByModernScreenshot(canvasDom, {\n    backgroundColor: graphBackgroundColor\n});\nawait graphInstance.restoreAfterImageGeneration();\n```\n\n## 这个示例的独特之处\n\n对比数据把这个示例放在 `node`、`hand-drawn-style`、`css-theme` 和 `custom-line-style` 附近，但它的关注点与这些相邻示例都不相同。它最清晰的区别在于，会在运行时对所有在线节点重写已加载图谱的 `node.type`，然后在由插槽驱动的尺寸变化稳定后重新居中并再次适配。\n\n相较于 `node`，这里的核心启发并不是并排展示每个节点 JSON 样式技巧的目录。`node-slot-list` 更进一步，深入到图级别的模板切换：一张已经挂载的图可以在五种自定义节点主体以及一种混合随机模式之间切换，而无需重建数据集。\n\n相较于 `hand-drawn-style`，这里可复用的思路更偏向渲染器编排，而不是单一主题皮肤。相较于 `css-theme` 和 `custom-line-style`，这个示例的重点也不主要是给内置图表面重新着色或变更连线预设。它真正关注的是在保持同一份居中数据集、minimap 和浮动工作区外壳不变的前提下，直接切换节点标记本身。\n\n它最强的特征组合是：透明的矩形基础节点、针对 center 布局的调优、由包装类驱动的选中态主题，以及基于同一份人物数据集进行的图级别 `updateNode(...)` 切换。这个组合使得该示例更像一个运行时节点模板画廊，而不是静态的自定义节点演示。\n\n## 这种模式还适用于哪里\n\n这种模式很适合那些需要在同一套关系上提供多种节点呈现方式的产品。例如在员工关系图中，可以在紧凑徽章和资料卡之间切换；在风险图中，可以在图标状态和评分卡之间切换；在基础设施视图中，则可以在服务图标和详情卡片之间切换。\n\n它也适用于设计评审和白标工作流。团队可以保留一个已经准备好的图实例，对比不同的节点密度或品牌皮肤，并在最终选定生产模板之前，验证 minimap、选中态样式和导出效果。\n\n同一套结构也可以作为插槽系统的回归测试板。由于拓扑保持不变而渲染器发生切换，因此它是检验新节点模板是否仍然适配布局、选中态处理和导出链路的一种实用途径。\n",false,500,1782615371219]