A macro-based html templating library (1.0 compatible).
API: https://stebalien.github.io/horrorshow-rs/horrorshow/
rust
html! {
html {
head {
title { : "Hello world!" }
}
body {
// attributes
h1(id="heading") {
// Insert escaped text
: "Hello! This is <html />"
}
p {
// Insert raw text (unescaped)
: raw!("Let's <i>count</i> to 10!")
}
ol(id="count") {
// run some inline code...
|mut tmpl| for i in 0..10 {
// append to the current template.
// store output because rust bug #25753
tmpl = tmpl << html! {
li {
// format some text
#{"{}", i+1 }
}
};
}
}
// You need semi-colons for tags without children.
br; br;
p {
: "Easy!"
}
}
}
}.render();
Becomes (whitespace added for clarity).
html
<html>
<head>
<title>Hello world!</title>
</head>
<body>
<h1 id="heading">Hello! This is <html /></h1>
<p>Let's <i>count</i> to 10!</p>
<ol id="count">
<li>1</li>
<li>2</li>
<li>3</li>
<li>4</li>
<li>5</li>
<li>6</li>
<li>7</li>
<li>8</li>
<li>9</li>
<li>10</li>
</ol>
<br /> <br />
<p>Easy!</p>
</body>
</html>
Inside an html template, the following expressions are valid:
some_tag; -- Insert a the tag some_tag.
some_tag(attr=rust_expresion,...); -- Insert a the tag some_tag with the specified
attributes. The attribute values will be evaluated as rust expressions at runtime.
some_tag { ... } -- Insert a the tag some_tag and recursivly evaluate the ....
some_tag(...) { ... } -- Same as above but with custom attributes.
: rust_expression, : { rust_code } -- Evaluate the expression or block and insert result current position.
#{"format_str", rust_expressions... } -- Format the arguments according to format_str and insert the
result at the current position.
@ rust_expression, @ { rust_code } -- Evaluate the expression or block.
In rust code embedded inside of a template, you can append text with any of the following macros:
append_fmt!("format_str", args...) -- format, escape, and append argumentsappend_raw!(text) -- append text without escapingappend!(text) -- escape and append textappend_html! { html_template... } -- append an html template.This library is mostly untested and probably a security hazard.