fuchsia.accessibility.semantics

預設

與元素相關聯的預設動作。

次要

與元素相關聯的次要動作。這可能對應長按 (觸控螢幕) 或按一下滑鼠右鍵 (滑鼠)。

SET_FOCUS

將焦點移至這個元素 (輸入/無無障礙功能)。

SET_VALUE

設定元素的值。

SHOW_ON_SCREEN

捲動節點即可顯示。

決策

將滑桿減少一個步驟值。步驟大小是由執行此動作的語意節點擁有者定義。舉例來說，音量滑桿可能想製作步驟 1、2、3，而時間滑桿可能讓每個步驟改變都略過 30 秒。

成效增幅

將滑桿往一個步驟值遞增。步驟大小是由執行此動作的語意節點擁有者定義。舉例來說，音量滑桿可能想製作步驟 1、2、3，而時間滑桿可能讓每個步驟改變都略過 30 秒。

NONE

未輸入資料或元素不是核取方塊時使用。

已勾選

已勾選

已取消檢查

已取消勾選

混合

未確定狀態

已啟用

已啟用元素。

已停用

元素已停用。

不確定

未確定狀態。

單位化

節點尚無標籤。

屬性

這個元素在執行階段 UI 中的屬性會明確設定標籤。例如包含 aria 標籤的元素。

ATTRIBUTE_EMPTY

執行階段 UI 中的這項元素屬性會明確將標籤設為空白。

字幕

這個標籤是表格類元素的說明文字。由於部分輔助技術具有處理資料表的特殊模式，執行階段應針對這類來源標記其標籤，讓使用者瞭解在資料表模式中瀏覽資料表的內容。例如，<caption> HTML 標記會設定標籤。

內容

這個節點會從應用程式顯示的內容收到其標籤。舉例來說，網頁中的文字會成為這個節點的標籤。

預留位置

一個元素可接收使用者輸入的值，並提供建議輸入內容。例如 HTML 輸入欄位中的預留位置屬性。

RELATED_ELEMENT

其他元素提供此元素的標籤。例如透過 aria 標籤來新增。

TITLE

這個元素的標籤會以視覺化工具提示表示。例如來自 <title> HTML 標記。

值

標籤取自使用者輸入的值。

不明

這個角色代表了角色目前不支援的元素。

按鈕

畫面中可點選/啟用的內容，且只有單一函式。

標頭

標題文字，例如 HTML 中標記為 <h1> 的內容。

IMAGE

圖片或圖形。

TEXT_FIELD

可接收文字輸入內容的欄位。

防滑

滑桿，例如影片的音量滑桿或時間滑桿。

連結

連結，例如網頁上的連結。

CHECK_BOX

可切換的核取方塊。

RADIO_BUTTON

用來從一組選項中選取選項的圓形按鈕。

飯店清單

用於代表清單的角色。

LIST_ELEMENT

這個角色用於代表清單中的元素，包括標記及其內容。例如，標記 <li> 的元素，或具備 ARIA 清單項目角色的元素。

LIST_ELEMENT_MARKER

用於代表清單標記的角色 (例如項目符號、數字、羅馬數字等)。

STATIC_TEXT

這個角色代表不可變更的文字。

TOGGLE_SWITCH

用於代表切換鈕的角色。

表格

這個角色用來代表元素表格。

GRID

用於代表格線的角色。例如具有 aria-grid 角色的元素。

TABLE_ROW

用來代表資料表資料列的角色。

儲存格

這個角色用來代表表格或格線中的儲存格。

COLUMN_HEADER

用於代表欄標題的角色。例如含有 HTML 標記 <th> 的元素。

ROW_GROUP

用於代表 aria-rowgroup 類似元素的角色。

段落

這個角色用於代表一段文字。

SEARCH_BOX

TEXT_FIELD_WITH_COMBO_BOX

ROW_HEADER

開啟

切換按鈕已設為開啟。

關閉

切換按鈕目前為關閉狀態。

不確定

切換鈕處於「不確定」狀態。

1

說明應用程式變更的訊息。這則訊息應以應用程式所用的語言進行本地化。

1

元素的主要標籤。如果超過 MAX_LABEL_SIZE，則用戶端會負責截斷標籤。

2

元素的次要標籤。如果超過 MAX_LABEL_SIZE，則用戶端會負責截斷標籤。

3

節點中次要動作 (即長按或按一下滑鼠右鍵) 應執行的動作說明。

4

如果元素是滑桿 / 範圍控制項，就會填入範圍屬性。

5

如果元素屬於某些類型的集合，系統會填入設定屬性。舉例來說，相關的圓形按鈕是同一組按鈕的一部分。

6

如果節點有「LIST」角色，則應填寫清單屬性。請注意，只需填入 size 和 set_element_ids。

7

如果節點具有 LIST_ELEMENT 角色，且從具備「LIST」角色的節點繼承，則應填寫清單元素屬性。請注意，只應填入 index。

8

元素的階層層級。舉例來說，HTML 內的標頭可以是第 1 級到第 6 級，也可以是 Markdown。

9

元素是表格時，系統會填入表格屬性。

10

此元素的標籤來源。

11

元素是否屬於虛擬鍵盤。例如螢幕小鍵盤上的按鍵。

12

元素是表格列時，表格列的屬性就會填入資料。

13

表格儲存格屬性會在元素為表格儲存格時填入。

1

代表特定 UI 中節點的專屬 ID。系統會假設 0 為根節點，也是樹狀結構的唯一進入點。如果未命中，node_id 就不會填入。

2

按照順序排列的節點 ID 清單，代表從根節點到命中節點的路徑。

1

代表特定 UI 中節點的專屬 ID。系統會假設零為根節點和樹狀結構的唯一進入點。不允許使用森林。

2

這個元素的角色，例如按鈕、核取方塊等。

3

這個物件的狀態表格，例如已勾選、可編輯等。

4

這個節點的屬性表格。

5

可對這個節點執行的動作清單。

6

這個節點的子項 ID 清單，按週遊順序列出。提供語意樹狀結構資訊的執行階段，會負責確保樹狀結構不包含週期。每個節點只能有一個父項。

7

此元素的本機定界框。

8

將這個節點的座標空間轉換為其容器空間。4x4 的大小 以便與視覺網頁相容這個矩陣必須包含下列格式

[ Sx 0 0 Tx ] [ 0 Sy 0 Ty ] [ 0 0 Sz Tz ] [ 0 0 0 1 ]

其中 Sx、Sy 和 Sz 是縮放係數，而 Tx、Ty、Tz 則是 x、y 和 z 元件的轉譯因數。

9

這個節點上祖系的節點 ID，用來做為 |transform| 的目標。如果沒有，系統會將此解讀為這個節點的父項。

10

注意：我們已淘汰 transform，並改用 node_to_container_transform。用戶端「不得」設定這兩個欄位。

將這個節點的座標空間轉換為其容器空間。如果已設定 container_id 欄位，則該 ID 會指定容器節點。否則，這個節點的父項就是容器節點。

此外，如果已設定 container_id，Fuchsia 無障礙工具會在轉換為容器座標空間時套用 node_to_container_transform，然後依容器的 location.min 將這個節點的座標空間轉譯後轉譯。如未設定 container_id，系統不會套用這項譯後翻譯。

4x4 解析度，與視覺網頁相容。這個矩陣必須格式如下：

[ Sx 0 0 Tx ] [ 0 Sy 0 Ty ] [ 0 0 Sz Tz ] [ 0 0 0 1 ]

其中 Sx、Sy 和 Sz 是縮放係數，而 Tx、Ty、Tz 則是 x、y 和 z 元件的轉譯因數。

1

範圍控制項元素可使用的最小值。

2

範圍控制項元素可使用的最大值。

3

叫用 DECREMENT 或 INCREMENT 動作時，元素的步驟差異值。

1

資料集的大小。

2

資料集中的元素索引，從一個索引開始。

3

此組合中其他元素的節點 ID。

1

不再使用

2

核取方塊狀態。這個欄位與 ToggledState 互斥。

3

表示目前已選取該元素。

4

元素目前是隱藏，或由架構標示為隱藏。

5

使用者輸入的元素值 (如適用)。如果超過 MAX_VALUE_SIZE，則用戶端會負責截斷。

6

如果元素是滑桿或範圍控制項，則此欄位會包含目前值。請注意，這與上述的值欄位不同，因為這個值是由用戶端產生，並由使用者調整。

7

如果元素是可捲動的可視區域，這個欄位會包含這個節點座標空間中要套用至子項的 x 和 y 偏移值。您可以利用這個偏移設定，安排子項在可視區域中的位置，反映元素目前的捲動情形。這些值沒有限制，沒有限制。

8

切換鈕的狀態。只有在元素是切換切換元素且與 CheckedState 互斥時，才需要設定這個欄位。

9

指出此元素是否可在 UI 中聚焦。請注意，這並非 11y 的焦點，而是輸入焦點。

10

這個元素是否具有輸入焦點。這與系統焦點相對應。只能設定一個元素的值。如果多個節點將這個值設為「true」，系統將無法判定行為。

11

具有啟用/停用狀態的元素狀態。

1

這個表格儲存格橫跨的欄數。

已淘汰 - 改為在儲存格節點使用 TableCellAttributes

2

這個表格儲存格橫跨的列數。

已淘汰 - 改為在儲存格節點使用 TableCellAttributes

3

此資料表中的資料列數。

4

此資料表中的欄數。

5

表格欄標題的節點 ID。

6

表格列標題的節點 ID。

1

這個儲存格的列-索引。

2

這個儲存格的欄索引。

3

這個表格儲存格橫跨的列數。

4

這個表格儲存格橫跨的欄數。

1

表格列索引。

1

語意樹狀結構中節點的子項數量上限。

標籤字串的大小上限 (以位元組為單位)。

訊息字串的大小上限 (以位元組為單位)。

單次更新可以傳送的語意節點數量上限。

語意集中的元素數量上限。

語意樹狀結構的深度上限。

值字串的大小上限 (以位元組為單位)。