Gecko [ www.finalhopeacademy.com ]

Name	Size	Permission
autoescape.rst	1.65 KB	-rw-r--r--
block.rst	448 B	-rw-r--r--
do.rst	177 B	-rw-r--r--
embed.rst	6.84 KB	-rw-r--r--
extends.rst	7.19 KB	-rw-r--r--
filter.rst	463 B	-rw-r--r--
flush.rst	218 B	-rw-r--r--
for.rst	4.46 KB	-rw-r--r--
from.rst	275 B	-rw-r--r--
if.rst	1.92 KB	-rw-r--r--
import.rst	1.72 KB	-rw-r--r--
include.rst	2.47 KB	-rw-r--r--
index.rst	238 B	-rw-r--r--
macro.rst	2.61 KB	-rw-r--r--
sandbox.rst	764 B	-rw-r--r--
set.rst	1.64 KB	-rw-r--r--
spaceless.rst	1.14 KB	-rw-r--r--
use.rst	3.18 KB	-rw-r--r--
verbatim.rst	367 B	-rw-r--r--
with.rst	1.07 KB	-rw-r--r--

Code Editor : import.rst

``import``
==========

Twig supports putting often used code into :doc:`macros<../tags/macro>`. These
macros can go into different templates and get imported from there.

There are two ways to import templates. You can import the complete template
into a variable or request specific macros from it.

Imagine we have a helper module that renders forms (called ``forms.html``):

.. code-block:: jinja

{% 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 %}

The easiest and most flexible is importing the whole module into a variable.
That way you can access the attributes:

.. code-block:: jinja

{% 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>

Alternatively you can import names from the template into the current
namespace:

.. code-block:: jinja

{% 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>

.. tip::

To import macros from the current file, use the special ``_self`` variable
    for the source.

.. seealso:: :doc:`macro<../tags/macro>`, :doc:`from<../tags/from>`

${this.title}

Code Editor : import.rst