fuchsia.accessibility.semantics

DEFAULT

The default action associated with the element.

SECONDARY

The secondary action associated with the element. This may correspond to a long press (touchscreens) or right click (mouse).

SET_FOCUS

Set (input/non-accessibility) focus on this element.

SET_VALUE

Set the element's value.

SHOW_ON_SCREEN

Scroll node to make it visible.

DECREMENT

Decrement a slider by one step value. The step size is defined by the owner of the semantic node that executes this action. For example, a volume slider may want to make steps 1, 2, 3, while a time slider may want to skip 30 seconds each step change.

INCREMENT

Increment a slider by one step value. The step size is defined by the owner of the semantic node that executes this action. For example, a volume slider may want to make steps 1, 2, 3, while a time slider may want to skip 30 seconds each step change.

NONE

Used when no data is entered or the element is not a check box.

CHECKED

Checked

UNCHECKED

Unchecked

MIXED

Indeterminate state

ENABLED

Element is enabled.

DISABLED

Element is disabled.

INDETERMINATE

Indeterminate state.

UNITIALIZED

The node does not have a label yet.

ATTRIBUTE

An attribute of this element in the runtime UI explicitly sets its label. For example, an element with aria-label.

ATTRIBUTE_EMPTY

An attribute of this element in the runtime UI explicitly sets its label to be empty.

CAPTION

This label serves as the caption for a table-like element. Because some assistive technology have special modes to deal with tables, a runtime should mark its label with this type of origin so that users know what the table is about when they navigate in the table mode. For example, a <caption> html tag sets the label.

CONTENTS

This node receives its label from the contents present in the application. For example, text from a web page becomes the label of this node.

PLACEHOLDER

An element that can receive user entered value and has a suggested input. For example, the placeholder attribute on an html input field.

RELATED_ELEMENT

Another element provides the label for this element. For example, via aria-labeledby.

TITLE

This element's label is represented by a visual tooltip. For example, as if from a <title> html tag.

VALUE

The label comes from an user-entered value.

UNKNOWN

Role used to represent elements which role is not currently supported.

BUTTON

Something on screen that can be clicked/activated, that has a single function.

HEADER

Header text, e.g. something tagged <h1> in HTML.

IMAGE

An image or graphic.

TEXT_FIELD

A field that can receive text input.

SLIDER

A slider, e.g. a volume slider or a time slider of a video.

LINK

A link, e.g. a link on a webpage.

CHECK_BOX

A check box that can be toggled.

RADIO_BUTTON

A radio button that selects an option among a group of options.

LIST

Role used to represent lists.

LIST_ELEMENT

Role used to represent an element in a list, including its marker and its content. For example, a element tagged <li>, or an element with the ARIA listitem role.

LIST_ELEMENT_MARKER

Role used to represent a list marker (e.g. a bullet point, number, roman numeral, etc.).

STATIC_TEXT

Role used to represent immutable text.

TOGGLE_SWITCH

Role used to represent toggle switch.

TABLE

Role used to represent a table of elements.

GRID

Role used to represent a grid. For example, an element with the aria-grid role.

TABLE_ROW

Role used to represent the row of a table.

CELL

Role used to represent the cell of a table or grid.

COLUMN_HEADER

Role used to represent a column header. For example, an element with the html tag <th>.

ROW_GROUP

Role used to represent an aria-rowgroup-like element.

PARAGRAPH

Role used to represent a paragraph of text.

SEARCH_BOX

TEXT_FIELD_WITH_COMBO_BOX

ROW_HEADER

ON

Toggle switch is on.

OFF

Toggle switch is off.

INDETERMINATE

Toggle switch is in Indeterminate state.

1

A message describing the change in the application. This message is expected to be localized in the language that the application is in.

1

The primary label for an element. If longer than MAX_LABEL_SIZE the client is responsible for truncating the label.

2

The secondary label for an element. If longer than MAX_LABEL_SIZE the client is responsible for truncating the label.

3

A description of what the secondary action on a node (equivalent to long press or right click) should do.

4

The range attributes are filled if the element is a slider / a range control.

5

Set attributes are filled if the element is part of some type of set. For example, radio buttons that are related are part of the same set.

6

The list attributes should be filled if the node has the LIST role. Note that only size and set_element_ids should be filled.

7

The list element attributes should be filled if the node has a LIST_ELEMENT role and descends from a node with a LIST role. Note that only index should be filled.

8

The hierarchical level of an element. For example, a header can be of level 1 to 6 in html or markdown.

9

The table attributes are filled when the element is a table.

10

The origin of the label of this element.

11

Whether the element is part of a virtual keyboard. For example, a key on an onscreen keyboard.

12

The table row attributes are filled when the element is a table row.

13

The table cell attributes are filled when the element is a table cell.

1

Unique ID that represents a node in a particular UI. Zero is assumed to be the root node and the only entry point to the tree. node_id will not be filled when there is no hit.

2

The ordered list of node ids which represent path from root node to the hit node.

1

Unique ID that represents a node in a particular UI. Zero is assumed to be the root node and the only entry point to the tree. No forest is allowed.

2

Role of this element, e.g. button, checkbox, etc.

3

A table of states of this object, e.g. checked, editable, etc.

4

A table of attributes of this node.

5

A list of actions that can be performed on this node.

6

The list of child IDs of this node, in traversal order. Runtimes supplying semantic tree information are responsible for ensuring the tree does not contain cycles. Each node may have only one parent.

7

Local bounding box of this element.

8

Transform from this node's coordinate space to its container's space. 4x4 for compatibility with scenic. This matrix is required to have the form

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

where Sx, Sy, and Sz are scale factors and Tx, Ty, Tz are the translation factors for the x, y, and z components.

9

Node ID of the ancestor of this node that is used as the target of |transform|. If not present, this is interpreted as this node's parent.

10

NOTE: We are deprecating transform in favor of node_to_container_transform. Clients must NOT set both fields.

Transform from this node's coordinate space to its container's space. If the container_id field is set, then that id specifies the container node. Otherwise, this node's parent is the container node.

Additionally, if container_id is set, the fuchsia accessibility manager will post-translate this node's coordinate space by its container's location.min after applying node_to_container_transform when converting to the container's coordinate space. If container_id is unset, this post-translation will NOT be applied.

4x4 for compatibility with scenic. This matrix is required to have the form:

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

where Sx, Sy, and Sz are scale factors and Tx, Ty, Tz are the translation factors for the x, y, and z components.

1

The minimum value a range control element can take.

2

The maximum value a range control element can take.

3

The step delta the element applies when the action DECREMENT or INCREMENT are invoked.

1

Size of the set.

2

Element index in the set, starting from one.

3

Node ids of other elements in this set.

1

DEPRECATED

2

State of a checkbox. This field is mutually exclusive with ToggledState.

3

Whether the element is currently selected.

4

Whether the element is currently hidden or marked invisible by the framework.

5

The user-entered value of the element, if applicable. If longer than MAX_VALUE_SIZE the client is responsible for truncating.

6

If the element is a slider or a range control, this field contains the current value. Note that this is not the same as the value field above, as this is generated by the client and just adjusted by the user.

7

If the element is a scrollable viewport, this field contains the x and y offsets within this node's coordinate space to apply to the children. This offsetting is used to position the children within the viewport to reflect the current scrolling of the element. There are no constraints on these values other than they must be finite.

8

State of a toggle switch. This field must only be set if the element is a toggle switch element and is mutually exclusive with CheckedState.

9

Whether this element is focusable in the UI. Note that this is not the a11y focus, but the input focus.

10

Whether this element has the input focus. This corresponds to the system focus. Only one element can have this value set. The behavior is undetermined if more than one node sets this value to 'true'.

11

State of an element with enabled/disabled state.

1

The number of columns this table cell spans.

DEPRECATED - Use TableCellAttributes for cell nodes instead

2

The number of rows this table cell spans.

DEPRECATED - Use TableCellAttributes for cell nodes instead

3

Number of rows in this table.

4

Number of columns in this table.

5

Node ids of the table's column headers.

6

Node ids of the table's row headers.

1

Row-index of this cell.

2

Column-index of this cell.

3

The number of rows this table cell spans.

4

The number of columns this table cell spans.

1

Table row index.

1

Maximum number of children for a node in the semantic tree.

Maximum size of a label string, in bytes.

Maximum size of a message string, in bytes.

Maximum number of semantic nodes that may be sent in a single update.

Max number of elements in a semantic set.

Maximum depth of the semantic tree.

Maximum size of a value string, in bytes.