sailfish

SailFish

简单、小巧且极快的Rust模板引擎

用户指南 | API文档 | 示例

</div>

✨ 特性

受EJS启发的简单直观语法
在模板内包含其他模板文件
内置过滤器
最小化依赖（总共<15个crates）
极快的速度（参见基准测试）
更好的错误消息
语法高亮支持（vscode，vim）
适用于Rust 1.60或更高版本

🐟 示例

依赖：

[dependencies]
sailfish = "0.9.0-beta"

你可以选择使用TemplateSimple直接访问字段：

模板文件（templates/hello.stpl）：

<html>
  <body>
    <% for msg in messages { %>
      <div><%= msg %></div>
    <% } %>
  </body>
</html>

代码：

use sailfish::TemplateSimple;

#[derive(TemplateSimple)]
#[template(path = "hello.stpl")]
struct HelloTemplate {
    messages: Vec<String>
}

fn main() {
    let ctx = HelloTemplate {
        messages: vec![String::from("foo"), String::from("bar")],
    };
    println!("{}", ctx.render_once().unwrap());
}

或者使用更强大的Template/TemplateMut/TemplateOnce：

模板文件（templates/hello.stpl）：

<html>
  <body>
    <% for msg in &self.messages { %>
      <div><%= msg %></div>
    <% } %>
    <div><%= self.say_hello() %></div>
  </body>
</html>

代码：

use sailfish::Template;

#[derive(Template)]
#[template(path = "hello.stpl")]
struct HelloTemplate {
    messages: Vec<String>
}

impl HelloTemplate {
    fn say_hello(&self) -> String {
        String::from("Hello!")
    }
}

fn main() {
    let ctx = HelloTemplate {
        messages: vec![String::from("foo"), String::from("bar")],
    };
    println!("{}", ctx.render().unwrap());
}