details element (html)

Expectation: convey its role

Rationale:

A screen reader user needs to know how they can interact with the element. Voice control software might use the role to help users activate controls that do not have a visible name.

Strength of this expectation for different types of assistive technologies:

• Screen Readers: MUST
• Voice Control: NA

Examples:

• A screen reader might announce the role as "group" or "details"
• A screen reader might consider the group as presentational and not convey a group role

Expectation: convey the name of the group if the group role is conveyed

Rationale:

A screen reader user needs to know what to enter.

Strength of this expectation for different types of assistive technologies:

• Screen Readers: MUST
• Voice Control: NA

Expectation: convey the boundaries of the details element if the group role is conveyed

Rationale:

A user needs to know when they enter and exit an element

Strength of this expectation for different types of assistive technologies:

• Screen Readers: MUST
• Voice Control: NA

Examples:

• A screen reader might announce the role of the element when entering and say something like "leaving" when exiting.
• A screen reader might not explicitly announce entering and existing the element, but instead imply that the is in the containing object by conveying the roles of required children (options in a listbox for example).
• A screen reader might announce position in set information such as "1 of 6".
• A screen reader might not convey boundaries if the content fits on a single line