编辑“︁Django模板标签”︁

= Django模板标签 =

'''Django模板标签'''是Django模板系统（Template System）的核心组成部分之一，用于在HTML模板中嵌入动态逻辑。它们允许开发者执行条件判断、循环迭代、变量赋值等操作，而无需在视图中处理所有逻辑。模板标签通常由大括号和百分号包围，例如<code>{% tag %}</code>。

== 基本语法 ==
Django模板标签的基本语法结构如下：
<syntaxhighlight lang="django">
{% tag_name arguments %}
</syntaxhighlight>

其中：
* <code>tag_name</code>是标签的名称（如<code>if</code>、<code>for</code>等）。
* <code>arguments</code>是可选的参数或表达式，具体取决于标签的功能。

== 常用模板标签 ==

=== 条件判断：<code>{% if %}</code> ===
<code>{% if %}</code>标签用于在模板中进行条件判断，类似于Python中的<code>if</code>语句。

==== 示例 ====
<syntaxhighlight lang="django">
{% if user.is_authenticated %}
    <p>Welcome, {{ user.username }}!</p>
{% else %}
    <p>Please log in.</p>
{% endif %}
</syntaxhighlight>

==== 输出 ====
* 如果用户已登录，显示欢迎消息。
* 如果用户未登录，提示登录。

=== 循环迭代：<code>{% for %}</code> ===
<code>{% for %}</code>标签用于遍历可迭代对象（如列表、查询集等）。

==== 示例 ====
<syntaxhighlight lang="django">
<ul>
{% for item in items %}
    <li>{{ item.name }}</li>
{% empty %}
    <li>No items available.</li>
{% endfor %}
</ul>
</syntaxhighlight>

==== 输出 ====
* 如果<code>items</code>不为空，渲染每个项目的名称。
* 如果<code>items</code>为空，显示“No items available”。

=== 变量赋值：<code>{% with %}</code> ===
<code>{% with %}</code>标签用于在模板中临时赋值变量，避免重复计算或访问复杂表达式。

==== 示例 ====
<syntaxhighlight lang="django">
{% with total=items|length %}
    <p>Total items: {{ total }}</p>
{% endwith %}
</syntaxhighlight>

==== 输出 ====
显示<code>items</code>的长度。

=== 模板继承：<code>{% extends %}</code> 和 <code>{% block %}</code> ===
Django的模板继承机制允许创建基础模板（父模板）并在子模板中覆盖特定部分。

==== 父模板（base.html） ====
<syntaxhighlight lang="django">
<!DOCTYPE html>
<html>
<head>
    <title>{% block title %}Default Title{% endblock %}</title>
</head>
<body>
    {% block content %}
    {% endblock %}
</body>
</html>
</syntaxhighlight>

==== 子模板（child.html） ====
<syntaxhighlight lang="django">
{% extends "base.html" %}

{% block title %}Custom Title{% endblock %}

{% block content %}
    <p>This is the child template content.</p>
{% endblock %}
</syntaxhighlight>

==== 输出 ====
子模板继承父模板的结构，并覆盖<code>title</code>和<code>content</code>块。

== 高级模板标签 ==

=== 自定义标签 ===
开发者可以创建自定义模板标签以扩展功能。自定义标签需要：
1. 在<code>templatetags</code>目录中创建Python模块。
2. 使用<code>@register.simple_tag</code>或<code>@register.inclusion_tag</code>装饰器注册标签。

==== 示例：自定义标签 ====
<syntaxhighlight lang="python">
# myapp/templatetags/custom_tags.py
from django import template

register = template.Library()

@register.simple_tag
def current_time(format_string):
    from datetime import datetime
    return datetime.now().strftime(format_string)
</syntaxhighlight>

==== 在模板中使用 ====
<syntaxhighlight lang="django">
{% load custom_tags %}
<p>Current time: {% current_time "%Y-%m-%d %H:%M:%S" %}</p>
</syntaxhighlight>

==== 输出 ====
显示当前时间，格式为<code>YYYY-MM-DD HH:MM:SS</code>。

=== 过滤器标签：<code>{% filter %}</code> ===
<code>{% filter %}</code>标签用于对块内的内容应用过滤器。

==== 示例 ====
<syntaxhighlight lang="django">
{% filter upper %}
    This text will be uppercase.
{% endfilter %}
</syntaxhighlight>

==== 输出 ====
<pre>THIS TEXT WILL BE UPPERCASE.</pre>

== 实际应用案例 ==

=== 分页显示 ===
使用<code>{% for %}</code>和条件判断实现分页逻辑。

<syntaxhighlight lang="django">
<div class="pagination">
    {% if page_obj.has_previous %}
        <a href="?page=1">First</a>
        <a href="?page={{ page_obj.previous_page_number }}">Previous</a>
    {% endif %}

    <span>Page {{ page_obj.number }} of {{ page_obj.paginator.num_pages }}</span>

    {% if page_obj.has_next %}
        <a href="?page={{ page_obj.next_page_number }}">Next</a>
        <a href="?page={{ page_obj.paginator.num_pages }}">Last</a>
    {% endif %}
</div>
</syntaxhighlight>

=== 动态导航菜单 ===
根据用户权限显示不同的导航项。

<syntaxhighlight lang="django">
<ul>
    <li><a href="/">Home</a></li>
    {% if user.is_staff %}
        <li><a href="/admin/">Admin Panel</a></li>
    {% endif %}
</ul>
</syntaxhighlight>

== 模板标签的Mermaid流程图 ==
以下是一个简单的模板标签处理流程：

<mermaid>
graph TD
    A[模板引擎解析模板] --> B[遇到模板标签]
    B --> C{标签类型?}
    C -->|if/for等| D[执行逻辑]
    C -->|自定义标签| E[调用自定义函数]
    D --> F[生成HTML]
    E --> F
</mermaid>

== 数学公式支持 ==
如果需要计算模板中的数值，可以使用数学公式。例如，计算百分比：
<math>
\text{Percentage} = \left( \frac{\text{part}}{\text{total}} \right) \times 100
</math>

== 总结 ==
Django模板标签提供了强大的逻辑控制能力，使得模板可以动态渲染内容而无需在视图中处理所有细节。通过合理使用内置标签和自定义标签，开发者可以创建灵活且易于维护的模板系统。

[[Category:后端框架]]
[[Category:Django]]
[[Category:Django模板系统]]