Terrastruct/d2项目中连接线(Edge)的链接功能实现分析
2025-05-10 21:16:52作者:苗圣禹Peter
Terrastruct/d2项目是一个用于绘制技术架构图的工具,类似于流程图和系统架构图的绘制工具。在最新开发中,项目团队正在为连接线(Edge)添加链接功能支持,这将使图表中的连接线能够像节点(Shape)一样支持超链接跳转。
当前实现状态
目前,d2项目已经为节点(Shape)实现了链接功能,用户可以通过指定link属性为节点添加超链接。当用户点击这些节点时,浏览器会跳转到指定的URL地址。这一功能是通过以下技术路径实现的:
- 在编译器(d2graph)中解析link关键字并存储到节点属性中
- 在导出器(exporter)阶段读取该属性值
- 在SVG渲染阶段将节点包装在
<a>标签中实现链接功能
连接线链接功能的实现方案
为连接线(Edge)实现类似的链接功能,需要遵循类似的技术路径:
-
编译器层面:需要在d2graph.go文件中扩展连接线的属性解析逻辑,使其能够识别和处理link关键字,就像处理节点link属性一样。
-
导出器层面:在export.go文件中,需要修改导出逻辑,确保连接线的link属性能够被正确读取并传递到渲染阶段。
-
渲染层面:在SVG渲染器(d2svg.go)中,需要为连接线添加
<a>标签包装,使得连接线也能支持点击跳转功能。
技术实现细节
实现这一功能需要注意几个关键点:
-
SVG中的链接实现:SVG图形中的链接是通过
<a>元素实现的,该元素可以包含其他SVG元素作为其内容。对于连接线来说,需要确保<a>标签正确包裹了表示连接线的路径元素。 -
事件处理:需要考虑连接线的点击区域处理,确保用户能够方便地点击到连接线触发链接跳转。
-
视觉反馈:可以添加hover效果等视觉提示,让用户知道哪些连接线是可点击的。
功能意义
为连接线添加链接功能将大大增强d2图表的交互性和实用性。例如:
- 在系统架构图中,可以直接通过连接线跳转到相关文档
- 在流程图中,可以通过连接线跳转到详细说明
- 在依赖关系图中,可以通过连接线查看组件间的详细交互文档
这一功能的实现将使d2图表从静态展示工具转变为更具交互性的文档系统,提升用户体验和图表的信息承载能力。
登录后查看全文
热门项目推荐
相关项目推荐
atomcodeClaude Code 的开源替代方案。连接任意大模型,编辑代码,运行命令,自动验证 — 全自动执行。用 Rust 构建,极致性能。 | An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed. Get StartedRust0215
cann-learning-hubCANN 学习中心仓,支持在线互动运行、边学边练,提供教程、示例与优化方案,一站式助力昇腾开发者快速上手。Jupyter Notebook0138
uni-appA cross-platform framework using Vue.jsJavaScript08
GLM-5.2智谱开源 GLM-5.2,这是针对长文本任务的最新旗舰模型。相较于前代产品 GLM-5.1,它在长文本任务处理能力上实现了显著飞跃,并且首次在稳定的 100 万 token 上下文中提供这一能力。Jinja00
SwanLab⚡️SwanLab - an open-source, modern-design AI training tracking and visualization tool. Supports Cloud / Self-hosted use. Integrated with PyTorch / Transformers / LLaMA Factory / veRL/ Swift / Ultralytics / MMEngine / Keras etc.Python00
tiny-universe《大模型白盒子构建指南》:一个全手搓的Tiny-UniverseJupyter Notebook03
热门内容推荐
项目优选
收起
deepin linux kernel
C
32
16
openEuler内核是openEuler操作系统的核心,既是系统性能与稳定性的基石,也是连接处理器、设备与服务的桥梁。
C
471
465
暂无描述
Dockerfile
779
5.08 K
本项目是CANN提供的transformer类大模型算子库,实现网络在NPU上加速计算。
C++
876
2.03 K
Ascend Extension for PyTorch
Python
758
968
本项目是CANN提供的神经网络类计算算子库,实现网络在NPU上加速计算。
C++
697
1.4 K
昇腾LLM分布式训练框架
Python
185
231
本项目是CANN提供的数学类基础计算算子库,实现网络在NPU上加速计算。
C++
1.1 K
1.14 K
本仓库是 Flutter SDK 与 Flutter Engine 的 OpenHarmony 适配版本,由 CPF-Flutter 团队维护。开发者可使用熟悉的 Flutter 技术栈开发 OpenHarmony 应用,3.35.7 及以后的适配版本可基于本仓库源码构建支持 OpenHarmony 的 Flutter Engine。
Dart
1.04 K
271
JiuwenSwarm 是一款基于openJiuwen开发的智能AI Agent,它能够将大语言模型的强大能力,通过你日常使用的各类通讯应用,直接延伸至你的指尖。
Python
2.25 K
677