Django Template Engine provides filters which are used to transform the values of variables and tag arguments. We have already discussed major Django Template Tags. Tags can't modify value of a variable whereas filters can be used for incrementing value of a variable or modifying it to one's own need.
Syntax
{{ variable_name | filter_name }} Filters can be “chained.” The output of one filter is applied to the next. {{ text|escape|linebreaks }} is a common idiom for escaping text contents, then converting line breaks to <p> tags.
Example
{{ value | length }} If value is ['a', 'b', 'c', 'd'], the output will be 4.
Major Template Filters in Django
This article revolves around various Django Template Filters one can use during a project. Filters transform the values of variables and tag arguments. Let's check some major filters.
add
- It is used to add an argument to the value. Example
{{ value | add:"2" }}- If value is 4, then the output will be 6. This filter is used to increment a variable in django Templates.
addslashes
- It is used to add slashes before quotes. Useful for escaping strings in CSV. Example
{{ value | addslashes }}- If value is "I'm Jai", the output will be "I\'m Jai".
capfirst
- It is used to capitalize the first character of the value. If the first character is not a letter, this filter has no effect. Example
{{ value | capfirst }}- If value is "jai", the output will be "Jai".
center
- It is used to center the value in a field of a given width. Example
"{{ value | center:"15" }}"- If value is "Jai", the output will be " Jai ".
cut
- It is used to remove all values of arg from the given string. Example
{{ value | cut:" " }}- If value is "String with spaces", the output will be "Stringwithspaces".
date
- It is used to format a date according to the given format. Example
{{ value | date:"D d M Y" }}- If value is a datetime object (e.g., the result of datetime.datetime.now()), the output will be the string 'Thu 06 Feb 2020'. For More information and patterns visit here.
default
- It is used to give a default value to a variable. If variable evaluates to False, it will use the default argument given else the variable value itself. Example
{{ value | default:"nothing" }}- If value is "" (the empty string), the output will be nothing.
dictsort
- It takes a list of dictionaries and returns that list sorted by the key given in the argument. Example
{{ value | dictsort:"name" }}- If value is:
[ {'name': 'zed', 'age': 19}, {'name': 'amy', 'age': 22}, {'name': 'joe', 'age': 31}, ]- then the output would be:
[ {'name': 'amy', 'age': 22}, {'name': 'joe', 'age': 31}, {'name': 'zed', 'age': 19}, ] divisibleby
- It returns True if the value is divisible by the argument. Example
{{ value | divisibleby:"3" }}- If value is 21, the output would be True.
escape
- It is used to escape a string’s HTML. Specifically, it makes these replacements:
html < is converted to < > is converted to > ' (single quote) is converted to ' " (double quote) is converted to " & is converted to &
- Example
{{ title | escape }}filesizeformat
- It is used to format the value like a ‘human-readable’ file size (i.e. '13 KB', '4.1 MB', '102 bytes', etc.). Example
{{ value | filesizeformat }}- If value is 123456789, the output would be 117.7 MB.
first
- It is used to return the first item in a list. Example
{{ value | first }}- If value is the list ['a', 'b', 'c'], the output will be 'a'.
join
- It is used to join a list with a string, like Python’s str.join(list) Example
{{ value | join:" // " }}- If value is the list ['a', 'b', 'c'], the output will be the string "a // b // c".
last
- It is used to return the last item in a list. Example
{{ value | last }}- If value is the list ['a', 'b', 'c', 'd'], the output will be the string "d".
length
- It is used to return the length of the value. This works for both strings and lists. Example
{{ value | length }}- If value is ['a', 'b', 'c', 'd'] or "abcd", the output will be 4.
linenumbers
- It is used to display text with line numbers. Example
{{ value | linenumbers }}- If value is:
one two three
- the output will be:
1. one 2. two 3. three
lower
- It is used to converts a string into all lowercase. Example
{{ value | lower }}}- If value is My Name is Jai, the output will be my name is jai.
make_list
- It is used to return the value turned into a list. For a string, it’s a list of characters. For an integer, the argument is cast to a string before creating a list. Example
{{ value | make_list }}- If value is the string "Naveen", the output would be the list ['N', 'a', 'v', 'e', 'e', 'n']. If value is 123, the output will be the list ['1', '2', '3'].
random
- It is used to return a random item from the given list. Example
{{ value | random }}- If value is the list ['a', 'b', 'c', 'd'], the output could be "b".
slice
- It is used to return a slice of the list. Example
{{ some_list | slice:":2" }}- If some_list is ['a', 'b', 'c'], the output will be ['a', 'b'].
slugify
- It is used to convert to ASCII. It converts spaces to hyphens and removes characters that aren’t alphanumerics, underscores, or hyphens. Converts to lowercase. Also strips leading and trailing whitespace. Example
{{ value | slugify }}- If value is "Jai is a slug", the output will be "jai-is-a-slug".
time
- It is used to format a time according to the given format. Example
{{ value | time:"H:i" }}- If value is equivalent to datetime.datetime.now(), the output will be the string "01:23".
timesince
- It is used to format a date as the time since that date (e.g., “4 days, 6 hours”). Example
{{ blog_date | timesince:comment_date }}- if blog_date is a date instance representing midnight on 1 June 2006, and comment_date is a date instance for 08:00 on 1 June 2006, then the following would return “8 hours”
title
- It is used to convert a string into titlecase by making words start with an uppercase character and the remaining characters lowercase. This filter makes no effort to keep “trivial words” in lowercase. Example
{{ value | title }}- If value is "my FIRST post", the output will be "My First Post".
unordered_list
- It is used to recursively take a self-nested list and returns an HTML unordered list – WITHOUT opening and closing <ul> tags. Example
{{ var | unordered_list }}- if var contains ['States', ['Kansas', ['Lawrence', 'Topeka'], 'Illinois']], then {{ var|unordered_list }} would return:
html <li>States <ul> <li>Kansas <ul> <li>Lawrence</li> <li>Topeka</li> </ul> </li> <li>Illinois</li> </ul> </li> </li>
upper
- It is used to convert a string into all uppercase. Example
{{ value | upper }}- If value is "Jai is a slug", the output will be "JAI IS A SLUG".
wordcount
- It is used to return the number of words. Example
{{ value | wordcount }}- If value is "jai is a slug", the output will be 4.
Similar Reads
Django Templates Templates are the third and most important part of Django's MVT Structure. A Django template is basically an HTML file that can also include CSS and JavaScript. The Django framework uses these templates to dynamically generate web pages that users interact with. Since Django primarily handles the ba
7 min read
variables - Django Templates Prerequisite- Django TemplatesIn Django, templates are used to dynamically generate HTML content by combining static HTML with dynamic data from views. One of the simplest and most useful features of Django templates is the use of variables. Variables allow you to display data passed from a view ins
2 min read
Django Template Tags Prerequisite: What are Django Templates?Django provides a powerful templating engine that allows us to add logic directly into our templates using template tags. These tags enable everything from control structures (like if and for loops), to inserting dynamic content, to template inheritance. Templ
4 min read
extends - Django Template Tags Django’s {% extends %} tag allows you to reuse a base template across multiple pages, so you don’t have to repeat the same HTML code in every template. This makes your templates cleaner, easier to maintain, and helps keep a consistent layout throughout your site.Syntax: {% extends 'base_template.htm
2 min read
if - Django Template Tags The {% if %} tag in Django templates allows us to control what content is displayed based on certain conditions. We can use it to show or hide parts of a page depending on whether a condition is met.Syntax of the {% if %} Tag{% if variable %}// statements{% else %}// statements{% endif %}condition:
3 min read
for loop - Django Template Tags Django templates allow you to render dynamic data by embedding Python-like logic into HTML. The for loop is one of the most commonly used template tags, enabling you to iterate over lists or other iterable objects. It helps you display repeated content (like lists, tables, etc.) in your templates wi
3 min read
comment - 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 the template but also provide som
2 min read
include - 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
2 min read
url - Django Template Tag 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
3 min read
cycle - 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
3 min read