Mind Map项目中的收起按钮数量显示问题解析

在Mind Map项目中，收起按钮的默认行为是显示当前节点所有子孙节点的数量总和。这一设计虽然能够提供完整的层级信息，但与主流思维导图软件（如XMind、MindManager等）的交互模式存在差异——这些软件通常只显示直接子节点的数量。

问题本质分析

Mind Map项目通过expandBtnNumHandler配置项提供了自定义收起按钮显示内容的接口。根据API文档描述，该函数应接收节点实例作为参数，允许开发者基于节点属性自定义显示内容。然而在实际代码实现中，传入的却是预先计算好的子孙节点总数，导致开发者无法获取到节点的直接子代信息。

技术实现细节

在思维导图的数据结构中，每个节点通常包含以下关键属性：

• 节点ID
• 节点文本内容
• 子节点数组
• 父节点引用
• 展开/收起状态

要实现直接子节点数量的显示，需要访问节点的children数组属性并获取其长度，而非递归遍历所有后代节点。

解决方案演进

项目维护者在v0.11.1版本中对此问题进行了修复，现在expandBtnNumHandler回调函数会同时接收两个参数：

1. 计算好的子孙节点总数（保持向后兼容）
2. 节点实例对象

这使得开发者现在可以灵活选择显示逻辑：

expandBtnNumHandler: (total, node) => {
    // 显示直接子节点数量
    return node.children ? node.children.length : 0;
    
    // 或者继续显示所有子孙节点数量
    // return total;
}

最佳实践建议

对于不同场景下的收起按钮显示策略：

1. 简单层级结构：建议显示直接子节点数量，避免数字过大造成视觉干扰
2. 复杂知识图谱：可考虑显示子孙总数，强调节点的全局影响力
3. 混合模式：可以结合两种方式，如"3/15"表示"直接子节点3个/总子孙15个"

该改进体现了开源项目对开发者需求的快速响应能力，也展示了API设计时考虑扩展性的重要性。通过这样的渐进式增强，既保持了向后兼容，又提供了更灵活的定制能力。