extends – Django Template Tags
A Django template is a text document or a Python string marked-up using the Django template language. Django being a powerful Batteries included framework provides convenience to rendering data in a template. Django templates not only allow passing data from view to template, but also provides some limited features of a programming such as variables, for loops, comments, extends etc.
This article revolves about how to use extends tag in Templates. extends tag is used for inheritance of templates in django. One needs to repeat the same code again and again. Using extends we can inherit templates as well as variables.
Syntax:
{% extends 'template_name.html' %}
Example:
assume the following directory structure:
dir1/
template.html
base2.html
my/
base3.html
base1.html
In template.html, the following paths would be valid:
html
{% extends "./base2.html" %}{% extends "../base1.html" %}{% extends "./my/base3.html" %} |
extends – Django template Tags Explanation
Illustration of How to use extends tag in Django templates using an Example. Consider a project named w3wiki having an app named Beginner.
Refer to the following articles to check how to create a project and an app in Django.
Now create a view through which we will access the template,
In Beginner/views.py,
Python3
# import Http Response from djangofrom django.shortcuts import render# create a functiondef Beginner_view(request): # return response return render(request, "extendedBeginner.html") |
Create a url path to map to this view. In Beginner/urls.py,
Python3
from django.urls import path# importing views from views.pyfrom .views import Beginner_viewurlpatterns = [ path('', Beginner_view),] |
extends is always used with block tags so that can be inherited and overridden. Create a template as base template in templates/Beginner.html.
html
<h1>Main Template</h1>{% block content %}{% endblock %} |
Now create a template which will use Beginner.html as base template. Create a new template extendedBeginner.html,
html
{% extends "Beginner.html" %}{% block content %}<h2> w3wiki is the Best{% endblock %} |
Let’s check if data is displayed from both the templates in extendedBeginner.html
Advanced Usage
{% extends variable %} uses the value of variable. If the variable evaluates to a string, Django will use that string as the name of the parent template. If the variable evaluates to a Template object, Django will use that object as the parent template.