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: src/content/en/2025/accessibility.md
+7-7Lines changed: 7 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -152,11 +152,11 @@ If you want to check whether your site is restricting zoom, examine its source c
152
152
153
153
### Language identification
154
154
155
-
Declaring a page's primary language with the `lang` attribute is essential. It lets screen readers select the correct pronunciation rules and enables browsers to provide more accurate automatic translations. Beyond the primary language, it’s equally important to specify the language of sections that differ from the main language. This ensures that screen readers properly switch pronunciation for foreign words or phrases.
155
+
Declaring a page's primary language with the `lang` attribute is essential. It lets screen readers select the correct pronunciation rules and enables browsers to provide more accurate automatic translations. Beyond the primary language, it's equally important to specify the language of sections that differ from the main language. This ensures that screen readers properly switch pronunciation for foreign words or phrases.
156
156
157
157
Despite being a <ahreflang="en"href="https://www.w3.org/WAI/WCAG22/Understanding/language-of-page">straightforward Level A WCAG requirement</a>, language declaration remains an area where many sites fall short. In 2025, roughly 86% of sites include a valid `lang` attribute, largely unchanged from 2024. This suggests steady adoption but also highlights room for improvement.
158
158
159
-
Correctly applying the `lang` attribute begins with including it on the `<html>` tag to specify the page's primary language. Pages often contain multiple languages. Use the `lang` attribute on individual elements or sections as needed. The <ahreflang="en"href="https://www.w3.org/WAI/WCAG21/Understanding/language-of-parts.html">W3C’s documentation on specifying the language of parts</a> provides detailed guidance on this topic.
159
+
Correctly applying the `lang` attribute begins with including it on the `<html>` tag to specify the page's primary language. Pages often contain multiple languages. Use the `lang` attribute on individual elements or sections as needed. The <ahreflang="en"href="https://www.w3.org/WAI/WCAG21/Understanding/language-of-parts.html">W3C's documentation on specifying the language of parts</a> provides detailed guidance on this topic.
160
160
161
161
Missing or incorrect language declarations can cause translation errors.
162
162
@@ -182,7 +182,7 @@ The most familiar queries, `prefers-reduced-motion` and `prefers-color-scheme`,
182
182
183
183
Continuing to incorporate these preferences advances accessibility and user satisfaction by respecting individual needs and system settings.
184
184
185
-
Broader implementation of personalization through CSS media queries hasn't seen significant growth despite these incremental gains. Encouraging further adoption helps ensure websites honor users’ preferences, including reducing motion for vestibular disorder sensitivities and adapting display colors or contrast for visual comfort.
185
+
Broader implementation of personalization through CSS media queries hasn't seen significant growth despite these incremental gains. Encouraging further adoption helps ensure websites honor users' preferences, including reducing motion for vestibular disorder sensitivities and adapting display colors or contrast for visual comfort.
186
186
187
187
## Navigation
188
188
@@ -194,7 +194,7 @@ Wide-screen TVs and voice interfaces like Siri and Amazon Alexa create unique na
194
194
195
195
Focus indication is essential for users who rely primarily on keyboard navigation and assistive devices to move through web content. It provides a visible cue that highlights which element is currently focused, so users understand where they are on the page.
196
196
197
-
Automated testing tools like Google Lighthouse can identify many basic requirements and flag obvious failures around focus indicators. But they're limited when it comes to complex interactions like keyboard traps, focus order, and whether focus moves logically to new content. Passing automated audits doesn’t guarantee a site’s keyboard accessibility or a good user experience for keyboard users.
197
+
Automated testing tools like Google Lighthouse can identify many basic requirements and flag obvious failures around focus indicators. But they're limited when it comes to complex interactions like keyboard traps, focus order, and whether focus moves logically to new content. Passing automated audits doesn't guarantee a site's keyboard accessibility or a good user experience for keyboard users.
198
198
199
199
Comprehensive manual testing is irreplaceable.
200
200
@@ -251,7 +251,7 @@ In 2025, `tabindex` usage has increased slightly. Just over 50% of sites used it
251
251
252
252
Landmarks structure a web page into distinct thematic regions, using native HTML elements such as `<header>`, `<nav>`, `<main>`, and `<footer>`. These elements create a clear, high-level page outline that help users of assistive technologies quickly understand the layout and jump directly to relevant sections.
253
253
254
-
A common accessibility anti pattern persists when developers add redundant ARIA attributes. For example, adding `role="navigation"` to a `<nav>` element. The `<nav>` element inherently carries the navigation role, so this duplication adds clutter to the code without benefit and may confuse assistive technology. <ahreflang="en"href="https://www.w3.org/WAI/WCAG21/Techniques/html/H101">Best practice is to favor native HTML5 elements</a> first before adding ARIA landmark roles. That's ARIA’s primary guideline.
254
+
A common accessibility anti pattern persists when developers add redundant ARIA attributes. For example, adding `role="navigation"` to a `<nav>` element. The `<nav>` element inherently carries the navigation role, so this duplication adds clutter to the code without benefit and may confuse assistive technology. <ahreflang="en"href="https://www.w3.org/WAI/WCAG21/Techniques/html/H101">Best practice is to favor native HTML5 elements</a> first before adding ARIA landmark roles. That's ARIA's primary guideline.
255
255
256
256
Accessibility experts like Eric Bailey have highlighted <ahreflang="en"href="https://www.smashingmagazine.com/2025/06/what-i-wish-someone-told-me-aria/">the pitfalls of overusing ARIA</a> in contexts where native semantic HTML is enough. Heydon Pickering's <ahreflang="en"href="https://heydonworks.com/article/pride-shame-and-accessibility/">twelve principles of web accessibility</a> also emphasize the critical role semantic structure and landmarks play in accessible navigation.
257
257
@@ -534,7 +534,7 @@ Continued efforts to replace or supplement visual CAPTCHAs with more accessible
534
534
535
535
Accessible media on the web requires providing alternative formats to ensure content is usable by everyone. Users with visual impairments benefit from audio descriptions that convey important visual information. Users who are deaf or hard of hearing rely on captions or sign language interpretation to access audio content.
536
536
537
-
Audio descriptions and captions aren't enough. Transcripts are necessary for audio-only and video-only content, offering a complete textual alternative. For non-text content like images, provide appropriate alternative text. If they don’t add meaningful information, mark them as decorative.
537
+
Audio descriptions and captions aren't enough. Transcripts are necessary for audio-only and video-only content, offering a complete textual alternative. For non-text content like images, provide appropriate alternative text. If they don't add meaningful information, mark them as decorative.
538
538
539
539
The principles and requirements for accessible media remain consistent between 2024 and 2025, emphasizing the ongoing importance of providing inclusive multimedia experiences to users with disabilities.
540
540
@@ -1142,7 +1142,7 @@ React offers maximum flexibility and customization, but requires developers to i
1142
1142
1143
1143
<ahreflang="en"href="https://angular.dev/">Angular</a> provides strong built-in accessibility features, structured conventions that promote semantic HTML, ARIA attribute support, and <ahreflang="en"href="https://material.angular.io/">Material Design</a> components with keyboard navigation and screen reader support out-of-the-box. Angular's opinionated structure tends to guide developers toward more standardized, accessible practices.
1144
1144
1145
-
<ahreflang="en"href="http://Vue.js">Vue.js</a> aims to strike a balance between React's flexibility and Angular’s structure. Vue’s progressive design, clear template syntax, and component architecture support accessibility, though it relies more on developer discipline and third-party plugins like <ahreflang="en"href="https://github.com/vue-a11y">vue-a11y</a>.
1145
+
<ahreflang="en"href="http://Vue.js">Vue.js</a> aims to strike a balance between React's flexibility and Angular's structure. Vue's progressive design, clear template syntax, and component architecture support accessibility, though it relies more on developer discipline and third-party plugins like <ahreflang="en"href="https://github.com/vue-a11y">vue-a11y</a>.
1146
1146
1147
1147
We also note that <ahreflang="en"href="https://github.blog/open-source/social-impact/our-pledge-to-help-improve-the-accessibility-of-open-source-software-at-scale/">GitHub took the Global Accessibility Awareness Day (GAAD) pledge</a> to improve open source accessibility at scale. This commitment addresses a critical gap: 90% of companies use open source, 97% of codebases contain open source components, and an estimated 70–90% of code within commercial tools derives from open source.
0 commit comments