GET 和 POST

处理表单时只会用到 GET 和 POST 两种HTTP方法。

Django的登录表单使用 POST 方法传输数据，在这个方法中浏览器会封装表单数据，为了传输会进行编码，然后发送到服务端并接收它的响应。

相比之下，GET 方法将提交的数据捆绑到一个字符串中，并用它来组成一个URL。该URL包含了数据要发送的地址以及一些键值对应的数据。如果您在Django文档中进行一次搜索，就会看到这点，它会生成一个形似 https://docs.djangoproject.com/search/?q=forms&release=1 的URL。

GET 和 POST 通常用于不同的目的。

任何可能用于更改系统状态的请求应该使用 POST —— 比如一个更改数据库的请求。GET 应该只被用于不会影响系统状态的请求。

GET 也不适合密码表格，因为密码会出现在 URL 中，因此也会出现在浏览器历史和服务器日志中，都是纯文本。它也不适合于大量的数据，或二进制数据，如图像。一个使用 GET 请求管理表单的网络应用程序是一个安全风险：攻击者很容易模仿表单的请求来获得对系统敏感部分的访问。POST，加上其他保护措施，如 Django 的 CSRF 保护，可以对访问进行更多控制。

另一方面， GET 方法适用于诸如网页搜索表单这样的内容，因为这类呈现为一个 GET 请求的URL很容易被存为书签、分享或重新提交。

Django的 Form 类

Django表单系统的核心组件是 Form 类。它与Django模型描述对象的逻辑结构、行为以及它呈现给我们内容的形式的方式大致相同， Form 类描述一张表单并决定它如何工作及呈现。

类似于模型类的字段映射到数据库字段的方式，表单类的字段会映射到HTML表单的 <input> 元素。 ModelForm 通过 Form 映射模型类的字段到HTML表单的 <input> 元素，Django admin就基于此。

表单字段本身也是类；他们管理表单数据并在提交表单时执行验证。 DateField 和 FileField 处理的数据类型差别很大，所以必须用来处理不同的字段。

在浏览器中，表单字段以HTML“控件”（用户界面的一个片段）的形式展现给我们。每个字段类型都有与之相匹配的 控件类 ，但必要时可以覆盖。

实例化、处理和渲染表单

在Django中渲染一个对象的时候，我们通常：

1. 在视图中获取它（例如从数据库中取出）

2. 将它传递给模板上下文

3. 使用模板变量将它扩展为HTML标记

在模板中渲染表单几乎与渲染任何其他类型的对象的一样，但是存在一些关键性的差异。

如果模型实例不包含数据，在模板中对它做任何处理几乎没什么用。但完全有理由用来渲染一张空表单——当我们希望用户来填充的时候就会这么做。

所以当我们在视图中处理模型实例时，我们一般从数据库中获取它。当我们处理表单时，我们一般在视图中实例化它。

当我们实例化一个表单时，我们可以选择将其保留为空，或者预先填充它，例如：

• 来自已保存的模型实例的数据（例如在管理编辑表单的情况下）

• 我们从其他来源获取的数据

• 从前面一个HTML 表单提交过来的数据

最后一种情况最有趣，因为这使得用户不仅可以阅读网站，而且还可以将信息发回给它。

需要完成的工作

假设您希望在您的网站上创建一张简易的表单，用来获取用户的名字。您需要在模板中使用类似代码：

<form action="/your-name/" method="post">
    <label for="your_name">Your name: </label>
    <input id="your_name" type="text" name="your_name" value="{{ current_name }}">
    <input type="submit" value="OK">
</form>

这告诉浏览器将表单数据返回给URL /your-name/ ，并使用 POST 方法。它将显示一个标签为 "Your name:" 的文本字段，以及一个 "OK" 按钮。如果模板上下文包含一个 current_name 变量，它会被预填充到 your_name 字段。

您需要一个视图来渲染这个包含HTML表单的模板，并能适当提供 current_name 字段。

提交表单时，发送给服务器的 POST 请求将包含表单数据。

现在，您还需要一个与该 /your-name/ URL相对应的视图，该视图将在请求中找到相应的键/值对，然后对其进行处理。

这是一个非常简单的表单。在实际应用中，一个表单可能包含几十个或数百个字段，其中许多字段可能需要预先填充，而且我们可能期望用户在完成操作之前多次执行编辑-提交周期。

我们可能需要在浏览器中进行一些验证，甚至在表单提交之前；我们可能希望使用更复杂的字段 ，以允许用户做类似日期选择等操作。

此刻，我们很容易通过使用Django来完成以上大部分工作。

在Django 中构建一张表单

from django import forms


class NameForm(forms.Form):
    your_name = forms.CharField(label="Your name", max_length=100)

<label for="your_name">Your name: </label>
<input id="your_name" type="text" name="your_name" maxlength="100" required>

from django.http import HttpResponseRedirect
from django.shortcuts import render

from .forms import NameForm


def get_name(request):
    # if this is a POST request we need to process the form data
    if request.method == "POST":
        # create a form instance and populate it with data from the request:
        form = NameForm(request.POST)
        # check whether it's valid:
        if form.is_valid():
            # process the data in form.cleaned_data as required
            # ...
            # redirect to a new URL:
            return HttpResponseRedirect("/thanks/")

    # if a GET (or any other method) we'll create a blank form
    else:
        form = NameForm()

    return render(request, "name.html", {"form": form})

<form action="/your-name/" method="post">
    {% csrf_token %}
    {{ form }}
    <input type="submit" value="Submit">
</form>

绑定的和未绑定的表单实例

绑定和非绑定表单之间的区别很重要：

• 未绑定的表单没有与其关联的数据。当渲染给用户的时候，它会是空的或者包含默认值。

• 绑定的表单拥有已提交的数据，因此可以用来判断数据是否合法。如果渲染了一张非法的绑定的表单，它将包含内联的错误信息，告知用户要纠正哪些数据。

表单的 is_bound 属性将告诉您一张表单是否具有绑定的数据。

字段详解

考虑一下比我们上面的小示例更有用的一张表单，我们可以用它在个人网站上实现“联系我”的功能：

from django import forms


class ContactForm(forms.Form):
    subject = forms.CharField(max_length=100)
    message = forms.CharField(widget=forms.Textarea)
    contact_email = forms.EmailField()
    urgent = forms.BooleanField(required=False)

前面的表单只有一个your_name字段，类型为CharField。这个例子有四个字段：subject、message、contact_email和urgent。CharField、EmailField和BooleanField只是可用字段类型中的三种，完整列表参见表单字段。

from django.core.mail import EmailMessage

if form.is_valid():
    subject = form.cleaned_data["subject"]
    message = form.cleaned_data["message"]
    contact_email = form.cleaned_data["contact_email"]
    urgent = form.cleaned_data["urgent"]

    body = (
        "Submitted through the contact form.\n"
        f"Contact email (unverified): {contact_email}\n"
        f"Marked urgent: {'yes' if urgent else 'no'}\n"
        f"Message:\n{message}"
    )

    # Send the message, directing replies to the contact_email.
    EmailMessage(
        subject=f"[contact form] {subject}",
        body=body,
        from_email="contact-form@example.com",
        to=["info@example.com"],
        headers={"Importance": "high"} if urgent else None,
        reply_to=[contact_email],
    ).send()

    return HttpResponseRedirect("/thanks/")

可复用的表单模板

在渲染表单时生成的 HTML 输出本身是通过模板生成的。你可以通过创建一个合适的模板文件，并设置自定义的 FORM_RENDERER 来控制这个过程，以在整个站点范围内使用 form_template_name。你也可以通过覆盖表单的 template_name 属性来自定义每个表单，以使用自定义模板呈现表单，或者直接将模板名称传递给 Form.render()。

下面的示例将导致 {{ form }} 被呈现为 form_snippet.html 模板的输出：

在你的模板中：

# In your template:
{{ form }}

# In form_snippet.html:
{% for field in form %}
    <div class="fieldWrapper">
        {{ field.errors }}
        {{ field.label_tag }} {{ field }}
    </div>
{% endfor %}

然后你可以配置 FORM_RENDERER 设置：

from django.forms.renderers import TemplatesSetting


class CustomFormRenderer(TemplatesSetting):
    form_template_name = "form_snippet.html"


FORM_RENDERER = "project.settings.CustomFormRenderer"

…或者对于单个表单：

class MyForm(forms.Form):
    template_name = "form_snippet.html"
    ...

…或者对于单个表单实例的单次渲染，通过将模板名称传递给 Form.render()。以下是在视图中使用此方法的示例：

def index(request):
    form = MyForm()
    rendered_form = form.render("form_snippet.html")
    context = {"form": rendered_form}
    return render(request, "index.html", context)

请参阅 将表单输出为 HTML 以获取更多详细信息。

可重用的字段组模板

每个字段都可以作为表单的属性访问，在模板中使用{{ form.name_of_field }}。字段的as_field_group()方法把标签、控件、错误信息和帮助文本作为一个整体渲染。

因此，可以编写通用模板，按所需布局安排每个字段的组成元素。例如：

{{ form.non_field_errors }}
<div class="fieldWrapper">
  {{ form.subject.as_field_group }}
</div>
<div class="fieldWrapper">
  {{ form.message.as_field_group }}
</div>
<div class="fieldWrapper">
  {{ form.contact_email.as_field_group }}
</div>
<div class="fieldWrapper">
  {{ form.urgent.as_field_group }}
</div>

默认情况下，Django 使用 "django/forms/field.html" 模板，该模板设计用于与默认的 "django/forms/div.html" 表单样式一起使用。

默认模板可以通过在项目级别的 FORM_RENDERER 中设置 field_template_name 来自定义：

from django.forms.renderers import TemplatesSetting


class CustomFormRenderer(TemplatesSetting):
    field_template_name = "field_snippet.html"

… 或在单个字段上：

class MyForm(forms.Form):
    subject = forms.CharField(template_name="my_custom_template.html")
    ...

… 或在每个请求的基础上通过调用 BoundField.render() 并提供模板名称：

def index(request):
    form = ContactForm()
    subject = form["subject"]
    context = {"subject": subject.render("my_custom_template.html")}
    return render(request, "index.html", context)

手动渲染字段

还可以对字段的渲染进行更细粒度的控制。通常情况下，这将在一个自定义字段模板中实现，以便可以编写一次并在每个字段中重用模板。但也可以直接从表单上的字段属性中访问。例如：

{{ form.non_field_errors }}
<div class="fieldWrapper">
    {{ form.subject.errors }}
    <label for="{{ form.subject.id_for_label }}">Email subject:</label>
    {{ form.subject }}
</div>
<div class="fieldWrapper">
    {{ form.message.errors }}
    <label for="{{ form.message.id_for_label }}">Your message:</label>
    {{ form.message }}
</div>
<div class="fieldWrapper">
    {{ form.contact_email.errors }}
    <label for="{{ form.contact_email.id_for_label }}">Your email address:</label>
    {{ form.contact_email }}
</div>
<div class="fieldWrapper">
    {{ form.urgent.errors }}
    <label for="{{ form.urgent.id_for_label }}">Urgent reply needed?</label>
    {{ form.urgent }}
</div>

完整的 <label> 元素还可以使用 label_tag() 来生成。例如：

<div class="fieldWrapper">
    {{ form.subject.errors }}
    {{ form.subject.label_tag }}
    {{ form.subject }}
</div>

<ul class="errorlist">
    <li>Contact email is required.</li>
</ul>

{% if form.subject.errors %}
    <ol>
    {% for error in form.subject.errors %}
        <li><strong>{{ error|escape }}</strong></li>
    {% endfor %}
    </ol>
{% endif %}

<ul class="errorlist nonfield">
    <li>Generic validation error</li>
</ul>

遍历表单字段

如果您要给每个表单字段使用相同的HTML，您可以用 {% for %} 依次循环遍历每个字段来减少重复代码：

{% for field in form %}
    <div class="fieldWrapper">
        {{ field.errors }}
        {{ field.label_tag }} {{ field }}
        {% if field.help_text %}
          <p class="help" id="{{ field.auto_id }}_helptext">
            {{ field.help_text|safe }}
          </p>
        {% endif %}
    </div>
{% endfor %}

{{ field }}提供的实用属性包括：

{{ field.errors }}

输出一个 <ul class="errorlist"> ，其中包含这个字段的所有验证错误信息。你可以使用 {% for error in field.errors %} 循环来自定义错误信息的显示。在这种情况下，循环中的每个对象是包含错误信息的字符串。

{{ field.field }}

表单类中的 Field 实例由 BoundField 封装。您可以用它来访问 Field 的属性，比如 {{ char_field.field.max_length }} 。

{{ field.help_text }}

与该字段关联的帮助文本。

{{ field.html_name }}

字段名称：用于其输入元素的name属性中。如果设置了表单前缀，它也会被加进去。

{{ field.id_for_label }}

此字段使用的ID，上例中为id_contact_email。如果手动构造标签，可以用它代替label_tag。例如，编写内联JavaScript时，它也有助于避免硬编码字段ID。

{{ field.is_hidden }}

如果是隐藏字段，这个属性为 True ，否则为 False 。它作为模板变量没多大作用，但可用于条件测试，例如：

{% if field.is_hidden %}
   {# Do something special #}
{% endif %}

{{ field.label }}

字段的标签，例如Contact email。

{{ field.label_tag }}

字段的标签将包装在适当的 HTML <label> 标签中。这包括表单的 label_suffix。例如，默认的 label_suffix 是冒号：

<label for="id_contact_email">Contact email:</label>

{{ field.legend_tag }}

类似于 field.label_tag，但在多个输入被包装在 <fieldset> 中的小部件上使用 <legend> 标签代替 <label>。

{{ field.use_fieldset }}

如果表单字段的小部件包含应该在 <fieldset> 中语义上分组的多个输入，并且带有 <legend> 以提高可访问性，则此属性为 True。在模板中的示例用法：

{% if field.use_fieldset %}
  <fieldset>
  {% if field.label %}{{ field.legend_tag }}{% endif %}
{% else %}
  {% if field.label %}{{ field.label_tag }}{% endif %}
{% endif %}
{{ field }}
{% if field.use_fieldset %}</fieldset>{% endif %}

{{ field.value }}

字段的值。例如 someone@example.com 。

完整的属性和方法列表参见BoundField参考指南。

{# Include the hidden fields #}
{% for hidden in form.hidden_fields %}
{{ hidden }}
{% endfor %}
{# Include the visible fields #}
{% for field in form.visible_fields %}
    <div class="fieldWrapper">
        {{ field.errors }}
        {{ field.label_tag }} {{ field }}
    </div>
{% endfor %}