From 7a3a0c5e777f233fafabde4dd76b03430c586419 Mon Sep 17 00:00:00 2001 From: Matt King Date: Mon, 28 Nov 2016 17:00:05 -0800 Subject: [PATCH] Clarify description of screen reader listbox presentation 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. --- aria-practices.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/aria-practices.html b/aria-practices.html index c1103befe9..00dad1e360 100644 --- a/aria-practices.html +++ b/aria-practices.html @@ -918,7 +918,7 @@

Listbox

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.

- 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.