关于jinja2 宏定义的小问题

最新推荐文章于 2021-10-05 15:54:02 发布

惊瑟

最新推荐文章于 2021-10-05 15:54:02 发布

阅读量1.5k

点赞数

CC 4.0 BY-SA版权

分类专栏： Python随笔文章标签： jinja2 宏 macro

本文链接：https://blog.youkuaiyun.com/qq_34062683/article/details/78234695

Python随笔专栏收录该内容

29 篇文章

订阅专栏

本文通过实例展示了如何使用Flask框架结合Jinja2模板引擎中的宏定义来提高代码复用性。详细解释了宏定义的语法及参数传递机制，并对比了不同宏定义方式的效果。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

使用flask的render_template（渲染HTML模板）创建一个简单的web程序，代码如下：

#coding:utf-8
from flask import  Flask
from flask import render_template

app=Flask(__name__)

@app.route('/')
def f():
    comments=['nihao','jing']
    return render_template('if.html',comments=comments)

if __name__=='__main__':
    app.run()

HTML模板if.html如下：

<ul>
    {% for comment in comments %}
        <li>{{ comment }}</li>
    {% endfor %}
</ul>

运行结果如图：

接下来用宏定义重新写HTML模板，宏定义forms.html如下：

{% macro t(comment) %}
     <li>{{comment}}</li>
{% endmacro %}

在另一模板t_if.html中引用该宏定义：

{% import 'forms.html' as forms %} <!--将forms导入，as后面的名字可以随意定义-->
<ul>
{% for comment in comments %}
        {{forms.t(comment)}}  <!--引用其中的宏定义-->
{% endfor %}
</ul>

运行后与上面效果相同。

虽然程序可以工作，但不理解宏定义究竟如何工作的，比如

{% macro t(comment) %}

括号里面的参数有何规定和要求，主程序中的comments是如何传到模板的等等，但搜了一下，发现大部分都是互相copy，并无深入介绍，so，自己动手丰衣足食。

首先，先试验一下将

{% macro t(comment) %}

括号去掉，因为受到c里面define的影响，直觉上觉得用一个字母t代替下面的语句没问题，试验以后发现报错，

看来缺了括号不行，那就加上括号，改为：

{% macro t() %} 注意此时括号没有参数

运行结果如下：

虽然没报错，但列表里的内容显示不出来了。我们分析，既然有两个点，说明执行到了t_if.html中

{{forms.t()}}

这一步，只不过没有内容没显示出来罢了。于是猜测

% macro t(comment) %}

括号中的comment是用来传参的，再将t_if.html的

{% for comment in comments %}
        {{forms.t(comment)}}  <!--引用其中的宏定义-->
{% endfor %}

改为

{% for c in comments %}
        {{forms.t(c)}}  <!--引用其中的宏定义-->
{% endfor %}

相应的forms.html也改为

{% macro t(c) %}
     <li>{{c}}</li>
{% endmacro %}

可正常运行。

于是我们得出结论，jinja2 中的宏定义不能随便定义，如果里面有可变参数，需要用小括号将参数传递进去。