\{{ariaref}}複雑な複合ウィジェットやアプリケーションで一般的に使用される document ロールは、コンテキストを読み取りモードに切り替えることを支援技術を知らせることができます。 document ロールは、ドキュメントモードを使用して、この要素に含まれるコンテンツを読み取るための読み取りモードまたはブラウズモードを支援技術に指示します。
複雑な複合ウィジェットやアプリケーションで一般的に使用される文書 (document) ロールは、コンテキストを読み取りモードに切り替えることを支援技術を知らせることができます。 文書 (document) ロールは、読み取りモードまたは閲覧モードを持つ支援技術に、この要素に含まれるコンテンツを文書モードを使用して読み取るように指示します。
<div role="dialog"> ... @@ -19,53 +19,48 @@ translation_of: Web/Accessibility/ARIA/Roles/Document_Role </div>-
この例は、いくつかのコントロールと、支援技術のユーザーがタブを当てて（Tab キーによる移動で）読むことができる情報テキストを含むセクションを含むダイアログウィジェットを示しています。
+この例は、いくつかのコントロールと、支援技術のユーザーがタブ移動で読むことができる情報テキストを含むセクションを備えたダイアログウィジェットを示しています。
デフォルトでは、ウェブページはドキュメント（document）として扱われ、支援技術（AT）は、新しいウェブページに入るときブラウズモードまたは読み取りモードにします。 このモードは、ウィジェットロールや application ロールなど、さまざまなロールを通じて変更できます。 document ロールは、AT をブラウズモードまたは読み取りモードに戻します。
デフォルトでは、ウェブページは文書 (document、ドキュメント) として扱われ、支援技術 (AT) は、新しいウェブページに入るとき閲覧モードまたは読み取りモードにします。 このモードは、ウィジェットロールやアプリケーション (application) ロールなど、さまざまなロールを通じて変更できます。 文書 (document) ロールは、AT を閲覧モードまたは読み取りモードに戻します。
一般に、application ロールまたは他のインタラクティブなウィジェットロール内に配置される document ロールは、利用可能な場合、支援技術のユーザがブラウズモードまたは仮想読み取りモードを使用して読むべきである複雑な複合ウィジェットのセクションを示すために使用します。
一般的に、アプリケーションロールまたは他のインタラクティブなウィジェットロール内に配置される文書 (document) ロールは、利用可能な場合、支援技術のユーザーが閲覧モードまたは仮想読み取りモードを使用して読むべきである複雑な複合ウィジェットのセクションを示すために使用します。
読み取りモードの AT は、ウィジェットロールまたは application ロールのセットを持つ要素を除くすべての要素に対してそのモードをデフォルトとしているため、document ロールは、静的リッチテキストとして読むべきであるウィジェットまたはアプリケーション内のフォーカス可能な要素に対してのみ役に立ちます。 ウィジェット内のテキストを含む要素に role="document" と tabindex="0" を追加すると、スクリーンリーダーのユーザーは Tab キーを押してドキュメント要素にフォーカスを合わせ、スクリーンリーダーの読み取りカーソルでテキストを読み取ることができます。
読み取りモードを持つ AT は、ウィジェットロールまたはアプリケーションロールの設定を持つ要素を除くすべての要素に対して読み取りモードをデフォルトとしているため、文書ロールは、静的リッチテキストとして読むべきであるウィジェットまたはアプリケーション内のフォーカス可能な要素に対してのみ役立ちます。 ウィジェット内のテキストを含む要素に role="document" と tabindex="0" を追加すると、スクリーンリーダーのユーザーは Tab キーを押して文書要素にフォーカスを置き、スクリーンリーダーの読み取りカーソルでテキストを読むことができます。
支援技術は、親の動的コンテキストのために再配線されたコントロールを遮り、上矢印または下矢印キーボードイベントなどの標準入力イベントを再度有効にして、読み取りカーソルを制御するために、コンテキストをドキュメントモードに戻すべきです。
+支援技術は、コンテキストを文書モードに戻すべきであり、場合によっては、親の動的コンテキスト用に配線されたコントロールから横取りすることで、上矢印や下矢印のキーボードイベントなどの標準入力イベントを再度有効にして、読み取りカーソルを制御します。
-article ロールとは対照的に、document ロールは、document ロールを持つ他の要素との関係はなく、単にそれ含む複合ウィジェットとの関係を持っています。 記事（article）は関連記事を持つことができます。
記事 (article) ロールとは対照的に、文書 (document) ロールは、文書ロールを持つ他の要素との関係はなく、単にそれ含む複合ウィジェットとの関係があるだけです。 記事は関連記事を持つことができます。
aria-expandedtrue または false の値を含み、ドキュメントが現在展開されているか折りたたまれているかを示します。 他の値には、ドキュメントが折りたたまれないことを意味するデフォルトの undefined が含まれます。true または false の値を含み、文書が現在展開されているか折りたたまれているかを示します。 他の値には、文書が折りたたまれないことを意味するデフォルトの undefined が含まれます。tabindex="0"-
tabindex="0" 属性/値のペアを設定することで、要素をフォーカス可能にするべきです。 これにより、ユーザーはタブを当てることができ、読み取りモードが自動的に呼び出され、コンテンツをすぐに読むことができます。
tabindex="0" 属性/値のペアを設定することで、要素をフォーカス可能にするべきです。 これにより、ユーザーはそれにタブ移動でき、自動的に読み取りモードが起動し、内容をすぐに読むことができるようになります。
なし（任意の属性が必要とする場合を除く。 例えば、document が折りたたみ可能である場合、aria-expanded のステートと値を維持する必要があります。）
なし (任意の属性が必要とする場合を除く。 例えば、文書 (document) が折りたたみ可能である場合、aria-expanded のステートと値を維持する必要があります。)
例えば、Gmail と1つの会話ビューがあります。 GMail はウェブアプリケーションです。 Gmail の場合、ほとんどのユーザーエージェントのインタラクションは、ほとんどの場合、アプリケーションによって奪われます。 ただし、会話の件名を含む1つの会話の開始見出しにキーボードフォーカスが設定されている場合、スクリーンリーダーのユーザーは読み取りモードのコマンドを使用してメッセージを読んだり、展開したり、折りたたんだり、彼らがどんなやり方でも操作できるようにします。 Back ボタンをアクティブにするか、関連するキーを押すことによって、フォーカスがメッセージリストに戻ると、直接アプリケーションのインタラクションモードが再度呼び出され、矢印キーを使用してリスト内の別の会話に移動できます。
+例として、Gmail と1つの会話ビューがあります。 GMail はウェブアプリケーションです。 Gmail の場合、ユーザーエージェントとのやりとりのほとんどがアプリケーションによって奪われます。 ただし、会話の主題を含む1つの会話の開始見出しにキーボードフォーカスが設定されている場合、スクリーンリーダーのユーザーは読み取りモードのコマンドを使用してメッセージを読んだり、展開したり、折りたたんだり、操作したりできます。 [戻る] ボタンをアクティブ化するか、関連するキーを押すことによって、フォーカスがメッセージリストに戻ると、アプリケーションとの直接やりとりモードが再び起動し、矢印キーを使用してリスト内の別の会話に移動できます。
tabindex 属性に値 0 を設定することにより、document ロールを持つ項目がフォーカス可能であることを常に確認します。 これはタブ順にも含まれます。
tabindex 属性に値 0 を設定することにより、文書ロールを持つ項目がフォーカス可能であることを常に確認してください。 これにより、項目がタブ順序にも含まれるようになります。
document ロールは、ユーザーが標準のスクリーンリーダーのコマンドで読むべき内容であることを明白に明示することによって、支援技術の動作を間接的に制御する簡単な方法です。
文書ロールは、ユーザーがスクリーンリーダーの標準コマンドで読むべき内容であることを明確に示すことによって、支援技術の振る舞いを間接的に制御する簡単な方法です。
-