diff --git a/STYLEGUIDE.md b/STYLEGUIDE.md index a71ad9cce0183..d43919b6c32b5 100644 --- a/STYLEGUIDE.md +++ b/STYLEGUIDE.md @@ -10,6 +10,7 @@ recommended for the development of all Kibana plugins. - [HTML](style_guides/html_style_guide.md) - [API](style_guides/api_style_guide.md) - [Architecture](style_guides/architecture_style_guide.md) +- [Accessibility](style_guides/acecssibility_guide.md) ## Filenames diff --git a/style_guides/accessibility_guide.md b/style_guides/accessibility_guide.md new file mode 100644 index 0000000000000..2ccc5c9f7ad69 --- /dev/null +++ b/style_guides/accessibility_guide.md @@ -0,0 +1,230 @@ +# Accessibility (A11Y) Guide + +This document provides some technical guidelines how to prevent several common +accessibility issues. + +## Naming elements + +### `aria-label` and `aria-labelledby` + +Every element on a page will have a name, that is read out to an assistive technology +like a screen reader. This will for most elements be the content of the element. +For form elements it will be the content of the assosciated `