# 打字练习模式(细记) - 捕获:2026-10-10 23:40(UTC+8),课节 Lesson 1,整句练习 + 显示图片开 - progress.mode:`typing`;题量 **17**(整句/cardCut 级,非拆句 62 格) ## 提示区 - 英文按字符/词块展示待输入内容(如 `W a k e …`),下方有 IPA、词性、句法(如「谓语(短语动词)」) - 中文翻译行(如「起床啦!早上好。」) - 可选课节配图(`practice-image`,OSS webp) - 输入:**打字练习输入框**(单行) ## 屏幕键盘 - 容器类:`typing-keyboard-frame` → `typing-keyboard typing-keyboard--letters` - 行:`typing-keyboard-row` - 键:`typing-key` + `is-letter`;空白宽键 `is-blank is-wide`(Backspace/Shift 等) - 标签:`typing-key-main` 内字符(含 Space 行) ### 高亮规则(观察,未故意打错) | 状态 class | 含义 | |---|---| | `is-active` | 当前应敲的键(与待输入下一字符一致,如 W) | | (未触发) | 文档未记录 `is-wrong` 等;错误反馈可能为音效 + 输入框状态 | ## 手型 / 指法 SVG - 基础手:`https://www.tanqudao.com/typing-hands/Right.svg` → `assets/typing-hands-Right.svg` - 当前键手型:`https://www.tanqudao.com/typing-hands/KeyW.svg`(目标键为 W 时)→ `assets/typing-hands-KeyW.svg` - DOM:`img.typing-hand-image`,与键盘并排;**命名规则**推测为 `/typing-hands/Key{大写键名}.svg`(字母键),非字母键待补 - SVG 内容:灰度手轮廓 + 蓝色描边高亮对应手指区域(KeyW 为右手食指段) 指法映射未在前端 DOM `data-finger` 暴露;指法引导依赖 **手型图切换 + 键盘 is-active** 双重提示。 ## 快捷键(打字专用) 见 `-app-game.md`:无 Ctrl+Q / ↓↑ 答案条;**空格 = 隐藏答案**。 ## 相关接口 - `POST /api/practice/progress` mode=`typing` - 音效:`/api/sound-effects` → `typing.defaultUrl` 等 - 课文:`GET /api/lesson-sheet`(整句时 row 为 cardCut 整句,见 `-api-lesson-sheet.md` 样例)