ARIA: complementary ロール

{{ariaref}}complementary ランドマークロールは、メインコンテンツに関連する補助セクションを指定するために使用され、しかも分離しても単独で成り立つことができます。 これらのセクションは、サイドバーやコールアウトボックスとして表示されることがよくあります。 可能であれば、代わりに HTML の <aside> 要素を使用してください。

<div role="complementary">
  <h2>私たちのパートナー</h2>
  <!-- 補完的なセクションのコンテンツ -->
</div>

これはイベントのスポンサーへのリンクを含むサイドバーです。

complementary ロールはランドマークロールです。 ランドマーク（landmark）は、支援技術によって使用され、文書の大きなセクションを迅速に識別してナビゲートすることができます。 complementary ランドマークロールを持つコンテナ内にリストされたコンテンツは、文書のメインのコンテンツから分離されている場合でも意味をなすべきです。

<div role="complementary">
  <h2>トレンド記事</h2>
  <ul>
     <li><a href="#">あなたがすべての気分を感じさせる18のツイート</a></li>
     <li><a href="#">私は完璧な昼食用の容器を見つけたので、それを探すのを停止する</a></li>
     <li><a href="#">最終的に私たちがこれらの食品と呼ぶべきものを決定する時が来た</a></li>
     <li><a href="#">Tumblr で今週見た17の本当に良い投稿</a></li>
     <li><a href="#">10の親のハック、私たちはそれらを試したので、働くことを知っている</a></li>
   </ul>
 </div>

ランドマークロールは、文書のより大きな全体的なセクションを識別するために、控えめに使用することを意図しています。 あまりにも多くのランドマークロールを使用すると、スクリーンリーダーで「ノイズ」が発生し、ページ全体のレイアウトを理解することが難しくなります。

<aside> 要素を使用すると、自動的にセクションが complementary ロールを持つことを伝えます。 可能であれば、それを代わりに使用することをお勧めします。

複数のランドマーク

文書に複数の complementary ランドマークロールや <aside> 要素がある場合は、各ランドマークに aria-label 属性を使用してラベルを付けるか、それらに適切な説明的なタイトルがある場合は、aria-labelledby 属性を使用してそれを指してください。 このラベルで、支援技術のユーザーがそれぞれのランドマークの目的をすばやく理解できるようになります。

<aside aria-label="使用上の注意">
  <!-- コンテンツ -->
</aside>

...

<aside id="sidebar" aria-label="スポンサー">
  <!-- コンテンツ -->
</aside>

冗長な説明

スクリーンリーダーは、ランドマークロールの種類をアナウンスします。 このため、ラベルでランドマークが何であるかを説明する必要はありません。 例えば、 aria-label="サイドバー" の role="complementary" の宣言は、"complementary サイドバー" として重複してアナウンスすることができます。

ブラウザー拡張などの特定の技術は、ページ上に存在する全てのランドマークロールのリストを生成することができ、非スクリーンリーダーユーザーはドキュメントの大きなセクションを素早く識別してナビゲートできます。

• ランドマークブラウザー拡張（英語）

TBD

• <aside>: 余談要素
• complementary (role): Accessible Rich Internet Applications (WAI-ARIA) 1.1
• HTML5 ドキュメントのセクションとアウトライン
• ランドマークロール: ARIA を使用する: ロール、ステート、プロパティ
• Using WAI-ARIA Landmarks – 2013 | The Paciello Group
• Accessible Landmarks | scottohara.me
• Aside Revisited | HTML5 Doctor