-
Notifications
You must be signed in to change notification settings - Fork 80
1007599: Add a Accessibility file in Sankey controls. #7535
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: development
Are you sure you want to change the base?
Changes from all commits
2a21d14
a9c8aeb
7bd6790
0155897
20df736
5f1ef61
a1e14a3
3a46b53
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,83 @@ | ||
| --- | ||
| layout: post | ||
| title: Accessibility in Blazor Sankey Component | Syncfusion | ||
| description: Checkout and learn here all about Accessibility using Keyboard navigation in Syncfusion Blazor Sankey component and more. | ||
| platform: Blazor | ||
| control: Sankey | ||
| documentation: ug | ||
| --- | ||
|
|
||
| # Accessibility in Blazor Sankey Component | ||
|
|
||
| The Blazor Sankey component followed the accessibility guidelines and standards, including [ADA](https://www.ada.gov/), [Section 508](https://www.section508.gov/), [WCAG 2.2](https://www.w3.org/TR/WCAG22/) standards, and [WCAG roles](https://www.w3.org/TR/wai-aria/#roles) that are commonly used to evaluate accessibility. | ||
|
|
||
| The accessibility compliance for the Blazor Sankey component is outlined below. | ||
|
|
||
| | Accessibility Criteria | Compatibility | | ||
| | -- | -- | | ||
| | [WCAG 2.2 Support](../common/accessibility#accessibility-standards) | <img src="https://cdn.syncfusion.com/content/images/landing-page/yes.png" alt="Yes"> | | ||
| | [Section 508 Support](../common/accessibility#accessibility-standards) | <img src="https://cdn.syncfusion.com/content/images/landing-page/yes.png" alt="Yes"> | | ||
| | [Screen Reader Support](../common/accessibility#screen-reader-support) | <img src="https://cdn.syncfusion.com/content/images/landing-page/yes.png" alt="Yes"> | | ||
| | [Right-To-Left Support](../common/accessibility#right-to-left-support) | <img src="https://cdn.syncfusion.com/content/images/landing-page/yes.png" alt="Yes"> | | ||
| | [Color Contrast](../common/accessibility#color-contrast) | <img src="https://cdn.syncfusion.com/content/images/landing-page/yes.png" alt="Yes"> | | ||
| | [Mobile Device Support](../common/accessibility#mobile-device-support) | <img src="https://cdn.syncfusion.com/content/images/landing-page/yes.png" alt="Yes"> | | ||
| | [Keyboard Navigation Support](../common/accessibility#keyboard-navigation-support) |<img src="https://cdn.syncfusion.com/content/images/landing-page/yes.png" alt="Yes"> | | ||
| | [Axe-core Accessibility Validation](../common/accessibility#ensuring-accessibility) | <img src="https://cdn.syncfusion.com/content/images/landing-page/yes.png" alt="Yes"> | | ||
|
|
||
| <style> | ||
| .post .post-content img { | ||
| display: inline-block; | ||
| margin: 0.5em 0; | ||
| } | ||
| </style> | ||
|
|
||
| <div><img src="https://cdn.syncfusion.com/content/images/documentation/full.png" alt="Yes"> - All features of the component meet the requirement.</div> | ||
|
|
||
| <div><img src="https://cdn.syncfusion.com/content/images/documentation/partial.png" alt="Intermediate"> - Some features of the component do not meet the requirement.</div> | ||
|
|
||
| <div><img src="https://cdn.syncfusion.com/content/images/documentation/not-supported.png" alt="No"> - The component does not meet the requirement.</div> | ||
|
|
||
| ## WAI-ARIA attributes | ||
|
|
||
| WAI-ARIA(Accessibility Initiative - Accessible Rich Internet Applications) defines a way to increase the accessibility of web pages, dynamic content, and user interface components developed with AJAX, HTML, JavaScript, and related technologies. ARIA provides additional semantics to describe the role, state, and functionality of web components. | ||
|
|
||
| Element |Default description | ||
| -----|----- | ||
| Links |Reads the link value. | ||
| Nodes |Reads the Node value. | ||
| Legend |Reads the legend value. | ||
|
|
||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Also check the accessibility for links and legends for Sankey and add them if capable.
Contributor
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Modified the content. |
||
| The Blazor Sankey component followed the [WAI-ARIA](https://www.w3.org/WAI/ARIA/apg/patterns/alert/) patterns to meet the accessibility. The following ARIA attributes are used in the Blazor Sankey component: | ||
|
|
||
| * img (role) | ||
| * button (role) | ||
| * region (role) | ||
| * aria-label (attribute) | ||
| * aria-hidden (attribute) | ||
| * aria-pressed (attribute) | ||
|
|
||
| ## Keyboard navigation | ||
|
|
||
| The Blazor Sankey component followed the [keyboard interaction](https://www.w3.org/WAI/ARIA/apg/patterns/alert/#keyboardinteraction) guideline, making it easy for people who use assistive technologies (AT) and those who completely rely on keyboard navigation. The following keyboard shortcuts are supported by the Blazor Sankey component. | ||
|
|
||
| | Windows | Mac | Description | | ||
| |-----|-----|---| | ||
| | <kbd>Tab</kbd> | <kbd>Tab</kbd> | Moves focus to the next focusable element in the Sankey. | | ||
| | <kbd>↓</kbd> | <kbd>↓</kbd> | Moves focus to the data point below the selected node. | | ||
| | <kbd>↑</kbd> | <kbd>↑</kbd> | Moves focus to the data point above the selected node. | | ||
| | <kbd>←</kbd> | <kbd>←</kbd> | Moves focus to the data point to the left of the selected node. | | ||
| | <kbd>→</kbd> | <kbd>→</kbd> | Moves focus to the data point to the right of the selected node. | | ||
| | <kbd>Ctrl</kbd> + <kbd>P</kbd> | <kbd>⌘</kbd> + <kbd>P</kbd> | Prints the Sankey. | | ||
|
|
||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. "Ensuring Accessibility" content was missing. Check with Chart component UG and update that content too.
Contributor
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Add the missing content in Accessibility files |
||
|
|
||
| ## Ensuring accessibility | ||
|
|
||
| The Blazor Sankey component's accessibility levels are ensured through an [axe-core](https://www.nuget.org/packages/Deque.AxeCore.Playwright) with playwright tests. | ||
|
|
||
| The accessibility compliance of the Blazor Sankey component is shown in the following sample. Open the sample in a new window to evaluate the accessibility of the Blazor Sankey component with accessibility tools. | ||
|
|
||
| ## See also | ||
|
|
||
| * [Accessibility in Syncfusion<sup style="font-size:70%">®</sup> Blazor components](https://blazor.syncfusion.com/documentation/common/accessibility) | ||
|
|
||
| * [Accessibility Customization in Syncfusion<sup style="font-size:70%">®</sup> Blazor components](./advanced-accessibility-configuration) | ||
Uh oh!
There was an error while loading. Please reload this page.