G2 [Bug]: 图例标题配置无效

Describe the bug / 问题描述

分类图例 title 配置无效。

legend: {
  color: {
    title: '类型',
  },
},

Reproduction link / 复现链接

No response

Steps to Reproduce the Bug or Issue / 重现步骤

No response

Version / 版本

🆕 5.x

OS / 操作系统

[ ] macOS
[ ] Windows
[ ] Linux
[ ] Others / 其他

Browser / 浏览器

[ ] Chrome
[ ] Edge
[ ] Firefox
[ ] Safari (Limited support / 有限支持)
[ ] IE (Nonsupport / 不支持)
[ ] Others / 其他

Dec 05 '25 03:12 lxfu1

@lxfu1 您好！以下是关于您问题的自动回复：

您好，感谢您的反馈！

问题分析

您提到分类图例（legend）title 配置无效，并给出了如下配置：

legend: {
  color: {
    title: '类型',
  },
},

根据 G2 v5 官方文档，您的配置语法是正确的，legend.color.title 用于设置分类图例的标题文本。

可能原因与排查建议

G2 版本兼容性问题
您提到使用 5.x 版本。请确保实际引入的 G2 版本为 5.0 及以上，并且 legend 相关功能未被裁剪或 tree-shaking 剔除。
图表类型与数据
legend 只有在存在 color 通道，并且数据确实产生分类图例时才会显示 title。请确认 encode 配置类似如下示例：
```
encode: { x: '字段1', y: '字段2', color: '分类字段' }
```
title 样式被覆盖或未生效
如果有进一步自定义 legend 或样式，可能会影响 title 的显示。可尝试添加更多 title 相关属性进行测试，例如：
```
legend: {
  color: {
    title: '类型',
    titleFontSize: 16,
    titleFontWeight: 'bold',
    titleFill: '#333',
  }
}
```
legend 渲染被禁用或隐藏
检查是否有其他 legend 相关配置导致 legend 未正常显示，如 legend: false 或 mark 级别 legend 配置覆盖。
浏览器控制台报错
请观察是否有相关报错信息，帮助定位问题。

参考官方示例

以下为官方推荐的 legend title 配置示例（可对比您的实际代码）：

legend: {
  color: {
    title: '图例标题',
    titleFontSize: 16,
    titleFontFamily: 'sans-serif',
    titleFontWeight: 500,
    titleFill: '#000',
  }
}

建议操作

确保 color 通道已启用且为分类字段
升级至最新 G2 5.x 版本进行测试
增加 title 样式配置排查是否渲染
最小化复现代码，排除其他配置干扰

如仍无效，请提供更完整的代码片段或在线复现链接，便于进一步定位问题。

参考文档

如有更多信息或需要进一步协助，请随时补充！🙏

此回复由 AI 助手自动生成。如有任何问题，我们的团队会尽快跟进。

Dec 05 '25 03:12 github-actions[bot]

原因是在初始化主题的时候分类图例 title 被设置为了false，导致后续用户配置的 title 被忽略了

Dec 10 '25 08:12 interstellarmt