axum 中使用模板引擎

790313
2021/11/13 08:16:18

利用模板引擎,我们不需要再把 HTML 代码写在 Rust 代码中了,而是将其独立保存为*.html文件。既方便维护,也有利用开发。

创建模板文件

首先,我们在项目根目录创建一个templates目录,并在这个目录创建一个index.html文件,内容如下:

<!DOCTYPE html>
<html lang="zh-Hans">
  <head>
    <meta charset="UTF-8" />
    <title>axum.rs</title>
  </head>
  <body>
    <p>你好,<strong>{{ name }}</strong></p>
  </body>
</html>

其中的 {{ name }} 是模板引擎的指令,用于将变量等数据显示在页面上。

创建模板对应的结构体

为了让模板与 rust 相关联,我们需要对刚刚创建的templates/index.html模板创建一个对应的结构体:

其中

  • #[template(path = "index.html")]:指定关联的模板文件。 askama 默认会去项目根目录的 templates/ 目录下查找指定的模板文件。

使用模板

async fn index() -> Result<Html<String>, String> {
    let name = String::from("axum中文网");
    let tpl = IndexTemplate { name };
    let html = tpl.render().map_err(|err| err.to_string())?;
    Ok(Html(html))
}

更多模板指令

我们只使用了一个指令,就是将变量显示在页面上。askama 支持非常多的模板指令,比如:formatch过滤器if子模板block等。完整内容你可以在askama 文档中查看。

过滤器

本章讨论模板引擎,你可以在代码库中找到完整代码。