Tera高级特性实战：宏、测试器和自定义函数开发终极指南-平芜编程栈

Tera高级特性实战：宏、测试器和自定义函数开发终极指南

【免费下载链接】teraA template engine for Rust based on Jinja2/Django项目地址: https://gitcode.com/gh_mirrors/te/tera

Tera是一个基于Rust的模板引擎，灵感来源于Jinja2和Django模板系统。它提供了丰富的高级特性，包括宏、测试器和自定义函数，这些功能可以帮助开发者构建更灵活、更强大的模板。本文将深入探讨这些高级特性，带你掌握Tera模板引擎的核心功能。

什么是Tera模板引擎？

Tera是一个用Rust编写的现代模板引擎，它结合了Jinja2和Django模板的优点，提供了简洁而强大的模板语法。Tera支持变量、条件语句、循环、宏、过滤器等功能，非常适合构建动态网页、邮件模板、配置文件等。

Tera的主要特点包括：

简洁直观的模板语法
强大的宏系统，支持参数和默认值
丰富的内置测试器，用于条件判断
可扩展的过滤器系统，用于数据转换
安全的模板执行环境

Tera宏：代码复用的终极武器

宏是Tera中实现代码复用的强大工具。它们允许你定义可重用的模板片段，并在需要时进行调用。宏可以接受参数，甚至可以有默认值，使你的模板更加灵活。

宏的基本定义和使用

在Tera中，你可以使用{% macro %}标签定义宏：

{% macro hello(name) %} Hello, {{ name }}! {% endmacro hello %}

然后在模板中使用{{ self::hello(name="World") }}来调用这个宏。

带默认参数的宏

Tera的宏支持默认参数，这使得宏的使用更加灵活：

{% macro greet(name="Guest") %} Welcome, {{ name }}! {% endmacro greet %}

宏的高级用法

Tera的宏系统还支持更高级的功能，如宏的导入和嵌套调用：

{% import "macros.html" as utils %} {{ utils::greet(name="Alice") }}

你甚至可以在宏中调用其他宏，实现更复杂的逻辑：

{% macro factorial(n) %} {% if n > 1 %} {{ n }} * {{ self::factorial(n=n-1) }} {% else %} 1 {% endif %} {% endmacro factorial %}

宏的定义和使用可以在src/renderer/macros.rs文件中找到更多细节。

Tera测试器：条件判断的强大工具

测试器（Tester）是Tera中用于条件判断的特殊函数。它们通常用在{% if %}语句中，用于检查变量是否满足特定条件。

内置测试器

Tera提供了许多内置测试器，如：

defined: 检查变量是否已定义
undefined: 检查变量是否未定义
odd: 检查数字是否为奇数
even: 检查数字是否为偶数
string: 检查值是否为字符串
number: 检查值是否为数字
iterable: 检查值是否可迭代

使用示例：

{% if user.age is even %} {{ user.name }} is even years old. {% endif %}

自定义测试器

除了内置测试器，Tera还允许你注册自定义测试器。这可以通过Rust代码实现：

tera.register_tester("hello", |_: Option<&JsonValue>, _: &[JsonValue]| Ok(true));

然后在模板中使用：

{% if something is hello %} Hello test passed! {% endif %}

更多关于测试器的实现可以在src/tera.rs文件中找到。

Tera过滤器：数据转换的强大工具

过滤器（Filter）是Tera中用于数据转换的函数。它们可以对变量进行各种处理，如格式化、转换、过滤等。

内置过滤器

Tera提供了丰富的内置过滤器，涵盖了字符串处理、数组操作、数字格式化等多个方面：

字符串处理：upper,lower,trim,truncate
数组操作：first,last,nth,join,sort
数字处理：abs,round,filesizeformat
通用操作：length,reverse,json_encode

使用示例：

{{ "hello world" | upper }} <!-- 输出 "HELLO WORLD" --> {{ [3, 1, 2] | sort }} <!-- 输出 [1, 2, 3] --> {{ 123456 | filesizeformat }} <!-- 输出 "120.6 KB" -->

自定义过滤器

Tera同样支持自定义过滤器。你可以通过Rust代码注册自己的过滤器：

struct Safe; impl Filter for Safe { fn filter(&self, value: &Value, _args: &HashMap<String, Value>) -> Result<Value> { Ok(value.clone()) } } tera.register_filter("safe_filter", Safe);

然后在模板中使用：

{{ user_input | safe_filter }}

过滤器的实现细节可以在src/builtins/filters/mod.rs文件中找到。

实战：构建一个完整的Tera应用

现在，让我们通过一个简单的示例来展示如何在实际项目中使用Tera的这些高级特性。

步骤1：创建项目并添加依赖

首先，创建一个新的Rust项目，并在Cargo.toml中添加Tera依赖：

[dependencies] tera = "1.0"

步骤2：创建模板文件

在项目根目录下创建一个templates目录，并添加以下模板文件：

templates/macros.html

{% macro card(title, content) %} <div class="card"> <h3>{{ title }}</h3> <p>{{ content }}</p> </div> {% endmacro card %}

templates/index.html

{% import "macros.html" as ui %} <!DOCTYPE html> <html> <head> <title>Tera Advanced Features</title> </head> <body> <h1>Welcome to Tera</h1> {{ ui::card( title="Macros", content="Macros allow you to reuse template fragments." ) }} {% if users | length > 0 %} <h2>Users</h2> <ul> {% for user in users | sort(attribute="name") %} <li>{{ user.name }} ({{ user.age }} years old)</li> {% endfor %} </ul> {% endif %} </body> </html>

步骤3：编写Rust代码

创建src/main.rs文件，编写以下代码：

use tera::{Context, Tera}; use serde::Serialize; #[derive(Serialize)] struct User { name: String, age: u32, } fn main() -> Result<(), Box<dyn std::error::Error>> { // 初始化Tera let mut tera = Tera::new("templates/**/*.html")?; // 创建上下文数据 let mut context = Context::new(); context.insert("users", &vec![ User { name: "Bob".to_string(), age: 30 }, User { name: "Alice".to_string(), age: 25 }, ]); // 渲染模板 let rendered = tera.render("index.html", &context)?; println!("{}", rendered); Ok(()) }