配置与选项
本页对应英文版 Configuration & Options,介绍 relation-graph 的配置系统如何统一描述视觉风格、交互行为、布局参数、性能模式和编辑能力。
配置类型系统
- 用户侧通常传入部分配置。
- 运行时会补齐默认值,得到完整配置对象。
默认配置创建
- 系统会在初始化阶段把缺失配置自动补齐。
- 这样业务层只需要声明自己关心的部分。
核心配置类别
UI 显示
- 工具栏、小地图、辅助视图等。
视觉样式
- 节点颜色、连线颜色、背景、文字、线形等。
交互控制
- 是否允许拖拽、滚轮、编辑、建线等。
画布与视口
- 初始缩放、偏移、最小 / 最大缩放等。
布局配置
- 布局名称、方向、间距、力学参数等。
性能配置
- 性能模式与视口裁剪相关开关。
编辑配置
- 是否启用节点编辑、连线编辑、参考线、连接目标等。
模板与标记
- 连线模板、箭头 marker、创建流程默认模板等。
运行时更新
- 配置可以在运行时通过 API 更新。
- 更新后,布局、渲染和交互系统会按需响应。
配置校验与错误处理
- 核心系统会尽量兜底异常配置。
- 但业务侧仍应确保关键字段语义正确。
与平台集成
- 各平台在配置语义上保持一致,只是传递方式不同。