26 lines
3.5 KiB
Markdown
26 lines
3.5 KiB
Markdown
---
|
||
'@g3soft/ui': minor
|
||
---
|
||
|
||
G3Table 键盘：方向键显式分工（左右归输入框、上下给表格导航）、Enter 确认并下移、多行编辑器回车换行。
|
||
|
||
**单击格仍直接进入编辑** —— 本组件的既有交互不变，这次只调整键盘分工与几处不符习惯的行为。
|
||
|
||
- **方向键显式分工**。此前方向键**全部**被输入框吃掉（编辑器一挂上就聚焦），想改中间一位时整格跳走、想换行时又只能靠 Tab —— 两个方向都别扭。现在：
|
||
- **左右** → 交给输入框移动光标 / `Shift+左右` 选中文本（编辑文本的刚需，不能让出去）；
|
||
- **上下**（单行）→ **让给表格**导航，切到上 / 下一行的同一列**并进入编辑**（单行输入框里上下键没有任何原生用途，让出去是零损失）；
|
||
- `Shift+上下` → 仍归输入框（原生语义是「选中到首尾」）；
|
||
- `textarea` 里的上下 → 仍归输入框（要跨行移动光标）。
|
||
- ⚠️ 左右不能让给表格：同一个键不可能既移光标又切格。横向切换用 `Tab`（它还会跳过只读列，比按列 ±1 更贴合录入语境）。
|
||
- **Enter（单行）= 确认 + 下移到下一行同列**（Excel / Sheets / AG Grid / Handsontable 的通行约定）。
|
||
- 旧行为是 `preventDefault` + `select()` —— **全选文本，且不提交**。它既不是浏览器行为（单行 `input` 的 Enter 原生是「提交表单 / 无动作」，**不换行**），也不是表格软件的行为，而且「确认」这个动作整个缺失：改完按回车值还没落库。
|
||
- 下一行同一列若是只读列、或那一行被按行禁用 → **跳过**，落到下面第一个可编辑格；到表尾 → **停在原地**（不循环回表头：回车一路按到底突然跳回第一行会很意外）。
|
||
- ⚠️ 实现上必须**显式提交**当前值：移动会让编辑器 vnode 卸载，而 DOM 元素被移除时浏览器**不派发 blur**（做日期编辑器时踩过这个坑），只靠 `onBlur` 的话敲完按回车值就丢了。
|
||
- **Enter（`type: 'textarea'`）= 换行**（浏览器原生语义）。此前多行与单行共用同一段 `onKeydown` 且没按类型分流，导致备注这类多行格**按回车会把整段文本全选掉、根本换不了行**。
|
||
- **`Esc` 会退出编辑态并把焦点还给该格**。此前它只让输入框失焦，而编辑态是**行级**的、那一行仍停在编辑态（表现是「Esc 一下没反应」）；更要紧的是焦点掉到 `body` —— 之后按方向键完全不经过表格，等于键盘失灵。
|
||
- **checkbox 补上 `Space` 切换**（原生 checkbox 的切换键）；`Enter` 保留（表格用户的既有期待，连续录入时手不离 Enter）。此前只认 Enter。
|
||
- **`date` 编辑器**按同一套分工：左右归输入框（日期是文本，用户会想改其中一段），上下给导航。
|
||
- 配套：playground 新增 `table-keys-wrap` 小表（text / number / textarea 三列，行高给足以容纳多行编辑器）作为宿主 —— `table-wrap` 的列序被 Tab 跳格用例逐格锁着，且它里面没有多行编辑器，锁不住「单行 / 多行 Enter 语义不同」这条区分。
|
||
- e2e 新增 7 条：方向键分工 5 条（单击即编辑 / 上下切行 / 左右移光标 / `Shift+左右` 选文本 / `textarea` 跨行）、Enter 单行确认下移、Enter 多行换行。方向键那几条断言的是**光标真的动了 / 选区真的变了**，而不只是「没跳格」。
|
||
- 文档新增「键盘：单击即编辑，方向键分工」一节。
|