Skip to content

Commit

Permalink
Clarify description of screen reader listbox presentation
Browse files Browse the repository at this point in the history
To address the Nov 28, 2016 comment by @jnurthen on issue #122,
modified aria-practices.html:
In the listbox pattern description, changed:
When screen readers present a listbox, they render the name, state, and position of each option in the list.
To:
When screen readers present a listbox, they may render the name, state, and position of each option in the list.
  • Loading branch information
mcking65 committed Nov 29, 2016
1 parent 0b4cd49 commit 7a3a0c5
Showing 1 changed file with 1 addition and 1 deletion.
2 changes: 1 addition & 1 deletion aria-practices.html
Expand Up @@ -918,7 +918,7 @@ <h3>Listbox</h3>
A listbox that allows a single option to be chosen is a single-select listbox; one that allows multiple options to be selected is a multi-select listbox.
</p>
<p>
When screen readers present a listbox, they render the name, state, and position of each option in the list.
When screen readers present a listbox, they may render the name, state, and position of each option in the list.
The name of an option is a string calculated by the browser, typically from the content of the option element.
As a flat string, the name does not contain any semantic information.
Thus, if an option contains a semantic element, such as a heading, screen reader users will not have access to the semantics.
Expand Down

0 comments on commit 7a3a0c5

Please sign in to comment.