balkan familytree js 当前版本不支持强制展开全部节点以显示完整家谱树，官方明确表示该功能尚未实现，但已列入下一代产品的开发规划。
balkan familytree js 当前版本不支持强制展开全部节点以显示完整家谱树，官方明确表示该功能尚未实现，但已列入下一代产品的开发规划。
在使用 Balkan FamilyTree JS 构建交互式家族关系可视化时，开发者常期望通过配置项一键展开所有层级节点（如祖父母、父母、子女、孙辈等），实现“全图无折叠”的浏览体验。然而，根据 Balkan 官方技术支持团队（Zornitsa）的正式回应，当前版本（截至最新公开文档与 SDK v4.x）并未提供 expandAll: true、autoExpandDepth: Infinity 或类似 API 来禁用默认的折叠逻辑。所有分支的折叠/展开行为均依赖用户显式交互（点击节点展开图标）或有限的初始化配置（如 expandLevel: 2），无法真正“取消折叠限制”。
这意味着以下常见尝试将无效：
// ❌ 以下配置在当前版本中不存在或无效
new FamilyTree(document.getElementById("tree"), {
expandAll: true, // 不被识别
autoExpandDepth: -1, // 无此选项
collapse: false, // 无全局禁用折叠参数
nodes: [...],
// ...
});✅ 可行的替代方案（临时应对）：
- 使用 expandLevel 设置一个足够大的初始展开深度（例如 expandLevel: 10），适用于层级相对固定且深度可控的中小型家谱；
- 结合 tree.expand(nodeId) 方法，在初始化后遍历关键节点并编程式展开（需注意性能，避免对超大节点集频繁调用）；
- 通过 CSS 隐藏折叠控件（.ft-node-collapsed::before { display: none; }），虽不能真正展开节点，但可改善视觉干扰——此法仅隐藏 UI 元素，不改变数据渲染逻辑，节点仍处于折叠状态。
⚠️ 重要注意事项：
- 强制展开全部节点可能引发严重的性能问题（尤其是超过 500+ 节点的家谱），导致页面卡顿、布局错乱或内存溢出；
- Balkan 团队已确认“完整无折叠家谱视图”属于下一代产品（非当前 FamilyTree JS 的演进版）的核心特性，建议关注其官网公告或订阅 BALKAN App Roadmap 获取进展；
- 若项目时间敏感且必须展示全图，可评估迁移至 D3.js + force-directed layout 或 GoJS 等更灵活的图谱库，并自行实现家族关系层级渲染逻辑。
总之，现阶段应理性接受该限制，优先优化交互引导（如分步展开、区域聚焦、搜索定位）而非追求一次性全量渲染——这既是技术约束下的务实选择，也更符合用户实际查阅家谱的认知路径。
