G6树图中实现叶子节点文字垂直排列的技术方案

背景介绍

在使用G6图表库构建树形结构时，开发者经常会遇到需要特殊处理叶子节点显示样式的需求。特别是在紧凑盒(compactBox)布局、从上至下(TB)排列的树形结构中，如何让最底层矩形(rect)节点的文字垂直显示是一个常见的可视化需求。

核心问题分析

在G6的树形布局中，叶子节点的文字默认是水平排列的。当我们需要实现类似中文古籍的垂直排版效果时（即文字从上至下逐行排列），需要考虑以下几个技术要点：

1. 叶子节点的识别与特殊样式处理
2. 文字垂直排列的实现方式
3. 节点尺寸与文字排版的协调

解决方案

方法一：CSS样式控制

通过为叶子节点添加特定的CSS类，可以实现文字的垂直排列：

// 在节点样式中添加自定义类
{
  type: 'rect',
  labelCfg: {
    style: {
      writingMode: 'vertical-rl',  // 垂直从右到左排列
      textOrientation: 'mixed',    // 保持文字正立
      width: '1em',                // 限制宽度为一个字符宽度
      whiteSpace: 'pre-wrap'       // 允许换行
    }
  }
}

方法二：数据预处理

在数据层面识别叶子节点并添加特殊样式属性：

// 遍历数据识别叶子节点
function processData(data) {
  if (!data.children || data.children.length === 0) {
    // 叶子节点特殊处理
    data.style = {
      width: 30,
      height: 200,
      labelCfg: {
        style: {
          writingMode: 'vertical-rl'
        }
      }
    };
  } else {
    // 非叶子节点处理
    data.children.forEach(child => processData(child));
  }
  return data;
}

方法三：自定义节点

对于更复杂的需求，可以创建自定义节点类型：

G6.registerNode('verticalTextNode', {
  draw(cfg, group) {
    const rect = group.addShape('rect', {
      attrs: {
        x: 0,
        y: 0,
        width: cfg.size[0],
        height: cfg.size[1],
        fill: cfg.style.fill
      }
    });
    
    // 垂直排列文字
    const text = cfg.label.split('');
    text.forEach((char, i) => {
      group.addShape('text', {
        attrs: {
          x: cfg.size[0] / 2,
          y: 15 + i * 20,  // 垂直间距
          text: char,
          textAlign: 'center',
          fill: '#000'
        }
      });
    });
    
    return rect;
  }
});

实际应用建议

1. 性能考虑：对于大规模树形结构，CSS方案性能最佳
2. 兼容性：writing-mode属性在现代浏览器中支持良好
3. 交互优化：垂直排列时注意调整节点交互区域
4. 视觉平衡：适当调整节点宽高比，确保文字可读性

总结

在G6中实现叶子节点文字垂直排列有多种技术路径，开发者可以根据项目具体需求选择最适合的方案。CSS样式方案简单高效，适合大多数场景；数据预处理方案便于集中管理样式；自定义节点方案则提供了最大的灵活性。无论采用哪种方法，都需要注意节点尺寸与文字排版的协调，确保最终可视化效果既美观又实用。