rhtml 0.3.0

Html Utils
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

use std::{borrow::Cow, fmt::Display};

use crate::{HtmlNode, html};

/// Html Builder
///
/// This struct represents an Html Document.
pub struct HtmlBuilder<'a> {
    root: HtmlNode<'a>,
}

impl<'a> HtmlBuilder<'a> {
    /// Create a new HTML Builder
    ///
    /// By default the following document is created.
    /// ```html
    /// <html>
    ///     <head>
    ///         <meta charset="UTF-8"></meta>
    ///     </head>
    ///     <body></body>
    /// </html>
    /// ```
    pub fn new() -> Self {
        let root = html!("html", [
            html!("head", [html!("meta", {"charset": "UTF-8"})]),
            html!("body")
        ]);
        Self { root }
    }
    /// Create a new [HtmlBuilder] with a title
    #[inline]
    pub fn with_title(title: impl Into<Cow<'a, str>>) -> Self {
        let mut builder = Self::new();
        builder.head().append(html!("title", {text: title}));
        builder
    }
    #[inline]
    pub fn head(&mut self) -> &mut HtmlNode<'a> {
        self.root.nth(0).unwrap()
    }
    #[inline]
    pub fn body(&mut self) -> &mut HtmlNode<'a> {
        self.root.nth(1).unwrap()
    }
}

impl Default for HtmlBuilder<'_> {
    fn default() -> Self {
        Self::new()
    }
}

impl Display for HtmlBuilder<'_> {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "<!DOCTYPE html>")?;
        self.root.write_to(f)
    }
}