Accessibility Audit Scope - #4264

TL;DR: 8 issues found, 24 total instances. 4 are high priority (keyboard access, focus visibility, skip nav, modal ARIA). Mostly small fixes — estimated ~1-2 days total. No issues with images, form labels, or lang attribute.

cc @allthedoll @knolleary

Audited against WCAG 2.1 AA. Nick's header anchor fix (#4266) is already merged. Here's what remains:

Issues & Effort

#	Issue	Why	Files Affected	Effort	Priority
1	No "Skip to main content" link	WCAG 2.4.1 - Keyboard users must tab through entire nav on every page load	`_includes/layouts/base.njk`	S	✅ See #4883
2	Interactive divs not keyboard-accessible - file drop zone, pagination `<li>` elements, dialog overlay all use `onclick` without `tabindex`, `role`, or key handlers	WCAG 2.1.1 - All functionality must be operable via keyboard; screen readers can't announce non-semantic elements	`_includes/migration.njk`, `integrations/index.njk`, `_includes/feature_lists/features-table-base.njk`	M	High
3	Modal missing ARIA attrs - no `role="dialog"`, `aria-modal`, `aria-labelledby`, no focus trap, no Escape key close	WCAG 4.1.2 - Screen readers don't announce it as a dialog; focus can escape behind the modal	`_includes/components/ai-expert-modal.njk`, `js/ai-expert-modal.js`	M	High
4	Focus outlines removed without alternatives - `outline: none` on search, range input, textareas with no visible replacement	WCAG 2.4.7 - Keyboard users lose track of which element is focused	`css/algolia-theme.css`, `css/style.css`, `_includes/components/ai-chat-interface.njk`	S	✅ See #4883
5	`text-gray-400` contrast too low on white - used across 15+ files for dates, metadata, labels	WCAG 1.4.3 - Contrast ratio ~2.7:1, minimum required is 4.5:1 for normal text	Multiple (changelog, blog, events, feature tables, etc.)	M	Medium
6	Heading hierarchy violations - H1 jumps to H5 in comparison pages; mismatched open/close tag in benefits	WCAG 1.3.1 - Screen reader users navigate by heading level; skipped levels break that mental model	`vs/litmus.njk`, `vs/kepware.njk`, `_includes/benefits.njk`	S	Medium
7	Generic "read more" links - no distinguishing context for screen readers	WCAG 2.4.4 - Screen readers list all links out of context; multiple identical "read more" links are indistinguishable	`_includes/changelog/changelog-posts.njk`	S	Low
8	Pagination `aria-labelledby` points to nonexistent ID	WCAG 4.1.2 - Broken reference means assistive tech gets no label for the pagination nav	`integrations/index.njk`	S	Low

Effort Key

S = Small (< 1 hr, isolated change)
M = Medium (1-3 hrs, touches multiple files or needs testing)

What's already passing

All images have alt attributes
Form inputs have labels / aria-label
<html lang="en"> is set
Header anchor links are accessible (Update generated header anchors to be more accessible #4266)

Suggested approach

Start with items 1 and 4 (quick wins, high impact), then tackle 2 and 3 together (keyboard/ARIA). Item 5 (contrast) is a bulk find-and-replace of text-gray-400 -> text-gray-500/text-gray-600 but needs visual review. Total estimate: ~1-2 days of focused work.

Website accessibility issues #4264

Description

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions