diff --git a/.ua/backlog.json b/.ua/backlog.json index 43b11f8..cf7ed45 100644 --- a/.ua/backlog.json +++ b/.ua/backlog.json @@ -532,6 +532,14 @@ "acceptance": "jumpable 开启且总页数 > 1 时末尾显示页码输入 + 总页数,回车跳转并钳制合法范围;npm run check 全绿", "status": "done", "notes": "自补:既有组件可用性细节" + }, + { + "id": "g22", + "title": "menu 键入字母快跳菜单项", + "motivation": "菜单项多时方向键逐个移动太慢,与 select 的键入快跳对齐保持组件族一致性", + "acceptance": "menu 展开时键入可打印字符循环聚焦 label 前缀匹配项(忽略大小写),1s 无输入重置;既有导航不变;npm run check 全绿", + "status": "open", + "notes": "自补:既有组件可用性细节" } ] } diff --git a/.ua/index.json b/.ua/index.json index 406b2b8..20dab59 100644 --- a/.ua/index.json +++ b/.ua/index.json @@ -1,6 +1,6 @@ { "$schema": "ui-arch-registry-index/0.1", - "generatedAt": "2026-10-26T03:10:41.109Z", + "generatedAt": "2026-10-26T03:13:07.810Z", "repoRoot": ".", "packages": [ { @@ -150,7 +150,7 @@ "checkbox(props):复选框,checked 信号双向绑定,disabled 支持布尔或信号禁用", "switchButton(props):开关,checked 信号双向绑定,disabled 支持布尔或信号禁用", "select(props):自绘下拉选择(非原生 select),value 信号双向绑定,点外部 / Esc 关闭,选项弹层带微动画,disabled 支持布尔或信号禁用,空间不足自动翻转,键入字母快跳选项", - "menu(props):下拉菜单,触发器 + 自绘弹层,条目支持禁用 / 危险 / 分隔线,↑↓ 环形导航,点外部 / Esc 关闭,空间不足自动翻转", + "menu(props):下拉菜单,触发器 + 自绘弹层,条目支持禁用 / 危险 / 分隔线,↑↓ 环形导航,点外部 / Esc 关闭,空间不足自动翻转,键入字母快跳菜单项", "flip(trigger, panel, preferred):浮层上下翻转判定,按触发器与面板的视口几何决定 preferred 方位放不下时是否翻转,返回实际生效方位 'top' | 'bottom'", "radioGroup(props):单选组,options + value 信号双向绑定,disabled 整组禁用", "accordion(props):折叠面板,标题按钮 + grid 行高过渡,单开(手风琴)或多开,支持禁用面板与 active 信号受控", diff --git a/apps/demo/main.ts b/apps/demo/main.ts index c27309e..5fc6c8e 100644 --- a/apps/demo/main.ts +++ b/apps/demo/main.ts @@ -569,7 +569,7 @@ const content = h( section( 'sec-menu', '下拉菜单', - 'menu 触发器 + 自绘弹层:条目支持禁用 / 危险 / 分隔线,↑↓ 环形导航,点外部或 Esc 收起;视口下方空间不足时弹层自动翻到上方。', + 'menu 触发器 + 自绘弹层:条目支持禁用 / 危险 / 分隔线,↑↓ 环形导航,点外部或 Esc 收起;视口下方空间不足时弹层自动翻到上方,展开后键入字母可快跳菜单项。', h( 'div', { class: 'row' }, diff --git a/llms-full.txt b/llms-full.txt index e738845..28c1177 100644 --- a/llms-full.txt +++ b/llms-full.txt @@ -1,6 +1,6 @@ # @ui-arch 组件库 Agent 文档(无图形版) -> 自动生成于 2026-10-26T03:10:41.109Z,数据源:各包 ua.manifest.json,勿手改。人类版文档站:apps/docs/index.html。 +> 自动生成于 2026-10-26T03:13:07.810Z,数据源:各包 ua.manifest.json,勿手改。人类版文档站:apps/docs/index.html。 > 组件 = 普通函数,传 props 返回 DOM;状态用 signal 双向绑定:读 signal() 写 signal(v)。 ## 快速上手 @@ -1015,7 +1015,7 @@ API 速览: - checkbox(props):复选框,checked 信号双向绑定,disabled 支持布尔或信号禁用 - switchButton(props):开关,checked 信号双向绑定,disabled 支持布尔或信号禁用 - select(props):自绘下拉选择(非原生 select),value 信号双向绑定,点外部 / Esc 关闭,选项弹层带微动画,disabled 支持布尔或信号禁用,空间不足自动翻转,键入字母快跳选项 -- menu(props):下拉菜单,触发器 + 自绘弹层,条目支持禁用 / 危险 / 分隔线,↑↓ 环形导航,点外部 / Esc 关闭,空间不足自动翻转 +- menu(props):下拉菜单,触发器 + 自绘弹层,条目支持禁用 / 危险 / 分隔线,↑↓ 环形导航,点外部 / Esc 关闭,空间不足自动翻转,键入字母快跳菜单项 - flip(trigger, panel, preferred):浮层上下翻转判定,按触发器与面板的视口几何决定 preferred 方位放不下时是否翻转,返回实际生效方位 'top' | 'bottom' - radioGroup(props):单选组,options + value 信号双向绑定,disabled 整组禁用 - accordion(props):折叠面板,标题按钮 + grid 行高过渡,单开(手风琴)或多开,支持禁用面板与 active 信号受控 diff --git a/llms.txt b/llms.txt index 943b54b..5d086fe 100644 --- a/llms.txt +++ b/llms.txt @@ -55,7 +55,7 @@ - checkbox(props):复选框,checked 信号双向绑定,disabled 支持布尔或信号禁用 - switchButton(props):开关,checked 信号双向绑定,disabled 支持布尔或信号禁用 - select(props):自绘下拉选择(非原生 select),value 信号双向绑定,点外部 / Esc 关闭,选项弹层带微动画,disabled 支持布尔或信号禁用,空间不足自动翻转,键入字母快跳选项 - - menu(props):下拉菜单,触发器 + 自绘弹层,条目支持禁用 / 危险 / 分隔线,↑↓ 环形导航,点外部 / Esc 关闭,空间不足自动翻转 + - menu(props):下拉菜单,触发器 + 自绘弹层,条目支持禁用 / 危险 / 分隔线,↑↓ 环形导航,点外部 / Esc 关闭,空间不足自动翻转,键入字母快跳菜单项 - flip(trigger, panel, preferred):浮层上下翻转判定,按触发器与面板的视口几何决定 preferred 方位放不下时是否翻转,返回实际生效方位 'top' | 'bottom' - radioGroup(props):单选组,options + value 信号双向绑定,disabled 整组禁用 - accordion(props):折叠面板,标题按钮 + grid 行高过渡,单开(手风琴)或多开,支持禁用面板与 active 信号受控 diff --git a/packages/skin/ui/src/menu.ts b/packages/skin/ui/src/menu.ts index 59c2972..45cce89 100644 --- a/packages/skin/ui/src/menu.ts +++ b/packages/skin/ui/src/menu.ts @@ -2,12 +2,13 @@ import { effect, h, signal } from '@ui-arch/frame'; import type { MenuItem, MenuProps } from './types.js'; import { flip } from './position.js'; -/*** 下拉菜单:触发器 + 自绘弹层,项支持禁用 / 危险 / 分隔线;点项 / 点外部 / Esc 关闭,↑↓ 环形导航 + Home/End 跳转 ***/ +/*** 下拉菜单:触发器 + 自绘弹层,项支持禁用 / 危险 / 分隔线;点项 / 点外部 / Esc 关闭,↑↓ 环形导航 + Home/End 跳转 + 键入快跳 ***/ export function menu(props: MenuProps): HTMLElement { // —— 状态集中声明 —— const open = signal(false); // 弹层开合 const place = signal<'top' | 'bottom'>('bottom'); // 实际生效方位:打开时按视口空间自动翻转 const focusables: HTMLButtonElement[] = []; // 可聚焦项(跳过分隔线与禁用项),供键盘导航 + const labels: string[] = []; // 与 focusables 平行的条目文案,供键入快跳 const pick = (item: MenuItem): void => { open(false); // 选中即收起 @@ -29,7 +30,7 @@ export function menu(props: MenuProps): HTMLElement { h('span', { class: 'ua-menu-label' }, item.label), item.shortcut ? h('kbd', { class: 'ua-menu-key' }, item.shortcut) : null, // 快捷键只做提示,不拦截按键 ) as HTMLButtonElement; - if (!item.disabled) focusables.push(btn); // 禁用项不参与导航 + if (!item.disabled) { focusables.push(btn); labels.push(item.label); } // 禁用项不参与导航 return btn; }); @@ -57,6 +58,19 @@ export function menu(props: MenuProps): HTMLElement { const root = h('div', { class: () => `ua-menu${open() ? ' ua-open' : ''}` }, trigger, pop); + // —— 键入快跳缓冲:与 select 的行为保持一致 —— + let typed = ''; // 最近键入的字母串 + let typedAt = 0; // 最近键入时间戳,超 1 秒重置 + const jumpByTyped = (ch: string): void => { + const now = Date.now(); + typed = now - typedAt > 1000 ? ch : typed + ch; // 超时重新起词,否则追加 + typedAt = now; + const at = focusables.indexOf(document.activeElement as HTMLButtonElement); // 当前焦点序号 + const order = focusables.map((_, i) => (at + 1 + i) % focusables.length); // 从下一项开始环形排列 + const hit = order.find((i) => labels[i].toLowerCase().startsWith(typed.toLowerCase())); // 前缀匹配 + if (hit != null) focusables[hit]?.focus(); // 命中即聚焦;无命中留在原地 + }; + root.addEventListener('keydown', (e: KeyboardEvent) => { if (e.key === 'Escape') { open(false); @@ -65,7 +79,10 @@ export function menu(props: MenuProps): HTMLElement { } if (e.key === 'Home' && open()) { e.preventDefault(); focusables[0]?.focus(); return; } // Home 跳首项 if (e.key === 'End' && open()) { e.preventDefault(); focusables[focusables.length - 1]?.focus(); return; } // End 跳末项 - if (e.key !== 'ArrowDown' && e.key !== 'ArrowUp') return; // 卫语句:只接管上下键 + if (e.key !== 'ArrowDown' && e.key !== 'ArrowUp') { + if (open() && e.key.length === 1) jumpByTyped(e.key); // 可打印字符:键入快跳 + return; // 卫语句:其余按键不接管 + } e.preventDefault(); if (!open()) { open(true); diff --git a/packages/skin/ui/ua.manifest.json b/packages/skin/ui/ua.manifest.json index a0d4ad3..e10e3d8 100644 --- a/packages/skin/ui/ua.manifest.json +++ b/packages/skin/ui/ua.manifest.json @@ -21,7 +21,7 @@ "checkbox(props):复选框,checked 信号双向绑定,disabled 支持布尔或信号禁用", "switchButton(props):开关,checked 信号双向绑定,disabled 支持布尔或信号禁用", "select(props):自绘下拉选择(非原生 select),value 信号双向绑定,点外部 / Esc 关闭,选项弹层带微动画,disabled 支持布尔或信号禁用,空间不足自动翻转,键入字母快跳选项", - "menu(props):下拉菜单,触发器 + 自绘弹层,条目支持禁用 / 危险 / 分隔线,↑↓ 环形导航,点外部 / Esc 关闭,空间不足自动翻转", + "menu(props):下拉菜单,触发器 + 自绘弹层,条目支持禁用 / 危险 / 分隔线,↑↓ 环形导航,点外部 / Esc 关闭,空间不足自动翻转,键入字母快跳菜单项", "flip(trigger, panel, preferred):浮层上下翻转判定,按触发器与面板的视口几何决定 preferred 方位放不下时是否翻转,返回实际生效方位 'top' | 'bottom'", "radioGroup(props):单选组,options + value 信号双向绑定,disabled 整组禁用", "accordion(props):折叠面板,标题按钮 + grid 行高过渡,单开(手风琴)或多开,支持禁用面板与 active 信号受控",