aria-orientation

aria-orientation 属性は、要素の方向が水平、垂直、または不明/曖昧であることを示します。

解説

方向は上下左右の矢印キーを押した際に予想される動作に影響を与えるため、ユーザーが特定のウィジェットをナビゲートする方法を知るには、方向を知ることが重要になる場合があります。aria-orientation 属性は、要素の方向が horizontalverticalundefined のいずれであるかを支援技術ユーザーに示すために使用されます。

いくつかのウィジェットにはデフォルトの方向があります:

デフォルトで水平です:

デフォルトで垂直です:

それぞれの separatoraria-orientation はセパレーターの方向と一致している必要があります。

ツリー内のノードがデフォルトの垂直方向ではなく水平に配置されている場合、またはタブリストがデフォルトの水平方向ではなく垂直である場合、下矢印キーは通常の右矢印キーとして機能し、上矢印キーは通常の左矢印キーとして機能します。これらの場合、支援技術のユーザーは正しく移動するためにウィジェットの方向を知る必要があります。

フォーカスがツリーまたはタブリスト内にある場合でも、上矢印キーと下矢印キーは通常のブラウザースクロールで使用できます。ウィジェットがデフォルトの想定された方向と関連するナビゲーションを持たない場合にユーザーに警告できるようにするために、aria-orientation を含めます。

ARIA は支援技術がユーザーにコンテンツを提示する方法のみを変更することを常に覚えておいてください。矢印キーの動作を変更するには JavaScript が必要です。

horizontal

要素は水平方向に配置されます。

undefined (既定値)

要素の方向が不明/曖昧です。

vertical

要素は垂直方向に配置されます。

関連インターフェイス

Element.ariaOrientation

Element インターフェイスの一部である ariaOrientation プロパティは、aria-orientation 属性の値を反映します。

ElementInternals.ariaOrientation

ElementInternals インターフェイスの一部である ariaOrientation プロパティは、aria-orientation 属性の値を反映します。

関連付けられたロール

使用するロール:

継承先のロール:

仕様書

Specification
Accessible Rich Internet Applications (WAI-ARIA)
# aria-orientation

関連情報