ARIA1の翻訳#1155
Open
tsmd wants to merge 15 commits into
Open
Conversation
momdo
reviewed
Aug 14, 2025
Co-authored-by: Momdo Nakamura <xmomdo@gmail.com>
Co-authored-by: Momdo Nakamura <xmomdo@gmail.com>
Co-authored-by: Momdo Nakamura <xmomdo@gmail.com>
Co-authored-by: Momdo Nakamura <xmomdo@gmail.com>
Co-authored-by: Momdo Nakamura <xmomdo@gmail.com>
Co-authored-by: Momdo Nakamura <xmomdo@gmail.com>
Co-authored-by: Momdo Nakamura <xmomdo@gmail.com>
Co-authored-by: Momdo Nakamura <xmomdo@gmail.com>
Co-authored-by: Momdo Nakamura <xmomdo@gmail.com>
Co-authored-by: Momdo Nakamura <xmomdo@gmail.com>
Contributor
Author
Member
|
@tsmd 問題ありませんので、主査レビューに回します。 |
Contributor
Author
bakera
reviewed
May 2, 2026
| <p>The purpose of this technique is to demonstrate how to use the WAI-ARIA <a href="https://www.w3.org/TR/wai-aria-1.2/#aria-describedby"><code class="language-html">aria-describedby</code></a> property to provide programmatically determined, descriptive information about a user interface element. The <code class="language-html">aria-describedby</code> property may be used to attach descriptive information to one or more elements through the use of an <code class="language-html">id</code> reference list. The <code class="language-html">id</code> reference list contains one or more unique element <code class="language-html">id</code>s.</p> | ||
| <p>Refer to <a href="https://www.w3.org/TR/html-aria/">ARIA in HTML</a> for information on how to provide WAI-ARIA States and Properties with HTML. WAI-ARIA States and Properties are compatible with other languages as well; refer to documentation in those languages.</p> | ||
| <h2>解説</h2> | ||
| <p>このテクニックの目的は、プログラムによる解釈がされる、ユーザインタフェース要素に関する説明的な情報を提供するために、どのように WAI-ARIA <a href="https://www.w3.org/TR/wai-aria-1.2/#aria-describedby"><code class="language-html">aria-describedby</code></a> プロパティを使用するかを示すことにある。<code class="language-html">aria-describedby</code> プロパティは、<code class="language-html">id</code> 参照リストの使用を通して一つ以上の要素の説明的情報と結びつけるために使用してもよいものである。<code class="language-html">id</code> 参照リストは、一つ以上のユニークな要素 <code class="language-html">id</code> を含む。</p> |
Contributor
There was a problem hiding this comment.
may be used を「使用してもよい」としていますが、意味がわかりにくいように思いました。
ちなみに、WCAG 2.2本体の用語集にある "which may be used by people" は現在の訳では「利用者が使用することがある」とされています。
こちらも「使用されることがある」というくらいで良いのではないでしょうか。
Suggested change
| <p>このテクニックの目的は、プログラムによる解釈がされる、ユーザインタフェース要素に関する説明的な情報を提供するために、どのように WAI-ARIA <a href="https://www.w3.org/TR/wai-aria-1.2/#aria-describedby"><code class="language-html">aria-describedby</code></a> プロパティを使用するかを示すことにある。<code class="language-html">aria-describedby</code> プロパティは、<code class="language-html">id</code> 参照リストの使用を通して一つ以上の要素の説明的情報と結びつけるために使用してもよいものである。<code class="language-html">id</code> 参照リストは、一つ以上のユニークな要素 <code class="language-html">id</code> を含む。</p> | |
| <p>このテクニックの目的は、プログラムによる解釈がされる、ユーザインタフェース要素に関する説明的な情報を提供するために、どのように WAI-ARIA <a href="https://www.w3.org/TR/wai-aria-1.2/#aria-describedby"><code class="language-html">aria-describedby</code></a> プロパティを使用するかを示すことにある。<code class="language-html">aria-describedby</code> プロパティは、<code class="language-html">id</code> 参照リストの使用を通して一つ以上の要素の説明的情報と結びつけるために使用されることがある。<code class="language-html">id</code> 参照リストは、一つ以上のユニークな要素 <code class="language-html">id</code> を含む。</p> |
| <p class="note-title marker">注記</p> | ||
| <div> | ||
| <p>The <code class="language-html">aria-describedby</code> property is not designed to reference descriptions on an external resource - since it is an <code class="language-html">id</code>, it must reference an element in the same <abbr title="Document Object Model">DOM</abbr> document.</p> | ||
| <p><code class="language-html">aria-describedby</code> プロパティは、外部リソース上の説明を参照するように設計されていない――これは <code class="language-html">id</code> なので、同一 <abbr title="Document Object Model">DOM</abbr> 文書内の要素を参照しなければならない。</p> |
Contributor
There was a problem hiding this comment.
since 以降がちょっと変な感じがします。since はその後全体にかかっているはずで、
「IDだから、同一DOMを参照しなければならない」
ではなく、
「IDであり、同一DOMを参照しなければならないから」
ではないでしょうか。
Suggested change
| <p><code class="language-html">aria-describedby</code> プロパティは、外部リソース上の説明を参照するように設計されていない――これは <code class="language-html">id</code> なので、同一 <abbr title="Document Object Model">DOM</abbr> 文書内の要素を参照しなければならない。</p> | |
| <p><code class="language-html">aria-describedby</code> プロパティは、外部リソース上の説明を参照するように設計されていない――これは <code class="language-html">id</code> であり、同一 <abbr title="Document Object Model">DOM</abbr> 文書内の要素を参照しなければならないためである。</p> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #477
ARIA1の翻訳です。
raw.githack.com
https://raw.githack.com/waic/wcag22/tsmd-ARIA1/techniques/aria/ARIA1.html
@momdo
レビューをお願いします。
「このテクニックについて」末尾の文章は新規に訳を起こしました。
現行訳の訳注1および2は不要になっていると判断し追加しませんでした。