HTML enterkeyhint 全局属性

Baseline 已广泛支持

此功能已得到良好确立,可在多种设备和浏览器版本上运行。自⁨2021 年 11 月⁩起,所有浏览器均已提供此功能。

enterkeyhint 全局属性是一个 枚举型 属性,用于定义在虚拟键盘上显示的“回车”键的标签(或图标)。

试一试

<input enterkeyhint="go" />

<p contenteditable enterkeyhint="go">https://example.org</p>

描述

(例如 <textarea><input> 元素)的 表单控件 或使用 contenteditable 的元素可以指定一个 inputmode 属性来控制将使用哪种类型的虚拟键盘。为了进一步改善用户体验,可以通过提供 enterkeyhint 属性来专门定制“回车”键,指示“回车”键应该显示什么标签(或哪个图标)。“回车”键通常表示用户下一步应该执行的操作;典型操作包括:发送文本、插入新行或搜索。

如果没有提供 enterkeyhint 属性,用户代理可能会使用 inputmodetypepattern 属性的上下文信息来显示合适的“回车”键标签(或图标)。

enterkeyhint 属性是一个 枚举型 属性,并且只接受以下值:

描述 示例标签(取决于用户代理和用户语言)
enterkeyhint="enter" 通常用于插入新行。 return,
enterkeyhint="done" 通常表示没有更多需要输入的内容,输入法编辑器(IME)将关闭。 done,
enterkeyhint="go" 通常表示将用户引导至其输入文本的目标。 go, 🡢
enterkeyhint="next" 通常将用户引导至下一个可接受文本输入的字段。 next,
enterkeyhint="previous" 通常将用户引导至上一个可接受文本输入的字段。 return,
enterkeyhint="search" 通常将用户引导至搜索其输入文本结果的页面。 search, 🔍
enterkeyhint="send" 通常将文本传递给目标。 send

规范

规范
HTML
# attr-enterkeyhint

浏览器兼容性

另见

  • 反映此属性的 HTMLElement.enterKeyHint 属性
  • inputmode 全局属性
  • contenteditable 全局属性
  • <input> 元素上的 typepattern 属性