Struct Template

Source

pub struct Template { /* private fields */ }

Expand description

Template for composing multiple semantic elements into a page structure.

Provides a high-level API for building accessible HTML5 document layouts.

§Examples

use html_generator::elements::Template;

let page = Template::new()
    .nav("Main navigation", "<ul><li>Home</li></ul>")
    .main_content("<h1>Welcome</h1><p>Content here.</p>")
    .aside("Related", "<p>Related links</p>")
    .build();
assert!(page.contains("<nav"));
assert!(page.contains("<main"));
assert!(page.contains("<aside"));

Implementations§

Source §

impl Template

Source

pub fn new() -> Self

Creates a new empty template.

§Examples

use html_generator::elements::Template;

let html = Template::new().build();
assert!(html.is_empty());

Source

pub fn nav(self, label: &str, content: &str) -> Self

Adds a navigation section.

§Examples

use html_generator::elements::Template;

let html = Template::new().nav("Primary", "<a href='/'>Home</a>").build();
assert!(html.contains("<nav"));
assert!(html.contains(r#"aria-label="Primary""#));

Adds a header section.

§Examples

use html_generator::elements::Template;

let html = Template::new().header("<h1>Site</h1>").build();
assert!(html.contains("<header><h1>Site</h1></header>"));

Source

pub fn main_content(self, content: &str) -> Self

Adds the main content area.

§Examples

use html_generator::elements::Template;

let html = Template::new().main_content("<p>Body</p>").build();
assert!(html.contains("<main"));
assert!(html.contains(r#"role="main""#));

Source

pub fn section(self, label: &str, content: &str) -> Self

Adds a section to the template.

§Examples

use html_generator::elements::Template;

let html = Template::new().section("Intro", "<p>Hi</p>").build();
assert!(html.contains("<section"));
assert!(html.contains(r#"aria-label="Intro""#));

Source

pub fn aside(self, label: &str, content: &str) -> Self

Adds an aside section.

§Examples

use html_generator::elements::Template;

let html = Template::new().aside("Related", "<p>links</p>").build();
assert!(html.contains("<aside"));

Adds a footer section.

§Examples

use html_generator::elements::Template;

let html = Template::new().footer("&copy; 2026").build();
assert!(html.contains("<footer"));
assert!(html.contains(r#"role="contentinfo""#));

Source

pub fn build(&self) -> String

Renders the full template to an HTML string.

§Examples

use html_generator::elements::Template;

let html = Template::new()
    .nav("N", "<ul></ul>")
    .main_content("<p>x</p>")
    .build();
assert!(html.contains("<nav"));
assert!(html.contains("<main"));