Table of Contents

• 1. 简介
• 2. 用法
• 3. 参数和变量
• 4. 注意事项
  • 4.1. macro的变量只能为如下三种:
  • 4.2. 和block的关系:
• 5. 参考文档

jinja2是python的模板引擎, 在写python web使用的过程中,发现macro可以节省大量的代码.所以做了一个小的总结.

用法基本上都是网上的文章. 自己主要是写了注意事项,也算是心得体会.

宏类似常规编程语言中的函数。它们用于把常用行为作为可重用的函数，取代 手动重复的工作。 例子:

{% macro input(name, value=http://www.mamicode.com/‘‘, type=‘text‘, size=20) -%}"{{ type }}" name="{{ name }}" value="http://www.mamicode.com/{{" size="{{ size }}">
{%- endmacro %}

在命名空间中，宏之后可以像函数一样调用:

<p>{{ input(‘username‘) }}</p>
<p>{{ input(‘password‘, type=‘password‘) }}</p>

如果宏在不同的模板中定义，你需要首先使用 import

{% from ‘base/macro/submit.macro‘ import test %}

varargs
如果有多于宏接受的参数个数的位置参数被传入，它们会作为列表的值保存在 varargs 变量上。
kwargs
同 varargs ，但只针对关键字参数。所有未使用的关键字参数会存储在 这个特殊变量中。
caller
如果宏通过 call 标签调用，调用者会作为可调用的宏被存储在这个 变量中。
宏也可以暴露某些内部细节。下面的宏对象属性是可用的:

name
宏的名称。 {{ input.name }} 会打印 input 。
arguments
一个宏接受的参数名的元组。
defaults
默认值的元组。
catch_kwargs
如果宏接受额外的关键字参数（也就是访问特殊的 kwargs 变量），为 true 。
catch_varargs
如果宏接受额外的位置参数（也就是访问特殊的 varargs 变量），为 true 。
caller
如果宏访问特殊的 caller 变量且由 call 标签调用，为 true 。

4.1 macro的变量只能为如下三种:

4.2 和block的关系:

模板设计者文档