diff --git a/accessibility-checker-extension/src/assets/img/2_8_SettingsKeyboardChecker.png b/accessibility-checker-extension/src/assets/img/2_8_SettingsKeyboardChecker.png new file mode 100644 index 000000000..5c0e03a06 Binary files /dev/null and b/accessibility-checker-extension/src/assets/img/2_8_SettingsKeyboardChecker.png differ diff --git a/accessibility-checker-extension/src/assets/img/2_8_SettingsKeyboardVisualizationGuide.png b/accessibility-checker-extension/src/assets/img/2_8_SettingsKeyboardVisualizationGuide.png new file mode 100644 index 000000000..434faf014 Binary files /dev/null and b/accessibility-checker-extension/src/assets/img/2_8_SettingsKeyboardVisualizationGuide.png differ diff --git a/accessibility-checker-extension/src/assets/img/2_8_SettingsRulesets.png b/accessibility-checker-extension/src/assets/img/2_8_SettingsRulesets.png index a1b091830..e3bc18463 100644 Binary files a/accessibility-checker-extension/src/assets/img/2_8_SettingsRulesets.png and b/accessibility-checker-extension/src/assets/img/2_8_SettingsRulesets.png differ diff --git a/accessibility-checker-extension/src/assets/img/2_8_SettingsRulesets_old.png b/accessibility-checker-extension/src/assets/img/2_8_SettingsRulesets_old.png new file mode 100644 index 000000000..a1b091830 Binary files /dev/null and b/accessibility-checker-extension/src/assets/img/2_8_SettingsRulesets_old.png differ diff --git a/accessibility-checker-extension/src/assets/img/2_8_SettingsSelectGuideline.png b/accessibility-checker-extension/src/assets/img/2_8_SettingsSelectGuideline.png index 92c662622..7b460b89b 100644 Binary files a/accessibility-checker-extension/src/assets/img/2_8_SettingsSelectGuideline.png and b/accessibility-checker-extension/src/assets/img/2_8_SettingsSelectGuideline.png differ diff --git a/accessibility-checker-extension/src/assets/img/2_8_SettingsSelectGuideline_old.png b/accessibility-checker-extension/src/assets/img/2_8_SettingsSelectGuideline_old.png new file mode 100644 index 000000000..92c662622 Binary files /dev/null and b/accessibility-checker-extension/src/assets/img/2_8_SettingsSelectGuideline_old.png differ diff --git a/accessibility-checker-extension/src/ts/docs/QuickGuideACApp.tsx b/accessibility-checker-extension/src/ts/docs/QuickGuideACApp.tsx index 4827e7a08..d6675b6ff 100644 --- a/accessibility-checker-extension/src/ts/docs/QuickGuideACApp.tsx +++ b/accessibility-checker-extension/src/ts/docs/QuickGuideACApp.tsx @@ -445,6 +445,8 @@ export class QuickGuideACApp extends React.Component<{}, quickGuideACAppState> { alt="settings gear icon highlighted" />

+ +

Rule set settings

{ alt="Accessibility guidelines options" />

-

Rule sets for a specific accessibility guideline or version of the IBM Accessibility requirements are available to check against an established policy. +

Rule sets for a specific version of the WCAG accessibility guideline or version of the IBM Accessibility requirements are available to check against an established policy. Select one of the following:

IBM Accessibility 7.2: includes checking against WCAG 2.1 plus additional IBM requirements @@ -475,6 +477,26 @@ export class QuickGuideACApp extends React.Component<{}, quickGuideACAppState> { WCAG 2.1 (A, AA): referenced by EN 301 549 and other policies, but not the latest W3C specification WCAG 2.0 (A, AA): referenced by US Section 508 + +

Keyboard checker mode settings

+

+ Keyboard checker mode options +

+

This section contains the settings for the visualizations and notifications:

+ + Lines connecting tab stops: by default, the 'Lines connecting tab stops' checkbox is selected. + Without this setting, only the numbered tab stop icons would be visible on the page. + + Element outlines: by default, the bounding boxes do not display. + Select the 'Element outlines' checkbox to see light bounding boxes for each interactive element in the tab order. + + Alert notifications: toggles on and off the panel notification that appears every time the keyboard checker mode is selected. + This setting is equivalent to selecting the ‘Do not show this again’ checkbox in the notification panel. + +

For more in-depth guidance, view {

5. Settings

By default, the Checker uses the latest deployment of a set of rules that correspond to the WCAG standard, plus additional IBM requirements. - Use the 'Settings' page to change the default rule set for a supported guideline (standard) and the 'Keyboard Checker Mode' settings. + Use the 'Settings' page to change the default rule set for a supported guideline (standard) and the 'Keyboard checker mode' settings.

There are two methods to open the Settings page, the browser toolbar and the settings gear icon: @@ -939,24 +939,32 @@ class UsingACApp extends React.Component<{}, UsingACAppState> {

In the Checker panel itself, select the Settings gear icon to open the settings page.

+ +

Rule set settings

+

+ Rule sets are a packaged set of rules that are mapped to an accessibility guideline. + The rules in the sets are updated regularly and each update has a date of deployment. + For details on rule changes at each deployment, see the IBMa/equal-access Release Notes in GitHub. + For details on which rules are mapped to which accessibility requirement, see the Checker rule sets listed in the IBM Accessibility Requirements. +

+

+ The Latest Deployment rule set setting is the default. + For consistent testing throughout a project, choose a specific deployment date. + To replicate an earlier test, choose the deployment date of the original test. +

Rule set options

-

Rule set settings

-

- Rule sets with rules that map to a specific WCAG version are available. - The rule sets are updated regularly and each update has a date of deployment. - For consistent testing throughout a project, choose a specific date of deployment. - To replicate an earlier test, choose the deployment date of the original test. -

Select one of the following:

- Latest deployment - the latest rule set of the selected accessibility guideline (default) + Latest Deployment - the latest rule set of the selected accessibility guideline (default) <date> Deployment - replicate an earlier test by choosing the deployment date of the original test Preview Rules - experiment with a possible future rule set @@ -967,20 +975,27 @@ class UsingACApp extends React.Component<{}, UsingACAppState> { />

- Rule sets for a specific accessibility guideline or version of the IBM Accessibility requirements are available to check against an established policy. + The rule sets for a specific WCAG version or version of the IBM Accessibility Requirements are available to check against an established policy. Select one of the following options from the 'Select accessibility guidelines' dropdown:

- IBM Accessibility 7.2: includes checking against WCAG 2.1 plus additional IBM requirements + IBM Accessibility 7.2: includes checking against WCAG 2.1 plus additional IBM requirements. IBM Accessibility 7.3: includes checking against WCAG 2.2 plus additional IBM requirements. This will be the default starting Oct 1, 2024. - WCAG 2.2 (A, AA): this is the latest W3C specification. Content that conforms to WCAG 2.2 also conforms to WCAG 2.1 and 2.0 - WCAG 2.1 (A, AA): referenced by EN 301 549 and other policies, but not the latest W3C specification - WCAG 2.0 (A, AA): referenced by US Section 508 + WCAG 2.2 (A, AA): this is the latest W3C specification with no additional IBM requirements. Content that conforms to WCAG 2.2 also conforms to WCAG 2.1 and 2.0. + WCAG 2.1 (A, AA): referenced by earlier versions of EN 301 549 and other policies, but not the latest W3C specification. Content that conforms to WCAG 2.1 also conforms to WCAG 2.0. + WCAG 2.0 (A, AA): referenced by US Section 508.

Keyboard checker mode settings

-

- +

+ Keyboard checker mode options +

+

This section contains the settings for the visualizations and notifications:

+ Lines connecting tab stops: by default, the 'Lines connecting tab stops' checkbox is selected. Without this setting, only the numbered tab stop icons would be visible on the page. @@ -989,10 +1004,21 @@ class UsingACApp extends React.Component<{}, UsingACAppState> { Alert notifications: toggles on and off the panel notification that appears every time the keyboard checker mode is selected. This setting is equivalent to selecting the ‘Do not show this again’ checkbox in the notification panel. - - Keyboard tab stops: explanation panel can be displayed at any time by selecting the ‘More Info’ icon next to the ‘Keyboard tab stops’ heading above the list issues. - +
+

+ Keyboard tab stops - Visualization guide +

+

The Keyboard tap stops visualization guide notification panel is displayed each time the mode is turned on:

+ + Do not show this again: checkbox can be selected to avoid displaying the notification panel. + + Keyboard tab stops- Visualization guide: notification panel can be displayed at any time by selecting the ‘More Info’ icon next to the ‘Keyboard tab stops’ heading above the list issues. + +

6. Checker reports