Django模板标签完整攻略（详解版）

目录

• 模板标签语法
• 常用模板标签
  • {% if %}标签
  • {% for %}标签
  • {% url %}标签
  • {% block %}标签
  • {% extends %}标签
• 自定义模板标签
• 总结

Django模板标签是用于在模板中动态地展示或操作数据的一种方式。Django自带了许多标签，如 {% if %}、{% for %}、{% url %}等，同时也支持自定义标签。下面详细介绍Django模板标签的语法和用法。

模板标签语法

Django模板标签以“{%”开头，“%}”结尾，如下所示：

{% tag %}

其中，tag是标签的名称，具体使用方法和作用取决于标签本身。

常用模板标签

{% if %}标签

{% if %}是Django中最常用的标签之一，用于根据条件判断是否展示某些内容。其语法如下：

{% if condition %}
    content
{% endif %}

其中，condition是一个逻辑表达式，为True时展示content，False时不展示。

例如，如果我们要根据是否登录显示不同的欢迎信息，可以使用以下代码：

{% if user.is_authenticated %}
    <p>欢迎您，{{ user.username }}！</p>
{% else %}
    <p>您还没有登录。</p>
{% endif %}

{% for %}标签

{% for %}标签用于循环遍历序列（如列表、查询结果等）的每个元素，并依次展示内容。其语法如下：

{% for element in sequence %}
    content
{% endfor %}

其中，element是序列中的每个元素，在每次循环中都会被赋值；sequence是待遍历的序列，可以是列表、查询结果等；content是需要展示的内容，可以使用element代表序列中的元素。

例如，如果要展示一张照片墙，可以使用以下代码：

{% for image in images %}
    <img src="{{ image.url }}">
{% endfor %}

{% url %}标签

{% url %}标签用于根据视图函数名称和URL名称反解析出URL。其语法如下：

{% url 'view_name' arg1 arg2 %}

其中，view_name是视图函数的名称，可以是在urlpatterns中指定的函数名或相关视图类的as_view()方法；arg1, arg2等是传递给视图函数的参数。

例如，如果要传递id=1作为参数访问detail视图函数，可以使用以下代码：

{% url 'detail' id=1 %}

{% block %}标签

{% block %}标签用于定义一个在子模板中可以被覆盖的区块。其语法如下：

{% block block_name %}
    content
{% endblock %}

其中，block_name是区块的名称，可以被子模板覆盖；content是需要展示的内容，如果子模板没有覆盖该区块，则展示该内容。

例如，如果要在模板中定义一个可被覆盖的侧边栏，可以使用以下代码：

{% block sidebar %}
    <ul>
        <li><a href="#">Link1</a></li>
        <li><a href="#">Link2</a></li>
        <li><a href="#">Link3</a></li>
    </ul>
{% endblock %}

{% extends %}标签

{% extends %}标签用于从父模板中继承内容，可以引入父模板中的{% block %}标记。其语法如下：

{% extends 'base.html' %}

其中，'base.html'是父模板的路径，通常使用绝对路径或相对于TEMPLATE_DIRS的相对路径。

例如，如果要在一个子模板中继承父模板，并覆盖其中的sidebar区块，可以使用以下代码：

{% extends 'base.html' %}
{% block sidebar %}
    <ul>
        <li><a href="#">New Link1</a></li>
        <li><a href="#">New Link2</a></li>
        <li><a href="#">New Link3</a></li>
    </ul>
{% endblock %}

自定义模板标签

除了Django自带的标签外，我们还可以自定义标签来实现更复杂的功能。自定义标签需要在应用程序的templatetags目录下创建一个py文件，并定义一个包含处理逻辑的函数。

例如，我们定义一个名为lower的标签，用于将给定字符串转换为小写：

1.上面提到过，需要在templatetags目录下创建一个py文件，例如mytags.py;

2.在mytags.py中定义lower函数，如下所示：

from django import template

register = template.Library()

@register.filter
def lower(value):
    return value.lower()

其中，lower函数接收一个字符串作为参数，将其转换为小写并返回；@register.filter是一个装饰器，用于将lower注册为过滤器。

3.在模板中使用lower标签，如下所示：

{{ text|lower }}

其中，text是要转换的字符串，lower是自定义的标签名。

总结

Django模板标签是展示和操作数据的重要手段，Django提供了许多常用标签，如if、for、url等；另外，我们可以自定义标签来实现更复杂的功能。掌握Django模板标签的语法和用法，对于开发Web应用程序非常重要。