aria-multiline

aria-multiline 属性指示 textbox 是否接受多行输入或仅接受单行输入。

描述

EnterReturn 键的默认行为在单行和多行文本字段之间有所不同。当用户焦点在单行 <input type="text"> 中时,EnterReturn 键击通常会提交表单。

当用户焦点在多行 <textarea> 中时,键击会插入换行符。仅适用于设置了 textbox 角色的元素,aria-multiline 属性指示辅助技术该文本框是接受多行输入还是仅接受单行输入,从而设定对输入数据类型的期望以及这些键击将执行的操作。

注意: 尽可能使用 HTML <input><textarea>,因为它们具有内置的语义和行为,不需要 ARIA 属性或脚本,并且内置了键盘支持。

如果设置了 aria-multiline="true",则表示文本框小部件将接受输入中的换行符,类似于 HTML <textarea>。角色为 textbox 但没有该属性或其值为 false 的元素是简单的文本框。

在设计文本框时请注意焦点和键击。ARIA 仅修改无障碍树,因此辅助技术向您的用户展示文本框的方式会有所不同。ARIA 不会更改元素的默认功能或行为。在不按预期用途和默认功能使用语义 HTML 元素时,您必须使用 JavaScript 来管理行为和功能,包括响应键击事件。

true

文本框接受多行输入。

false

文本框仅接受单行输入。

关联接口

Element.ariaMultiLine

ariaMultiLine 属性是 Element 接口的一部分,反映 aria-multiline 属性的值。

ElementInternals.ariaMultiLine

ariaMultiLine 属性是 ElementInternals 接口的一部分,反映 aria-multiline 属性的值。

关联角色

用于的角色

继承到角色

规范

规范
无障碍富互联网应用程序 (WAI-ARIA)
# aria-multiline

另请参阅