CoderWithAI LogoCoderWithAI

模板语法和标签

在Django中，模板是用于生成HTML页面的强大工具。模板不仅允许你嵌入动态内容，还提供了丰富的语法和标签来帮助你更高效地编写模板代码。本教程将详细介绍Django模板语法和标签的使用方法，并通过代码示例和实践练习帮助你掌握这些知识。

1. 模板语法基础

1.1 变量

在Django模板中，变量是通过{{ variable_name }}的形式来使用的。变量可以是视图函数传递给模板的任何数据类型，如字符串、列表、字典等。

示例：

<!-- templates/example.html -->
<p>Hello, {{ name }}!</p>

在视图函数中，你可以这样传递变量：

# views.py
from django.shortcuts import render

def example_view(request):
    context = {'name': 'Alice'}
    return render(request, 'example.html', context)

1.2 过滤器

过滤器用于修改变量的显示方式。它们通过管道符号（|）附加在变量后面。

示例：

<!-- templates/example.html -->
<p>Hello, {{ name|upper }}!</p>

在这个例子中，upper过滤器将name变量转换为大写。

1.3 注释

模板中的注释可以通过{# #}来实现。注释内容不会在最终生成的HTML中显示。

示例：

{# This is a comment #}

2. 常用模板标签

2.1 if 标签

if标签用于条件判断。你可以根据变量的值来决定是否显示某些内容。

示例：

<!-- templates/example.html -->
{% if user.is_authenticated %}
    <p>Welcome, {{ user.username }}!</p>
{% else %}
    <p>Please log in.</p>
{% endif %}

2.2 for 标签

for标签用于循环遍历列表或字典。

示例：

<!-- templates/example.html -->
<ul>
{% for item in items %}
    <li>{{ item }}</li>
{% endfor %}
</ul>

2.3 block 和 extends 标签

block和extends标签用于模板继承。通过继承，你可以创建一个基础模板，并在子模板中覆盖或扩展某些部分。

示例：

基础模板（base.html）：

<!-- templates/base.html -->
<!DOCTYPE html>
<html>
<head>
    <title>{% block title %}Default Title{% endblock %}</title>
</head>
<body>
    {% block content %}
    {% endblock %}
</body>
</html>

子模板（child.html）：

<!-- templates/child.html -->
{% extends "base.html" %}

{% block title %}Child Title{% endblock %}

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

2.4 include 标签

include标签用于包含其他模板文件。这对于复用模板片段非常有用。

示例：

<!-- templates/example.html -->
<div>
    {% include "partials/header.html" %}
    <p>Main content here.</p>
    {% include "partials/footer.html" %}
</div>

3. 实践练习

3.1 创建一个简单的博客模板

  1. 创建视图函数：在views.py中创建一个视图函数，传递一个包含博客文章列表的上下文。
# views.py
from django.shortcuts import render

def blog_view(request):
    posts = [
        {'title': 'First Post', 'content': 'This is the first post.'},
        {'title': 'Second Post', 'content': 'This is the second post.'},
    ]
    return render(request, 'blog.html', {'posts': posts})
  1. 创建模板文件：在templates目录下创建blog.html文件，使用for标签循环显示博客文章。
<!-- templates/blog.html -->
<!DOCTYPE html>
<html>
<head>
    <title>My Blog</title>
</head>
<body>
    <h1>My Blog</h1>
    <ul>
    {% for post in posts %}
        <li>
            <h2>{{ post.title }}</h2>
            <p>{{ post.content }}</p>
        </li>
    {% endfor %}
    </ul>
</body>
</html>
  1. 配置URL：在urls.py中配置URL模式，指向blog_view视图。
# urls.py
from django.urls import path
from . import views

urlpatterns = [
    path('blog/', views.blog_view, name='blog'),
]
  1. 运行服务器：启动Django开发服务器，访问/blog/路径，查看博客页面。
python manage.py runserver

4. 总结

通过本教程，你学习了Django模板的基本语法和常用标签，并通过实践练习创建了一个简单的博客模板。模板语法和标签是Django开发中不可或缺的一部分，掌握它们将帮助你更高效地构建动态网页。

在接下来的课程中，我们将继续深入探讨模板继承、上下文处理器、自定义模板标签和过滤器等内容，进一步增强你的模板开发能力。

← Previous: 04. 模板系统Next: 深入理解Django模板继承 →