课程：Django入门项目 - 论坛系统
打卡时间：2018.5.8

前言

本篇学习模板复用和表单的一些知识，这篇文章比较长。耐心读完会有收获的。

一、模板复用

之前我们创建的两个home.html和topic.html。他们之间存在一些相同的内容，如果单独创建文件少还可以，如果有几十个页面甚至上百个页面，维护起来就相当麻烦了。这是就需要复用技术。

通过编写一个母模板，包含页面所共有的内容。其他模板继承自母模板。

在templates中创建名为base.html的文件。

{% load static %}<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>{% block title %}Django Boards {% endblock %}</title>
    <link rel="stylesheet" href="{% static 'css/bootstrap.min.css' %}">
</head>
<body>
    <div class="container">
        <ol class="breadcrumb my-4">
            {% block breadcrumb %}
            {% endblock %}
        </ol>
        {% block content %}
        {% endblock %}
    </div>
</body>
</html>

以上就是母版页，其他模板都需要继承该模板。模板中{% block %}标签。它用于在模板中保留一个空间，子模板可以在其中插入代码和HTML。

例如：{% block title %}是接收title的，母版中给出了默认值。

下面重写之前的两个模板: home.html和topic.html。

{#继承自base.html#}
{% extends 'base.html' %}

{#添加头部导航标签#}
{% block breadcrumb %}
    <li class="breadcrumb-item active">Boards</li>
{% endblock %}

{#页面内容#}
{% block content %}
<table class="table">
            <thead class="">
            <tr>
                <th>Board</th>
                <th>Posts</th>
                <th>Topics</th>
                <th>Last Post</th>
            </tr>
            </thead>
            <tbody>
                {% for board in boards %}
                    <tr>
                        <td>
{#                            进入board_topics传递参数pk #}
                            <a href="{% url 'board_topics' board.pk%}">{{ board.name }}</a>
                            <small class="text-muted d-block">{{ board.desc }}</small>
                        </td>
                        <td class="align-middle">0</td>
                        <td class="align-middle">0</td>
                        <td></td>
                    </tr>
                {% endfor %}
            </tbody>
        </table>

{% endblock %}

topic界面

{% extends 'base.html' %}

{% block title %}
    {{ board.name }} - {{ block.super }}
{% endblock %}

{% block breadcrumb %}
    <li class="breadcrumb-item"><a href="{% url 'home' %}">Boards</a></li>
    <li class="breadcrumb-item active">{{ board.name }}</li>
{% endblock %}

{% block content %}

{% endblock %}

修改完成后，可以验证一下是否存在错误。

执行python manage.py test。

二、表单处理

表单用来处理用户的输入。下面看一个例子吧！

新建一个路由，命名为new_topic:

{% extends 'base.html' %}

{% block title %}
Start a New Topic
{% endblock %}

{% block breadcrumb %}
    <li class="breadcrumb-item"><a href="{% url 'home' %}">Boards</a></li>
    <li class="breadcrumb-item"><a href="{% url 'board_topics' board.pk %}">{{ board.name }}</a></li>
    <li class="breadcrumb-item active">New topic</li>
{% endblock %}

{% block content %}

{% endblock %}

对new_topic进行测试

class NewTopicTests(TestCase):
    def setUp(self):
        Board.objects.create(name='Django', desc='Django board')

    def test_new_topic_view_success_status_code(self):
        url = reverse('new_topic', kwargs={'pk': 1})
        response = self.client.get(url)
        self.assertEquals(response.status_code, 200)

    def test_new_topic_view_not_found_status_code(self):
        url = reverse('new_topic',kwargs={'pk': 99})
        response = self.client.get(url)
        self.assertEquals(response.status_code, 404)

    def test_new_topic_url_resolves_new_topic_view(self):
        view = resolve('/boards/1/new/')
        self.assertEquals(view.func, new_topic)

    def test_new_topic_view_contains_link_back_top_board_topics_view(self):
        new_topic_url = reverse('new_topic', kwargs={'pk': 1})
        board_topic_url = reverse('board_topics', kwargs={'pk': 1})
        response = self.client.get(new_topic_url)
         self.assertContains(response, 'href="{}"'.format(board_topic_url))

setUp：创建一个测试中使用的 Board 实例
test_new_topic_view_success_status_code：检查发给 view 的请求是否成功
test_new_topic_view_not_found_status_code：检查当 Board 不存在时 view 是否会抛出一个 404 的错误
test_new_topic_url_resolves_new_topic_view：检查是否正在使用正确的 view
test_new_topic_view_contains_link_back_to_board_topics_view：确保导航能回到 topics 的列表

运行python manage.py test，查看测试结果。

为new_topic添加表单。


{% block content %}
    <form method="post">
    {% csrf_token %}
    <div class="form-group">
        <label for="id_subject" class="">Subject</label>
        <input type="text" class="form-control" id="id_subject" name="subject">
    </div>
    <div class="form-group">
        <label for="id_message" class="">Message</label>
        <textarea name="message" id="id_message" rows="5" class="form-control"></textarea>
    </div>
    </form>
{% endblock %}

csrf_token模板标签，它是与其他表单数据一起提交的隐藏字段。

获取数据用户输入的数据。

def new_topic(request, pk):
    board = get_object_or_404(Board, pk=pk)

    if request.method == 'POST':
        subject = request.POST['subject']
        message = request.POST['message']
        user = User.objects.first() # 临时登陆账户

        topic = Topic.objects.create(
            subject = subject,
            board = board,
            starter = user
        )
        post = Post.objects.create(
            message = message,
            topic = topic,
            created_by = user
        )
        return redirect('board_topics', pk=board.pk) # 重定向到topic页
    return render(request, 'new_topic.html', {'board': board})

参考：表单处理
由于代码较多，这里不粘贴代码。

三、创建表单的正确方式

Forms API创建表单，在django.forms模块中。两种表单类型：
forms.Form：通用表单实现
forms.ModelFrom：Form的子类，它与Model相关联。

boards/forms.py

from django import forms
from .models import Topic

class NewTopicForm(forms.ModelForm):
    message = forms.CharField(widget=forms.Textarea(), max_length=4000)

    class Meta:
        model = Topic
        fields = ['subject', 'message']

这是我们的第一个 form。它是一个与 Topic model 相关联的 ModelForm。Meta 类里面 fields 列表中的 subject 引用 Topic 类中的 subject field(字段)。现在注意到我们定义了一个叫做 message 的额外字段。它用来引用 Post 中我们想要保存的 message。

四、小结

本篇学习表单的基本用法，Form API的使用方法。由代码较多没有整理，请查看：表单处理

【Django】入门实践指南之模板复用&表单处理|第6篇

【Django】入门实践指南之模板复用&表单处理|第6篇

目录

前言

一、模板复用

二、表单处理

三、创建表单的正确方式

四、小结

推荐阅读更多精彩内容