xilem_web 0.4.0

HTML DOM frontend for the Xilem Rust UI framework.
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

// Copyright 2023 the Xilem Authors
// SPDX-License-Identifier: Apache-2.0

type CowStr = std::borrow::Cow<'static, str>;

/// Representation of an attribute value.
///
/// This type is used as optimization, to avoid allocations, as it's copied around a lot
#[derive(PartialEq, Clone, Debug, PartialOrd)]
pub enum AttributeValue {
    True, // for the boolean true, this serializes to an empty string (e.g. for <input checked>)
    I16(i16),
    U16(u16),
    I32(i32),
    U32(u32),
    Usize(usize),
    F32(f32),
    F64(f64),
    String(CowStr),
}

impl AttributeValue {
    pub fn serialize(&self) -> CowStr {
        match self {
            Self::True => "".into(), // empty string is equivalent to a true set attribute
            Self::I16(n) => n.to_string().into(),
            Self::U16(n) => n.to_string().into(),
            Self::I32(n) => n.to_string().into(),
            Self::U32(n) => n.to_string().into(),
            Self::Usize(n) => n.to_string().into(),
            Self::F32(n) => n.to_string().into(),
            Self::F64(n) => n.to_string().into(),
            Self::String(s) => s.clone(),
        }
    }
}

/// Types implementing this trait can be used as value in e.g. [`Element::attr`](`crate::interfaces::Element::attr`)
pub trait IntoAttributeValue: Sized {
    fn into_attr_value(self) -> Option<AttributeValue>;
}

impl<T: IntoAttributeValue> IntoAttributeValue for Option<T> {
    fn into_attr_value(self) -> Option<AttributeValue> {
        if let Some(value) = self {
            T::into_attr_value(value)
        } else {
            None
        }
    }
}

impl IntoAttributeValue for bool {
    fn into_attr_value(self) -> Option<AttributeValue> {
        self.then_some(AttributeValue::True)
    }
}

impl IntoAttributeValue for AttributeValue {
    fn into_attr_value(self) -> Option<AttributeValue> {
        Some(self)
    }
}

impl IntoAttributeValue for i16 {
    fn into_attr_value(self) -> Option<AttributeValue> {
        Some(AttributeValue::I16(self))
    }
}

impl IntoAttributeValue for u16 {
    fn into_attr_value(self) -> Option<AttributeValue> {
        Some(AttributeValue::U16(self))
    }
}

impl IntoAttributeValue for i32 {
    fn into_attr_value(self) -> Option<AttributeValue> {
        Some(AttributeValue::I32(self))
    }
}

impl IntoAttributeValue for u32 {
    fn into_attr_value(self) -> Option<AttributeValue> {
        Some(AttributeValue::U32(self))
    }
}

impl IntoAttributeValue for usize {
    fn into_attr_value(self) -> Option<AttributeValue> {
        Some(AttributeValue::Usize(self))
    }
}

impl IntoAttributeValue for f32 {
    fn into_attr_value(self) -> Option<AttributeValue> {
        Some(AttributeValue::F32(self))
    }
}

impl IntoAttributeValue for f64 {
    fn into_attr_value(self) -> Option<AttributeValue> {
        Some(AttributeValue::F64(self))
    }
}

impl IntoAttributeValue for String {
    fn into_attr_value(self) -> Option<AttributeValue> {
        Some(AttributeValue::String(self.into()))
    }
}

impl IntoAttributeValue for CowStr {
    fn into_attr_value(self) -> Option<AttributeValue> {
        Some(AttributeValue::String(self))
    }
}

impl IntoAttributeValue for &'static str {
    fn into_attr_value(self) -> Option<AttributeValue> {
        Some(AttributeValue::String(self.into()))
    }
}