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>
当然,对于完整的
<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
{{ 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 标签.