Game dev
Saved & recent

Screen reader semantics

Related terms: accessible name, role, state, accessibility tree, UI focus

Meaningful information exposed to assistive software alongside the visual interface. A control has a name describing its purpose, a role describing what kind of control it is, and relevant state such as checked, disabled or its current value. A screen reader can announce that information when the player reaches it.

An icon alone does not supply all this meaning. Label custom controls, expose their actual state, and update it when the interface changes. Standard controls often provide part of this automatically. Combine semantics with usable navigation; a correctly labeled button still needs to be reachable.

Further reading
Godot: accessibility roles and states
Subtitles Name Subtitles Role Checkbox State Checked Subtitles,checkbox, checked focused control exposed semantics
The focused control exposes the name Subtitles, the checkbox role and its checked state. A screen reader can announce those fields when the player reaches it.

View in the full Game dev collection