diff options
author | Wind1808 <42607060+Wind1808@users.noreply.github.com> | 2021-07-15 00:05:08 +0900 |
---|---|---|
committer | GitHub <noreply@github.com> | 2021-07-15 00:05:08 +0900 |
commit | e90e80856baf145c1c677d1afda14ca103a3beb9 (patch) | |
tree | ac0b309e35e8e812efb267e311bcfe7914ed7c8c | |
parent | 8ffdcbc556ea949c0212554ec2b7d75d4a5828dc (diff) | |
download | translated-content-e90e80856baf145c1c677d1afda14ca103a3beb9.tar.gz translated-content-e90e80856baf145c1c677d1afda14ca103a3beb9.tar.bz2 translated-content-e90e80856baf145c1c677d1afda14ca103a3beb9.zip |
Web/Accessibility/ARIA/Roles/Search_role の更新 (#1433)
* ARIA: search ロールの更新
* ARIA: search ロールの更新
-rw-r--r-- | files/ja/web/accessibility/aria/roles/search_role/index.html | 68 |
1 files changed, 36 insertions, 32 deletions
diff --git a/files/ja/web/accessibility/aria/roles/search_role/index.html b/files/ja/web/accessibility/aria/roles/search_role/index.html index df6ac80cd3..d0bab247b2 100644 --- a/files/ja/web/accessibility/aria/roles/search_role/index.html +++ b/files/ja/web/accessibility/aria/roles/search_role/index.html @@ -7,43 +7,41 @@ tags: - Accessibility translation_of: Web/Accessibility/ARIA/Roles/Search_role --- -<p>\{{ariaref}}</p> - -<p><span class="seoSummary"><code>search</code> <a href="/ja/docs/Web/Accessibility/ARIA/ARIA_Techniques#Landmark_roles">ランドマークロール</a>は、ページ、サイト、またはサイトのコレクションを検索するために使用されるページのセクションを識別するために使用されます。</span></p> +<p><span class="seoSummary">検索 (<code>search</code>) <a href="/ja/docs/Web/Accessibility/ARIA/ARIA_Techniques#landmark_roles">ランドマークロール</a>は、ページ、サイト、またはサイトのコレクションの検索に使用されるページのセクションを識別するために使用します。</span></p> <pre class="brush: html"><form role="search"> <!-- 検索入力 --> </form> </pre> -<h2 id="Description" name="Description">説明</h2> +<h2 id="Description">説明</h2> -<p><code>search</code> ロールは<a href="/ja/docs/Web/Accessibility/ARIA/ARIA_Techniques#Landmark_roles">ランドマーク</a>です。 ランドマークは、支援技術によって使用され、文書の大きなセクションを迅速に識別してナビゲートすることができます。 <code>search</code> ロールは、全体として結合して検索(search)機能を作成するアイテムおよびオブジェクトを包含するコンテナ要素に追加します。 <code><form></code> が検索フォームの場合、<code><a href="/ja/docs/Web/Accessibility/ARIA/Roles/Form_Role">form</a></code> ロールの代わりに <code>search</code> ロールを使用します。 文書に複数の検索が含まれている場合、それぞれに固有のラベルを持つべきです。 <a href="/ja/docs/Web/HTML/Element/input/search"><code>search</code> 型の <code><input></code> 要素</a>があるなら、<code>search</code> ランドマークを定義する HTML 要素があります。</p> +<p>検索 (<code>search</code>) ロールは、<a href="/ja/docs/Web/Accessibility/ARIA/ARIA_Techniques#landmark_roles">ランドマーク</a>です。 ランドマークは、支援技術によって使用され、文書の大きなセクションを素早く識別してナビゲートすることができます。 検索 (<code>search</code>) ロールは、全体として組み合わせて検索機能を作成する項目およびオブジェクトを含むコンテナー要素に追加します。 <code><form></code> が検索フォームの場合、フォーム (<code><a href="/ja/docs/Web/Accessibility/ARIA/Roles/Form_Role">form</a></code>) ロールの代わりに検索 (<code>search</code>) ロールを使用します。 文書に複数の検索が含まれている場合、それぞれに固有のラベルを持つべきです。 <a href="/ja/docs/Web/HTML/Element/input/search"><code>search</code> 型の <code><input></code> 要素</a>はありますが、検索ランドマークを定義する HTML 要素はありません。</p> -<h2 id="Examples" name="Examples">例</h2> +<h2 id="Examples">例</h2> -<pre><span class="tag"><form id="search" role="search"> -</span> <label for="search-input">このサイトを検索</label> +<pre class="brush: html"><form id="search" role="search"> + <label for="search-input">このサイトを検索</label> <input type="search" id="search-input" name="search" spellcheck="false"> <input value="検索する" type="submit"> -<span class="tag"></form></span> +</form> </pre> -<h2 id="Accessibility_concerns" name="Accessibility_concerns">アクセシビリティに関する懸念</h2> +<h2 id="Accessibility_concerns">アクセシビリティに関する懸念</h2> -<p><a href="/ja/docs/Web/Accessibility/ARIA/ARIA_Techniques#Landmark_roles">ランドマークロール</a>は、文書のより大きな全体的なセクションを識別するために、控えめに使用することを意図しています。 あまりにも多くのランドマークロールを使用すると、スクリーンリーダーで「ノイズ」が発生し、ページ全体のレイアウトを理解することが難しくなります。</p> +<p><a href="/ja/docs/Web/Accessibility/ARIA/ARIA_Techniques#landmark_roles">ランドマークロール</a>は、文書のより大きな全体的なセクションを識別するために、控えめに使用することを意図しています。 あまりにも多くのランドマークロールを使用すると、スクリーンリーダーで「ノイズ」が発生し、ページ全体のレイアウトを理解することが難しくなります。</p> -<h2 id="Best_practices" name="Best_practices">ベストプラクティス</h2> +<h2 id="Best_practices">ベストプラクティス</h2> -<h3 id="Prefer_HTML" name="Prefer_HTML">好ましい HTML</h3> +<h3 id="Prefer_HTML">好ましい HTML</h3> -<p>{{htmlelement("form")}} 要素を <code>role="search"</code> の宣言とともに使用すると、最大限のサポートが得られます。</p> +<p><a href="/ja/docs/Web/HTML/Element/form"><code><form></code> 要素</a>を検索ロール (<code>role="search"</code>) の宣言と共に使用することで、最大限のサポートが提供されます。</p> -<h3 id="Labeling_landmarks" name="Labeling_landmarks">ランドマークのラベル付け</h3> +<h3 id="Labeling_landmarks">ランドマークのラベル付け</h3> -<h4 id="Multiple_landmarks" name="Multiple_landmarks">複数のランドマーク</h4> +<h4 id="Multiple_landmarks">複数のランドマーク</h4> -<p>文書に複数の <code>search</code> ランドマークロールがある場合は、各ランドマークに対してラベルを指定します。 このラベルで、支援技術のユーザーがそれぞれのランドマークの目的をすばやく理解することができます。</p> +<p>文書内に複数の検索 (<code>search</code>) ランドマークロールがある場合は、各ランドマークにラベルを付けます。 このラベルで、支援技術のユーザーがそれぞれのランドマークの目的を素早く理解することができます。</p> <pre class="brush: html"><form id="site-search" role="search" aria-label="サイト全体"> <!-- 検索入力 --> @@ -56,12 +54,12 @@ translation_of: Web/Accessibility/ARIA/Roles/Search_role </form> </pre> -<h4 id="Repeated_landmarks" name="Repeated_landmarks">繰り返されるランドマーク</h4> +<h4 id="Repeated_landmarks">繰り返されるランドマーク</h4> -<p>文書内の <code>search</code> ランドマークロールが文書内で繰り返され、両方のランドマークのコンテンツが同じ場合は、各ランドマークに同じラベルを使用します。 この例では、ページの上部と下部でサイト全体の検索が繰り返されています。</p> +<p>文書内で検索 (<code>search</code>) ランドマークロールが繰り返され、両方のランドマークのコンテンツが同じ場合は、各ランドマークに同じラベルを使用します。 この例では、ページの上部と下部でサイト全体の検索が繰り返されています。</p> <pre class="brush: html"><header> - <form id="site-search" role="search" aria-label="サイト全体"> + <form id="site-search-top" role="search" aria-label="サイト全体"> <!-- 検索入力 --> </form> </header> @@ -69,25 +67,25 @@ translation_of: Web/Accessibility/ARIA/Roles/Search_role ... <footer> - <form id="site-search" role="search" aria-label="サイト全体"> + <form id="site-search-bottom" role="search" aria-label="サイト全体"> <!-- 検索入力 --> </form> </footer> </pre> -<h4 id="Redundant_descriptions" name="Redundant_descriptions">冗長な説明</h4> +<h4 id="Redundant_descriptions">冗長な説明</h4> -<p>スクリーンリーダーは、ランドマークロールの種類をアナウンスします。 このため、ラベルでランドマークが何であるかを説明する必要はありません。 例えば、<code>aria-label="サイト全体の検索"</code> の <code>role="search"</code> の宣言は、"search サイト全体の検索" として重複してアナウンスすることができます。</p> +<p>スクリーンリーダーは、ランドマークロールの種類をアナウンスします。 このため、ラベルでランドマークが何であるかを説明する必要はありません。 例えば、<code>aria-label="サイト全体の検索"</code> を使用した検索ロール (<code>role="search"</code>) の宣言は、「サイト全体の検索検索」として重複してアナウンスされることがあります。</p> -<h3 id="Added_benefits" name="Added_benefits">追加された利点</h3> +<h3 id="Added_benefits">追加された利点</h3> -<p>ブラウザー拡張などの特定の技術は、ページ上に存在する全てのランドマークロールのリストを生成することができ、非スクリーンリーダーユーザーは文書の大きなセクションを素早く識別してナビゲートできます。</p> +<p>ブラウザー拡張などの特定の技術は、ページ上に存在する全てのランドマークロールのリストを生成することができ、スクリーンリーダーを使用していないユーザーでも文書の大きなセクションを素早く識別してナビゲートできます。</p> <ul> - <li><a href="http://matatk.agrip.org.uk/landmarks/">ランドマークブラウザー拡張</a>(英語)</li> + <li><a href="https://matatk.agrip.org.uk/landmarks/">ランドマークブラウザー拡張</a>(英語)</li> </ul> -<h2 id="Specifications" name="Specifications">仕様</h2> +<h2 id="Specifications">仕様</h2> <table class="standard-table"> <tbody> @@ -106,17 +104,23 @@ translation_of: Web/Accessibility/ARIA/Roles/Search_role </tbody> </table> -<h2 id="Screen_reader_support" name="Screen_reader_support">スクリーンリーダーのサポート</h2> +<h2 id="Screen_reader_support">スクリーンリーダーのサポート</h2> <p>TBD</p> -<h2 id="See_also" name="See_also">関連情報</h2> +<h2 id="See_also">関連情報</h2> <ul> - <li>{{htmlelement("form")}}: フォーム要素</li> + <li><a href="/ja/docs/Web/HTML/Element/form"><form>: フォーム要素</a></li> <li><a href="/ja/docs/Web/HTML/Element/input/search"><input type="search"></a></li> - <li><a href="/ja/docs/Web/HTML/Sections_and_Outlines_of_an_HTML5_document">HTML5 ドキュメントのセクションとアウトライン</a></li> - <li><a href="/ja/docs/Web/Accessibility/ARIA/ARIA_Techniques#Landmark_roles">ランドマークロール: ARIA を使用する: ロール、ステート、プロパティ</a></li> + <li><a href="/ja/docs/orphaned/Web/Guide/HTML/Using_HTML_sections_and_outlines">HTML のセクションとアウトラインの使用</a></li> + <li><a href="/ja/docs/Web/Accessibility/ARIA/ARIA_Techniques#landmark_roles">ランドマークロール: ARIA を使用する: ロール、ステート、プロパティ</a></li> <li><a href="https://developer.paciellogroup.com/blog/2013/02/using-wai-aria-landmarks-2013/">Using WAI-ARIA Landmarks – 2013 | The Paciello Group</a></li> <li><a href="https://www.scottohara.me/blog/2018/03/03/landmarks.html">Accessible Landmarks | scottohara.me</a></li> </ul> + +<section id="Quick_links"> + <ol> + <li><a href="/ja/docs/Web/Accessibility/ARIA/Roles"><strong>WAI-ARIA ロール</strong></a>{{ListSubpagesForSidebar("/ja/docs/Web/Accessibility/ARIA/Roles")}}</li> + </ol> +</section> |