yew-template

This crate allows you to separate your HTML from your Rust code when using Yew.

Usage

Hello World

<div>
    <p>Hello [name]!</p>
</div>

let html = template_html!("templates/hello.html", name="World");

The code above will actually compile to the following code:

let html = html! {
    <div>
        <p>{"Hello World!"}</p>
    </div>
};

Using variables

let name = "World";
let html = template_html!("templates/hello.html", name);

Would compile to:

let name = "World";
let html = html! {
    <div>
        <p>{"Hello "}{name}{"!"}</p>
    </div>
};

Variables with different identifiers

let last_name = "World";
let html = template_html!("templates/hello.html", name=last_name);

Using expressions

let name_reversed = String::from("dlroW");
let html = template_html!(
    "templates/hello.html",
    name = {
        let mut name = name_reversed.into_bytes();
        name.reverse();
        let name = String::from_utf8(name).unwrap();
        name
    }
);

Which will also display Hello World! as the output is as follows:

let name_reversed = String::from("dlroW");
let html = html! {
    <div>
        <p>
            {"Hello "}{{
            let mut name = name_reversed.into_bytes();
            name.reverse();
            let name = String::from_utf8(name).unwrap();
            name
            }}{"!"}
        </p>
    </div>
};

Note that the brackets around expressions are optional.

In attributes

<div style=[style]>
   <p>Hello [name]!</p>
</div>

let html = template_html!("templates/hello.html", name="World", style="color: red;");

Applied to Yew callbacks

<div onclick=[onclick]>
   <p>Hello [name]!</p>
</div>

let link = ctx.link();
let html = template_html!("templates/hello.html", name="World", onclick={link.callback(|_| Msg::AddOne)});

Notes

Litteral values are NOT escaped because they come from your code. Using a litteral value of value closed by quotes" trailing stuff will cause problems. This will be fixed in a future version.
You can use multiple top-level elements in your html template file.

License: MIT

yew-template 0.1.0