ARIA:aria-multiline 属性
aria-multiline
属性指示 textbox
是否接受多行输入,还是仅接受单行输入。
描述
单行和多行文本字段在按下 Enter 或 Return 键时的默认行为不同。当用户焦点位于单行 <input type="text"> 时,按下 Enter 或 Return 键通常会提交表单。
当用户焦点位于多行 <textarea>
中时,按键会插入一个换行符。aria-multiline
属性仅与设置了 textbox
角色的元素相关,它向辅助技术指示该文本框接受多行输入还是仅接受单行输入,从而设定用户输入何种数据以及按键将执行何种操作的预期。
注意: 尽可能使用 HTML 的 <input>
或 <textarea>
元素,因为它们具有内置的语义和行为,不需要 ARIA 属性或脚本,并且内置了键盘支持。
如果设置了 aria-multiline="true"
,则表示该文本框控件将接受输入中的换行符,类似于 HTML 的 <textarea>
。角色为 textbox
且没有该属性,或值为 false
的元素是简单的文本框。
在设计文本框时,请注意焦点和按键。ARIA 仅修改可访问性树,因此也会改变辅助技术向用户呈现文本框的方式。ARIA 不会改变元素的默认功能或行为。当不使用语义 HTML 元素来实现其预期目的和默认功能时,您必须使用 JavaScript 来管理行为和功能,包括响应按键事件。
值
相关接口
Element.ariaMultiLine
-
Element
接口的一部分ariaMultiLine
属性反映了aria-multiline
属性的值。 ElementInternals.ariaMultiLine
-
ElementInternals
接口的一部分ariaMultiLine
属性反映了aria-multiline
属性的值。
相关角色
用于角色
继承至角色
规范
规范 |
---|
无障碍富互联网应用程序 (WAI-ARIA) # aria-multiline |