Home / Django

Rendering data in templates

When working with web applications, one of the essential tasks is to display data dynamically. Django, a powerful Python web framework, provides a straightforward and flexible way to render data in templates. Templates in Django allow you to separate the design and presentation logic from the application's business logic. In this article, we will explore how to render data in templates using Django.

Setting up the environment

Before we begin, make sure you have Django installed. You can install it by running the following command in your terminal:

pip install django

Once Django is installed, create a new Django project and navigate to its directory:

django-admin startproject myproject
cd myproject

Creating a template

To render data in Django, we need to create a template file that contains the HTML structure along with placeholders for dynamic content. Templates in Django use the Django template language, which provides a rich set of features for manipulating and displaying data.

In your Django project, create a new directory called templates. Inside this directory, create a file index.html:

mkdir templates
touch templates/index.html

Open index.html in your preferred text editor and add the following content:

<!DOCTYPE html>
<html>
<head>
    <title>My Django App</title>
</head>
<body>
    <h1>Welcome to my Django App</h1>
    <p>The current time is: {{ current_time }}</p>
</body>
</html>

In the above template, we have a placeholder {{ current_time }}, which will be replaced with the current time when rendered.

Rendering data in views

Now that we have created a template, let's render it with some data. In Django, views are responsible for processing requests and supplying the necessary data to the templates. Open the views.py file in your Django project directory and modify it as follows:

from django.shortcuts import render
import datetime

def index(request):
    current_time = datetime.datetime.now()
    return render(request, 'index.html', {'current_time': current_time})

In the index function, we import the render function from Django and the datetime module. We then fetch the current time using datetime.datetime.now(), and pass it as a variable current_time to the render function along with the template name 'index.html'.

Mapping URLs to views

To access the view we just created, we need to map a URL to it. Open urls.py in your project directory and modify it as follows:

from django.urls import path
from . import views

urlpatterns = [
    path('', views.index, name='index'),
]

In the above code, we import the path function from django.urls and our views module. We then define a URL pattern that maps the root URL ('') to the index view.

Running the application

We have set up our template, view, and URL mapping. Now, let's run our Django application. In the terminal, make sure you are in the project directory and execute the following command:

python manage.py runserver

Open your browser and visit http://localhost:8000. You should see the text "Welcome to my Django App" along with the current time dynamically rendered on the page.

Conclusion

Rendering data in templates is a fundamental aspect of building dynamic web applications. Django's template engine provides a powerful and efficient way to separate the presentation logic from the underlying application. By following the steps outlined in this article, you should now have a good understanding of how to render data in templates using Django. Happy coding!