auditmysite 0.45.0

Resource-efficient WCAG 2.1 Accessibility Checker in Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75

//! WCAG 1.2.8 Media Alternative (Prerecorded) (Level AAA)
//!
//! An alternative for time-based media is provided for all prerecorded
//! synchronized media and for all prerecorded video-only media.

use crate::accessibility::AXTree;
use crate::cli::WcagLevel;
use crate::wcag::types::{FindingKind, RuleMetadata, Severity, Violation, WcagResults};

pub const MEDIA_ALTERNATIVE_RULE: RuleMetadata = RuleMetadata {
    id: "1.2.8",
    name: "Media Alternative (Prerecorded)",
    level: WcagLevel::AAA,
    severity: Severity::Medium,
    description: "Prerecorded media has a text alternative or description track",
    help_url: "https://www.w3.org/WAI/WCAG21/Understanding/media-alternative-prerecorded.html",
    axe_id: "media-alt",
    tags: &["wcag2aaa", "wcag128", "cat.time-and-media"],
};

pub fn check_media_alternative(tree: &AXTree) -> WcagResults {
    let mut results = WcagResults::new();

    let has_video = tree.iter().any(|n| {
        !n.ignored
            && matches!(
                n.role.as_deref(),
                Some("video") | Some("VideoElement") | Some("EmbeddedObject")
            )
    });

    if has_video {
        results.add_violation(
            Violation::new(
                MEDIA_ALTERNATIVE_RULE.id,
                MEDIA_ALTERNATIVE_RULE.name,
                MEDIA_ALTERNATIVE_RULE.level,
                Severity::Medium,
                "Video content detected. Verify that a full text alternative or audio description \
                 track exists for all prerecorded video content.",
                "video",
            )
            .with_fix(
                "Provide a text transcript or synchronized audio description for prerecorded \
                 video. Add a <track kind=\"descriptions\"> element or link to a text alternative.",
            )
            .with_rule_id(MEDIA_ALTERNATIVE_RULE.axe_id)
            .with_help_url(MEDIA_ALTERNATIVE_RULE.help_url)
            .with_kind(FindingKind::NotTestable),
        );
    } else {
        // No video found — emit a general notice anyway since the AXTree
        // may not capture all embedded media (iframes, objects).
        results.add_violation(
            Violation::new(
                MEDIA_ALTERNATIVE_RULE.id,
                MEDIA_ALTERNATIVE_RULE.name,
                MEDIA_ALTERNATIVE_RULE.level,
                Severity::Low,
                "WCAG 1.2.8 requires manual verification that all prerecorded video and \
                 audio content has a full text alternative.",
                "page",
            )
            .with_fix(
                "Ensure every prerecorded multimedia element has a complete text transcript \
                 and, where applicable, an audio description.",
            )
            .with_rule_id(MEDIA_ALTERNATIVE_RULE.axe_id)
            .with_help_url(MEDIA_ALTERNATIVE_RULE.help_url)
            .with_kind(FindingKind::NotTestable),
        );
    }

    results
}