学完本文,你能独立安装 treestorm、构建带状态管理的树节点、绑定增删改查事件,并避开初始化与异步更新的典型陷阱。
# 准备
- 环境要求:Node.js 16+ 与 npm 8+,浏览器需支持 ES Module。
- 安装命令:在项目根目录执行 `npm install treestorm`。
- 确认安装:运行 `node -e "import('treestorm').then(()=>console.log('ok'))"`,输出 `ok` 即成功。
# 第一步:初始化一棵最小树
- 在 HTML 中创建挂载点:``。
- 引入核心 API:`import { TreeStorm } from 'treestorm';`
- 写基础实例:
const tree = new TreeStorm({
el: '#app',
data: [
{ id: '1', label: '根节点', children: [
{ id: '1-1', label: '子节点A' }
]}
]
});
tree.render();
- 判断标准:页面出现“根节点”与“子节点A”,点击箭头可展开折叠。
# 第二步:绑定交互与状态管理
- **核心方法**:`tree.on('node:click', handler)` 监听点击,`tree.getNode(id)` 获取节点对象。
- 添加节点:调用 `tree.addNode(parentId, { id: 'new', label: '新节点' })`,自动刷新视图。
- 删除节点:`tree.removeNode(id)`,注意若该节点有子级,默认级联删除。
- 状态管理技巧:用 `tree.getState()` 导出当前树结构,`tree.loadState(json)` 恢复,适合本地缓存。
- 验证:点击子节点A,控制台输出其 id;点击“新增”按钮后,树中出现“新节点”。
# 第三步:异步数据与动态更新
- **常见需求**:从后端接口拉数据后渲染。
- 做法:在 `fetch` 返回后,调用 `tree.setData(resp.data)` 整体替换数据。
- 增量更新:若只想更新某个节点标签,用 `tree.updateNode(id, { label: '新名字' })`,避免全量重绘。
- 错误场景:异步返回的节点缺少 `id` 或 `children` 字段,会触发警告并跳过该节点。
- 判断标准:接口返回 1 秒后,树正确显示新结构,且旧节点展开状态保留。
# 验证与常见坑
- **验证清单**:
1. 初始化后无控制台报错。
2. 增删改后视图与 `tree.getState()` 数据一致。
3. 折叠状态在数据更新后仍保留。
- **坑1:重复渲染**。多次调用 `tree.render()` 会导致事件绑定叠加,正确做法是只初始化一次,后续用 `setData` 或 `updateNode`。
- **坑2:id 冲突**。如果两个节点 id 相同,`getNode` 只返回第一个,务必用唯一 id(如时间戳或 UUID)。
- **坑3:异步时序**。若在数据加载前调用 `addNode`,父节点可能不存在,返回 `false`。用 `tree.on('ready')` 事件确保初始化完成后再操作。
完成以上步骤,你已经掌握 treestorm 的核心增删改查与状态同步。生产环境建议封装成组件,并将 `getState` 结果定期持久化到 localStorage,以防刷新丢失。
