Accessible Name and Description Computation 1.1 日本語訳

4.1 名前計算

ユーザーエージェントは、下記のアクセシブルな名前および説明の計算の節で概説される規則を使用して、アクセシブルな名前を計算しなければならない。

4.2 説明計算

aria-describedbyが存在する場合、ユーザエージェントは、現在の要素のaria-describeby属性によって参照される要素のテキストによる代替を連結することによってアクセシブルな説明を計算しなければならない。参照される要素のテキストによる代替は、アクセシブルな名前および説明の計算の節で概説される複数の方法を使用して計算される。

4.3 アクセシブルな名前および説明計算

アクセシブルな名前および説明の計算は、アクセシブルな名前とアクセシブルな説明の両方を生成するために使用される。複数の異なる種類の要素、ノード、およびマークアップの組み合わせに対して提供される異なる規則が存在する。適切な場合、テキストによる代替は、要素内に含まれるすべての関連コンテンツから構築される。これは、テキスト自身が参照する自身の子またはノードからテキストを検索するための規則の完全なセットを使用して、再帰的なステップ2Bおよび2Fを経て達成される。

計算の目的は、スペースで区切られたテキストトークンのフラットな文字列の形式で、代替プレゼンテーション用の知覚可能なラベルまたは説明を作成することである。

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

1. 初期化する：root nodeを与えられた要素に、current nodeをroot nodeに、そしてtotal accumulated textを空文字列（""）に設定する。
2. current nodeのテキストによる代替を計算する：
   1. current nodeが非表示であり、かつaria-labelledbyまたはaria-describebyによって直接参照されない場合、もしくはネイティヴホスト言語のテキストによる代替要素（HTMLのlabelなど）または属性によって直接参照されない場合、空文字列を返す。
      コメント：

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

   2. そうでなければ：
      • 名前を計算して、current nodeが少なくとも1つの妥当なIDREFを含むaria-labelledby属性を持ち、かつcurrent nodeがまだaria-labelledbyトラバーサルの一部でない場合、そのIDREFを発生順に処理する：
      • または、説明を計算して、current nodeが少なくとも1つの妥当なIDREFを含むaria-describedby属性を持ち、かつcurrent nodeがまだaria-describedbyトラバーサルの一部でない場合、そのIDREFを発生順に処理する：
        1. accumulated textを空文字列に設定する。
        2. IDREFごとに：
           1. current nodeをIDREFによって参照されるノードに設定する。
           2. ステップ2から始めて、current nodeのテキストによる代替を計算する。result結果をそのテキストによる代替に設定する。
           3. スペース付きでresultをaccumulated textに追加する。
        3. accumulated textを返す。
      例：

      次の例は、「…かつcurrent nodeがまだaria-labelledbyトラバーサルの一部でない…」という句の意味を示している。

      • element1のアクセシブルな名前は"hello"である。これは、そのaria-labelledbyの最初のトラバースであり、element3につながるためである。
      • element2はアクセシブルな名前を持たない。計算は、element1につながるaria-labelledbyの最初のトラバースを含むが、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のトラバースが再帰によるものであり、かつcurrent nodeがステップ2Eで定義されている埋め込みコントロールである場合、aria-labelを無視してルール2Eにスキップする。
      • そうでなければ、aria-labelの値を返す。
      例：

      次の例は、ノードが自分自身を参照するaria-labelledbyを持つときの、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など）を提供する場合、要素がプレゼンテーションとしてマークされない限り（role="presentation"またはrole="none"）、ホスト言語によって定義されたflat stringの形式でその代替を返す。
      コメント：

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

   5. そうでなければ、埋め込みコントロールの値を調整できる場所で、current nodeが別のwidgetのラベル内に埋め込みコントロール（HTMLのlabel要素、またはaria-labelledbyによって直接参照される要素など）である場合、次の方法でテキストによる代替の一部として埋め込みコントロールを含める：
      • 埋め込みコントロールがロールtextboxを持つ場合、その値を返す。
      • 埋め込みコントロールがロールメニューbuttonを持つ場合、ボタンのテキストによる代替を返す。
      • 埋め込みコントロールがロールcomboboxまたはlistboxを持つ場合、選択したoptionのテキストによる代替を返す。
      • 埋め込みコントロールがロールrangeを持つ場合（spinbuttonやsliderなど）：
        • aria-valuetextプロパティが存在する場合、その値を返す。
        • そうでなければ、aria-valuenowプロパティが存在する場合、その値を返す。
        • そうでなければ、ホスト言語属性によって指定される値を使用する。
      例：

      テキスト入力フィールドを含むチェックボックスラベルについて考えてみよう："Flash the screen [input] times"。ユーザーが埋め込みテキストボックスに"5"を入力した場合、完全なラベルは"Flash the screen 5 times"となる。

      例3

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

   6. そうでなければ、current nodeのロールがコンテンツ由来の名前を許可する場合、またはcurrent nodeがaria-labelledbyもしくはaria-describebyによって参照される、もしくはネイティヴホスト言語のテキストによる代替要素（HTMLのラベルなど）である場合、またはネイティヴホスト言語のテキストによる代替要素の子孫である場合：
      1. accumulated textを空文字列に設定する。
      2. current nodeに関連付けられているCSSで生成されたテキストコンテンツを確認し、それをaccumulated textに含める。CSS :beforeおよび:after擬似要素[CSS2]は、コンテンツモデルを持つ要素にテキストコンテンツを提供することができる。
         • :before擬似要素の場合、ユーザーエージェントは、スペースなしでCSSテキストコンテンツをcurrent nodeのテキストコンテンツの先頭に追加しなければならない。
         • :after擬似要素の場合、ユーザーエージェントは、スペースなしでCSSテキストコンテンツをcurrent nodeのテキストコンテンツに追加しなければならない。
      3. current nodeのそれぞれの子ノードに対して：
         1. current nodeを子ノードに設定する。
         2. ステップ2から始めて、current nodeのテキストによる代替を計算する。result結果をそのテキストによる代替に設定する。
         3. resultをaccumulated textに追加する。
      4. accumulated textを返す。

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

      コメント：

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

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

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

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

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