From e1f4ccf5096070f0f796a95b3285800d89d11bdf Mon Sep 17 00:00:00 2001 From: Mike Gower Date: Mon, 21 Mar 2022 10:34:42 -0700 Subject: [PATCH] Breadcrumb accessibility (#2773) * Update accessibility.mdx Add new template. * Update accessibility.mdx Updated content to match handoff material * Update accessibility.mdx modified update to opening paragraph * added images * Update accessibility.mdx removed contraction * Update accessibility.mdx Altered headings and image captions; corrected spelling of labelling * updated images * Update accessibility.mdx slight update to caption to remove formatting Co-authored-by: kodiakhq[bot] <49736102+kodiakhq[bot]@users.noreply.github.com> --- .../components/breadcrumb/accessibility.mdx | 338 ++---------------- .../images/breadcrumb-accessibility-1.png | Bin 0 -> 44898 bytes .../images/breadcrumb-accessibility-2.png | Bin 0 -> 35733 bytes 3 files changed, 28 insertions(+), 310 deletions(-) create mode 100644 src/pages/components/breadcrumb/images/breadcrumb-accessibility-1.png create mode 100644 src/pages/components/breadcrumb/images/breadcrumb-accessibility-2.png diff --git a/src/pages/components/breadcrumb/accessibility.mdx b/src/pages/components/breadcrumb/accessibility.mdx index 999d094c1c5..0584cade687 100644 --- a/src/pages/components/breadcrumb/accessibility.mdx +++ b/src/pages/components/breadcrumb/accessibility.mdx @@ -6,335 +6,53 @@ description: tabs: ['Usage', 'Style', 'Code', 'Accessibility'] --- -import { - StructuredListWrapper, - StructuredListHead, - StructuredListBody, - StructuredListRow, - StructuredListInput, - StructuredListCell, - OrderedList, - ListItem, -} from 'carbon-components-react'; + + +No accessibility annotations are needed for breadcrumbs, but keep these considerations in mind if you are modifying Carbon or creating a custom component. + + - How it works - Accessibility considerations - Resources - Accessibility testing + What Carbon provides + Development considerations -## How it works +## What Carbon provides -The `Breadcrumb` component implements the -[Breadcrumb design pattern from WAI ARIA](https://www.w3.org/TR/wai-aria-practices-1.1/#breadcrumb) -for Carbon. It establishes a landmark on the page which assists the user in -understanding where they currently are and which pages exist in the current -page's hierarchical order. +Carbon bakes keyboard operation into its components, improving the experience of blind users and others who operate via the keyboard. Carbon incorporates many other accessibility considerations, some of which are described below. -The landmark is provided through the `