共用方式為


適用於 W3C 可存取的豐富因特網應用程式規格的 UI 自動化

網站會使用異步 JavaScript 和 XML(AJAX)、DHTML 和 JavaScript 等技術支援的動態內容和進階 UI 控件來增加其公用程式。 不過,輔助技術經常無法與這些複雜的控件互動,或向使用者公開動態內容。 無障礙的豐富因特網應用程式 (ARIA) 是一個 W3C 技術規格,用於開發 Web 內容和應用程式,讓身心障礙人士能夠存取它們。

為了支援 ARIA 規格,Microsoft UI 自動化規格可讓開發人員將 UI Automation AriaRole 和 AriaProperties 属性與 W3C ARIA 角色和狀態或屬性產生關聯。 這有助於用戶應用程式,例如Microsoft Internet Explorer 支援 UI 自動化內容中的 ARIA 物件模型,同時保留基準輔助功能物件模型。

本附錄提供 W3C 資訊與Microsoft Active Accessibility 和 UI Automation 規格的建議對應,並利用兩個新的 UI 自動化屬性。

本主題包含下列各節:

對應至 Microsoft Active Accessibility and UI Automation 的 W3C ARIA 角色

W3C ARIA 角色可以對應至Microsoft Active Accessibility 角色或 UI 自動化控件類型。 使用UI自動化時,AriaRole 屬性也可能支援原始的W3C ARIA角色。 使用者代理程式可以使用UI AutomationLocalizedControlType屬性,提供W3C ARIA角色的當地語系化描述;不過,這是選擇性的。 未指定本地化字串時,系統會提供預設LocalizedControlType字串。 使用者代理程式也可以使用空格做為分隔符,在AriaRole屬性中提供次要角色,如ARIA W3C標準中所定義。

W3C ARIA 角色屬性 (DRAFT) Microsoft作用中輔助功能角色 UI 自動化控制件類型 UI Automation AriaRole 屬性
警報 ROLE_SYSTEM_ALERT 文字 警報
alertdialog ROLE_SYSTEM_DIALOG 窗格 alertdialog
應用 ROLE_SYSTEM_PANE 窗格 應用
ROLE_SYSTEM_DOCUMENT
旗幟 ROLE_SYSTEM_GROUPING 群組 旗幟
按鈕 ROLE_SYSTEM_PUSHBUTTON 按鈕 按鈕
複選框 ROLE_SYSTEM_CHECKBUTTON CheckBox 複選框
columnheader ROLE_SYSTEM_COLUMNHEADER DataItem columnheader
下拉式方塊 ROLE_SYSTEM_COMBOBOX ComboBox 下拉式方塊
互補 ROLE_SYSTEM_GROUPING 群組 互補
contentinfo ROLE_SYSTEM_GROUPING 群組 contentinfo
定義 ROLE_SYSTEM_GROUPING 群組 定義
描述 ROLE_SYSTEM_TEXT 文字 描述
對話 ROLE_SYSTEM_DIALOG 窗格 對話
目錄 ROLE_SYSTEM_LIST 清單 目錄
公文 ROLE_SYSTEM_CLIENT 公文
形式 ROLE_SYSTEM_GROUPING 群組 形式
網 格 ROLE_SYSTEM_TABLE DataGrid 網 格
gridcell ROLE_SYSTEM_CELL DataItem gridcell
ROLE_SYSTEM_GROUPING 群組
標題 ROLE_SYSTEM_TEXT 文字 標題
img ROLE_SYSTEM_GRAPHIC 映像 img
連結 ROLE_SYSTEM_LINK 超連結 連結
清單 ROLE_SYSTEM_LIST 清單 清單
listbox ROLE_SYSTEM_LIST 清單 listbox
listitem ROLE_SYSTEM_LISTITEM ListItem listitem
日誌 ROLE_SYSTEM_GROUPING 群組 日誌
主要 ROLE_SYSTEM_GROUPING 群組 主要
選取 框 ROLE_SYSTEM_ANIMATION 文字 選取 框
功能表 ROLE_SYSTEM_MENUPOPUP 功能表 功能表
功能表欄 ROLE_SYSTEM_MENUBAR MenuBar 功能表欄
menuitem ROLE_SYSTEM_MENUITEM MenuItem menuitem
menuitemcheckbox ROLE_SYSTEM_CHECKBUTTON CheckBox menuitemcheckbox
menuitemradio ROLE_SYSTEM_RADIOBUTTON RadioButton menuitemradio
導航 ROLE_SYSTEM_GROUPING 群組 導航
注意 ROLE_SYSTEM_GROUPING 群組 注意
選擇 ROLE_SYSTEM_LISTITEM ListItem 選擇
介紹 ROLE_SYSTEM_PANE 窗格 介紹
progressbar ROLE_SYSTEM_PROGRESSBAR ProgressBar progressbar
收音機 ROLE_SYSTEM_RADIOBUTTON RadioButton 收音機
radiogroup ROLE_SYSTEM_GROUPING 群組 radiogroup
地區 ROLE_SYSTEM_PANE 窗格 地區
ROLE_SYSTEM_ROW DataItem
rowheader ROLE_SYSTEM_ROWHEADER DataItem rowheader
滾動條 ROLE_SYSTEM_SCROLLBAR ScrollBar 滾動條
搜索 ROLE_SYSTEM_GROUPING 群組 搜索
部分 ROLE_SYSTEM_GROUPING 群組 部分
分隔符 ROLE_SYSTEM_SEPARATOR 分隔符 分隔符
滑塊 ROLE_SYSTEM_SLIDER 滑桿 滑塊
spinbutton ROLE_SYSTEM_SPINBUTTON 微調器 spinbutton
地位 ROLE_SYSTEM_STATUSBAR StatusBar 地位
標籤 ROLE_SYSTEM_PAGETAB TabItem 標籤
tablist ROLE_SYSTEM_PAGETABLIST 索引標籤 tablist
tabpanel ROLE_SYSTEM_PANE 窗格 tabpanel
文字框 ROLE_SYSTEM_TEXT 文字框
定時器 ROLE_SYSTEM_CLOCK 窗格 定時器
工具列 ROLE_SYSTEM_TOOLBAR ToolBar 工具列
tooltip ROLE_SYSTEM_TOOLTIP 工具提示 tooltip
ROLE_SYSTEM_OUTLINE 樹狀結構
treegrid ROLE_SYSTEM_TABLE DataGrid treegrid
treeitem ROLE_SYSTEM_OUTLINEITEM TreeItem treeitem

對應至使用中輔助功能和UI自動化Microsoft W3C ARIA 狀態和屬性

W3C ARIA 狀態和屬性對應至各種Microsoft Active Accessibility 和 UI Automation 屬性和函式。 UI Automation AriaProperties 屬性支援大部分的 ARIA 狀態和屬性。 例外狀況是採用對象參考的 ARIA 屬性(例如,describedby ARIA 屬性),以及輔助功能物件模型支援的 ARIA 屬性。 例如,ARIA activedescendent 屬性應該以輔助功能物件模型中焦點的專案表示。 當指定輔助功能物件模型時,ARIA 擁有 屬性也應該反映在輔助功能物件模型中。

AriaProperties 是字串屬性,其名稱/值組的集合,其分隔符為等號 (=) 和分號 (;),例如 “checked=true;disabled=false”。 當這些分隔符或反斜杠出現在值時,反斜杠 (\) 會當做逸出。 提供者程式代碼可以新增驗證,以驗證文件物件模型中的原始 ARIA 屬性,但並非必要。

W3C ARIA 狀態和屬性 Microsoft Active Accessibility 属性 UI 自動化屬性 UI Automation AriaProperties 屬性
activedescendent STATE_SYSTEM_FOCUSED (accState) HasKeyboardFocus (指定接收焦點的子項目屬性) n/a
原子 n/a n/a 原子
STATE_SYSTEM_BUSY (accState) n/a
管道 n/a n/a 管道
檢查 STATE_SYSTEM_CHECKED (accState) ToggleState (切換 控件模式) 檢查
控制 n/a ControllerFor n/a
describedby n/a DescribedBy n/a
禁用 STATE_SYSTEM_UNAVAILABLE (accState) IsEnabled 禁用
dropeffect n/a n/a dropeffect
擴大 STATE_SYSTEM_COLLAPSEDSTATE_SYSTEM_EXPANDED (accState) ExpandCollapseState (ExpandCollapse 控件模式) 擴大
flowto n/a FlowTo n/a
n/a n/a
haspopup STATE_SYSTEM_HASPOPUP (accState) n/a haspopup
隱藏 STATE_SYSTEM_INVISIBLE (accState) IsOffscreen 隱藏
無效 n/a IsDataValidForForm 無效
labelledby n/a LabeledBy n/a
水準 accValue n/a (由自動化專案樹狀結構表示) 水準
n/a n/a
多行 n/a 控件類型 多行
multiselectable STATE_SYSTEM_EXTSELECTABLE (accState) CanSelectMultiple (選取範圍 控件模式) multiselectable
擁有 n/a (應該反映在可存取的物件樹狀結構中) n/a (應該反映在自動化專案樹狀結構中) n/a
Posinset n/a (在可存取的物件樹狀結構或 childId 中表示) n/a (在自動化專案樹狀結構中表示) posinset
STATE_SYSTEM_PRESSED ToggleState (切換 控件模式)
readonly STATE_SYSTEM_READONLY IsReadOnly readonly
相關 n/a n/a 相關
必填 n/a IsRequiredForForm 必填
秘密 STATE_SYSTEM_PROTECTED IsPassword 秘密
選擇 STATE_SYSTEM_SELECTED IsSelected (SelectionItem 控件模式) 選擇
setsize n/a n/a (自動化專案樹狀結構中的子計數) setsize
排序 n/a n/a 排序
tabindex STATE_SYSTEM_FOCUSABLE IsKeyboardFocusable tabindex
valuemax n/a 最大值 (RangeValue 控制件模式) valuemax
valuemin n/a 最小值 (RangeValue 控件模式) valuemin
valuenow IAccessible::get_accValue 值 (RangeValue 控件模式) valuenow
valuetext IAccessible::get_accValue
注意:設定 valuenow 和 valuetext ARIA 屬性時,accValue 會保存來自 ARIA valuetext 屬性的數據。
值 ( 控制樣式)
注意:指定 valuetext 和 valuenow 時,RangeValue 和 Value 控件模式可以與 UI 自動化共存。
valuetext

其他考慮

使用者介面自動化也提供具有 Text 控件模式的簡單文字物件模型,其支援將物件內嵌在 Document 物件中。 這可讓使用者代理程式和用戶端應用程式視使用者案例而定,將 Web 內容視為 HTML 檔或傳統桌面 UI。