auditmysite 1.7.2

Resource-efficient WCAG 2.2 AA 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
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135

//! MainNavigation pattern (issue #27).
//!
//! Detects semantic main navigation: `<nav>` or `role="navigation"`, with
//! accessible name when multiple nav landmarks exist, and native link children.

use crate::accessibility::AXTree;

use super::{PatternAnalysis, PatternConfidence};

pub(super) fn detect(tree: &AXTree, out: &mut PatternAnalysis) {
    let nav_nodes = tree.nodes_with_role("navigation");
    if nav_nodes.is_empty() {
        return;
    }

    let multiple = nav_nodes.len() > 1;
    let mut named = 0usize;
    let mut with_links = 0usize;

    for nav in &nav_nodes {
        let has_name = nav.name.as_deref().is_some_and(|n| !n.trim().is_empty());
        if has_name {
            named += 1;
        }

        // Count link descendants
        let link_count = nav
            .child_ids
            .iter()
            .filter_map(|id| tree.get_node(id))
            .filter(|child| matches!(child.role.as_deref(), Some("link")))
            .count();
        if link_count > 0 {
            with_links += 1;
        }
    }

    // When multiple navs exist, each one needs a name — without it, screen
    // readers cannot distinguish them. Flag the missing-name case as info.
    if multiple && named < nav_nodes.len() {
        let count_missing = nav_nodes.len() - named;
        out.add_recognized(
            "MainNavigation",
            format!(
                "{} navigation {} found, but {} have no accessible name. Screen reader users cannot distinguish them.",
                nav_nodes.len(),
                if nav_nodes.len() == 1 { "landmark" } else { "landmarks" },
                count_missing
            ),
            PatternConfidence::Partial,
        );
        return;
    }

    if with_links == 0 {
        // Nav landmark without link descendants — likely empty or malformed.
        out.add_recognized(
            "MainNavigation",
            format!(
                "{} navigation {} found, but none contain link children. Pattern is structurally incomplete.",
                nav_nodes.len(),
                if nav_nodes.len() == 1 { "landmark" } else { "landmarks" }
            ),
            PatternConfidence::Partial,
        );
        return;
    }

    out.add_recognized(
        "MainNavigation",
        format!(
            "Semantic main navigation recognized ({} {} with native links). Good foundation for keyboard and screen reader use.",
            nav_nodes.len(),
            if nav_nodes.len() == 1 { "landmark" } else { "landmarks" }
        ),
        PatternConfidence::Strong,
    );
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::accessibility::{AXNode, AXTree};

    fn node(id: &str, role: &str, name: Option<&str>, child_ids: Vec<&str>) -> AXNode {
        AXNode {
            node_id: id.to_string(),
            ignored: false,
            ignored_reasons: vec![],
            role: Some(role.to_string()),
            name: name.map(String::from),
            name_source: None,
            description: None,
            value: None,
            properties: vec![],
            child_ids: child_ids.into_iter().map(String::from).collect(),
            parent_id: None,
            backend_dom_node_id: None,
        }
    }

    #[test]
    fn test_strong_when_nav_with_links() {
        let tree = AXTree::from_nodes(vec![
            node("1", "navigation", Some("Main"), vec!["2"]),
            node("2", "link", Some("Home"), vec![]),
        ]);
        let mut a = PatternAnalysis::default();
        detect(&tree, &mut a);
        assert_eq!(a.recognized.len(), 1);
        assert_eq!(a.recognized[0].confidence, PatternConfidence::Strong);
    }

    #[test]
    fn test_partial_when_multiple_navs_unnamed() {
        let tree = AXTree::from_nodes(vec![
            node("1", "navigation", None, vec!["3"]),
            node("2", "navigation", None, vec!["4"]),
            node("3", "link", Some("Home"), vec![]),
            node("4", "link", Some("Imprint"), vec![]),
        ]);
        let mut a = PatternAnalysis::default();
        detect(&tree, &mut a);
        assert_eq!(a.recognized.len(), 1);
        assert_eq!(a.recognized[0].confidence, PatternConfidence::Partial);
    }

    #[test]
    fn test_nothing_when_no_nav() {
        let tree = AXTree::from_nodes(vec![node("1", "WebArea", None, vec![])]);
        let mut a = PatternAnalysis::default();
        detect(&tree, &mut a);
        assert!(a.recognized.is_empty());
    }
}