valkyrie_docgen/items/container/
listable.rs

1use super::*;
2
3pub trait Listable {
4    fn left() -> Option<Html> {
5        None
6    }
7    fn right() -> Option<Html> {
8        None
9    }
10    fn delimiter() -> Html;
11    fn div_class() -> Option<String> {
12        None
13    }
14}
15
16pub trait TableItem {
17    fn get_group_name() -> String;
18    fn get_group_description() -> String {
19        String::new()
20    }
21    fn get_name(&self) -> Html;
22    fn get_doc(&self) -> Html {
23        html! {}
24    }
25}
26
27#[derive(Clone, Debug)]
28pub struct RcList<T: Clone>(pub Vec<Rc<T>>);
29
30impl<T: Listable + Renderable + Clone> Renderable for RcList<T> {
31    fn render(&self) -> Html {
32        if self.0.is_empty() {
33            return EMPTY_HTML;
34        }
35        let items: Html = T::left()
36            .into_iter()
37            .chain(self.0.iter().map(|s| s.render()).intersperse(T::delimiter()))
38            .chain(T::right().into_iter())
39            .collect();
40        match T::div_class() {
41            Some(s) => html! {<div class=s>{items}</div>},
42            None => html! {<>{items}</>},
43        }
44    }
45}
46
47impl<T: TableItem + Clone> RcList<T> {
48    pub fn build_table(&self) -> Html {
49        let name = T::get_group_name();
50        let id = format!("pkg.{}", &name.to_lowercase());
51        let tooltip = Tooltip { base: T::get_group_name(), text: T::get_group_description() };
52        let anchor = Anchor(format!("#pkg.{}", &name.to_lowercase()));
53        let items: Html = self
54            .0
55            .iter()
56            .map(|e| {
57                html! {
58                <tr class="module-item">
59                    <td>{e.get_name()}</td>
60                    <td class="doc-short">{e.get_doc()}</td>
61                </tr>
62                }
63            })
64            .collect();
65        html! {
66        <>
67            <h2 id=id class="module-header">{tooltip}{anchor}</h2>
68            <table><tbody>{items}</tbody></table>
69        </>
70        }
71    }
72}
73
74impl<'a, T> From<&[&'a str]> for RcList<T>
75where
76    T: From<&'a str> + Clone,
77{
78    fn from(v: &[&'a str]) -> Self {
79        RcList(v.iter().map(|&e| Rc::new(T::from(e))).collect())
80    }
81}
valkyrie_docgen/items/container/listable.rs

valkyrie_docgen/items/container/
listable.rs
