paige 1.0.0

A simple HTML templating API, written 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

use super::*;

/// The Page struct.
/// Stores a list of nested HTML elements.
pub struct Page {
   pub content: Vec<El>,
}

impl Page {
   /// Returns a new Page. Takes a slice of El as input.
   pub fn new(content: &[El]) -> Self {
      Page {
         content: content.to_vec(),
      }
   }
   
   /// Pushes an El onto content field vec.
   pub fn add(mut self, child: El) -> Self {
      self.content.push(child);
      self
   }
   
   /// Allows for finding a child element by its id attribute.
   pub fn id_find(&mut self, id: &str) -> Option<&mut El> {
      
      for child in self.content.iter_mut() {
         
         let find = child.id_find(id);
         
         match find {
            Some(_) => { return find; },
            None => (),
         }
      }
      
      None
   }
   
   /// Formats the Page for display or storage. Automatically
   /// prepends '<!DOCTYPE HTML> to the beginning of the file.
   pub fn format(&self, make_pretty: bool) -> String {
      let mut f = Formatter {
         make_pretty,
         buf: String::new(),
      };
      
      f.parse_and_format(&self.content, 0);
      
      f.buf
   }
}

impl std::fmt::Display for Page {
   fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
      write!(f, "{}", self.format(true))
   }
}