diff --git a/.ua/backlog.json b/.ua/backlog.json index 004fb9e..83e6701 100644 --- a/.ua/backlog.json +++ b/.ua/backlog.json @@ -612,6 +612,14 @@ "acceptance": "tree({ nodes, expanded, selected, defaultExpandAll, onSelect }) 递归渲染 + 箭头展开收起 + 点选 + Enter/→/← 键盘 + 禁用不响应;组件数 40→41 三处计数同步;npm run check 全绿", "status": "done", "notes": "自补:组件补充;selected/expanded 信号均可外部受控" + }, + { + "id": "g32", + "title": "tree 补 ↑↓/Home/End 行间导航", + "motivation": "tree 只支持 Enter/→/←,无法用键盘在节点间移动焦点,键盘用户仍得靠鼠标找行", + "acceptance": "↑↓ 在当前可见节点间移动、Home/End 到首末行,只改焦点不改选中,收起分支的子节点不参与遍历;npm run check 全绿", + "status": "open", + "notes": "自补:既有组件可用性细节" } ] } diff --git a/.ua/index.json b/.ua/index.json index 52ed311..e88a88c 100644 --- a/.ua/index.json +++ b/.ua/index.json @@ -1,6 +1,6 @@ { "$schema": "ui-arch-registry-index/0.1", - "generatedAt": "2026-10-26T03:41:59.549Z", + "generatedAt": "2026-10-26T03:43:04.201Z", "repoRoot": ".", "packages": [ { @@ -1901,7 +1901,7 @@ "节点树用 { key, label, children } 描述,key 唯一即可(选中与展开都按 key 记)", "传 selected 信号即可外部受控;不传则组件内部维护选中态", "点箭头只展开/收起,点标签才选中;叶子节点箭头位置留空以对齐", - "键盘 Enter/空格 选中、→ 展开、← 收起;disabled 节点点击与键盘都不响应", + "键盘:↑↓ 在可见节点间移动、Home/End 到首末行(只移动焦点),Enter/空格 选中、→ 展开、← 收起;disabled 节点点击与键盘都不响应", "defaultExpandAll 首屏展开全部分支(外部已给 expanded 初值时以外部为准)" ] } diff --git a/llms-full.txt b/llms-full.txt index a9fb300..3f9c435 100644 --- a/llms-full.txt +++ b/llms-full.txt @@ -1,6 +1,6 @@ # @ui-arch 组件库 Agent 文档(无图形版) -> 自动生成于 2026-10-26T03:41:59.549Z,数据源:各包 ua.manifest.json,勿手改。人类版文档站:apps/docs/index.html。 +> 自动生成于 2026-10-26T03:43:04.201Z,数据源:各包 ua.manifest.json,勿手改。人类版文档站:apps/docs/index.html。 > 组件 = 普通函数,传 props 返回 DOM;状态用 signal 双向绑定:读 signal() 写 signal(v)。 ## 快速上手 @@ -1084,7 +1084,7 @@ const sel = signal(''); tree({ nodes: [{ key: 'src', label: 'src', children: [{ 1. 节点树用 { key, label, children } 描述,key 唯一即可(选中与展开都按 key 记) 2. 传 selected 信号即可外部受控;不传则组件内部维护选中态 3. 点箭头只展开/收起,点标签才选中;叶子节点箭头位置留空以对齐 -4. 键盘 Enter/空格 选中、→ 展开、← 收起;disabled 节点点击与键盘都不响应 +4. 键盘:↑↓ 在可见节点间移动、Home/End 到首末行(只移动焦点),Enter/空格 选中、→ 展开、← 收起;disabled 节点点击与键盘都不响应 5. defaultExpandAll 首屏展开全部分支(外部已给 expanded 初值时以外部为准) 现场演示:apps/docs/demo.html#sec-tree diff --git a/packages/skin/ui/src/tree.ts b/packages/skin/ui/src/tree.ts index 2d0c859..e0b4050 100644 --- a/packages/skin/ui/src/tree.ts +++ b/packages/skin/ui/src/tree.ts @@ -72,9 +72,22 @@ export function tree(props: TreeProps): HTMLElement { } }); + /*** 当前可见的节点行(收起分支的子节点不参与 ↑↓ 遍历) ***/ + const visibleRows = (): HTMLElement[] => + Array.from(root.querySelectorAll('.ua-tree-row')).filter((el) => !el.closest('.ua-tree-children[hidden]')); + root.addEventListener('keydown', (e: KeyboardEvent) => { const row = (e.target as HTMLElement).closest('.ua-tree-row') as HTMLElement | null; if (!row) return; // 卫语句:焦点不在节点行 + if (e.key === 'ArrowDown' || e.key === 'ArrowUp' || e.key === 'Home' || e.key === 'End') { + const list = visibleRows(); + const at = list.indexOf(row); + if (at < 0) return; // 卫语句:行已不在可见集 + e.preventDefault(); + const next = e.key === 'Home' ? list[0] : e.key === 'End' ? list[list.length - 1] : list[at + (e.key === 'ArrowDown' ? 1 : -1)]; + next?.focus(); // 行间移动只改焦点,不改变选中 + return; + } const key = [...rows.entries()].find(([, el]) => el === row)?.[0]; if (!key) return; // 卫语句:找不到对应节点 const node = findNode(props.nodes, key); diff --git a/packages/skin/ui/ua.manifest.json b/packages/skin/ui/ua.manifest.json index 329f3d2..1aa428d 100644 --- a/packages/skin/ui/ua.manifest.json +++ b/packages/skin/ui/ua.manifest.json @@ -1772,7 +1772,7 @@ "节点树用 { key, label, children } 描述,key 唯一即可(选中与展开都按 key 记)", "传 selected 信号即可外部受控;不传则组件内部维护选中态", "点箭头只展开/收起,点标签才选中;叶子节点箭头位置留空以对齐", - "键盘 Enter/空格 选中、→ 展开、← 收起;disabled 节点点击与键盘都不响应", + "键盘:↑↓ 在可见节点间移动、Home/End 到首末行(只移动焦点),Enter/空格 选中、→ 展开、← 收起;disabled 节点点击与键盘都不响应", "defaultExpandAll 首屏展开全部分支(外部已给 expanded 初值时以外部为准)" ] }