Quick Assess in Accessibility Insights for Web

What is Quick Assess?

Quick Assess is a process that measures limited compliance with Web Content Accessibility Guidelines (WCAG) 2.1 Level AA success criteria with 10 requirements and each test covers one accessibility requirement.

There are three types of requirement:

  • Automated – the tool identifies instances and evaluates them automatically.
  • Assisted – the tool actively helps you identify or evaluate instances.
  • Manual – the tool provides instructions for identifying and evaluating instances.

Note: Completing a quick assess pass requires you to use standard keyboard commands and to visually identify interactive interface elements.

How to complete a Quick Assess

Get ready to test

  1. In Chrome or the new Microsoft Edge, navigate to the page you want to test (aka the target page).

  2. Open Accessibility Insights for Web:

    • Select the extension icon.

    or

    or

    • Use these keyboard commands:

      Windows or Linux:

      1. Press Shift+Alt+T or F10 to set focus on the browser's address bar.
      2. Press the Left arrow to set focus on the Accessibility Insights for Web extension.
      3. Press the Space key to open the extension.

      MacOS:

      1. Press ⌘+L to set focus on the browser's address bar.
      2. Press the Tab key to set focus on the Accessibility Insights for Web extension.
      3. Press the Space key to open the extension.

    The Accessibility Insights for Web extension will open to the Launch pad.

    Four options are available in the Launch pad: FastPass, Quick Assess, Assessment, Ad hoc tools

  3. In the Launch pad, select Quick Assess.

    A secondary browser window will open to an overview of the quick assess process and results. At this point, the quick assess pass is 100% incomplete, so no results are available.

    Target page and the overview displayed side-by-side

Run the automated checks

  1. In the navigation pane, select Automated checks.

    The navigation pane will expand to show all of the automated checks, listed in alphabetical order.

  2. Optional: To learn more about automated checks:

    1. In the navigation pane, under Automated checks, select Getting started.

      The main pane will update to show a brief description of automated checks.

    2. In the main pane, next to the page title, select Guidance .

      A new browser tab will open with additional information about automated checks.

  3. In the navigation pane, under Getting started, select the first rule, area-alt.

    Within a few seconds, Accessibility Insights for Web will run all of the automated checks. The navigation pane will update to show the outcome for each rule checked.

    Automated checks results displayed in the navigation pane

  4. Explore the results:

    • To see failure instances: In the navigation pane, select a rule that failed.

    • To learn more about a rule: In the main pane, under How to test select See more info here.

    • To see failure instances highlighted directly in your target page:

      • In the main pane, turn on the Visual helper toggle (highlights all failure instances simultaneously).

      or

      • In the main pane, select one or more check boxes (highlights only selected failure instances).

    Failure instances highlighted on the target page

Complete the assisted and manual tests

Each of the remaining ten requirements covers accessibility requirements. We recommend completing the tests and requirements in the order they appear in the navigation pane.

  1. In the navigation pane, collapse the list of automated checks by selecting Automated checks.

  2. Select the next test (Keyboard).

    The navigation pane will expand to show all of the test requirements.

  3. Optional: To learn more about (Why it Matters), view this information in the grey box on the right side under (Why it Matters.)

  4. Optional: To learn more about this requirement, review the information and links on the Why it Matters section.

A side panel will open with detailed information about the requirement:

  • Why it matters
  • From a user's perspective (where applicable). This is a contribution from the Design for People Guidelines.
  • How to fix
  • Examples
  • Code snippets (where applicable)
  • Links to relevant WCAG success criteria, sufficient techniques, and common failures.

Requirement guidance in a side panel

  1. Read the instructions under How to test.

  2. Evaluate the instances and record your results.

    Some requirements in a quick assess require you to manually identify the instances to evaluate. (All of the requirements in the Keyboard test require you to manually identify instances.)

    Some requirements automatically generate a list of instances to evaluate. (The first requirement that generates a list of instances is in the Link Purpose requirement)

    • For manual requirements:

      1. Select Pass or Fail for the requirement.

        Tip: You can reset a requirement to its original indeterminate state by selecting Undo .

      2. If the requirement fails, add a failure instance. (If the requirement passes, no further input is needed.)

      Keyboard navigation requirement shows failed when one failure instance added

    • For assisted requirements, select Pass or Fail for each instance.

      Tip: You can reset an instance to is original indeterminate state by selecting Undo . Tip: After you mark all the failures, you can pass the remaining instances by selecting Pass unmarked instances.

      Link purpose requirement shows passed when all instances are marked as pass

  3. Select the next requirement, follow the instructions, and record your results.

  4. Repeat with the remaining requirements.

  5. When every requirement in every test is marked as Pass or Fail, your quick assess is complete.

View a summary of the quick assess results

At any time, select Overview in the navigation pane.

Overview showing current results for an in progress quick assess

Share a detailed report of the assessment results

  1. In the command bar near the top of the page, select Export result.

    A dialog will open.

  2. Optional: In the dialog, provide a description for the report.

  3. Select Export and choose one of the options.

To export as HTML

The HTML report groups results by the tests in Quick Assess and provides a summarized view of all the tests and their state (pass, fail or incomplete).

  1. In the Export dialog, under the Export dropdown, select Export as HTML.

An HTML report will automatically download to your computer. Depending on your browser, the report might open automatically in a new browser tab, or you might have to open it manually. Report showing results of a completed assessment

To export as JSON

The JSON report groups results by the Success Criteria and provides a list of all the requirements under each S.C. The date for the JSON report is exported in ISO 8601 format and the report version is the same as the Accessibility Insights for Web extension version.

  1. In the Export dialog, under the Export dropdown, select Export as JSON.

A JSON report will automatically download to your computer.

Start Over

Start a new Quick Assess

Data collected in a Quick Assess will persist until you start a new Quick Assess.

  1. In the command bar near the top of the page, select Start over > Start over Quick Assess.

    Note: Depending on the width of your browser window, you might have to select the More items disclosure button to access Start over.

  2. In the confirmation dialog, select Start over.

    All data in the quick assess will be cleared, and you will automatically navigate to the Quick Assess Overview.

Move to Assessment

At any time, you can move your data and test results from Quick Assess into Assessment. If you have an existing assessment in progress, you will be notified through a dialog.

  1. In the command bar near the top of the page, select Move to assessment.

  2. Once you are in the assessment view, you will have the existing data, that contains quick assess results, and the functionality to complete additional tests and requirements.

  3. Alternatively, you can also move to Assessment using the Complete button on the last requirement page of Quick Assess.

    Note: Data collected in an assessment persists until you load or start a new assessment. If there is an in progress assessment already, a confirmation dialog will appear. Loading an assessment or quick assess pass will clear all data in the local in-progress assessment.