DTL Tags & Filters

The Anatomy of the Django Template Language

Before we start coding, let's look at the basic building blocks of DTL. It consists of four main components:

1. Template Tags: Adding Logic to Your Templates

Template tags provide the logic and control flow inside your templates. The syntax {% tag_name %} will feel familiar to control structures in Python. Django processes these tags when rendering the template and executes the instruction.

Let's explore the most fundamental tags.

The {% for %} Tag: Looping Through Data

Remember that item_list we passed to the template in our last lesson? The {% for %} tag is how you iterate over it to create a proper list in HTML.

Syntax:

<ul>
    {% for item in item_list %}
        <li>{{ item }}</li>
    {% endfor %}
</ul>

This is directly analogous to Python's for item in item_list:. The loop is opened with {% for ... %} and must be closed with {% endfor %}.

The following video provides a practical demonstration of using a for loop to iterate over data related to a database object.

Helpful Loop Variables

Inside a for loop block, DTL gives you access to a special forloop object with useful attributes about the state of the loop:

For example, you could add a special CSS class to the first item in a list:

{% for item in item_list %}
    <li class="{% if forloop.first %}first-item{% endif %}">{{ item }}</li>
{% endfor %}

The {% if %}, {% elif %}, and {% else %} Tags: Conditional Logic

Just like in Python, you can control which parts of your template are rendered using conditional statements. This is perfect for showing or hiding elements based on the context data.

The syntax is intuitive:

{% if user.is_authenticated %}
    <p>Welcome, {{ user.username }}!</p>
{% elif user.is_guest %}
    <p>Welcome, Guest!</p>
{% else %}
    <p><a href="/login/">Please log in.</a></p>
{% endif %}

Like the for loop, an if block must be closed with {% endif %}. You can use boolean operators like and, or, and not, as well as comparison operators like ==, >, <.

A common task is handling an empty list. The for tag has a convenient built-in clause for this, {% empty %}.

The {% url %} Tag: Dynamic and Robust URLs

Hardcoding URLs in your templates (e.g., <a href="/polls/3/">) is fragile. If you ever change the URL structure in your urls.py, you have to hunt down and fix every instance in your templates. The {% url %} tag solves this problem.

It generates a URL by looking up a named URL pattern in your urls.py.

Example:
In polls/urls.py:

path('<int:question_id>/', views.detail, name='detail'),

In your template:

<a href="{% url 'detail' question.id %}">View Question</a>

Django will see name='detail', find the corresponding path, substitute question.id for <int:question_id>, and render the correct URL (e.g., /polls/3/).

This next video explains this critical concept and also introduces namespacing, which is essential for projects with multiple apps.

<ul>
    {% for product in products %}
        {% if product.in_stock %}
            <li>{{ product.name }} - ${{ product.price }}</li>
        {% endif %}
    {% empty %}
        <li>No products available.</li>
    {% endfor %}
</ul>

2. Template Filters: Formatting Your Data

While tags create logic, filters transform the output of your variables. The syntax uses a pipe character |, which should feel familiar if you've used command-line pipes in a shell.

Syntax: {{ variable|filter_name }} or {{ variable|filter_name:"argument" }}

Let's watch a video that introduces filters and demonstrates some of the most common ones.

Here's a summary of some useful filters. The official Django documentation, which we'll link to, has the complete list.

For a comprehensive guide and a complete list of all built-in tags and filters, the official Django documentation is the ultimate resource.

A Note on Logic: Templates vs. Views

DTL is powerful, but it's intentionally limited. It is designed for presentation logic, not business logic.

• Good use of DTL: Looping through a list, checking if a user is logged in, formatting a date.
• Bad use of DTL: Performing complex calculations, making database queries, processing API responses.

As a rule of thumb, prepare your data in the view. The view should do all the heavy lifting and pass a clean, easy-to-use context to the template. The template should then focus only on how to display that data.

Conclusion

You've now added the core of the Django Template Language to your toolkit. You can move beyond simply displaying variables and start controlling the structure and format of your rendered pages.

Key Takeaways:

• Tags {% ... %} control logic: Use {% for %} to iterate, {% if %} for conditionals, and {% url %} for creating robust links. Remember to close your blocks with {% endfor %} and {% endif %}.
• Filters | format output: Use filters like date, length, truncatewords, and upper to change how your variables are displayed.
• Chain filters for more power: You can apply multiple filters sequentially, like {{ variable|striptags|truncatewords:50 }}.
• Keep logic separated: Do complex data processing in the view. Use the template for presentation logic only.

In this lesson, we worked inside a single template file. In the real world, websites have many repeated elements like headers, footers, and sidebars. In our next lesson, we will explore template inheritance using the {% extends %} and {% block %} tags. This powerful feature will allow you to create a base layout and reuse it across your entire site, making your code much more efficient and maintainable.