1878748 - Create plain language accessibility description for moz-toggle

Status: NEW

(Toolkit :: UI Widgets, task, P3)

Description

[Tim Giles [:tgiles]]

We should create an accessibility section for the moz-toggle widget. This section should contain:

• Why you should always provide a label (for visual text) or aria-label (for visually hidden text)
• Why the widget is a button element (even though it behaves as a toggle) and what the aria-pressed attribute is doing for us (giving additional information to a screen reader to help determine the state of the toggle at any given time). Here's my previous argument for using aria-pressed over switch