Skip to content

Commit 56d120e

Browse files
authored
Remove smart quotes (#4320)
1 parent df59a83 commit 56d120e

File tree

1 file changed

+7
-7
lines changed

1 file changed

+7
-7
lines changed

src/content/en/2025/accessibility.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -152,11 +152,11 @@ If you want to check whether your site is restricting zoom, examine its source c
152152

153153
### Language identification
154154

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, its 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.
156156

157157
Despite being a <a hreflang="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.
158158

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 <a hreflang="en" href="https://www.w3.org/WAI/WCAG21/Understanding/language-of-parts.html">W3Cs 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 <a hreflang="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.
160160

161161
Missing or incorrect language declarations can cause translation errors.
162162

@@ -182,7 +182,7 @@ The most familiar queries, `prefers-reduced-motion` and `prefers-color-scheme`,
182182

183183
Continuing to incorporate these preferences advances accessibility and user satisfaction by respecting individual needs and system settings.
184184

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

187187
## Navigation
188188

@@ -194,7 +194,7 @@ Wide-screen TVs and voice interfaces like Siri and Amazon Alexa create unique na
194194

195195
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.
196196

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 doesnt guarantee a sites 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.
198198

199199
Comprehensive manual testing is irreplaceable.
200200

@@ -251,7 +251,7 @@ In 2025, `tabindex` usage has increased slightly. Just over 50% of sites used it
251251

252252
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.
253253

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. <a hreflang="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 ARIAs 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. <a hreflang="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.
255255

256256
Accessibility experts like Eric Bailey have highlighted <a hreflang="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 <a hreflang="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.
257257

@@ -534,7 +534,7 @@ Continued efforts to replace or supplement visual CAPTCHAs with more accessible
534534

535535
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.
536536

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 dont 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.
538538

539539
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.
540540

@@ -1142,7 +1142,7 @@ React offers maximum flexibility and customization, but requires developers to i
11421142

11431143
<a hreflang="en" href="https://angular.dev/">Angular</a> provides strong built-in accessibility features, structured conventions that promote semantic HTML, ARIA attribute support, and <a hreflang="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.
11441144

1145-
<a hreflang="en" href="http://Vue.js">Vue.js</a> aims to strike a balance between React's flexibility and Angulars structure. Vues progressive design, clear template syntax, and component architecture support accessibility, though it relies more on developer discipline and third-party plugins like <a hreflang="en" href="https://github.com/vue-a11y">vue-a11y</a>.
1145+
<a hreflang="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 <a hreflang="en" href="https://github.com/vue-a11y">vue-a11y</a>.
11461146

11471147
We also note that <a hreflang="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.
11481148

0 commit comments

Comments
 (0)