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

[lxfu1]

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 / 其他

[github-actions]

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

您好，感谢您的反馈！

问题分析

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

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

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

---

可能原因与排查建议

1. G2 版本兼容性问题
   您提到使用 5.x 版本。请确保实际引入的 G2 版本为 5.0 及以上，并且 legend 相关功能未被裁剪或 tree-shaking 剔除。

2. 图表类型与数据
   legend 只有在存在 color 通道，并且数据确实产生分类图例时才会显示 title。请确认 encode 配置类似如下示例：

   encode: { x: '字段1', y: '字段2', color: '分类字段' }

3. title 样式被覆盖或未生效
   如果有进一步自定义 legend 或样式，可能会影响 title 的显示。可尝试添加更多 title 相关属性进行测试，例如：

   legend: {
     color: {
       title: '类型',
       titleFontSize: 16,
       titleFontWeight: 'bold',
       titleFill: '#333',
     }
   }

4. legend 渲染被禁用或隐藏
   检查是否有其他 legend 相关配置导致 legend 未正常显示，如 legend: false 或 mark 级别 legend 配置覆盖。

5. 浏览器控制台报错
   请观察是否有相关报错信息，帮助定位问题。

---

参考官方示例

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

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

---

建议操作

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

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

---

参考文档

• G2 图例组件官方文档（Legend）
• G2 Legend Title 属性配置示例

---

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

---

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

[interstellarmt]

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

[CullenNg]

补充关于这个title的另外一些bug

当没有设置title (legend.color.title = false) 并且图例项过多的时候，图例区域的大小计算有问题（会往下掉），如下截图

验证：

1. 当图例行数为3的时候，设置 legend.color.titleInset = 24 的时候不会跳动；
2. 当图例行数为2的时候，设置 legend.color.titleInset = 12 的时候不会跳动；
3. 当设置 设置 legend.color.titlePosition = ‘inner’ 的时候也不会跳动；

综上推断 slider 拖动的时候又把 title 高度算计在里面了（虽然 title 无设置，凭空出来了）🤔