{"id":315,"date":"2022-02-14T08:14:13","date_gmt":"2022-02-14T16:14:13","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/?p=315"},"modified":"2022-02-14T08:15:04","modified_gmt":"2022-02-14T16:15:04","slug":"accessibility-insights-for-web","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/accessibility-insights-for-web\/","title":{"rendered":"Accessibility Insights for Web"},"content":{"rendered":"<p>This month we are continuing the series about Accessibility Insights, a suite of open-source accessibility testing tools. In December, <a href=\"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/accessibility-insights-for-windows\/\">John&#8217;s post<\/a> introduced <a href=\"https:\/\/accessibilityinsights.io\/docs\/en\/windows\/overview\">Accessibility Insights for Windows<\/a>, our tool that enables users to evaluate the accessibility of Windows applications. For this blog entry, we\u2019ll discuss <a href=\"https:\/\/accessibilityinsights.io\/docs\/en\/web\/overview\/\">Accessibility Insights for Web<\/a>, our Chrome and Edge extension that helps users find and fix web accessibility issues. You can evaluate web pages against the Web Content Accessibility Guidelines (WCAG) standards, and the extension provides support for <a href=\"https:\/\/www.w3.org\/TR\/WCAG21\/\">WCAG 2.1<\/a>. The extension has two primary workflows: the lightweight FastPass experience and the more detailed Assessment process. Let\u2019s explore both and learn how Accessibility Insights for Web can help you build web apps and web sites that are more accessible than before!<\/p>\n<h3>FastPass<\/h3>\n<p>The <a href=\"https:\/\/accessibilityinsights.io\/docs\/en\/web\/getstarted\/fastpass\/\">FastPass<\/a> experience helps users identify common, high-impact accessibility issues in approximately five minutes. This process involves three steps: The first step, <a href=\"https:\/\/accessibilityinsights.io\/docs\/en\/web\/getstarted\/fastpass\/#run-automated-checks\">Automated Checks<\/a>, automatically evaluates your page against dozens of accessibility requirements; these checks are powered by the <a href=\"https:\/\/www.npmjs.com\/package\/axe-core\"><strong>axe-core<\/strong><\/a> rules engine. Failures are immediately flagged and highlighted on the target page. You can use the visual helper toggle to show or hide failures on the target page. In the extension, you are presented with a list of failed instances grouped by violation.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-FastPass-AutoChecks-1.png\"><img decoding=\"async\" class=\"alignnone wp-image-328\" src=\"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-FastPass-AutoChecks-1.png\" alt=\"Failures highlighted on the target page and listed in the Accessibility Insights for Web page. The list has 24 instances and is collapsed. The Visual helper toggle is on. \" width=\"907\" height=\"576\" srcset=\"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-FastPass-AutoChecks-1.png 1000w, https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-FastPass-AutoChecks-1-300x191.png 300w, https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-FastPass-AutoChecks-1-768x488.png 768w\" sizes=\"(max-width: 907px) 100vw, 907px\" \/><\/a><\/p>\n<p>You can expand the list to see detailed information about each failure, its location, and a recommendation for <strong>How to fix <\/strong>it. The extension also features a <strong>Resource for this rule<\/strong> section with hyperlinks to additional documentation. This helps you learn about the \u201cwhy\u201d behind the applicable rule.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-FastPass-Tabstops.png\"><img decoding=\"async\" class=\"alignnone wp-image-322\" src=\"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-FastPass-Tabstops-1024x559.png\" alt=\"Four color-contrast failures highlighted on the target page. The Accessibility Insights for web page shows the expanded list of color contrast failures. For each failure, there is an element path, code snippet, and information on how to fix. \" width=\"906\" height=\"494\" srcset=\"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-FastPass-Tabstops-1024x559.png 1024w, https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-FastPass-Tabstops-300x164.png 300w, https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-FastPass-Tabstops-768x419.png 768w, https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-FastPass-Tabstops.png 1446w\" sizes=\"(max-width: 906px) 100vw, 906px\" \/><\/a><\/p>\n<p>For each failure instance, the extension offers options that enable you to file an issue in either a GitHub or Azure Boards repository, or to copy the details of the failure to the clipboard, allowing you to paste the information in any other tool of your choice and share your findings with others. You can also export the results of your <strong>Automated Checks <\/strong>run to an HTML report file.<\/p>\n<p>The second step of <strong>FastPass<\/strong> is <a href=\"https:\/\/accessibilityinsights.io\/docs\/en\/web\/getstarted\/fastpass\/#complete-the-manual-test-for-tab-stops\">Tab Stops<\/a>, a manual assisted test that helps you assess accessibility issues related to keyboard access. When the test starts, you will be redirected to the target page where you can navigate using the keyboard. Accessibility Insights for Web will highlight any elements which receive focus, numbering them so that it is easier for you to identify the tab order. By following the path shown, you can quickly identify accessibility issues such as missing tab stops, keyboard traps, or incorrect tab order.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-Tabstops-2.png\"><img decoding=\"async\" class=\"alignnone wp-image-330\" src=\"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-Tabstops-2.png\" alt=\"On the target page, there is a number in a circle on top of each element in the tab order with arrows between the circles. On the Accessibility Insights for Web page, &quot;Show Tab Stops&quot; has been toggled on and there are instructions on how to complete this test. \" width=\"902\" height=\"573\" srcset=\"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-Tabstops-2.png 1000w, https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-Tabstops-2-300x191.png 300w, https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-Tabstops-2-768x488.png 768w\" sizes=\"(max-width: 902px) 100vw, 902px\" \/><\/a><\/p>\n<p>The third, optional step is <a href=\"https:\/\/accessibilityinsights.io\/docs\/en\/web\/getstarted\/fastpass\/#optional-evaluate-instances-that-need-review\">Needs Review<\/a>, which helps you identify additional potential accessibility issues on your web page or site. This automated test generates a list of elements that require human review to determine if they pass or fail accessibility criteria. Like the <strong>Automated Checks<\/strong> test, you will be presented with a list of instances grouped by rule. Expanding a rule provides <strong>How to check <\/strong>instructions so you can manually assess each instance.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-web-needs-review.png\"><img decoding=\"async\" class=\"alignnone wp-image-338\" src=\"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-web-needs-review-1024x502.png\" alt=\"Needs review selected in the navigation pane, and instances that need review listed in the main panel\" width=\"901\" height=\"442\" srcset=\"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-web-needs-review-1024x502.png 1024w, https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-web-needs-review-300x147.png 300w, https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-web-needs-review-768x376.png 768w, https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-web-needs-review-1536x752.png 1536w, https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-web-needs-review.png 1921w\" sizes=\"(max-width: 901px) 100vw, 901px\" \/><\/a><\/p>\n<h3>Assessment<\/h3>\n<p>Through a mixture of 20+ manual, assisted, and automated checks, our <a href=\"https:\/\/accessibilityinsights.io\/docs\/en\/web\/getstarted\/assessment\/\">Assessment<\/a> workflow allows you to verify your page\u2019s conformance with WCAG 2.1 level AA standards and success criteria.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-Automated-Checks-Overview.png\"><img decoding=\"async\" class=\"alignnone wp-image-324\" src=\"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-Automated-Checks-Overview.png\" alt=\"Target page and the Assessment overview displayed side-by-side. The Assessment shows as 0% complete and no results are available. \" width=\"912\" height=\"500\" srcset=\"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-Automated-Checks-Overview.png 1000w, https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-Automated-Checks-Overview-300x164.png 300w, https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-Automated-Checks-Overview-768x421.png 768w\" sizes=\"(max-width: 912px) 100vw, 912px\" \/><\/a><\/p>\n<p>The first test is <strong>Automated Checks<\/strong> (the same test you run for the first step of <strong>FastPass<\/strong>). You can then run the remaining tests that evaluate your page against the additional WCAG 2.1 success criteria, with categories including headings, color contrast, etc. Each test section begins with a <strong>Getting started <\/strong>page that provides introductory information and context for this group of requirements. This includes documentation about why these tests matter, Do\u2019s and Don&#8217;ts, and links to the relevant WCAG guidance<strong>. <\/strong><\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-Keyboard.png\"><img decoding=\"async\" class=\"alignnone wp-image-325\" src=\"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-Keyboard.png\" alt=\"Keyboard test guidance opened in a new browser tab. Guidance features &quot;Why it matters&quot;, a design do-and-don't list, and information for users to learn more. \" width=\"920\" height=\"504\" srcset=\"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-Keyboard.png 1000w, https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-Keyboard-300x164.png 300w, https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-Keyboard-768x421.png 768w\" sizes=\"(max-width: 920px) 100vw, 920px\" \/><\/a><\/p>\n<p>Each requirement features step-by-step instructions, examples, and <strong>How to test<\/strong> guidance to help you diagnose and, if necessary, resolve the issue. Several tests are \u201cassisted,\u201d meaning either the tool automatically identifies potential failures for you to manually verify, or the tool provides you with a visual helper to highlight failure instances in the target page. At the end of each requirement, you indicate whether your page has passed or failed a given requirement.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-Keyboard-Navigation.png\"><img decoding=\"async\" class=\"alignnone wp-image-326\" src=\"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-Keyboard-Navigation.png\" alt=\"Test instructions in the main pane\" width=\"927\" height=\"508\" srcset=\"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-Keyboard-Navigation.png 1000w, https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-Keyboard-Navigation-300x164.png 300w, https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-content\/uploads\/sites\/72\/2022\/02\/AI-Web-Keyboard-Navigation-768x421.png 768w\" sizes=\"(max-width: 927px) 100vw, 927px\" \/><\/a><\/p>\n<p>At any time during the <strong>Assessment <\/strong>workflow, you can access the results in the <strong>Overview<\/strong> section, where a summary of your progress, passing percentage and failing percentage are available for easy review. You can also easily export the result in your preferred format (either HTML or JSON). You can learn more about <a href=\"https:\/\/accessibilityinsights.io\/docs\/en\/web\/getstarted\/assessment\/#share-a-detailed-report-of-the-assessment-results\">generating a report<\/a> on our documentation site.<\/p>\n<p>This concludes our introduction to Accessibility Insights for Web! You can visit <a href=\"https:\/\/accessibilityinsights.io\">https:\/\/accessibilityinsights.io<\/a> to learn more and download the extension for either Chrome or Edge browsers. If you\u2019re interested in contributing or want to install the Canary\/Insider versions of the tool, you can check out the GitHub repo at <a href=\"https:\/\/github.com\/Microsoft\/accessibility-insights-web\">https:\/\/github.com\/Microsoft\/accessibility-insights-web<\/a>. Next time we&#8217;ll share more information about our Android accessibility tools, so stay tuned for even more ways you can build accessible and inclusive applications.<\/p>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>In this post, Jacqueline Gibson goes over Accessibility Insights for Web, Microsoft&#8217;s open-sourced Chrome and Edge extension that helps users find and fix web accessibility issues.<\/p>\n","protected":false},"author":84002,"featured_media":113,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[4,5,21],"class_list":["post-315","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-engineering-at-microsoft","tag-1es","tag-accessibility","tag-ally"],"acf":[],"blog_post_summary":"<p>In this post, Jacqueline Gibson goes over Accessibility Insights for Web, Microsoft&#8217;s open-sourced Chrome and Edge extension that helps users find and fix web accessibility issues.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-json\/wp\/v2\/posts\/315","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-json\/wp\/v2\/users\/84002"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-json\/wp\/v2\/comments?post=315"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-json\/wp\/v2\/posts\/315\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-json\/wp\/v2\/media\/113"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-json\/wp\/v2\/media?parent=315"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-json\/wp\/v2\/categories?post=315"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/engineering-at-microsoft\/wp-json\/wp\/v2\/tags?post=315"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}