Accessible Name and Description Computation 1.2 日本語訳

ルートノード（Root node）

テキストによる代替が検索されるDOMノードまたは要素。

カレントノード（Current node）

root nodeのテキスト同等物を計算するために現に横断したDOMノード。最初は、current nodeがroot nodeであるが、後の段階では、root nodeの子孫か、別の参照されるノードのいずれかになる。

レンダリングされた子ノード（Rendered child nodes）

シャドウルートおよびスロットを考慮する場合に、特定のノードの子ノードとしてレンダリングされるノード。

フラットな文字列（Flat string）

すべてのキャリッジリターン、改行、タブ、およびフォームフィードが単一のスペースに置き換えられ、かつ複数のスペースが単一のスペースにまとめられる文字の文字列。この文字列は文字データのみを含む。マークアップは含まれない。

総累積テキスト（Total accumulated text）

これまでに計算されたテキスト同等物。ただし、current nodeを含めない。

累積テキスト（Accumulated text）

下記のステップまたはステップのシーケンスで累積されたテキスト。これは、下記のステップの一時的なストレージである。

結果（Result）

テキスト同等物は、次に説明するいずれかの手順で計算される。

スペースなしで結果をXに追加する（Append the result, without a space, to X）

• Xが空の場合、resultをXにコピーする。
• Xが空でない場合、resultをXの末尾にコピーする。

スペース付きで結果をXに追加する（Append the result, with a space, to X）

• Xが空の場合、resultをXにコピーする。
• Xが空でない場合、Xの末尾にスペースを追加してから、そのスペースの後へresultをXにコピーする。

スペースなしで結果をXの先頭に追加する（Prepend result, without a space, to X）

• Xが空の場合、resultをXにコピーする。
• Xが空でない場合、resultをXの先頭にコピーする。

スペース付きで結果をXの先頭に追加する（Prepend the result, with a space, to X）

• Xが空の場合、resultをXにコピーする。
• Xが空でない場合、resultをXの先頭にコピーし、そのコピーの後にスペースを追加する。

与えられた要素に対するテキストによる代替は、次のように計算される：

1. Initialization: root nodeを与えられた要素に、current nodeをroot nodeに、そしてtotal accumulated textを空文字列（""）に設定する。root nodeのロールで名前付けが禁止されている場合、空の文字列（""）を返す。
2. Computation: current nodeのテキストによる代替を計算する。
   1. Hidden Not Referenced: current nodeが非表示かつ存在する場合：
      1. aria-labelledbyまたはaria-describedbyトラバーサルの一部ではなく、そのリレーションによって直接参照されるノードが非表示になっていた場合。
      2. ネイティヴホスト言語のテキストによる代替要素（例：HTMLのlabel）または属性トラバーサルの一部でもなく、トラバーサルのルートが非表示になっていた場合。
      空文字列を返す。
      注記

      アクセシブルな名前の計算のために、非表示の広い定義を明確にすることが重要である。

      1. CSSプロパティdisplay:none、visibility:hidden、visibility:collapseまたはcontent-visibility:hiddenを持つノード :これらは、「認識できない」および「明示的に非表示」のガイドラインに一致するため、非表示と見なされる。
      2. CSSプロパティopacity:0もしくはfilter:opacity(0%)、または同様のSVGメカニズムを持つノード：非表示とは見なされない。これらの方法で非表示にされたテキストは、選択またはコピーすることができ、ユーザーエージェントはアクセシビリティツリーでそのテキストを公開する。
      3. aria-hidden="true"プロパティを持つノード：非表示と見なされ、「明示的に非表示」のガイドラインに一致する。
      4. 画面外または別のオブジェクトの背後に隠れているノードは、非表示とは見なされない。これらはアクセシビリティツリーで公開され、画面上のオブジェクトに名前を付けることもできる。
      注記

      デフォルトでは、支援技術は非表示情報を中継しないが、著者はそれを明示的に上書きし、aria-labelledbyまたはaria-describebyを使用することによって、アクセシブルな名前またはアクセシブルな説明の一部として非表示テキストを含めることができる。

   2. LabelledBy: そうでなければ、current nodeが少なくとも1つの有効なIDREFを含むaria-labelledby属性を持ち、かつcurrent nodeがまだ進行中のaria-labelledbyまたはaria-describedbyトラバーサルの一部になっていない場合、そのIDREFを出現順に処理する。
      1. accumulated textを空文字列に設定する。
      2. IDREFごとに：
         1. current nodeをIDREFによって参照されるノードに設定する。
         2. LabelledBy Traversal: 全体のComputationステップから始めて、urrent nodeの代替テキストを計算する。resultをそのテキストによる代替に設定する。
         3. スペース文字とresultをaccumulated textに追加する。
      3. 空文字列（""）でない場合、accumulated textを返す。

      Hidden Not Referencedと組み合わせたLabelledBy Traversalの結果は、aria-labelledbyまたはaria-describedbyによって参照されるノードが非表示の場合、ユーザーエージェントが、サブツリー内のすべてのノードをアクセシブルな名前またはアクセシブルな説明の一部として含めなければならないことを意味する。

   3. Embedded Control: そうでなければ、current nodeが別のウィジェットのラベル内に埋め込まれたコントロール（たとえば、aria-labelledbyによって直接参照される任意の要素）であり、ユーザーが埋め込みコントロールの値を調整できる場合、次の方法で埋め込みコントロールを代替テキストの一部として返す：
      1. Textbox: 埋め込みコントロールがロールtextboxを持つ場合、その値を返す。
      2. Combobox/Listbox: 埋め込みコントロールがロールcomboboxまたはlistboxを持つ場合、選択したoptionの代替テキストを返す。
      3. Range: 埋め込みコントロールがロールに役割rangeを持つ場合（たとえば、spinbutton、slider）：
         1. aria-valuetextプロパティが存在する場合、その値を返す。
         2. そうでなければ、aria-valuenowプロパティが存在する場合、その値を返す。
         3. そうでなければ、ホスト言語属性によって指定される値を使用する。
   4. AriaLabel: そうでなければ、current nodeがslot要素ではなく、かつaria-label属性を持ち、その値が未定義でも、空文字列でも、空白を削除しても空文字列ではない場合：
      1. current nodeのトラバーサルがName From Content descendant node recursionによるものでかつ、current nodeが埋め込みコントロールである場合、aria-labelを無視して規則Embedded Controlへ飛ぶ。
      2. そうでなければ、aria-labelの値を返す。
   5. Host Language Label: そうでなければ、current nodeのネイティヴマークアップが代替テキストを定義する属性（たとえばalt）または要素（たとえば、HTML label、SVG title）を提供する場合、current nodeがプレゼンテーショナル（role="presentation"またはrole="none"、alt=""）として公開されていない限り、ホスト言語によって定義されたflat stringの形式でその代替を返す（たとえばHTML-AAM）。
      注記

      重要！ネイティヴHTML要素のアクセシブルな名前は、ホスト言語によって計算方法が異なる場合がある。詳しくはHTML-AAMを確認すること。
      注記

      たとえば、HTMLにおいて、img要素のalt属性は代替テキストの文字列を定義し、label要素は参照されるフォーム要素のテキストを提供する。SVG2において、desc要素およびtitle要素は、それらの親要素の説明を提供する。

   6. Name From Content: そうでなければ、current node'sの ロールがコンテンツ由来の名前を許可する場合、またはcurrent nodeがaria-labelledby、aria-describedbyによって参照される、もしくはネイティヴホスト言語の代替テキスト要素（たとえばHTMLのlabel）である場合、またはネイティヴホスト言語の代替要素の子孫である場合は、次のようになる：
      1. Name From Content Reset: accumulated textを空文字列に設定する。
      2. Name From Generated Content: current nodeに関連付けられた CSS生成テキストコンテンツを確認して、accumulated textに含める。CSS ::beforeおよび::after擬似要素[CSS2]は、コンテンツモデルを持つ要素に::marker疑似要素を提供できる。
         1. ::marker擬似要素の場合、current nodeが::markerをサポートしている場合、ユーザーエージェントはcurrent nodeのテキストコンテンツの前にスペースなしでCSSテキストコンテンツを付加しなければならない。
         2. ::before擬似要素の場合、ユーザーエージェントは、スペースなしでCSSテキストコンテンツをcurrent nodeのテキストコンテンツの先頭に追加しなければならない。
         3. ::after擬似要素の場合、ユーザーエージェントは、スペースなしでCSSテキストコンテンツをcurrent nodeのテキストコンテンツに追加しなければならない。
      3. Determine Child Nodes: current nodeのrendered child nodesを決定する。
         1. current nodeにシャドウルートがアタッチされている場合、rendered child nodesをシャドウルートの子ノードに設定する。
         2. そうでなければ、current nodeが割り当てられたノードをもつスロットである場合、rendered child nodesをcurrent nodeの割り当てられたノードに設定する。
         3. そうでなければ、rendered child nodesをcurrent nodeの子ノードに設定する。
      4. Name From Each Child: current nodeのrendered child nodeごとに：
         1. current nodeをrendered child nodeに設定する。
         2. 全体のComputationステップで始まるcurrent nodeの代替テキストを計算する。resultをその代替テキストに設定する。
         3. resultをaccumulated textに追加する。
      5. 空文字列（""）でない場合、accumulated textを返す。

      重要：サブツリーの各ノードは一度だけ調べられる。テキストが子孫から収集されたが、いくつかの子孫ノードで別のIDREFによって参照される場合、その2回目以降の参照は行われない。これは、無限ループを避けるために行われる。

      注記

      このステップは子ノード自体にも適用でき、これは計算が再帰的であり、かつcurrent nodeのサブツリー内のすべての要素から収集されるテキストをもたらすことを意味する。ただし、任意の子孫ノードの代替テキストは、上記のステップBからDで説明した優先順位の高いマークアップから生成される可能性がある。この場合、"Namefrom: author"属性は、サブツリー全体の代替テキストを提供する。

      注記

      2024年1月18日：ARIA Working Groupは、current nodeのCSS display値、ならびにその隣接するノードおよび擬似要素に応じて、スペースの有無にかかわらずテキスト文字列を結合することの実現可能性を検討している。現在進行中の議論はAccName #225にある。

   7. Text Node: そうでなければ、current nodeがTextノードである場合、そのテキストのコンテンツを返す。
   8. Recursive Name From Content: そうでなければ、current nodeが、アクセシブルな名前またはアクセシブルな説明が計算されている要素の子孫であり、かつ子孫を含んでいる場合、Name From Content Resetに進む。
   9. Tooltip: そうでなければ、current nodeがツールチップ属性を持つ場合、その値を返す。
      注記

      ツールチップ属性は、サブツリーのコンテンツを含めて他に何も結果を提供できない場合にのみ、使用される。

   10. スペース文字および上記の各ステップのresultをtotal accumulated textに追加する。
3. すべてのステップが完了した後、total accumulated textは、計算を開始した要素のアクセシブルな名前またはアクセシブルな説明として使用される。