Rules Catalog

A11YSmith ships with accessibility rules for five platforms. Each rule maps to one or more WCAG 2.2 success criteria and produces findings with a severity level.

Web Rules (10 rules)

Web accessibility rules
Rule ID	Title	WCAG
`web-images-alt-text`	Images and Alternative Text	1.1.1
`web-name-role-value`	Name, Role, Value for Custom Controls	4.1.2
`web-buttons-vs-links`	Buttons vs. Links Semantics	4.1.2
`web-headings-landmarks`	Headings and Landmark Structure	1.3.1, 2.4.1, 2.4.6
`web-form-labels`	Form Labels and Error Messaging	1.3.1, 3.3.2, 4.1.2
`web-focus-indicators`	Focus Path and Focus Indicators	2.4.3, 2.4.7, 2.4.11
`web-tables`	Data Table Structure	1.3.1
`web-live-regions`	Dynamic Announcements and Live Regions	4.1.3
`web-modals-focus-trap`	Modals and Dialogs Focus Management	4.1.2
`web-target-size`	Touch and Click Target Size	2.5.5, 2.5.8

Android Rules (10 rules)

Android accessibility rules
Rule ID	Description	WCAG
`android-missing-content-description`	Interactive views must have a contentDescription	1.1.1
`android-touch-target-size`	Touch targets must be at least 48x48dp	2.5.8
`android-color-contrast`	Text must meet minimum contrast ratios	1.4.3
`android-missing-heading`	Headings must use proper semantics	1.3.1
`android-missing-traversal-order`	Focus traversal order must be logical	2.4.3
`android-live-region`	Dynamic content must use live regions	4.1.3
`android-state-description`	Stateful views must expose state via stateDescription	4.1.2
`android-clickable-no-role`	Clickable elements must have an accessibility role	4.1.2
`android-hardcoded-text-size`	Text sizes must use scalable units (sp)	1.4.4
`android-missing-compose-semantics`	Compose elements must have semantics	4.1.2

iOS Rules (13 rules)

iOS accessibility rules
Rule ID	Description	WCAG
`ios-missing-accessibility-label`	Interactive elements must have an accessibilityLabel	1.1.1
`ios-small-touch-target`	Touch targets must be at least 44x44pt	2.5.8
`ios-missing-heading-trait`	Headings must use the header accessibility trait	1.3.1
`ios-missing-hint`	Custom actions should provide an accessibilityHint	4.1.2
`ios-missing-toggle-label`	Toggle controls must have accessible labels	4.1.2
`ios-missing-announcement`	Dynamic content must post accessibility notifications	4.1.3
`ios-hardcoded-font-size`	Text must support Dynamic Type scaling	1.4.4
`ios-inaccessible-gesture`	Custom gestures must have accessible alternatives	2.5.1
`ios-hierarchy-missing-label`	Elements in hierarchy must have labels	1.1.1
`ios-hierarchy-missing-heading`	Heading hierarchy must be present	1.3.1
`ios-hierarchy-missing-value`	Adjustable elements must expose their value	4.1.2
`ios-hierarchy-small-touch-target`	Touch targets in hierarchy must meet minimum size	2.5.8
`ios-hierarchy-unreachable-element`	All elements must be reachable via VoiceOver	2.1.1

Document Rules (28 rules)

Word (.docx) -- 8 rules

Word document accessibility rules
Rule ID	Description
`DOCX-TITLE-001`	Document must have a title set
`DOCX-HEADING-001`	Heading levels must not skip
`DOCX-ALT-001`	Images must have alternative text
`DOCX-TABLE-001`	Tables must have header rows
`DOCX-LINK-001`	Hyperlink text must be descriptive
`DOCX-LANG-001`	Document language must be set
`DOCX-MERGED-001`	Tables should not have merged cells
`DOCX-LIST-001`	Lists must use proper list structure

Excel (.xlsx) -- 6 rules

Excel workbook accessibility rules
Rule ID	Description
`XLSX-SHEET-001`	Sheets must have meaningful names
`XLSX-TABLE-001`	Data must be in named tables with headers
`XLSX-MERGED-001`	Tables should not have merged cells
`XLSX-COLOR-001`	Data must not be conveyed by color alone
`XLSX-LINK-001`	Hyperlink text must be descriptive
`XLSX-CHART-001`	Charts must have alternative text

PowerPoint (.pptx) -- 6 rules

PowerPoint presentation accessibility rules
Rule ID	Description
`PPTX-TITLE-001`	Every slide must have a title
`PPTX-ORDER-001`	Reading order must be logical
`PPTX-ALT-001`	Images must have alternative text
`PPTX-DUPTITLE-001`	Slide titles must be unique
`PPTX-LINK-001`	Hyperlink text must be descriptive
`PPTX-MEDIA-001`	Media must have accessibility alternatives

PDF -- 8 rules

PDF accessibility rules
Rule ID	Description
`PDFUA-TAG-001`	PDF must have tagged structure
`PDFUA-ALT-001`	Images must have alternative text
`PDFUA-LANG-001`	Document language must be set
`PDFUA-BOOKMARK-001`	Document must have bookmarks for navigation
`PDFBP-FORM-001`	Form fields must have labels
`PDFBP-ORDER-001`	Reading order must be logical
`PDFQ-TEXT-001`	Text must be extractable (not image-only)
`PDFQ-FONT-001`	Fonts must be embedded