initial commit

1 files changed, 113 insertions, 0 deletions

diff --git a/files/ja/web/accessibility/aria/roles/listitem_role/index.html b/files/ja/web/accessibility/aria/roles/listitem_role/index.html
new file mode 100644
index 0000000000..02c85295f2
--- /dev/null
+++ b/files/ja/web/accessibility/aria/roles/listitem_role/index.html
@@ -0,0 +1,113 @@
+---
+title: 'ARIA: listitem ロール'
+slug: Web/Accessibility/ARIA/Roles/Listitem_role
+tags:
+  - ARIA
+  - ARIA Role
+  - Accessibility
+translation_of: Web/Accessibility/ARIA/Roles/Listitem_role
+---
+<div>\{{ariaref}}</div>
+
+<p class="summary">ARIAの <code>listitem</code> ロールは、項目のリスト内の項目を識別するために使用できます。 これは、通常、リストコンテナを識別するために使用される <code>list</code> ロールとともに使用されます。</p>
+
+<pre class="brush: html">&lt;section role="list"&gt;
+  &lt;div role="listitem"&gt;リスト項目 1&lt;/div&gt;
+  &lt;div role="listitem"&gt;リスト項目 2&lt;/div&gt;
+  &lt;div role="listitem"&gt;リスト項目 3&lt;/div&gt;
+&lt;/section&gt;
+</pre>
+
+<h2 id="Description" name="Description">説明</h2>
+
+<p>外側のコンテナとその内側の要素のリストで構成されるコンテンツは、それぞれ <code>list</code> と <code>listitem</code> のコンテナを使用して支援技術で識別できます。</p>
+
+<p>リストとリスト項目をマークアップするためにどの要素を使用すべきかについて、鉄則はありませんが、リスト項目がリストのコンテキストで意味をなすようにするべきです。 例えば、買い物リスト、料理の手順、運転の指示。</p>
+
+<div class="warning">
+<p><strong>警告</strong>: 可能な限り、適切な意味論の HTML 要素を使用して、<code>list</code> とその <code>listitem</code>（{{htmlelement("ul")}} や {{htmlelement("ol")}} と {{htmlelement("li")}}）をマークアップする必要があります。 詳しくは、{{anch("Best practices","ベストプラクティス")}}を参照してください。</p>
+</div>
+
+<h3 id="Associated WAI-ARIA Roles, States, and Properties" name="Associated WAI-ARIA Roles, States, and Properties">関連する WAI-ARIA のロール、ステート、プロパティ</h3>
+
+<dl>
+ <dt><a href="/ja/docs/Web/Accessibility/ARIA/Roles/List_role">list</a></dt>
+ <dd>
+ <p>項目のリスト。 <code>list</code> ロールを持つ要素には、子として <code>listitem</code> ロールを持つ1つ以上の要素、<code>group</code> ロールを持つ1つ以上の要素が必要です。 <code>group</code> ロールを持つ要素は、子として listitem ロールを持つ1つ以上の要素を持ちます。</p>
+ </dd>
+ <dt><a href="/ja/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_group_role">group</a></dt>
+ <dd>
+ <p>リストにネストされたときにリスト項目に限定される関連オブジェクトのコレクションです。 ページの目次に独自の場所を持つほど重要ではありません。</p>
+ </dd>
+</dl>
+
+<h3 id="Keyboard Interactions" name="Keyboard Interactions">キーボードインタラクション</h3>
+
+<p>無し</p>
+
+<h3 id="Required_JavaScript_features" name="Required_JavaScript_features">必要な JavaScript 機能</h3>
+
+<p>無し</p>
+
+<h2 id="Examples" name="Examples">例</h2>
+
+<p> <a href="https://www.scottohara.me/blog/2018/05/26/aria-lists.html">ARIA Lists</a> — Scott O'Hara によるいくつかの有用な例と考え（英語）</p>
+
+<h2 id="Best_practices" name="Best_practices">ベストプラクティス</h2>
+
+<p>例えば、HTML を制御できないが、JavaScript を使用した後でアクセシビリティを動的に向上させる必要がある場合など、<code>role="list"</code> と <code>role="listitem"</code> のみを使用する必要があります。</p>
+
+<p>可能な限り、適切な意味論の HTML 要素を使用して、<code>list</code> と <code>listitem</code>（{{htmlelement("ol")}} や {{htmlelement("ul")}} と {{htmlelement("li")}}）をマークアップする必要があります。 例えば、上記の例は次のように書き直すべきです。</p>
+
+<pre class="brush: html">&lt;ul&gt;
+  &lt;li&gt;リスト項目 1&lt;/li&gt;
+  &lt;li&gt;リスト項目 2&lt;/li&gt;
+  &lt;li&gt;リスト項目 3&lt;/li&gt;
+&lt;/ul&gt;</pre>
+
+<p>リスト項目の順序が重要な場合は、順序付きリストを使用します。</p>
+
+<pre class="brush: html">&lt;ol&gt;
+  &lt;li&gt;リスト項目 1&lt;/li&gt;
+  &lt;li&gt;リスト項目 2&lt;/li&gt;
+  &lt;li&gt;リスト項目 3&lt;/li&gt;
+&lt;/ol&gt;</pre>
+
+<div class="note">
+<p><strong>注</strong>: ARIA の <code>list</code> ロールと <code>listitem</code> ロールでは、順序付きリストと順序無しリストを区別しません。</p>
+</div>
+
+<div class="note">
+<p><strong>注</strong>: タブ付きインターフェースとして機能する項目のリストをマークアップする場合は、代わりに <code>tab</code>、<code>tabpanel</code>、<code>tablist</code> ロールを使用するべきです。</p>
+</div>
+
+<h2 id="Specifications" name="Specifications">仕様</h2>
+
+<table class="standard-table">
+ <tbody>
+  <tr>
+   <th scope="col">仕様</th>
+   <th scope="col">状態</th>
+  </tr>
+  <tr>
+   <td>{{SpecName("ARIA","#listitem","listitem")}}</td>
+   <td>{{Spec2('ARIA')}}</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Screen_reader_support" name="Screen_reader_support">スクリーンリーダーのサポート</h2>
+
+<p>TBD</p>
+
+<h2 id="See_also" name="See_also">関連情報</h2>
+
+<ul>
+ <li><a href="https://wicg.github.io/aom/spec/">Accessibility Object Model</a></li>
+ <li><a href="https://w3c.github.io/html-aria/">ARIA in HTML</a></li>
+ <li><span class="ILfuVd yZ8quc">HTML </span>{{htmlelement("li")}} 要素</li>
+ <li><span class="ILfuVd yZ8quc">HTML </span>{{htmlelement("ul")}} 要素</li>
+ <li><span class="ILfuVd yZ8quc">HTML </span>{{htmlelement("ol")}} 要素</li>
+ <li><a href="/ja/docs/Web/Accessibility/ARIA/Roles/List_role">ARIA: list ロール</a></li>
+ <li><a href="/ja/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_group_role">ARIA: group ロール</a></li>
+</ul>