Skip to content

feat(x-pro): 为 TodoList 增加树形展开与自定义节点 - #267

Open
cc-hearts wants to merge 7 commits into
mainfrom
feat/todo-list-tree-expand
Open

cc-hearts wants to merge 7 commits into
mainfrom
feat/todo-list-tree-expand

Conversation

@cc-hearts

Copy link
Copy Markdown
Member

🤔 本次变更属于 ...

  • 🆕 新功能
  • 📝 站点 / 文档改进
  • 💄 组件样式改进
  • 🤖 TypeScript 类型定义改进
  • ✅ 测试用例
  • ⌨️ 无障碍改进

🔗 相关 Issue

无。基于 TodoList 现有能力的功能扩展。

💡 背景与方案

Agent 的任务计划经常是分层的(父任务下挂子任务,或在任务行下方展示自定义内容),但当前 TodoList 只渲染一层扁平列表,也没有"行下方内容"的插槽。本次扩展在不改变现有 items 扁平契约、不改动已有 DOM/class 的前提下,为它补上树形展开与自定义节点能力,零 breaking change。

数据层(TodoItem,依赖已有的索引签名保持兼容)

字段 类型 说明
children TodoItem[] 子树,递归渲染子清单
payload unknown 任意自定义数据,交给 itemExtra 消费
expandable boolean 显式关闭某行的展开入口

新增 Props / Slots / Emits / 实例方法

类别 新增 说明
Props expandedKeys / defaultExpandedKeys 受控 / 非受控展开状态,沿用现有 open 的双轨写法
Props indentSize、recursiveCount 缩进 token;计数是否递归聚合到叶子(默认 false,保持兼容)
Slots itemExtra({ item, index, status, depth, expanded, toggle }) 完全接管展开区内容,可渲染任意 VNode
Slots itemExpandIcon({ item, index, status, depth }) 自定义展开箭头(点击统一由组件处理)
Emits update:expandedKeys / expandedKeysChange 与现有 openChange 对称
方法 expandAll / collapseAll / setExpandedKeys 对标现有 setOpen

关键实现点

  1. 零侵入渲染:li 用 flex-wrap 在末尾换行出展开区,状态图标 / 标题 / 详情 / 删除线的 DOM 与 class 全部不动;没有树形数据的清单渲染结果与改动前一致。
  2. 统计口径:statsItems 统一头部计数与自动折叠判定,避免顶层全完成但子树还在跑时误折叠。
  3. 展开入口判定:只有"有 children,或 itemExtra 插槽对该行返回实质内容"的行才出现箭头;纯叶子不显示。探测插槽时传 expanded: true,并用 hasSlotContent() 过滤 v-if 假分支产生的注释 VNode。
  4. 展开收起动画:与头部分割面板同款高度 + 透明度过渡(展开 0.22s / 收起 0.14s),完成后高度交还 auto;同步 reduced-motion 降级。
  5. 间距设计:新增 ComponentToken itemExpandGap(默认 4px)专控父行与展开区的间距,横向 columnGap 仍为 8px;嵌套清单无额外 margin。
  6. 标题可点击:可展开行的标题支持点击 / Enter / Space 切换,带 role="button" / aria-expanded / focus 轮廓;点击标题内的链接或按钮不会误触。

文档:中英文各补一个「树形任务与自定义节点」demo,以及新增 API / token / 方法表格与动效说明。

✅ 验证

  • vp run --filter @antdv-next/x-pro type-check:通过。
  • vp test --run packages/x-pro/tests/todo-list-utils.test.ts packages/x-pro/tests/todo-list.test.ts:86 个测试全过(新增树形、动画、叶子判定、标题交互等用例)。
  • vp test --run:全量 1083 个测试通过(无回归)。
  • 浏览器实测:三层递归 depth 0/1/2 正确,计数 4 of 10 completed 与展平行数吻合;展开 / 收起逐帧采样高度与透明度过渡正常;标题点击、插槽内链接不误触、纯叶子无箭头均验证通过。

📝 变更日志

语言 变更日志
🇺🇸 英文 Extend TodoList with tree expansion and custom nodes: nested child lists, per-row extra slot, controlled expanded keys, animated expand/collapse, clickable titles and compact nested spacing — fully backward compatible.
🇨🇳 中文 为 TodoList 扩展树形展开与自定义节点:支持递归子清单、行级展开插槽、受控展开状态、展开收起动画、点击标题切换与紧凑嵌套间距,完全向后兼容。

@pkg-pr-new

pkg-pr-new Bot commented Nov 17, 2026 •

Copy link
Copy Markdown

Open in StackBlitz

npm i https://pkg.pr.new/antdv-next/x/@antdv-next/x@267
npm i https://pkg.pr.new/antdv-next/x/@antdv-next/x-markdown@267
npm i https://pkg.pr.new/antdv-next/x/@antdv-next/x-sdk@267

commit: f03c224

@codecov

codecov Bot commented Nov 17, 2026 •

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 79.54545% with 27 lines in your changes missing coverage. Please review.

Files with missing lines Patch % Lines
...ges/x-pro/src/todo-list/components/TodoItemRow.tsx 54.28% 13 Missing and 3 partials ⚠️
packages/x-pro/src/todo-list/index.tsx 85.00% 4 Missing and 5 partials ⚠️
...pro/src/todo-list/hooks/useTodoListExpandedKeys.ts 90.47% 2 Missing ⚠️

📢 Thoughts on this report? Let us know!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant