enterkeyhint 是 input/textarea 的提示属性,用于建议软键盘回车键文案,但非强制生效;仅对移动端软键盘有效,ios 旧版支持差,需配合 type 使用且不支持中文。

enterkeyhint 是什么,为什么改不了回车键文案
enterkeyhint 是 HTML <input> 和 <textarea></textarea> 的原生属性,用来向软键盘(尤其是移动端)建议“回车键”应显示什么文字或图标,比如 "send"、"search"、"go"、"done" 等。但它不是强制改写文案的指令——浏览器和输入法有最终决定权,尤其 iOS Safari 对该属性支持有限,常忽略 enterkeyhint="send" 仍显示“搜索”或“前往”。
常见错误现象:
– 设置了 enterkeyhint="send",但微信内置浏览器/旧版 iOS 仍显示“搜索”
– 混用 type="search" 和 enterkeyhint="go",结果被 type 覆盖优先级
– 在 PC 浏览器上测试,根本看不到效果(该属性仅对软键盘生效)
哪些值有效,哪些会被忽略
合法值只有标准枚举值,非标准字符串(如 "发送"、"submit")会被浏览器静默降级为默认行为(通常是 "enter" 或根据 type 推断)。有效值包括:
-
"enter":通用回车(多数场景默认) -
"done":表示输入完成,常触发收起键盘 -
"go":跳转到目标页,适合 URL 输入 -
"next"/"previous":表单内焦点切换 -
"previous":同上,但部分 Android 键盘不识别 -
"search":强制显示“搜索”,兼容性最好(iOS/Android 均较稳定)
注意:enterkeyhint 不支持中文字符串;设成 "发送" 等会失效,退回到浏览器默认逻辑。
怎么配合 type 属性让提示更可靠
enterkeyhint 的实际表现高度依赖 type。例如:
-
<input type="search" enterkeyhint="search">→ 几乎总显示“搜索”(iOS/Android 都稳) -
<input type="text" enterkeyhint="send">→ Android Chrome 可能显示“发送”,但 iOS Safari 通常无视,仍显示“搜索”或“前往” -
<input type="url" enterkeyhint="go">→ 更大概率触发“前往”,因type="url"本身已暗示跳转语义 -
<textarea enterkeyhint="send"></textarea>→ 在聊天类 App 内嵌 WebView 中较容易生效(如企业微信、飞书)
关键原则:不要单独押注 enterkeyhint,优先选匹配业务语义的 type,再用 enterkeyhint 做增强。比如搜索框用 type="search" + enterkeyhint="search",比强行用 type="text" + enterkeyhint="search" 可靠得多。
真要“发送”文案,还有没有兜底方案
纯前端无法 100% 强制修改软键盘按钮文案,但可结合行为引导提升体验:
- 监听
keydown事件捕获Enter键,手动触发发送逻辑(e.key === "Enter"),避免用户误以为按钮无效 - 在输入框右侧加一个固定
<button>发送</button>,视觉上补全操作预期(尤其 iOS 用户习惯点按钮而非等键盘变化) - 若在 WebView 场景(如安卓 App 内嵌),可通过 JSBridge 调用原生 API 设置软键盘 action label(需客户端支持)
- 避免在
contenteditable元素上使用enterkeyhint—— 它不支持该属性,设了也无效
最易被忽略的一点:iOS 16.4+ 才开始较完整支持 enterkeyhint,低于此版本基本靠 type 驱动。上线前务必用真机(特别是 iPhone 旧系统)验证,模拟器不可信。











