ARIA:aria-multiline 属性

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

描述

单行和多行文本字段在按下 EnterReturn 键时的默认行为不同。当用户焦点位于单行 <input type="text"> 时,按下 EnterReturn 键通常会提交表单。

当用户焦点位于多行 <textarea> 中时,按键会插入一个换行符。aria-multiline 属性仅与设置了 textbox 角色的元素相关,它向辅助技术指示该文本框接受多行输入还是仅接受单行输入,从而设定用户输入何种数据以及按键将执行何种操作的预期。

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

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

在设计文本框时,请注意焦点和按键。ARIA 仅修改可访问性树,因此也会改变辅助技术向用户呈现文本框的方式。ARIA 不会改变元素的默认功能或行为。当不使用语义 HTML 元素来实现其预期目的和默认功能时,您必须使用 JavaScript 来管理行为和功能,包括响应按键事件。

true

文本框接受多行输入。

false

文本框仅接受单行输入。

相关接口

Element.ariaMultiLine

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

ElementInternals.ariaMultiLine

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

相关角色

用于角色

继承至角色

规范

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

另见