このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
ARIA: complementary ロール
補足 (complementary)ランドマークロールは、メインコンテンツに関連する補助セクションを指定するために使用され、しかも分離しても単独で成り立つことができます。 これらのセクションは、サイドバーやコールアウトボックスとして表示されることがよくあります。 可能であれば、代わりに HTML の<aside> 要素を使用してください。
<div role="complementary"> <h2>私たちのパートナー</h2> <!-- 補足的なセクションのコンテンツ --></div>これはイベントのスポンサーへのリンクを含むサイドバーです。
In this article
説明
補足 (complementary) ロールはランドマークロールです。 ランドマーク (landmark) は、支援技術によって使用され、文書の大きなセクションを迅速に識別してナビゲートすることができます。 補足 (complementary) ランドマークロールを持つコンテナー内にリストされたコンテンツは、文書のメインのコンテンツから分離されている場合でも意味をなすべきです。
メモ:<aside> 要素を使用すると、自動的にセクションが補足 (complementary) ロールを持つことを伝えます。 開発者は、ARIA を使用するよりも正しい意味論の HTML 要素を常に使用するべきです。
例
<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>アクセシビリティに関する懸念
ランドマークロールは、文書のより大きな全体的なセクションを識別するために、控えめに使用することを意図しています。 あまりにも多くのランドマークロールを使用すると、スクリーンリーダーで「ノイズ」が発生し、ページ全体のレイアウトを理解することが難しくなります。
ベストプラクティス
>好ましい HTML
<aside> 要素を使用すると、自動的にセクションが補足 (complementary) ロールを持つことを伝えます。 可能であれば、それを代わりに使用することをお勧めします。
ランドマークのラベル付け
複数のランドマーク
文書に複数の補足 (complementary) ランドマークロールや<aside> 要素がある場合は、各ランドマークにaria-label 属性を使用してラベルを付けるか、それらに適切な説明的なタイトルがある場合は、aria-labelledby 属性を使用してそれを指してください。 このラベルで、支援技術のユーザーがそれぞれのランドマークの目的をすばやく理解できるようになります。
<aside aria-label="使用上の注意"> <!-- コンテンツ --></aside>...<aside aria-label="スポンサー"> <!-- コンテンツ --></aside>冗長な説明
スクリーンリーダーは、ランドマークロールの種類をアナウンスします。 このため、ラベルでランドマークが何であるかを説明する必要はありません。 例えば、aria-label="サイドバー" のrole="complementary" の宣言は、"complementary サイドバー" として重複してアナウンスされることがあります。
追加された利点
ブラウザー拡張などの特定の技術は、ページ上に存在する全てのランドマークロールのリストを生成することができ、非スクリーンリーダーユーザーでも文書の大きなセクションを素早く識別してナビゲートできます。
- ランドマークブラウザー拡張 (英語)
仕様書
| Specification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA)> # complementary> |
| Unknown specification> |
スクリーンリーダーのサポート
TBD
関連情報
<aside>: 余談要素- complementary (role): Accessible Rich Internet Applications (WAI-ARIA) 1.1
- HTML のセクションとアウトラインの使用
- ランドマークロール: ARIA を使用する: ロール、ステート、プロパティ
- Using WAI-ARIA Landmarks – 2013 | The Paciello Group
- Accessible Landmarks | scottohara.me
- Aside Revisited | HTML5 Doctor
- WAI-ARIA ロール
alertdialog ロールの使用ARIA: alert ロールARIA: application ロールARIA: article ロールARIA: banner ロールARIA: button ロールARIA: cell ロールARIA: checkbox ロールARIA: columnheader ロールARIA: combobox ロールARIA: command ロールARIA: comment ロールARIA: complementary ロールARIA: composite ロールARIA: contentinfo ロールARIA: definition ロールARIA: dialog ロールARIA: directory ロール非推奨;ARIA: document ロールARIA: feed ロールARIA: figure ロールARIA: form ロールARIA: generic ロールARIA: grid ロールARIA: gridcell ロールARIA: heading ロールARIA: img ロールARIA: input ロールARIA: landmark ロールARIA: list ロールARIA: listbox ロールARIA: listitem ロールARIA: main ロールARIA: mark ロールARIA: marquee ロールARIA: math ロールARIA: menu ロールARIA: menubar ロールARIA: menuitem ロールARIA: menuitemcheckbox ロールARIA: menuitemradio ロールARIA: meter ロールARIA: navigation ロールARIA: none ロールARIA: option ロールARIA: radio ロールARIA: radiogroup ロールARIA: range ロールARIA: region ロールARIA: roletype ロールARIA: row ロールARIA: rowgroup ロールARIA: rowheader ロールARIA: scrollbar ロールARIA: search ロールARIA: searchbox ロールARIA: section ロールARIA: sectionhead ロールARIA: select ロールARIA: separator ロールARIA: spinbutton ロールARIA: structure ロールARIA: suggestion ロールARIA: switch ロールARIA: tab ロールARIA: table ロールARIA: tablist ロールARIA: tabpanel ロールARIA: term ロールARIA: textbox ロールARIA: timer ロールARIA: tooltip ロールARIA: tree ロールARIA: treegrid ロールARIA: treeitem ロールARIA: widget ロールARIA: window ロールARIA: 文書構造ロールgroup ロールの使用link ロールの使用log ロールの使用presentation ロールの使用progressbar ロールの使用slider ロールの使用status ロールの使用toolbar ロールの使用