用途:提供一个可直接嵌入的 iOS QWERTY 键盘片段,配合消息类组件(如 create-chatgpt-mockup、create-imessage-mockup)在视频中展示打字画面。键盘固定在屏幕底部,由所属组件用 transform: translateY(...) 负责上滑/下滑。
主要能力:模块导出 renderKeyboardHTML 与 renderKeyboardCSS。renderKeyboardHTML 接收建议词数组(最多三条,默认 ['I', 'The', "I'm"])与 layout(qwerty-lower、qwerty-upper、numbers),返回单个根 div.ios-keyboard 片段;renderKeyboardCSS 读取 templates/keyboard.css 返回带作用域的样式。片段按顺序包含建议栏、三行字母键、底部行与系统条;用户输入经 HTML 转义。
使用方式:const { renderKeyboardHTML, renderKeyboardCSS } = require('./generate'); 生成 HTML 后,将 renderKeyboardCSS() 放入页面 style 块注入一次。无构建步骤,仅依赖 Node 的 fs/path。本地预览可运行:node render.js --out /tmp/kb.html --suggestions 'I,The,I'''m'。
限制:纯静态,无按键弹起动画、无 emoji 面板、无大写锁定切换;layout 仅改变显示,切换由所属组件决定;未知 layout 会静默回退为 qwerty-lower;建议词超过三条会挤压布局;未注入 CSS 则不显示样式;templates/keyboard.css 缺失会抛 ENOENT;render.js 未传 --out 会打印用法并以退出码 1 结束。