support-dtl.md

Django template Language

Django’s template language is designed to strike a balance between power and ease. It’s designed to feel comfortable to those used to working with HTML. If you have any exposure to other text-based template languages, such as Smarty or Jinja2, you should feel right at home with Django’s templates.

Support

The following Handlebars to Django conversions are currently supported:

• comment
  • comment
• variable
  • variable
  • upper-context-variables
• raw
  • raw
• if
  • if
  • if-else
  • if-elseif
  • if-else-if
  • if-elseif-else
• for
  • for
  • for-data
  • for-index
  • for-blockparams
  • for-key
  • nested-for-blockparams
  • nested-for-conditional
  • nested-for-data
• partial
  • basic
  • dynamic
  • parameters

comment

comment/comment

hbs input:

<div class="entry">
  {{!-- comment 1 --}}
  {{! comment 2 }}
  inline {{! comment 3 }} test
  <!-- html comment -->
</div>

htl output:

<div class="entry">
  {# comment 1 #}
  {# comment 2 #}
  inline {# comment 3 #} test
  <!-- html comment -->
</div>

variable

variable/variable

hbs input:

<h1>{{ foo }}</h1>
<h1>{{ foo.bar }}</h1>

htl output:

<h1>{{ foo }}</h1>
<h1>{{ foo.bar }}</h1>

variable/upper-context-variables

hbs input:

{{#each users }}
  {{ name }}

  {{#each comments }}
    {{ ../name }} {{title}}

    {{#each commenter }}
      {{../../name}} {{name}}
    {{/each}}
  {{/each}}
{{/each}}

htl output:

{% for users_i in users %}
  {{ users_i.name }}

  {% for comments_i in users_i.comments %}
    {{ users_i.name }} {{ comments_i.title }}

    {% for commenter_i in comments_i.commenter %}
      {{ users_i.name }} {{ commenter_i.name }}
    {% endfor %}
  {% endfor %}
{% endfor %}

raw

raw/raw

hbs input:

{{ escaped }}
{{{ notEscaped }}}

htl output:

{{ escaped }}
{{ notEscaped|safe }}

if

if/if

hbs input:

{{#if foo }}
  Foo
{{/if}}

htl output:

{% if foo %}
  Foo
{% endif %}

if/if-else

hbs input:

{{#if foo as isFoo }}
  Foo
{{else}}
  Bar
{{/if}}

htl output:

{% if foo %}
  Foo
{% else %}
  Bar
{% endif %}

if/if-elseif

hbs input:

{{#if foo }}
  Foo
{{else if bar }}
  Bar
{{/if}}

htl output:

{% if foo %}
  Foo
{% elif bar %}
  Bar
{% endif %}

if/if-else-if

hbs input:

{{#if foo }}
  Foo
{{else}}
  {{# if bar }}
    Bar
  {{/if}}
  Baz
{{/if}}

htl output:

{% if foo %}
  Foo
{% else %}
  {% if bar %}
    Bar
  {% endif %}
  Baz
{% endif %}

if/if-elseif-else

hbs input:

{{#if foo }}
  Foo
{{else if bar }}
  Bar
{{else}}
  Foobar
{{/if}}

htl output:

{% if foo %}
  Foo
{% elif bar %}
  Bar
{% else %}
  Foobar
{% endif %}

for

for/for

hbs input:

{{#each users }}
  <a href="{{ foobar }}">link</a>
{{/each}}

htl output:

{% for users_i in users %}
  <a href="{{ users_i.foobar }}">link</a>
{% endfor %}

for/for-data

hbs input:

{{#each users }}
  <a href="{{ foobar }}">{{ this }}</a>
{{/each}}

htl output:

{% for users_i in users %}
  <a href="{{ users_i.foobar }}">{{ users_i }}</a>
{% endfor %}

for/for-index

hbs input:

{{#each users }}
  {{ @index }}: {{ this }}
{{/each}}

htl output:

{% for users_i in users %}
  {{ forloop.counter0 }}: {{ users_i }}
{% endfor %}

for/for-blockparams

hbs input:

{{#each map as |value key| }}
  {{ key }}: {{ value }}
{{/each}}

htl output:

{% for key, value in map.items %}
  {{ key }}: {{ value }}
{% endfor %}

for/for-key

hbs input:

{{#each map }}
  {{ @key }}: {{ this }}
{{/each}}

htl output:

{% for key, map_i in map.items %}
  {{ key }}: {{ map_i }}
{% endfor %}

for/nested-for-blockparams

hbs input:

{{#each users as |user| }}
  {{ user.name }}

  {{#each comments as |comment| }}
    {{ user.name }} {{comment.title}}
  {{/each}}

{{/each}}

htl output:

{% for user in users %}
  {{ user.name }}

  {% for comment in user.comments %}
    {{ user.name }} {{ comment.title }}
  {% endfor %}

{% endfor %}

for/nested-for-conditional

hbs input:

{{#each users }}
  {{#if foo }}

    {{#each comments }}

      {{#if title}}
        <a href="{{ id }}">{{ name }}</a>
      {{/if}}

    {{/each}}

  {{else}}
    {{#each comments }}
      {{id}}
    {{/each}}
  {{/if}}
{{/each}}

htl output:

{% for users_i in users %}
  {% if users_i.foo %}

    {% for comments_i in users_i.comments %}

      {% if comments_i.title %}
        <a href="{{ comments_i.id }}">{{ comments_i.name }}</a>
      {% endif %}

    {% endfor %}

  {% else %}
    {% for comments_i in users_i.comments %}
      {{ comments_i.id }}
    {% endfor %}
  {% endif %}
{% endfor %}

for/nested-for-data

hbs input:

{{#each users }}
  <a href="{{ id }}">{{ name }}</a>
  {{#each comments }}
    {{ name }}
  {{/each}}
{{/each}}

htl output:

{% for users_i in users %}
  <a href="{{ users_i.id }}">{{ users_i.name }}</a>
  {% for comments_i in users_i.comments %}
    {{ comments_i.name }}
  {% endfor %}
{% endfor %}

partial

partial/basic

hbs input:

{{> foo/bar.hbs }}

htl output:

{% include "foo/bar.html" %}

partial/dynamic

hbs input:

{{> (lookup . 'myVariable') }}

htl output:

{% include myVariable %}

partial/parameters

hbs input:

{{> myPartial name=firstName age=18 foo="bar" baz=true }}

htl output:

{% include "myPartial.html" with name=firstName age=18 foo="bar" baz=true %}