Module accessibility

Accessibility-related functionality for HTML processing.

This module provides comprehensive tools for improving HTML accessibility through:

• Automated ARIA attribute management
• WCAG 2.1 compliance validation
• Accessibility issue detection and correction

WCAG Compliance

This module implements checks for WCAG 2.1 compliance across three levels:

• Level A (minimum level of conformance)
• Level AA (addresses major accessibility barriers)
• Level AAA (highest level of accessibility conformance)

For detailed information about WCAG guidelines, see: https://www.w3.org/WAI/WCAG21/quickref/

Limitations

While this module provides automated checks, some accessibility aspects require manual review, including:

• Semantic correctness of ARIA labels
• Meaningful alternative text for images
• Logical heading structure
• Color contrast ratios

Examples

use html_generator::accessibility::{add_aria_attributes, validate_wcag, WcagLevel};

use html_generator::accessibility::AccessibilityConfig;
fn main() -> Result<(), Box<dyn std::error::Error>> {
    let html = r#"<button>Click me</button>"#;

    // Add ARIA attributes automatically
    let enhanced_html = add_aria_attributes(html, None)?;

    // Validate against WCAG AA level
    let config = AccessibilityConfig::default();
    validate_wcag(&enhanced_html, &config, None)?;

    Ok(())
}

Modules

• constants
  Constants used throughout the accessibility module
• utils
  Utility functions for accessibility checks

Structs

• AccessibilityConfig
  Color contrast requirements for different WCAG levels
• AccessibilityReport
  A comprehensive accessibility check result
• Issue
  Structure representing an accessibility issue found in the HTML

Enums

• Error
  Enum to represent possible accessibility-related errors.
• IssueType
  Types of accessibility issues that can be detected
• WcagLevel
  WCAG Conformance Levels

Functions

• add_aria_attributes
  Add ARIA attributes to HTML for improved accessibility.
• validate_wcag
  Validate HTML against WCAG guidelines with detailed reporting.

Type Aliases

• Result
  Result type alias for accessibility operations.