You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: blazor/check-box/accessibility.md
+17-7Lines changed: 17 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,13 +3,13 @@ layout: post
3
3
title: Accessibility in Blazor CheckBox Component | Syncfusion
4
4
description: Checkout and learn here all about Accessibility in Syncfusion Blazor CheckBox component and much more.
5
5
platform: Blazor
6
-
control: Checkbox
6
+
control: CheckBox
7
7
documentation: ug
8
8
---
9
9
10
10
# Accessibility in Blazor CheckBox Component
11
11
12
-
The Blazor CheckBox 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.
12
+
The Blazor CheckBox component follows established accessibility standards, including ADA, Section 508, and WCAG 2.2 guidelines. It supports screen readers, keyboard navigation, right-to-left (RTL) layouts, and high-contrast themes. For component details, see the CheckBox overview in the documentation (https://blazor.syncfusion.com/documentation/checkbox/) and the SfCheckBox API reference (https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Buttons.SfCheckBox.html). For enabling RTL at the component level, refer to Right-to-left support (./how-to/right-to-left).
13
13
14
14
The accessibility compliance for the Blazor CheckBox component is outlined below.
15
15
@@ -38,25 +38,35 @@ The accessibility compliance for the Blazor CheckBox component is outlined below
38
38
39
39
## WAI-ARIA attributes
40
40
41
-
The Blazor CheckBox component followed the [WAI-ARIA](https://www.w3.org/WAI/ARIA/apg/patterns/checkbox/) patterns to meet the accessibility. The following ARIA attributes are used in the Blazor CheckBox component:
41
+
The Blazor CheckBox component follows the WAI-ARIA Authoring Practices for checkboxes to ensure compatibility with assistive technologies. The following ARIA roles and attributes are used:
42
42
43
43
| Attributes | Purpose |
44
44
| --- | --- |
45
+
|`role="checkbox"`| Identifies the element as a checkbox control to assistive technologies. |
46
+
|`aria-checked`| Conveys the current state of the checkbox: `true`, `false`, or `mixed` (for indeterminate state). |
45
47
|`aria-disabled`| Indicates that the element is perceivable but disabled, so it is not editable or otherwise operable. |
48
+
|`aria-readonly`| Indicates that the value cannot be changed by the user (read-only state). |
49
+
|`aria-labelledby` / `aria-label`| Provides an accessible name. When the `Label` parameter is used, it associates a visible label with the checkbox. |
50
+
|`tabindex`| Ensures the checkbox is focusable via keyboard navigation in the expected order. |
51
+
52
+
For guidance on ARIA usage, see the ARIA checkbox pattern (https://www.w3.org/WAI/ARIA/apg/patterns/checkbox/).
46
53
47
54
## Keyboard interaction
48
55
49
-
The Blazor CheckBox component followed the [keyboard interaction](https://www.w3.org/WAI/ARIA/apg/patterns/checkbox/#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 CheckBox component.
56
+
The Blazor CheckBox component follows the keyboard interaction guidance, making it accessible to users who rely on keyboards or assistive technologies. The following keyboard shortcuts are supported:
50
57
51
58
| Windows | Mac | Actions |
52
59
| --- | --- | --- |
53
-
| <kbd>Space</kbd> | <kbd>Space</kbd> | When the CheckBox has focus, pressing the Space key changes the state of the CheckBox. |
60
+
| <kbd>Tab</kbd> / <kbd>Shift</kbd> + <kbd>Tab</kbd> | <kbd>Tab</kbd> / <kbd>Shift</kbd> + <kbd>Tab</kbd> | Moves focus to the checkbox or away from it following the tab sequence. |
61
+
| <kbd>Space</kbd> | <kbd>Space</kbd> | When the CheckBox has focus, pressing Space toggles its state. |
62
+
63
+
For detailed keyboard recommendations, see the ARIA checkbox keyboard interaction guidance (https://www.w3.org/WAI/ARIA/apg/patterns/checkbox/#keyboardinteraction).
54
64
55
65
## Ensuring accessibility
56
66
57
-
The Blazor CheckBox component's accessibility levels are ensured through an [axe-core](https://www.nuget.org/packages/Deque.AxeCore.Playwright) with playwright tests.
67
+
The Blazor CheckBox component's accessibility levels are validated using axe-core with Playwright tests to catch common issues such as missing names, incorrect ARIA states, and insufficient color contrast. Results can vary based on theme customization; ensure color contrast meets WCAG minimum ratios.
58
68
59
-
The accessibility compliance of the Blazor CheckBox component is shown in the following sample. Open the [sample](https://blazor.syncfusion.com/accessibility/checkbox) in a new window to evaluate the accessibility of the Blazor CheckBox component with accessibility tools.
69
+
The accessibility compliance of the Blazor CheckBox component is shown in the following sample. Open the sample in a new window to evaluate the component with accessibility tools.
0 commit comments