Variables vs Tags

Variables

{{ variable }}

Output data into HTML.

Example:

1

{{ post.title }}

If the variable inside {{}} is a Python dict, you can access its elements using:

1

{{ variable.key }}

If the variable inside {{}} is a Python list, you can access its elements by index using:

1

{{ variable.0 }}

Nested elements:

1

{{ variable.key.0 }}

Template Tags

{% tag %}

Used for logic / actions.

Core Template Tags

Load Static Files

1

{% load static %}

Required before using static paths.

1

<link rel="stylesheet" href="{% static 'css/main.css' %}">

URL Generation

1

{% url 'blog:index' %}

Dynamic URL from urls.py

With parameters:

1

{% url 'blog:post' post.slug %}

Named arguments:

1

{% url 'blog:post' slug=post.slug %}

If Statements

1
2
3
4
5

{% if user.is_authenticated %}

    <p>Logged in</p>

{% endif %}

With elif else:

1
2
3
4

{% if posts %}
{% elif other_posts %}
{% else %}
{% endif %}

For Loops

1
2
3
4
5

{% for post in posts %}

    {{ post.title }}

{% endfor %}

Loop counter: {{ forloop.counter }} -> counter starting at 1 {{ forloop.counter0 }} -> counter starting at 0

Block Inheritance

Inside Base Template:

1
2

{% block content %}
{% endblock %}

Inside Child Template:

1
2
3
4
5
6
7

{% extends 'base.html' %}

{% block content %}

    <h1>Hello</h1>

{% endblock %}

Include Other Templates

1

{% include 'partials/nav.html' %}

Reusable components.

CSRF Protection

Inside POST forms:

1

{% csrf_token %}

Required for Django form security.

Common Filters (with variables)

Filters modify output.

Syntax:

1

{{ value|filter }}

Examples:

• {{ name|upper }}
• {{ text|truncatechars:50 }}
• {{ content|safe }}
• {{ date|date:"Y-m-d" }}

Useful Examples:

Auth Navigation

1
2
3
4
5

{% if user.is_authenticated %}
    Logout
{% else %}
    Login
{% endif %}

Empty Loop Fallback

1
2
3
4

{% for post in posts %}
{% empty %}
<p>No posts found.</p>
{% endfor %}