How to install the hatmil crate // Lib.rs

Adding `hatmil` library as a dependency

Run this command in a terminal, in your project's directory:

cargo add hatmil

To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:

hatmil = "1.1.0"

The hatmil library will be automatically available globally. Read the hatmil library documentation.

Back to the crate overview.

Readme

Hatmil is an HTML builder for Rust. It can be used to create or modify web pages dynamically, including inline SVG.

With a Page, there are two "root" methods:

html for a full document
frag for a fragment, starting from an arbitrary element (HTML or SVG)

In either case, an element struct is returned which borrows from the Page.

Each element has methods for setting valid attributes, such as id. There are also methods for adding permitted child elements.

use hatmil::Page;

let mut page = Page::new();
let mut html = page.html();
let mut body = html.body();
body.p().id("para").cdata("Graph");
assert_eq!(
    String::from(page),
    "<html><body><p id=\"para\">Graph</p></body></html>"
);

Text content (character data) can be added using the cdata or cdata_len methods on an element. Special HTML characters will automatically be replaced by character references, as needed (for content which has already been escaped, use the raw method). The close method can be used to close the final open element.

After creating the page, use String::from(page) to get the resulting HTML. Any open tags will be closed automatically. Display is also implemented, enabling the use of format or to_string().

use hatmil::{Page, html::Div};

let mut page = Page::new();
let mut div = page.frag::<Div>();
div.button().class("rounded").cdata("Press Me!");
assert_eq!(
    String::from(page),
    "<div><button class=\"rounded\">Press Me!</button></div>"
);

Method Names

In most cases, element methods match the HTML tag exactly. But due to clashes with attribute names, some methods for creating child elements have an _el suffix:

abbr_el on Th, clash with abbr attribute
cite_el on BlockQuote and Q, clash with cite attribute
form_el on FieldSet, clash with form attribute
slot_el on many elements, clash with slot global attribute
style_el on Head, NoScript and SVG elements, clash with style global attribute
title_el on Head and SVG Style, clash with title global attribute

Some HTML names clash with Rust keywords. In these cases, raw identifiers must be used to call those methods:

r#as on Link
r#async on Script
r#for on Label and Output
r#in on multiple SVG filter elements
r#loop on Audio and Video
r#type on multiple HTML and SVG elements
r#use (SVG element)

Adding hatmil library as a dependency

Adding `hatmil` library as a dependency