JinJia2 测试器

Flask的Jinja2模板引擎中，测试器（Tests）是一组用来测试变量或表达式的特殊函数，它们返回一个布尔值（True或False），这使得在模板中执行条件判断变得更为灵活和强大。以下是关于Flask Jinja2测试器的详细介绍：

内置测试器

Jinja2模板引擎提供了一系列内置的测试器，这些测试器可以直接在模板中使用，而无需额外定义。以下是一些常见的内置测试器：

• callable(object)：判断对象是否可以被调用。
• defined(value)：判断变量是否已经定义。
• undefined(value)：判断变量是否未定义（注意与defined相反）。
• none(value)：判断变量是否是None。
• number(value)：判断变量是否是数字。
• string(value)：判断变量是否是字符串。
• sequence(value)：判断变量是否是序列（如列表、元组等）。
• iterable(value)：判断变量是否可以迭代。
• mapping(value)：判断变量是否是映射对象，比如字典。
• sameas(value, other)：判断变量和other是否指向相同的内存地址。

使用测试器

在Jinja2模板中，测试器通过is关键字与变量或表达式结合使用。如果测试器返回True，则执行相应的代码块；否则，执行else部分（如果有的话）。

示例：

<!-- 检查变量是否被定义 -->
{% if name is defined %}
    <p>Name is: {{ name }}</p>
{% else %}
    <p>Name is not defined</p>
{% endif %}

<!-- 检查变量是否为数字 -->
{% if age is number %}
    <p>{{ age }} is a number</p>
{% else %}
    <p>{{ age }} is not a number</p>
{% endif %}

<!-- 检查数值是否为偶数 -->
{% if 4 is even %}
    <p>4 is an even number</p>
{% else %}
    <p>4 is not an even number</p>
{% endif %}

自定义测试器

除了使用内置测试器外，还可以根据需要自定义测试器。自定义测试器的方法主要有两种：

1. 直接添加到Jinja2环境的tests字典中：

   from flask import Flask, render_template
   
   app = Flask(__name__)
   
   def test_phone(phone):
       # 测试手机号是否合法
       phone_re = r'1[3-9]\d{9}'
       return re.match(phone_re, phone)
   
   app.jinja_env.tests['is_phone'] = test_phone
   
   @app.route('/')
   def index():
       return render_template('index.html')
   
   if __name__ == '__main__':
       app.run(debug=True)
   

   在模板中使用：

   {% if "13800138000" is is_phone %}
       <p>This is a valid phone number</p>
   {% else %}
       <p>This is not a valid phone number</p>
   {% endif %}
   

2. 使用@app.template_test装饰器：

   from flask import Flask, render_template
   
   app = Flask(__name__)
   
   @app.template_test('starts_with')
   def starts_with(value, prefix):
       return value.startswith(prefix)
   
   @app.route('/')
   def index():
       return render_template('index.html')
   
   if __name__ == '__main__':
       app.run(debug=True)
   

   在模板中使用：

   {% if "hello world" is starts_with("hello") %}
       <p>The string starts with "hello"</p>
   {% else %}
       <p>The string does not start with "hello"</p>
   {% endif %}
   

自定义测试器提供了极高的灵活性，可以根据具体需求实现复杂的逻辑判断。