Skip to content

Commit b059d6e

Browse files
Merge pull request #6872 from syncfusion-content/BLAZ-983104-ugdocsign
983104: Updated the UG Documentation for the Signature,Chip,Checkbox and message
2 parents 43c89f3 + 94f5afd commit b059d6e

31 files changed

+416
-382
lines changed

blazor/check-box/accessibility.md

Lines changed: 17 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -3,13 +3,13 @@ layout: post
33
title: Accessibility in Blazor CheckBox Component | Syncfusion
44
description: Checkout and learn here all about Accessibility in Syncfusion Blazor CheckBox component and much more.
55
platform: Blazor
6-
control: Checkbox
6+
control: CheckBox
77
documentation: ug
88
---
99

1010
# Accessibility in Blazor CheckBox Component
1111

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).
1313

1414
The accessibility compliance for the Blazor CheckBox component is outlined below.
1515

@@ -38,25 +38,35 @@ The accessibility compliance for the Blazor CheckBox component is outlined below
3838

3939
## WAI-ARIA attributes
4040

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:
4242

4343
| Attributes | Purpose |
4444
| --- | --- |
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). |
4547
| `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/).
4653

4754
## Keyboard interaction
4855

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:
5057

5158
| Windows | Mac | Actions |
5259
| --- | --- | --- |
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).
5464

5565
## Ensuring accessibility
5666

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.
5868

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.
6070

6171
{% previewsample "https://ej2.syncfusion.com/accessibility/checkbox.html" %}
6272

0 commit comments

Comments
 (0)