spair 0.0.9

A framework for single-page application 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

use super::ElementUpdater;
use crate::{
    component::{Comp, Component},
    dom::{ElementStatus, ElementTag, Nodes},
};

#[must_use = "Caller should set selected option for <select> element"]
pub struct RememberSettingSelectedOption;

pub struct ListUpdater<'a> {
    use_template: bool,
    parent: &'a web_sys::Node,
    parent_status: ElementStatus,
    // This is None if it is a whole-list, the list is the only content of the parent node.
    // This is Some() if it is a partial-list, the parent contains the list and some other
    // nodes before or after the list.
    end_of_list_flag: Option<&'a web_sys::Node>,
    list: &'a mut Nodes,
}

impl<'a> ListUpdater<'a> {
    pub fn new(
        list: &'a mut Nodes,
        parent: &'a web_sys::Node,
        parent_status: ElementStatus,
        end_of_list_flag: Option<&'a web_sys::Node>,
        use_template: bool,
    ) -> Self {
        Self {
            use_template,
            parent,
            parent_status,
            end_of_list_flag,
            list,
        }
    }

    pub fn clear_after(&mut self, index: usize) {
        if index >= self.list.count() {
            return;
        }
        if index == 0 && self.end_of_list_flag.is_none() {
            self.parent.set_text_content(None);
            self.list.clear_vec();
        } else {
            self.list.remove_from_dom_after(index, self.parent);
        }
    }

    pub fn render<C, E, I, II, R>(
        &mut self,
        comp: &Comp<C>,
        state: &C,
        items: II,
        tag: E,
        render: R,
    ) -> RememberSettingSelectedOption
    where
        C: Component,
        E: ElementTag,
        II: Iterator<Item = I>,
        R: Fn(I, ElementUpdater<C>),
    {
        let mut index = 0;
        for item in items {
            let status = self.list.check_or_create_element_for_list(
                tag,
                index,
                self.parent,
                self.parent_status,
                self.end_of_list_flag,
                self.use_template,
            );
            let element = self.list.get_element_mut(index);
            let r = ElementUpdater::new(comp, state, element, status);
            render(item, r);
            index += 1;
        }
        self.clear_after(index);
        RememberSettingSelectedOption
    }
}