ARIA:aria-orientation 属性

aria-orientation 属性用于指示元素的朝向是水平、垂直还是未知/不确定。

描述

了解朝向对于用户如何导航某些控件可能很重要,因为朝向会影响左、右、上、下箭头键的预期行为。aria-orientation 属性用于向辅助技术用户指示元素的朝向是 horizontal(水平)还是 vertical(垂直),或者 undefined(未定义)。

一些控件默认具有朝向

默认水平

默认垂直

每个 separator 都应该具有与其朝向一致的 aria-orientation

当树中的节点排列成水平方向而不是默认的垂直方向,或者当标签列表是垂直的而不是默认的水平方向时,向下箭头键的功能将如同通常的向右箭头键,向上箭头键的功能将如同通常的向左箭头键。在这些情况下,辅助技术用户需要了解控件的朝向以便正确导航。

向上和向下箭头键通常可用于正常的浏览器滚动,即使焦点位于树或标签列表中。包含 aria-orientation 可以让用户在控件不具有默认预期朝向及相关导航时得到通知。

请始终记住,ARIA 仅会修改辅助技术向用户呈现内容的方式;更改箭头键的行为需要 JavaScript。

horizontal

该元素朝向为水平。

undefined(默认值)

该元素的朝向未知/不确定。

vertical

该元素朝向为垂直。

相关接口

Element.ariaOrientation

ariaOrientation 属性是 Element 接口的一部分,它反映了 aria-orientation 属性的值。

ElementInternals.ariaOrientation

ariaOrientation 属性是 ElementInternals 接口的一部分,它反映了 aria-orientation 属性的值。

相关角色

用于角色

继承到角色

规范

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

另见