Mastering Django Template Language (DTL): A Step-by-Step Guide

Django's Template Language (DTL) is a powerful tool for rendering dynamic data on web pages using HTML templates. This guide will cover how to pass data from views to templates, display variables, use conditional statements, apply loops, and implement filters with practical examples.

✅ 1. Passing Data from Views to Templates

🧠 How to Pass Data:

Data is passed using the context dictionary in the render() function.

# views.py
from django.shortcuts import render

# Simple Template Rendering
def home(request):
    return render(request, 'myapp/home.html')

# Dynamic Data Rendering
def user_info(request):
    context = {
        'name': 'John Doe',
        'age': 25,
        'fruits': ['Apple', 'Banana', 'Cherry'],
        'is_logged_in': True,
        'score': 85,
        'hobbies': ['Reading', 'Gaming', 'Traveling'],
    }
    return render(request, 'user_info.html', context)

🧠 Setting Up URL Routing (`urls.py`):

from django.urls import path
from . import views

urlpatterns = [
    path('', views.home, name='home'),
    path('userinfo/', views.user_info, name='user_info'),
]

✅ 2. Displaying Variables in Templates

📌 Template (`user_info.html`):

<!DOCTYPE html>
<html>
<head>
    <title>User Information</title>
</head>
<body>
    <h1>Hello, {{ name }}!</h1>
    <p>Age: {{ age }}</p>
    <p>Score: {{ score }}</p>

    <h2>Your Favorite Fruits:</h2>
    <ul>
    {% for fruit in fruits %}
        <li>{{ fruit }}</li>
    {% empty %}
        <li>No fruits available</li>
    {% endfor %}

    <h2>Hobbies:</h2>
    <ul>
    {% for hobby in hobbies %}
        <li>{{ hobby }}</li>
    {% empty %}
        <li>No hobbies listed</li>
    {% endfor %}

    <h2>Login Status:</h2>
    {% if is_logged_in %}
        <p>You are logged in.</p>
    {% else %}
        <p>Please log in.</p>
    {% endif %}
</body>
</html>

✅ Example Output:

Hello, John Doe!
Age: 25
Score: 85

Your Favorite Fruits:
- Apple
- Banana
- Cherry

Hobbies:
- Reading
- Gaming
- Traveling

Login Status:
You are logged in.

✅ 3. Using Conditional Statements in Templates

🧾 Example: Displaying Messages Based on Conditions

{% if score >= 90 %}
    <p>Excellent! You scored A grade.</p>
{% elif score >= 75 %}
    <p>Good Job! You scored B grade.</p>
{% else %}
    <p>Keep Trying! You scored below B grade.</p>
{% endif %}

✅ Explanation:

{% if ... %}: Checks if score >= 90.
{% elif ... %}: Additional condition for score >= 75.
{% else %}: Displays fallback message if none of the conditions are met.

✅ 4. Using Loops to Display Lists

🧾 Example: Displaying a List of Fruits and Hobbies

<h2>Your Favorite Fruits:</h2>
<ul>
{% for fruit in fruits %}
    <li>{{ fruit }}</li>
{% empty %}
    <li>No fruits available</li>
{% endfor %}
</ul>

<h2>Hobbies:</h2>
<ul>
{% for hobby in hobbies %}
    <li>{{ hobby }}</li>
{% empty %}
    <li>No hobbies listed</li>
{% endfor %}
</ul>

✅ Explanation:

{% for ... in ... %}: Iterates over both fruits and hobbies lists.
{% empty %}: Displays a message if the list is empty.

✅ 5. Applying Filters to Variables

🎨 Common Filters:

<p>Name in Uppercase: {{ name|upper }}</p>
<p>Truncated Name: {{ name|truncatechars:5 }}</p>
<p>Formatted Age: {{ age|add:5 }}</p>
<p>Default Value Example: {{ unknown_variable|default:'Not Available' }}</p>

✅ Filter Descriptions:

upper: Converts text to UPPERCASE.
truncatechars: Limits the text to specified characters.
add: Performs addition on numeric values.
default: Displays a default value if the variable is undefined.

✅ 6. Commenting in Templates

💡 Adding Comments:

{# This is a comment in Django template #}

Comments are not displayed in the browser.
Useful for adding notes and instructions in templates.

✅ 7. Best Practices with Django Template Language

Use simple variable syntax ({{ variable }}) to display data.
Avoid complex logic in templates; keep business logic in views.
Utilize conditional tags ({% if %}) and loops ({% for %}) effectively.
Apply filters to format data directly in templates.
Keep templates clean and maintainable using comments.

🎯 Conclusion:

By mastering Django Template Language (DTL), you can create dynamic and interactive web pages efficiently. Using variables, conditionals, loops, and filters, you can render data seamlessly from views to templates. Following the best practices will ensure that your templates remain clean, maintainable, and scalable. 🚀

Search This Blog

Django With Praveen