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