ARIA の状態とプロパティ

ARIA の状態とプロパティには、4 つのカテゴリーがあります。

1. ウィジェット属性

   • aria-autocomplete
   • aria-checked (en-US)
   • aria-disabled
   • aria-errormessage
   • aria-expanded (en-US)
   • aria-haspopup (en-US)
   • aria-hidden (en-US)
   • aria-invalid (en-US)
   • aria-label
   • aria-level
   • aria-modal (en-US)
   • aria-multiline
   • aria-multiselectable (en-US)
   • aria-orientation (en-US)
   • aria-placeholder (en-US)
   • aria-pressed (en-US)
   • aria-readonly (en-US)
   • aria-required (en-US)
   • aria-selected (en-US)
   • aria-sort (en-US)
   • aria-valuemax (en-US)
   • aria-valuemin (en-US)
   • aria-valuenow (en-US)
   • aria-valuetext (en-US)

2. ライブリージョン属性

   • aria-busy (en-US)
   • aria-live (en-US)
   • aria-relevant (en-US)
   • aria-atomic

3. ドラッグ＆ドロップ属性

   • aria-dropeffect (en-US)
   • aria-grabbed

4. リレーションシップ属性

   • aria-activedescendant
   • aria-colcount (en-US)
   • aria-colindex
   • aria-colspan (en-US)
   • aria-controls (en-US)
   • aria-describedby
   • aria-description (en-US)
   • aria-details (en-US)
   • aria-errormessage
   • aria-flowto (en-US)
   • aria-labelledby
   • aria-owns (en-US)
   • aria-posinset (en-US)
   • aria-rowcount (en-US)
   • aria-rowindex (en-US)
   • aria-rowspan (en-US)
   • aria-setsize (en-US)

いくつかの状態やプロパティは、ARIA ロールが適用されているかどうかに関係なく、すべての HTML 要素に適用されます。これらは『グローバル』属性として定義されます。グローバル状態やプロパティは、すべてのロールや基本マークアップ要素で対応しています。

上記の属性の多くはグローバルで、特に禁止されていない限り、どの要素にも含めることができます。

• aria-atomic
• aria-busy (en-US)
• aria-controls (en-US)
• aria-current (en-US)
• aria-describedby
• aria-description (en-US)
• aria-details (en-US)
• aria-disabled
• aria-dropeffect (en-US)
• aria-errormessage
• aria-flowto (en-US)
• aria-grabbed
• aria-haspopup (en-US)
• aria-hidden (en-US)
• aria-invalid (en-US)
• aria-keyshortcuts (en-US)
• aria-label
• aria-labelledby
• aria-live (en-US)
• aria-owns (en-US)
• aria-relevant (en-US)
• aria-roledescription (en-US)

「特に禁止」とは、上記の属性がすべてグローバルであることを意味します。ただし、aria-label および aria-labelledby プロパティは、ロール presentation またはその同義語 none ロールでは禁止されています。

以下は、MDN で取り上げた WAI-ARIA の状態やプロパティに応じたリファレンスページです。

aria-activedescendant

aria-activedescendant 属性は、composite (en-US) ウィジェット、combobox (en-US)、textbox、group、applicationにフォーカスが当たっている時、現在アクティブな要素を特定します。

aria-atomic

ARIA ライブリージョンにおいて、グローバルな aria-atomic 属性は、aria-relevant (en-US) 属性で定義された変更通知に基づいて、スクリーンリーダーなどの支援技術が変更された領域をすべて表示するのか、一部だけを表示するのかを示します。

aria-autocomplete

aria-autocomplete 属性は、 combobox (en-US), searchbox (en-US), textbox において、テキスト入力がユーザーの意図する値の一つ以上の予測を発生させるかどうかを示し、発生した場合にどのように予測を表示するかを指定します。

aria-colindex

aria-colindex 属性は table、grid、treegrid 内の全列数に対する要素の列インデックスまたは位置を定義します。

aria-describedby

aria-describedby はグローバル属性で、その属性が設定されている要素を説明する要素（複数可）を特定します。

aria-disabled

aria-disabled 状態は、要素は知覚可能であるが無効であり、編集やその他の操作をすることができないことを示します。

aria-errormessage

オブジェクトの aria-errormessage 属性は、そのオブジェクトのエラーメッセージを表示する要素を特定します。

aria-grabbed

aria-grabbed の状態は、ドラッグ＆ドロップ処理で要素が「つかまれた」状態を示します。

aria-label

aria-label 属性は対話型要素にラベル付けする文字列値を定義します。

aria-labelledby

aria-labelledby 属性は、適用される要素のラベル付けを行う要素（複数可）を識別します。

aria-level

aria-level 属性は、構造内の要素の階層レベルを定義します。

aria-multiline

aria-multiline 属性は textbox が複数行の入力を受け入れるか、単一の行のみを受け入れるかを示します。

• ARIA の使用: ロール、ステート、プロパティ