アクセシブルな名前と説明の算出 1.1

4.1 名前の算出

ユーザーエージェントは、アクセシブルな名前をアクセシブルな名前と説明の算出セクションで示されるルールに従って算出しなければなりません（MUST）。

4.2 説明の算出

aria-describedbyが存在する場合、ユーザーエージェントは、現在の要素のaria-describedby属性で参照される要素のテキスト代替を連結してアクセシブルな説明を算出しなければなりません（MUST）。参照要素のテキスト代替は、下記アクセシブルな名前と説明の算出セクションで示される複数の方法で算出されます。

4.3 アクセシブルな名前と説明の算出

アクセシブルな名前と説明の算出は、アクセシブルな名前とアクセシブルな説明の両方を生成するために使われます。要素やノード、マークアップの組み合わせごとに異なるルールが定められています。テキスト代替は、必要に応じて、要素内の関連コンテンツ全体から構築されます。これはステップ2Bおよび2F（再帰的な処理）で、子要素や参照ノードからテキストを取得するためにすべてのルールを用いて実行されます。

算出の目的は、代替表示のために、スペースで区切られたテキストトークンからなるフラットな文字列として、知覚可能なラベルまたは説明を生成することです。

指定された要素のテキスト代替は以下のように算出します：

1. 初期化：root nodeを指定要素に、current nodeをroot nodeに、total accumulated textを空文字列（""）に設定する。
2. current nodeのテキスト代替を算出する：
   1. current nodeが非表示かつaria-labelledbyやaria-describedby、またはネイティブのテキスト代替要素（例：HTMLのlabel）や属性から直接参照されていない場合は、空文字列を返す。
      補足：

      支援技術は通常、非表示情報を伝達しませんが、著者がaria-labelledbyやaria-describedbyを使って非表示テキストをアクセシブルな名前や説明として明示的に含めることができます。

   2. それ以外の場合：
      • 名前算出時、current nodeがaria-labelledby属性を持ち、少なくとも1つの有効なIDREFが含まれていて、なおかつcurrent nodeがすでにaria-labelledby走査の一部でない場合、そのIDREFを記述順で処理する：
      • または、説明算出時、current nodeがaria-describedby属性を持ち、少なくとも1つの有効なIDREFが含まれていて、なおかつcurrent nodeがすでにaria-describedby走査の一部でない場合、そのIDREFを記述順で処理する：
        1. accumulated textを空文字列に設定。
        2. 各IDREFについて：
           1. current nodeをIDREFで参照されるノードに設定。
           2. current nodeのテキスト代替をステップ2から算出し、resultに設定。
           3. resultをスペース付きでaccumulated textに追加。
        3. accumulated textを返す。
      例：

      以下は「…かつcurrent nodeがすでにaria-labelledby走査の一部でない…」の意味を示す例です。

      • element1のアクセシブルな名前は"hello"です。これは最初のaria-labelledby走査でelement3に到達するためです。
      • element2はアクセシブルな名前を持ちません。算出は最初のaria-labelledby走査でelement1に到達しますが、element1のaria-labelledbyはそれ以降辿りません。

      例1

      <element1 id="el1" aria-labelledby="el3" />
      <element2 id="el2" aria-labelledby="el1" />
      <element3 id="el3"> hello </element3>

   3. それ以外の場合、名前算出時にcurrent nodeがaria-label属性を持ち、その値が空文字列でなく、空白をトリムしても空文字列でない場合：
      • 再帰による走査の場合かつcurrent nodeがステップ2Eで定義される埋め込みコントロールの場合、aria-labelは無視し、規則2Eへ進む。
      • それ以外は、aria-labelの値を返す。
      例：

      以下はaria-labelledbyとaria-labelの相互作用の例です。<span role="button">要素のアクセシブルな名前はそれぞれ"Delete Documentation.pdf"と"Delete HolidayLetter.pdf"です。

      例2

      <h1>Files</h1>
      <ul>
        <li>
          <a id="file_row1" href="./files/Documentation.pdf">Documentation.pdf</a>
          <span role="button" tabindex="0" id="del_row1" aria-label="Delete" aria-labelledby="del_row1 file_row1"></span>
        </li>
        <li>
          <a id="file_row2" href="./files/HolidayLetter.pdf">HolidayLetter.pdf</a>
          <span role="button" tabindex="0" id="del_row2" aria-label="Delete" aria-labelledby="del_row2 file_row2"></span>
        </li>
      </ul>

   4. それ以外の場合、current nodeのネイティブマークアップがテキスト代替となる属性（例：title）や要素（例：HTMLのlabel）を備えていれば、ホスト言語で定義されたflat stringとしてその代替を返す。ただし要素がrole="presentation"やrole="none"であれば除く。
      補足：

      例えば、HTMLではimg要素のalt属性がテキスト代替文字列となり、label要素は参照されるフォーム要素のテキストを提供します。SVG2ではdescやtitle要素が親要素の説明を提供します。

   5. それ以外の場合、current nodeが他のウィジェットのラベル内（例：HTMLのlabel要素や、aria-labelledbyで直接参照される要素）に埋め込まれたコントロールであり、その値をユーザーが調整可能な場合、次の方法で埋め込みコントロールをテキスト代替に含める：
      • 埋め込みコントロールがロールtextboxの場合、その値を返す。
      • 埋め込みコントロールがロールmenubuttonの場合、ボタンのテキスト代替を返す。
      • 埋め込みコントロールがロールcomboboxまたはlistboxの場合、選択されたoptionのテキスト代替を返す。
      • 埋め込みコントロールがロールrange（例：spinbuttonやslider）の場合：
        • aria-valuetextプロパティがあれば、その値を返す。
        • なければaria-valuenowプロパティがあれば、その値を返す。
        • なければホスト言語属性で定義された値を使う。
      例：

      例えば、テキスト入力フィールドを含むチェックボックスラベル「画面をフラッシュ[入力]回」。ユーザーが埋め込みtextboxに"5"と入力した場合、ラベルは「画面をフラッシュ5回」となります。例：

      例3

      <div role="checkbox" aria-checked="false">Flash the screen <span role="textbox" aria-multiline="false"> 5 </span> times</div>

   6. それ以外の場合、current nodeのロールがcontentからの名前を許可している場合、またはcurrent nodeがaria-labelledby、aria-describedby、ネイティブテキスト代替要素（例：HTMLのlabel）、またはその子孫の場合：
      1. accumulated textを空文字列に設定。
      2. CSSで生成されたテキストコンテンツ（:beforeと:after疑似要素）をcurrent nodeに関連付けている場合、それをaccumulated textに含める。
         • :before疑似要素については、ユーザーエージェントは、CSSのテキストコンテンツをスペースなしでcurrent nodeのテキストコンテンツの前に追加しなければなりません（MUST）。
         • :after疑似要素については、ユーザーエージェントは、CSSのテキストコンテンツをスペースなしでcurrent nodeのテキストコンテンツの後ろに追加しなければなりません（MUST）。
      3. current nodeの各子ノードについて：
         1. current nodeを子ノードに設定。
         2. current nodeのテキスト代替をステップ2から算出し、resultに設定。
         3. resultをaccumulated textに追加。
      4. accumulated textを返す。

      重要：サブツリー内の各ノードは一度だけ参照されます。子孫からテキストを収集した場合、他のIDREFから同じ子孫ノードが参照されても2回目以降は辿りません。これは無限ループを防ぐためです。

      補足：

      このステップは子ノード自身にも適用されるため、算出は再帰的であり、current nodeのサブツリーのすべての要素からテキストが収集されます。ただし、子孫ノードのテキスト代替は、上記B〜Dステップの優先度の高いマークアップ（"Namefrom: author"属性）によってサブツリー全体のテキスト代替となる場合もあります。

   7. それ以外の場合、current nodeがテキストノードの場合、そのテキスト内容を返す。
   8. それ以外の場合、current nodeが、アクセシブルな名前やアクセシブルな説明の算出対象要素の子孫であり、かつ子孫を持つ場合は2F.iへ進む。
   9. それ以外の場合、current nodeがツールチップ属性を持つ場合、その値を返す。
      補足：

      ツールチップ属性は、他に結果が得られない場合（サブツリーの内容なども含めて）、のみ使用されます。

   上記各ステップのresultをスペース付きでtotal accumulated textに追加する。

すべてのステップが完了したら、total accumulated textが、算出を開始した要素のアクセシブルな名前またはアクセシブルな説明として利用されます。