import · Twig · 看云

# `import` Twig supports putting often used code into [*macros*](#). Thesemacros can go into different templates and get imported from there. There are two ways to import templates. You can import the complete templateinto a variable or request specific macros from it. Imagine we have a helper module that renders forms (called `forms.html`): <table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1 2 3 4 5 6 7</pre></div></td><td class="code"><div class="highlight"><pre>{% macro input(name, value, type, size) %} <input type="{{ type|default('text') }}" name="{{ name }}" value="{{ value|e }}" size="{{ size|default(20) }}" /> {% endmacro %} {% macro textarea(name, value, rows, cols) %} <textarea name="{{ name }}" rows="{{ rows|default(10) }}" cols="{{ cols|default(40) }}">{{ value|e }}</textarea> {% endmacro %} </pre></div></td></tr></table> The easiest and most flexible is importing the whole module into a variable.That way you can access the attributes: <table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1 2 3 4 5 6 7 8 9</pre></div></td><td class="code"><div class="highlight"><pre>{% import 'forms.html' as forms %} <dl> <dt>Username</dt> <dd>{{ forms.input('username') }}</dd> <dt>Password</dt> <dd>{{ forms.input('password', null, 'password') }}</dd> </dl> <p>{{ forms.textarea('comment') }}</p> </pre></div></td></tr></table> Alternatively you can import names from the template into the currentnamespace: <table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1 2 3 4 5 6 7 8 9</pre></div></td><td class="code"><div class="highlight"><pre>{% from 'forms.html' import input as input_field, textarea %} <dl> <dt>Username</dt> <dd>{{ input_field('username') }}</dd> <dt>Password</dt> <dd>{{ input_field('password', '', 'password') }}</dd> </dl> <p>{{ textarea('comment') }}</p> </pre></div></td></tr></table> Tip To import macros from the current file, use the special `_self` variablefor the source. See also [*macro*](#), [*from*](#)