Crate another_html_builder

Crate another_html_builder 

Source
Expand description

Just a simple toolkit for writing html.

This provides the basic functions needed to write basic html or create components to build a rich and complete UI.

§Example

In this example, we create a custom attribute and also a custom Head element.

use another_html_builder::attribute::AttributeValue;
use another_html_builder::prelude::WriterExt;
use another_html_builder::{Body, Buffer};

enum Lang {
    En,
    Fr,
}

impl AttributeValue for Lang {
    fn render(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.write_str(match self {
            Self::En => "en",
            Self::Fr => "fr",
        })
    }
}

struct Head {
    title: &'static str,
}

impl Default for Head {
    fn default() -> Self {
        Self {
            title: "Hello world!",
        }
    }
}

impl Head {
    fn render<'a, W: WriterExt>(&self, buf: Buffer<W, Body<'a>>) -> Buffer<W, Body<'a>> {
        buf.node("head")
            .content(|buf| buf.node("title").content(|buf| buf.text(self.title)))
    }
}

let head = Head::default();
let html = Buffer::default()
    .doctype()
    .node("html")
    .attr(("lang", Lang::Fr))
    .content(|buf| head.render(buf))
    .into_inner();
assert_eq!(
    html,
    "<!DOCTYPE html><html lang=\"fr\"><head><title>Hello world!</title></head></html>"
);

Modules§

attribute
Attribute related module. This contains the traits needed to implement a new kind of AttributeValue but also a wrapper to escape values.
content
Attribute related module. This contains a wrapper to escape values.
prelude
Set of extension implementations allowing to write to std::fmt::Write or std::io::Write.

Structs§

Buffer
Wrapper arround a writer element.
Element
Representation of an element

Enums§

Body
Representation of the inside of an element or the root level.