Django 模板中如何定义 block？

推荐答案

在 Django 模板中，block 用于定义可以被继承模板覆盖的内容块。block 标签的语法如下：

{% block block_name %}
    <!-- 默认内容 -->
{% endblock %}

• block_name 是块的名称，必须是唯一的。
• 在子模板中，可以通过相同的 block_name 来覆盖父模板中的内容。

本题详细解读

1. block 的基本用法

在 Django 模板中，block 标签用于定义一个可替换的内容块。通常用于模板继承中，允许子模板覆盖父模板中的特定部分。

例如，假设有一个基础模板 base.html：

// www.javascriptcn.com code example
<!DOCTYPE html>
<html>
<head>
    <title>{% block title %}默认标题{% endblock %}</title>
</head>
<body>
    <header>
        {% block header %}默认头部内容{% endblock %}
    </header>
    <main>
        {% block content %}默认内容{% endblock %}
    </main>
</body>
</html>

在这个例子中，title、header 和 content 是三个不同的 block，子模板可以选择性地覆盖这些块。

2. 子模板中的 block 覆盖

子模板可以通过继承父模板并覆盖其中的 block 来定制内容。例如，创建一个子模板 child.html：

// www.javascriptcn.com code example
{% extends "base.html" %}

{% block title %}
    子模板标题
{% endblock %}

{% block content %}
    <p>这是子模板的内容。</p>
{% endblock %}

在这个子模板中：

• title 块被覆盖为“子模板标题”。
• content 块被覆盖为“这是子模板的内容”。
• header 块没有被覆盖，因此会保留父模板中的默认内容。

3. block 的嵌套

block 可以嵌套使用，允许更复杂的模板结构。例如：

{% block content %}
    <div class="container">
        {% block inner_content %}
            默认内部内容
        {% endblock %}
    </div>
{% endblock %}

在子模板中，可以同时覆盖 content 和 inner_content 块。

4. block 的默认内容

如果子模板没有覆盖某个 block，Django 会使用父模板中定义的默认内容。这在需要提供默认值但允许自定义的情况下非常有用。

5. block 的命名规则

• block 名称必须是唯一的，不能在同一模板中重复使用相同的名称。
• block 名称可以包含字母、数字和下划线，但不能包含空格或其他特殊字符。

6. block 的继承链

Django 支持多级模板继承。如果子模板继承了另一个子模板，最终的 block 内容将由最底层的子模板决定。

例如：

<!-- grandchild.html -->
{% extends "child.html" %}

{% block content %}
    <p>这是孙子模板的内容。</p>
{% endblock %}

在这个例子中，content 块的内容将是“这是孙子模板的内容。”，而不是父模板或子模板中的内容。

7. block 的 super 关键字

在子模板中，可以使用 {{ block.super }} 来引用父模板中 block 的内容。这在需要在父模板内容的基础上添加内容时非常有用。

例如：

{% block content %}
    {{ block.super }}
    <p>这是子模板添加的内容。</p>
{% endblock %}

在这个例子中，子模板的 content 块会先显示父模板中的内容，然后显示子模板添加的内容。

8. block 的注意事项

• block 标签必须成对出现，即必须有 {% block %} 和 {% endblock %}。
• block 标签不能嵌套在 if 或 for 等控制流标签中。
• block 标签的名称应具有描述性，以便于理解和维护。

通过合理使用 block，可以创建灵活且可维护的 Django 模板结构。