]>
Commit | Line | Data |
---|---|---|
4f5b44bd NL |
1 | ``import`` |
2 | ========== | |
3 | ||
4 | Twig supports putting often used code into :doc:`macros<../tags/macro>`. These | |
5 | macros can go into different templates and get imported from there. | |
6 | ||
7 | There are two ways to import templates. You can import the complete template | |
8 | into a variable or request specific macros from it. | |
9 | ||
10 | Imagine we have a helper module that renders forms (called ``forms.html``): | |
11 | ||
12 | .. code-block:: jinja | |
13 | ||
14 | {% macro input(name, value, type, size) %} | |
15 | <input type="{{ type|default('text') }}" name="{{ name }}" value="{{ value|e }}" size="{{ size|default(20) }}" /> | |
16 | {% endmacro %} | |
17 | ||
18 | {% macro textarea(name, value, rows) %} | |
19 | <textarea name="{{ name }}" rows="{{ rows|default(10) }}" cols="{{ cols|default(40) }}">{{ value|e }}</textarea> | |
20 | {% endmacro %} | |
21 | ||
22 | The easiest and most flexible is importing the whole module into a variable. | |
23 | That way you can access the attributes: | |
24 | ||
25 | .. code-block:: jinja | |
26 | ||
27 | {% import 'forms.html' as forms %} | |
28 | ||
29 | <dl> | |
30 | <dt>Username</dt> | |
31 | <dd>{{ forms.input('username') }}</dd> | |
32 | <dt>Password</dt> | |
33 | <dd>{{ forms.input('password', null, 'password') }}</dd> | |
34 | </dl> | |
35 | <p>{{ forms.textarea('comment') }}</p> | |
36 | ||
37 | Alternatively you can import names from the template into the current | |
38 | namespace: | |
39 | ||
40 | .. code-block:: jinja | |
41 | ||
42 | {% from 'forms.html' import input as input_field, textarea %} | |
43 | ||
44 | <dl> | |
45 | <dt>Username</dt> | |
46 | <dd>{{ input_field('username') }}</dd> | |
47 | <dt>Password</dt> | |
48 | <dd>{{ input_field('password', '', 'password') }}</dd> | |
49 | </dl> | |
50 | <p>{{ textarea('comment') }}</p> | |
51 | ||
52 | .. tip:: | |
53 | ||
54 | To import macros from the current file, use the special ``_self`` variable | |
55 | for the source. | |
56 | ||
57 | .. seealso:: :doc:`macro<../tags/macro>`, :doc:`from<../tags/from>` |