アクセシブルな名前および説明の算出 1.2

ルートノード

テキスト代替が求められるDOMのノードまたは要素。

現在ノード

root nodeのテキスト等価物を算出するために現在たどられているDOMのノード。初期状態では、current nodeは root nodeであるが、後の段階では root nodeの何らかの子孫、または別の参照されたノードのいずれかである。

レンダリングされた子ノード

ノードは、 シャドウ ルートおよびスロットを考慮したときに、 与えられたノードの子ノードとしてレンダリングされるものである。

平坦な文字列

すべての復帰、改行、タブ、および改ページが単一の空白に置き換えられ、 複数の空白が単一の空白に削減された文字の文字列。その文字列は 文字データのみを含み、いかなるマークアップも含まない。

合計蓄積テキスト

current nodeを含まないところまで算出されたテキスト等価物。

蓄積テキスト

下記で説明されるステップまたは一連のステップで蓄積されたテキスト。それは それらのステップのための一時的な記憶領域である。

結果

下記で説明されるいずれかのステップで算出されたテキスト等価物。

結果を、空白なしで、Xに追加する

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

結果を、空白付きで、Xに追加する

• Xが空の場合、resultをXにコピーする。
• Xが空でない場合、Xの末尾に空白を追加し、その空白の後にresultを Xにコピーする。

結果を、空白なしで、Xの前に追加する

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

結果を、空白付きで、Xの前に追加する

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

与えられた要素のテキスト代替は次のように算出される:

1. 初期化: root nodeを与えられた 要素に、current nodeを root nodeに、total accumulated textを空文字列（""）に設定する。 root nodeのロールが名前付けを禁止する場合、空文字列（""）を返す。
2. 算出: current nodeのテキスト代替を算出する:
   1. 参照されていない非表示: 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-describedbyを使用することにより、 非表示テキストを アクセシブルな 名前またはアクセシブルな説明の一部として 含めることができる。

   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探索: 算出ステップ全体から開始して、 current nodeの テキスト代替を算出する。resultをそのテキスト代替に設定する。
         3. 空白文字および resultをaccumulated textに追加する。
      3. accumulated textが 空文字列（""）でない場合、それを返す。

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

   3. 埋め込みコントロール: そうでない場合で、 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の子孫 ノード再帰によるものであり、かつ current nodeが埋め込みコントロールである場合、aria-labelを無視し、 規則埋め込みコントロールへ進む。
      2. そうでない場合、aria-labelの値を返す。
   5. ホスト言語ラベル: そうでない場合で、 current nodeのネイティブマークアップがテキスト代替を定義する 属性（例: alt）または要素（例: HTMLのlabelまたはSVGのtitle）を提供する場合、 ホスト言語によって定義される flat stringの形式でその代替を返す（例: HTML-AAM）。ただし、 current nodeが提示的（role="presentation" またはrole="none"、alt=""）として公開される場合を除く。
      注

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

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

   6. コンテンツからの名前: そうでない場合で、 current nodeのロールが コンテンツからの 名前を許可する場合、またはcurrent nodeが aria-labelledby、aria-describedbyにより参照される場合、または ネイティブホスト言語のテキスト代替要素（例: HTMLにおけるlabel）である場合、または ネイティブホスト言語のテキスト代替要素の子孫である場合:
      1. コンテンツからの名前のリセット: accumulated textを空文字列に設定する。
      2. 生成コンテンツからの名前: current nodeに関連付けられた CSS生成テキストコンテンツを確認し、それを accumulated textに含める。 CSSの::before および::after疑似要素 [CSS2] は、コンテンツモデルを持つ要素に対して、 ::marker 疑似要素に加えて、テキストコンテンツを提供できる。
         1. ::marker疑似要素について、ユーザーエージェントは、 current nodeが::markerをサポートする場合、 CSSテキストコンテンツを、空白なしで、 current nodeのテキストコンテンツの前に追加しなければ MUSTならない。
         2. ::before疑似要素について、ユーザーエージェントは CSSテキストコンテンツを、空白なしで、 current nodeのテキストコンテンツの前に追加しなければ MUSTならない。
         3. ::after疑似要素について、ユーザーエージェントは CSSテキストコンテンツを、空白なしで、 current nodeのテキストコンテンツに追加しなければ MUSTならない。
      3. 子ノードの決定: current nodeの rendered child nodesを決定する:
         1. current nodeにシャドウ ルートが付随している場合、rendered child nodesを シャドウ ルートの子ノードに設定する。
         2. そうでない場合で、current nodeがslotであり、割り当てられた ノードを持つ場合、rendered child nodesを current nodeの割り当てられた ノードに設定する。
         3. そうでない場合、 rendered child nodesを current nodeの子ノードに設定する。
      4. 各子からの名前: current nodeの各 rendered child nodeについて:
         1. current nodeを rendered child nodeに設定する。
         2. 算出ステップ全体から開始して、 current nodeのテキスト代替を算出する。 resultをそのテキスト代替に設定する。
         3. resultを accumulated textに追加する。
      5. accumulated textが 空文字列（""）でない場合、それを返す。

      重要: サブツリー内の各ノードは一度だけ調べられる。 子孫からテキストが収集されているが、何らかの子孫ノード内の別のIDREFにより参照される場合、 その2番目または後続の参照はたどられない。これは 無限ループを避けるために行われる。

      注

      このステップは子ノード自身に適用される場合がある。これは、算出が再帰的であり、 current nodeのサブツリー内のすべての要素から、 それがどれほど深くても、収集されたテキストを結果とすることを意味する。しかし、任意の与えられた子孫 ノードのテキスト代替は、 上記のステップBからDで説明された、より高い優先順位のマークアップに由来し得る。 そこでは、"Namefrom: author"属性がサブツリー全体のテキスト代替を提供する。

      注

      2024年1月18日: ARIA作業部会は、 current node、ならびにその隣接ノードおよび疑似要素の CSS display値に応じて、 テキスト文字列を空白ありまたは空白なしで結合する実現可能性を検討している。 進行中の議論はAccName #225にある。

   7. テキストノード: そうでない場合で、current nodeが テキストノードである場合、 そのテキスト内容を返す。
   8. 再帰的なコンテンツからの名前: そうでない場合で、 current nodeが、 アクセシブルな名前またはアクセシブルな 説明が算出されている要素の子孫であり、かつ子孫を含む場合、 コンテンツからの名前のリセットへ進む。
   9. ツールチップ: そうでない場合で、current nodeが ツールチップ属性を持つ場合、 その値を返す。
      注

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

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