利用模板引擎,我们不需要再把 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 支持非常多的模板指令,比如:for
、match
、过滤器
、if
、子模板
、block
等。完整内容你可以在askama 文档中查看。
过滤器
本章讨论模板引擎,你可以在代码库中找到完整代码。