Skip to content

Commit 3437235

Browse files
authored
simplify accessibility info (google#527)
1 parent 21c6d27 commit 3437235

File tree

1 file changed

+3
-17
lines changed

1 file changed

+3
-17
lines changed

specification/v0_9/json/common_types.json

Lines changed: 3 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -10,29 +10,15 @@
1010
},
1111
"AccessibilityAttributes": {
1212
"type": "object",
13-
"description": "Overrides for accessibility behavior.",
13+
"description": "Attributes to enhance accessibility when using assistive technologies like screen readers.",
1414
"properties": {
1515
"label": {
1616
"$ref": "#/$defs/DynamicString",
17-
"description": "Overrides the content description. Use this to describe icons or provide extra context for buttons."
17+
"description": "A short string, typically 1 to 3 words, used by assistive technologies to convey the purpose or intent of an element. For example, an input field might have an accessible label of 'User ID' or a button might be labeled 'Submit'."
1818
},
1919
"description": {
2020
"$ref": "#/$defs/DynamicString",
21-
"description": "Describes the result of performing an action on the element (e.g., 'Double tap to submit')."
22-
},
23-
"role": {
24-
"type": "string",
25-
"description": "Explicitly sets the semantic role of the element.",
26-
"enum": [ "button", "header", "link", "image", "adjustable", "summary", "none" ]
27-
},
28-
"hidden": {
29-
"$ref": "#/$defs/DynamicBoolean",
30-
"description": "If true, the element and its children are hidden from accessibility services."
31-
},
32-
"liveRegion": {
33-
"type": "string",
34-
"description": "Indicates that updates to this element should be announced automatically.",
35-
"enum": [ "polite", "assertive", "off" ]
21+
"description": "Additional information provided by assistive technologies about an element such as instructions, format requirements, or result of an action. For example, a mute button might have a label of 'Mute' and a description of 'Silences notifications about this conversation'."
3622
}
3723
}
3824
},

0 commit comments

Comments
 (0)