如何创建自定义的 Django 模板标签？

推荐答案

在 Django 中创建自定义模板标签的步骤如下：

1. 创建模板标签目录：首先在你的 Django 应用中创建一个名为 templatetags 的目录，并在该目录下创建一个 __init__.py 文件，使其成为一个 Python 包。

2. 编写自定义模板标签：在 templatetags 目录下创建一个 Python 文件，例如 custom_tags.py，并在其中编写自定义模板标签的代码。

3. 注册模板标签：使用 Django 提供的 @register.simple_tag 或 @register.inclusion_tag 装饰器来注册自定义模板标签。

4. 在模板中使用自定义标签：在模板文件中使用 {% load custom_tags %} 加载自定义标签，然后使用 {% custom_tag_name %} 调用自定义标签。

示例代码

-- -------------------- ---- -------
- --------------
---- ------ ------ --------

-------- - ------------------

--------------------
--- ----------------------------
    ---- -------- ------ --------
    ------ --------------------------------------

<!-- 在模板中使用自定义标签 -->
{% load custom_tags %}
<p>当前时间：{% current_time "%Y-%m-%d %H:%M:%S" %}</p>

本题详细解读

1. 创建模板标签目录

Django 要求自定义模板标签必须放在应用的 templatetags 目录下。这个目录必须包含一个 __init__.py 文件，以便 Python 将其识别为一个包。

2. 编写自定义模板标签

在 templatetags 目录下创建一个 Python 文件，例如 custom_tags.py。在这个文件中，你可以定义自定义模板标签。Django 提供了两种常见的装饰器来注册模板标签：

• @register.simple_tag：用于简单的模板标签，通常返回一个字符串。
• @register.inclusion_tag：用于生成模板片段的标签，通常返回一个渲染后的模板。

3. 注册模板标签

使用 @register.simple_tag 或 @register.inclusion_tag 装饰器来注册自定义模板标签。装饰器会将函数注册为模板标签，使其可以在模板中使用。

4. 在模板中使用自定义标签

在模板文件中，首先使用 {% load custom_tags %} 加载自定义标签模块，然后使用 {% custom_tag_name %} 调用自定义标签。Django 会自动查找并执行相应的标签函数。

注意事项

• 确保 templatetags 目录位于正确的应用目录下。
• 自定义模板标签的名称不能与 Django 内置的模板标签名称冲突。
• 在模板中加载自定义标签时，模块名称应与文件名一致（不包括 .py 扩展名）。