vize_musea 0.485.0

Musea - Component gallery and documentation for Vize Vue components
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

//! Attribute reads over L1 open tags.
//!
//! Names and values are the authored L1 tokens: names compare exactly
//! (Art attributes are case-sensitive, as before), values are the verbatim
//! bytes between the quotes (entities undecoded — `args` / `viewport`
//! decode their own payloads).

use vize_l1::{Attribute, OpenTag};

/// The value of the first attribute named `name` that carries one.
///
/// A valueless occurrence (`title`) or an announced-but-absent value
/// (`title= >`, an L1 `Missing` hole) does not answer; a later valued
/// duplicate still can.
pub(crate) fn attr_value<'a>(open: &OpenTag<'a>, name: &str) -> Option<&'a str> {
    open.attrs
        .iter()
        .filter(|attr| attr.name.text == name)
        .find_map(present_value)
}

/// Whether any attribute named `name` is authored, valued or not.
pub(crate) fn has_attr(open: &OpenTag<'_>, name: &str) -> bool {
    open.attrs.iter().any(|attr| attr.name.text == name)
}

fn present_value<'a>(attr: &Attribute<'a>) -> Option<&'a str> {
    let value = attr.value.as_ref()?;
    (!value.content.is_missing()).then_some(value.content.text)
}

#[cfg(test)]
mod tests {
    use super::{attr_value, has_attr};
    use vize_l0::Allocator;
    use vize_l1::{OpenTag, SurfaceChild, parse};

    fn with_open_tag(source: &str, check: impl FnOnce(&OpenTag<'_>)) {
        let allocator = Allocator::new();
        let (tree, _) = parse(&allocator, source);
        let Some(SurfaceChild::Element(element)) = tree.children.first() else {
            panic!("expected one element in {source:?}");
        };
        check(&element.open);
    }

    #[test]
    fn values_are_the_authored_bytes() {
        with_open_tag(r#"<a t="Hello" u='x' v=w/x y="&amp;">"#, |open| {
            assert_eq!(attr_value(open, "t"), Some("Hello"));
            assert_eq!(attr_value(open, "u"), Some("x"));
            assert_eq!(attr_value(open, "v"), Some("w/x"));
            assert_eq!(attr_value(open, "y"), Some("&amp;"));
            assert_eq!(attr_value(open, "z"), None);
        });
    }

    #[test]
    fn valueless_and_missing_values_do_not_answer() {
        with_open_tag(r#"<a t e="" t="late" u= >"#, |open| {
            assert_eq!(attr_value(open, "t"), Some("late"));
            assert_eq!(attr_value(open, "u"), None);
            assert_eq!(attr_value(open, "e"), Some(""));
        });
    }

    #[test]
    fn names_compare_exactly() {
        with_open_tag(
            r#"<a :title="x" data-title="y" Title="z" default>"#,
            |open| {
                assert_eq!(attr_value(open, "title"), None);
                assert!(has_attr(open, "default"));
                assert!(!has_attr(open, "defaults"));
                assert!(!has_attr(open, "Default"));
            },
        );
    }
}