ARIA：文件角色

document 角色用於包含內容的頂部容器，輔助技術使用者可能希望以閱讀模式瀏覽這些內容。僅在複雜複合小部件或應用程式中的可聚焦部分才有用，document 角色通知輔助技術將閱讀上下文切換回閱讀模式：document 角色告訴具有閱讀或瀏覽模式的輔助技術使用文件模式閱讀此元素中包含的內容。

<div role="dialog">
  …
  <div id="InfoText" role="document" tabindex="0">
    <p>Some informational text goes here.</p>
  </div>
  …
  <button>Close</button>
</div>

此示例顯示了一個對話方塊，這是一個複雜複合小部件角色，帶有一些控制元件和一個包含一些資訊文字的部分，輔助技術使用者在切換到該部分時可以進入閱讀模式。

預設情況下，網頁被視為文件；輔助技術 (AT) 在進入新網頁時進入瀏覽或閱讀模式。可以透過各種角色（包括小部件和應用程式角色）更改此模式。document 角色將 AT 切換回瀏覽或閱讀模式。

document 角色通常放置在應用程式角色或其他互動式小部件角色中，用於指示覆雜複合小部件的一部分，輔助技術使用者應使用其瀏覽或虛擬閱讀模式（如果可用）來閱讀該部分。

由於具有閱讀模式的 AT 會預設將所有元素（除了設定了小部件或應用程式角色的元素）設定為該模式，因此文件角色僅對小部件或應用程式中應作為靜態富文字讀取的可聚焦元素有用。透過向包含小部件中文字的元素新增role="document"和tabindex="0"，螢幕閱讀器使用者可以按 Tab 鍵將焦點置於文件元素上，並使用螢幕閱讀器的閱讀游標讀取文字。

輔助技術應將上下文切換回文件模式，可能攔截為父級的動態上下文重新連線的控制元件，重新啟用標準輸入事件（例如向上或向下箭頭鍵盤事件）來控制閱讀游標。

與article角色相反，document角色與其他具有文件角色的元素沒有任何關係，它僅與包含的複合小部件有關。文章可以有相關的文章。

aria-expanded

如果文件元素是可摺疊的，則包含值為true或false的值，以指示文件當前是展開還是摺疊。其他值包括預設值undefined，表示文件不可摺疊。

tabindex="0"

用於使其可聚焦，以便輔助技術使用者可以切換到它並立即開始閱讀。

應透過在元素上設定tabindex="0"屬性/值對使其可聚焦。這樣，使用者就可以切換到它，閱讀模式會自動呼叫，並且可以立即讀取內容。

無，除非任何屬性需要。例如，如果document是可摺疊的，則必須維護aria-expanded的狀態和值。

一個例子是 Gmail 和單一對話檢視。Gmail 是一個 Web 應用程式。在 Gmail 中，大多數使用者代理互動都被應用程式所取代。但是，當鍵盤焦點設定在包含對話主題的單一對話的起始標題上時，螢幕閱讀器使用者可以使用閱讀模式命令來通讀訊息、展開或摺疊它們以及操作它們。一旦焦點透過啟用“後退”按鈕或按下關聯的擊鍵返回到訊息列表，則會再次呼叫直接應用程式互動模式，並且使用者可以使用箭頭鍵移動到列表中的其他對話。

始終確保具有文件角色的專案可聚焦，方法是設定值為 0 的tabindex屬性。這還將把它包含在 Tab 鍵順序中。

文件角色是一種簡單的方法，可以透過明確宣告這是使用者應該使用標準螢幕閱讀器命令閱讀的內容，來間接控制輔助技術的行為。

• ARIA：widget 角色
• ARIA：application 角色