enterkeyhint 是 HTML input/textarea 的原生属性,用于提示移动端软键盘回车键文案(如 search、send),仅影响 UI 不改变逻辑;Chrome≥77、Edge≥79、Samsung Internet 和 Safari≥16.4 支持,Firefox 不支持,iOS Safari 在 textarea 上常失效。

enterkeyhint 是什么,哪些浏览器支持
enterkeyhint 是 HTML <input> 和 <textarea> 元素的原生属性,用于向移动端软键盘提示“回车键”应显示什么文案(如 search、send、go 等)。它不改变表单提交行为,只影响软键盘 UI。
目前仅在 Chromium 内核浏览器(Chrome ≥ 77、Edge ≥ 79、Samsung Internet)和 Safari ≥ 16.4 中有效;Firefox 完全不支持,且 iOS Safari 在 <textarea> 上常忽略该属性。
别指望它触发逻辑——它只是提示,不是事件钩子。想监听“发送”动作,仍得靠 keydown 捕获 Enter 或监听 submit。
可用值及对应软键盘文案效果
enterkeyhint 的合法值是枚举字符串,不同值会触发系统键盘渲染不同文字或图标(实际表现取决于 OS 和输入法):
立即学习“前端免费学习笔记(深入)”;
• enter:默认回车符号(↵),多数场景下 fallback 行为
• done:常显示“完成”或勾号,适合单行编辑后收起键盘
• go:多见于地址栏或跳转场景,如“前往”
• next / previous:用于表单字段间导航,键盘显示箭头
• previous:部分 Android 键盘显示“上一项”
• search:触发搜索图标或“搜索”文字,配合 type="search" 更可靠
• send:常见于 IM 输入框,键盘显示“发送”
注意:enterkeyhint="send" 在微信内置浏览器中基本无效;iOS 上 search 值在 type="search" 时最稳定,其他值可能退化为 enter。
如何正确设置并避免常见失效原因
直接写在标签里即可,无需 JS 动态设置(但 JS 可通过 element.enterKeyHint 读取):
<input type="search" enterkeyhint="search" placeholder="搜点什么..."> <input type="text" enterkeyhint="send" aria-label="消息输入"> <textarea enterkeyhint="done"></textarea>
容易踩的坑:
• enterkeyhint 必须搭配 type 合理使用:比如 type="search" + enterkeyhint="search" 组合成功率最高;type="text" + enterkeyhint="send" 在部分安卓机型上可能被忽略
• 不要和 inputmode 冲突:例如 inputmode="numeric" 会强制数字键盘,此时 enterkeyhint 几乎无效
• iOS Safari 对 <textarea> 的 enterkeyhint 支持极差,建议单行场景优先用 <input type="text">
• 属性名大小写敏感,写成 EnterKeyHint 或 enterKeyHint 在 HTML 中无效(仅 JS 属性访问时用驼峰)
替代方案:当 enterkeyhint 不生效时怎么办
如果目标环境兼容性要求高(比如需覆盖微信、旧版 iOS),不能只依赖 enterkeyhint:
• 用 type="search" 替代 type="text":即使不走搜索逻辑,也能提升 enterkeyhint="search" 触发率
• 配合 CSS 强制单行 + resize: none + overflow: hidden 模拟 textarea 行为,再用 <input> 承载 enterkeyhint
• 在 submit 事件或 keydown 中识别 event.key === 'Enter' 并阻止默认行为,手动触发发送/搜索逻辑——这才是真正可控的部分
• 微信内嵌浏览器可尝试 confirm-type(非标准,仅部分版本响应),但不可靠,不推荐作为主路径
软键盘文案终究是提示,不是契约。能显示“发送”最好,显示不了 ↵ 也得确保 Enter 键逻辑正常——后者才是用户真正需要的。



















