D2项目多层SVG输出中的链接路径问题解析

问题描述

在D2图表工具中，当使用多层(multi-layer)功能生成SVG输出时，系统会自动将link关键字渲染为指向新图层的超链接。这些链接会生成到单独的SVG文件中，但当前实现存在一个关键问题：生成的链接路径缺少".svg"文件后缀名，导致链接无法正常工作。

技术细节分析

D2在生成多层SVG输出时，出于兼容性考虑同时使用了两种属性来定义链接：

1. href属性（现代标准）
2. xlink:href属性（已废弃的旧标准）

这两种属性都存在于生成的<a>元素中，但它们的值都缺少了必要的".svg"后缀。这种实现方式虽然考虑了向后兼容，但实际效果却影响了核心功能的可用性。

正确使用方法

虽然问题出在工具实现上，但值得注意的是，在D2中引用其他图层时，应该使用完整的路径引用方式。例如：

layers: {
    one: {
        ping: {
            link: _.layers.two  // 正确的引用方式
        }
    }
    two: {
        pong: {
            link: _.layers.one  // 正确的引用方式
        }
    }
}

这种引用方式使用了D2的路径引用语法（_.layers.图层名），能够更准确地定位目标图层。

解决方案建议

针对此问题，建议的修复方案包括：

1. 在生成链接路径时自动添加".svg"后缀
2. 移除已废弃的xlink:href属性，仅保留现代标准的href属性
3. 确保生成的链接路径与实际的SVG文件名完全匹配

影响范围

这个问题会影响所有使用多层SVG输出并依赖图层间链接功能的用户。虽然手动添加".svg"后缀可以临时解决问题，但这显然不是理想的解决方案。

总结

D2作为一款强大的图表工具，其多层SVG输出功能为复杂图表的组织提供了便利。然而，当前实现的链接路径问题影响了这一功能的实用性。期待在未来的版本中看到这个问题的修复，使多层SVG输出功能更加完善和可靠。