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 |