diff --git a/modules/preview-react/switch/stories/Switch.mdx b/modules/preview-react/switch/stories/Switch.mdx index c43d0907fb..0e918b97a9 100644 --- a/modules/preview-react/switch/stories/Switch.mdx +++ b/modules/preview-react/switch/stories/Switch.mdx @@ -80,6 +80,125 @@ Switch supports right-to-left languages when specified in the CanvasProvider the Switch supports custom styling via the `cs` prop. For more information, check our ["How To Customize Styles"](https://workday.github.io/canvas-kit/?path=/docs/styling-guides-customizing-styles--docs). +## Accessibility + +The primary accessibility goal is a visible, programmatically determinable name and an on or off +state that assistive technology can expose. Use **Switch** for a single setting that takes effect +immediately when toggled (for example, "Dark Mode"). When the user selects one or more options that +are applied on form submission, use [**Checkbox**](/components/inputs/checkbox/) instead. **Switch** +does not render its own `