宏和import语句

宏：

模板中的宏跟python中的函数类似，可以传递参数，但是不能有返回值，可以将一些经常用到的代码片段放到宏中，然后把一些不固定的值抽取出来当成一个变量，以下将用一个例子来进行解释：

  1. {% macro input(name, value='', type='text') %}
  2.         <input type="{{ type }}" name="{{ name }}" value="{{
  3.         value|e }}">
  4.     {% endmacro %}

以上例子可以抽取出了一个input标签，指定了一些默认参数。那么我们以后创建input标签的时候，可以通过他快速的创建：

  1. <p>{{ input('username') }}</p>
  2.     <p>{{ input('password', type='password') }}</p>

import语句：

在真实的开发中，会将一些常用的宏单独放在一个文件中，在需要使用的时候，再从这个文件中进行导入。import语句的用法跟python中的import类似，可以直接import...as...，也可以from...import...或者from...import...as...，假设现在有一个文件，叫做forms.html，里面有两个宏分别为input和textarea，如下：

  1. forms.html：
  2.     {% macro input(name, value='', type='text') %}
  3.         <input type="{{ type }}" value="{{ value|e }}" name="{{ name }}">
  4.     {% endmacro %}
  5.     {% macro textarea(name, value='', rows=10, cols=40) %}
  6.         <textarea name="{{ name }}" rows="{{ rows }}" cols="{{ cols
  7.         }}">{{ value|e }}</textarea>
  8.     {% endmacro %}

导入宏的例子：

  1. import...as...形式：

    1. {% import 'forms.html' as forms %}
    2. <dl>
    3. <dt>Username</dt>
    4. <dd>{{ forms.input('username') }}</dd>
    5. <dt>Password</dt>
    6. <dd>{{ forms.input('password', type='password') }}</dd>
    7. </dl>
    8. <p>{{ forms.textarea('comment') }}</p>

  2. from...import...as.../from...import...形式：

    1. {% from 'forms.html' import input as input_field, textarea %}
    2. <dl>
    3. <dt>Username</dt>
    4. <dd>{{ input_field('username') }}</dd>
    5. <dt>Password</dt>
    6. <dd>{{ input_field('password', type='password') }}</dd>
    7. </dl>
    8. <p>{{ textarea('comment') }}</p>

    另外需要注意的是，导入模板并不会把当前上下文中的变量添加到被导入的模板中，如果你想要导入一个需要访问当前上下文变量的宏，有两种可能的方法:

  • 显式地传入请求或请求对象的属性作为宏的参数。
  • 与上下文一起（with context）导入宏。

与上下文中一起（with context）导入的方式如下:

  1. {% from '_helpers.html' import my_macro with context %}