在模板中处理 django-Form

1.0 在视图中获取

# view.py
from .forms import MyForm
def view(request):
    if requrest.method == "POST"
        myForm = MyForm(requrest.post)
        if myForm.is_valid():
            # 验证通过，获取数据
            name = myForm.cleaned_data["name"]
            age = myForm.cleaned_data["age"]
    else:
        # get 请求的操作.
    # 表单上传的文件从 reques.FILES 中获取

2.0 在模板中渲染表单

2.1 使用django的渲染机制

{{ form }},在模板中渲染表单是不包含和按钮的
需要：

<form>
    {{ form }}
    <form type="sublime">
</form>

另外还有如下几种渲染方式：

• {{ form.as_table }} 以表单的渲染在tr标签中
• {{ form.as_p }} 渲染在

示例：
使用{{ form.as_p }}

// 对于每一个表单字段都有一个id = id_formName 
<p>
    <label for="id_subject">Subject:</label>
    <input id="id_subject" type="text" name="subject" maxlength="100" />
</p>
<p>
    <label for="id_message">Message:</label>
    <input type="text" name="message" id="id_message" />
</p>
<p>
    <label for="id_sender">Sender:</label>
    <input type="email" name="sender" id="id_sender" />
</p>
<p>
    <label for="id_cc_myself">Cc myself:</label>
    <input type="checkbox" name="cc_myself" id="id_cc_myself" />
</p>

2.2 手工渲染字段

放弃使用form直接渲染，自己手工获取到表单的字段渲染
每一个字段都是表单的一个属性，使用 {{ form.name_of_field }} 访问
example:

{{ 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.sender.errors }}
    <label for="{{ form.sender.id_for_label }}">Your email address:</label>
    {{ form.sender }}
</div>

<div class="fieldWrapper">
    {{ form.cc_myself.errors }}
    <label for="{{ form.cc_myself.id_for_label }}">CC yourself?</label>
    {{ form.cc_myself }}
</div>

当然，对于完整的元素也可以使用label_tag()来生成，example:

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

3.0 渲染表单的错误信息

• {{ form.non_field_errors }}
• {{ form.name_of_field.errors }}
  {{ form.name_of_field.errors }} 显示表单错误的一个清单,并渲染成一个ul,这个 ul 有一个 errorlist CSS 类型,可以用它定义外观。看上去可能像:

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

进一步显示（迭代）错误信息

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

对于空字段错误，将渲染成另一 CSS —nonfield,像这样

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

4.0 迭代表单的字段

表单使用相同的HTML,你可以使用 {% for %} 循环迭代每个字段来减少重复的代码：

{% for field in form %}
    <div class="fieldWrapper">
        {{ field.errors }}
        {{ field.label_tag }}
        {{ field }}
    </div>
{% endfor %}

field 中包括的有用字段：
* {{ field.label }}：字段的 label ,例如 Email address 。

• {{ field.label_tag }}：包含在HTML 标签中的字段 Label，包含表单的 label_suffix。默认的是一个冒号“：”。

• {{ field.id_for_label }}：用于这个字段的 ID

• {{ field.value }}：字段的值,例如 dolphin@example.com 。

• {{ field.html_name }}：输入元素的 name 属性中将使用的名称。它将考虑到表单的前缀。
• {{ field.help_text }}：该字段的帮助文档
• {{ field.errors }}：字段的验证错误信息
  输出一个 class=”errorlist” 的 ul，包含这个字段的验证错误信息。你可以使用 {%forerrorinfield.errors%}自定义错误的显示。这种情况下，循环中的每个对象只是一个包含错误信息的简单字符串。
• {{ field.is_hidden }}：字段是否隐藏，一个布尔值
• {{ field.field }}：表单类中的 Field 实例
  通过 BoundField 封装。你可以使用它来访问 Field 属性,例如 {% char_field.field.max_length %}。

4.1 迭代隐藏和可见的字段

Django 提供两个表单方法：hidden_fields() 和 visible_fields()。允许独立地在隐藏的和可见的字段上迭代。

{% for hidden in form.hidden_fields %}
    {{ hidden }}
{% endfor %}

{% for field in form.visible_fields %}
    <div class="fieldWrapper">
        {{ field.errors }}
        {{ field.label_tag }} 
        {{ field }}
    </div>
{% endfor %}

5.0 可重用的表单模板

# In your form template:
{% include "form_snippet.html" %}

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

递到模板上下文中的表单对象具有一个不同的名称,可以在 temolate 中 include 时使用 include 标签的 with 参数来对它起个别名:

{% include "form_snippet.html" with form=comment_form %}

如果你发现自己经常这样做,你可能需要考虑一下创建一个自定义的 inclusion 标签.