.. _template:

`template`
----------

With the :ref:`philosophy of escape hatches <escape-hatches>`, at the edge we enable replacing the entire rendering of components with the `template` config. You can use it in `Table` cells, to render table rows, to replace the rendering of fields, inputs, headers, and more. The `template` argument supports two types of values:



Template path
~~~~~~~~~~~~~

Strings are interpreted as template paths:

.. code-block:: python

    form = Form.create(
        auto__model=Artist,
        fields__name__template='test_template_as_path.html',
    )

.. raw:: html

    <div class="iframe_collapse" onclick="toggle('c943d8a5-e028-49b6-a6c9-d4168c742ad3', this)">▼ Hide result</div>
    <iframe id="c943d8a5-e028-49b6-a6c9-d4168c742ad3" src="doc_includes/template/test_template_as_path.html" style="background: white; display: ; width: 100%; min-height: 100px; border: 1px solid gray;"></iframe>
    <div class="show_structure_toggler"><span onclick="toggle_iframe_structure_overlay()">Toggle structure</span></div>

`Template` object
~~~~~~~~~~~~~~~~~

Pass a Django `Template` object to write the template code you want inline:

.. code-block:: python

    form = Form.create(
        auto__model=Artist,
        fields__name__template=Template('template contents <b>here</b>'),
    )

.. raw:: html

    <div class="iframe_collapse" onclick="toggle('4b47d887-ad42-4a3a-9e8d-7d99bc4648f1', this)">▼ Hide result</div>
    <iframe id="4b47d887-ad42-4a3a-9e8d-7d99bc4648f1" src="doc_includes/template/test_template_objects.html" style="background: white; display: ; width: 100%; min-height: 100px; border: 1px solid gray;"></iframe>
    <div class="show_structure_toggler"><span onclick="toggle_iframe_structure_overlay()">Toggle structure</span></div>