【一】引入#

声明：以下的Form、表单等术语都指的的广义的Django表单。
Form要么是绑定了数据的，要么是未绑定数据的。
如果是绑定的，那么它能够验证数据，并渲染表单及其数据，然后生成HTML表单。如果未绑定，则无法进行验证（因为没有数据可以验证！），但它仍然可以以HTML形式呈现空白表单。
若要创建一个未绑定的Form实例，只需简单地实例化该类：

1
f = ContactForm()

若要绑定数据到表单，可以将数据以字典的形式传递给Form类的构造函数：

1
>>> data = {'subject': 'hello',
2
...         'message': 'Hi there',
3
...         'sender': 'foo@example.com',
4
...         'cc_myself': True}
5
>>> f = ContactForm(data)

在这个字典中，键为字段的名称，它们对应于Form类中的字段。值为需要验证的数据。

【二】表单的绑定属性#

【1】Form.is_bound：#

如果你需要区分绑定的表单和未绑定的表单，可以检查下表单的is_bound属性值：

1
>>> f = ContactForm()
2
>>> f.is_bound
3
False
4
>>> f = ContactForm({'subject': 'hello'})
5
>>> f.is_bound
6
True

注意，传递一个空的字典将创建一个带有空数据的绑定的表单：

1
>>> f = ContactForm({})
2
>>> f.is_bound
3
True

如果你有一个绑定的Form实例但是想改下数据，或者你想给一个未绑定的Form表单绑定某些数据，你需要创建另外一个Form实例。
因为，Form实例的数据没是自读的，Form实例一旦创建，它的数据将不可变。

【三】使用表单验证数据#

【1】Form.clean()#

如果你要自定义验证功能，那么你需要重新实现这个clean方法。
还记得我们在前面的自定义验证器章节的内容吗？
这里的clean()方法其实也是Django提供给我们的一个钩子，用于添加整个表单级别的验证功能。
其源代码很简单，就是走个过程：

1
def clean(self):
2
    return self.cleaned_data

【2】Form.is_valid()#

Form对象的主要任务之一就是验证数据。
调用is_valid()方法来执行绑定表单的数据验证工作，并返回一个表示数据是否合法的布尔值。

1
>>> data = {'subject': 'hello',
2
...         'message': 'Hi there',
3
...         'sender': 'foo@example.com',
4
...         'cc_myself': True}
5
>>> f = ContactForm(data)
6
>>> f.is_valid()python
7
True

让我们试下非法的数据。下面的情形中，subject为空（默认所有字段都是必需的）且sender是一个不合法的邮件地址：

1
>>> data = {'subject': '',
2
...         'message': 'Hi there',
3
...         'sender': 'invalid email address',
4
...         'cc_myself': True}
5
>>> f = ContactForm(data)
6
>>> f.is_valid()
7
False

【3】Form.errors#

表单的errors属性保存了错误信息字典：

1
>>> f.errors
2
{'sender': ['Enter a valid email address.'], 'subject': ['This field is required.']}

在这个字典中，键为字段的名称，值为错误信息的Unicode字符串组成的列表。错误信息保存在列表中是因为字段可能有多个错误信息。
可以直接调用这个方法获得错误信息，不需要先调用is_valid方法，因为在后台，errors方法会自动调用is_valid。

【4】Form.errors.as_data()#

返回一个字典，它将字段映射到原始的ValidationError实例。

1
>>> f.errors.as_data()
2
{'sender': [ValidationError(['Enter a valid email address.'])],
3
'subject': [ValidationError(['This field is required.'])]}

【5】Form.errors.as_json(escape_html=False)#

返回JSON序列化后的错误信息字典。

1
>>> f.errors.as_json()
2
{"sender": [{"message": "Enter a valid email address.", "code": "invalid"}],
3
"subject": [{"message": "This field is required.", "code": "required"}]}

【6】Form.add_error(field, error)#

向表单特定字段添加错误信息。
field参数为字段的名称。
如果值为None，error将作为Form.non_field_errors()的一个非字段错误。

【7】Form.has_error(field, code=None)#

判断某个字段是否具有指定code的错误。
当code为None时，如果字段有任何错误它都将返回True。

【8】Form.non_field_errors()#

返回Form.errors中不是与特定字段相关联的错误。

【9】对于没有绑定数据的表单#

验证没有绑定数据的表单是没有意义的，下面的例子展示了这种情况：

1
>>> f = ContactForm()
2
>>> f.is_valid()
3
False
4
>>> f.errors
5
{}

【四】检查表单数据是否被修改#

【1】Form.has_changed()#

当你需要检查表单的数据是否从初始数据发生改变时，可以使用has_changed()方法。

1
>>> data = {'subject': 'hello',
2
...         'message': 'Hi there',
3
...         'sender': 'foo@example.com',
4
...         'cc_myself': True}
5
>>> f = ContactForm(data, initial=data)
6
>>> f.has_changed()
7
False

注意其中的initial参数用于给表单一个原始的数据。
提交表单后，我们可以重新构建表单并提供初始值，进行比较：

1
>>> f = ContactForm(request.POST, initial=data)
2
>>> f.has_changed()

如果request.POST与initial中的数据有区别，则返回True，否则返回False。

【2】Form.changed_data#

返回有变化的字段的列表。

1
>>> f = ContactForm(request.POST, initial=data)
2
>>> if f.has_changed():
3
...     print("The following fields changed: %s" % ", ".join(f.changed_data))
4
>>> f.changed_data
5
['subject', 'message']

【五】访问表单中的字段#

【1】通过fileds属性访问表单的字段#

1
>>> for row in f.fields.values(): print(row)
2
...
3
<django.forms.fields.CharField object at 0x7ffaac632510>
4
<django.forms.fields.URLField object at 0x7ffaac632f90>
5
<django.forms.fields.CharField object at 0x7ffaac3aa050>
6
>>> f.fields['name']
7
<django.forms.fields.CharField object at 0x7ffaac6324d0>

【2】修改Form实例的字段来改变字段在表单中的表示#

可以修改Form实例的字段来改变字段在表单中的表示

1
>>> f.as_table().split('\n')[0]
2
'<tr><th>Name:</th><td><input name="name" type="text" value="instance" required /></td></tr>'
3
>>> f.fields['name'].label = "Username"
4
>>> f.as_table().split('\n')[0]
5
'<tr><th>Username:</th><td><input name="name" type="text" value="instance" required /></td></tr>'

注意不要改变base_fields属性，因为一旦修改将影响同一个Python进程中接下来所有的ContactForm实例：

1
>>> f.base_fields['name'].label = "Username"
2
>>> another_f = CommentForm(auto_id=False)
3
>>> another_f.as_table().split('\n')[0]
4
'<tr><th>Username:</th><td><input name="name" type="text" value="class" required /></td></tr>'

【六】访问cleaned_data#

Form类中的每个字段不仅负责验证数据，还负责将它们转换为正确的格式。
- 例如，DateField将输入转换为Python的datetime.date对象。
无论你传递的是普通字符串’1994-07-15’、DateField格式的字符串、datetime.date对象、还是其它格式的数字，Django将始终把它们转换成datetime.date对象。
一旦你创建一个Form实例并通过验证后，你就可以通过它的cleaned_data属性访问干净的数据（未验证或者验证未通过时，是拿不到这个数据字典的）：

1
>>> data = {'subject': 'hello',
2
...         'message': 'Hi there',
3
...         'sender': 'foo@example.com',
4
...         'cc_myself': True}
5
>>> f = ContactForm(data)
6
>>> f.is_valid()
7
True
8
>>> f.cleaned_data
9
{'cc_myself': True, 'message': 'Hi there', 'sender': 'foo@example.com', 'subject': 'hello'}

如果你的数据没有通过验证，cleaned_data字典中只包含合法的字段：

1
>>> data = {'subject': '',
2
...         'message': 'Hi there',
3
...         'sender': 'invalid email address',
4
...         'cc_myself': True}
5
>>> f = ContactForm(data)
6
>>> f.is_valid()
7
False
8
>>> f.cleaned_data
9
{'cc_myself': True, 'message': 'Hi there'}

cleaned_data字典始终只包含Form中定义的字段，即使你在构建Form时传递了额外的数据。
在下面的例子中，我们传递了一组额外的字段给ContactForm构造函数，但是cleaned_data将只包含表单的字段：

1
>>> data = {'subject': 'hello',
2
...         'message': 'Hi there',
3
...         'sender': 'foo@example.com',
4
...         'cc_myself': True,
5
...         'extra_field_1': 'foo',
6
...         'extra_field_2': 'bar',
7
...         'extra_field_3': 'baz'}
8
>>> f = ContactForm(data)
9
>>> f.is_valid()
10
True
11
>>> f.cleaned_data # Doesn't contain extra_field_1, etc.
12
{'cc_myself': True, 'message': 'Hi there', 'sender': 'foo@example.com', 'subject': 'hello'}

当Form通过验证后，cleaned_data将包含所有字段的键和值，即使传递的数据中没有提供某些字段的值。
在下面的例子中，提供的实际数据中不包含nick_name字段，但是cleaned_data任然包含它，只是值为空：

1
>>> from django import forms
2
>>> class OptionalPersonForm(forms.Form):
3
...     first_name = forms.CharField()
4
...     last_name = forms.CharField()
5
...     nick_name = forms.CharField(required=False)
6
>>> data = {'first_name': 'John', 'last_name': 'Lennon'}
7
>>> f = OptionalPersonForm(data)
8
>>> f.is_valid()
9
True
10
>>> f.cleaned_data
11
{'nick_name': '', 'first_name': 'John', 'last_name': 'Lennon'}

【七】表单的HTML生成方式#

Form的第二个任务是将它渲染成HTML代码，默认情况下，根据form类中字段的编写顺序，在HTML中以同样的顺序罗列。
我们可以通过print方法展示出来：

1
>>> f = ContactForm()
2
>>> print(f)
3
<tr><th><label for="id_subject">Subject:</label></th><td><input id="id_subject" type="text" name="subject" maxlength="100" required /></td></tr>
4
<tr><th><label for="id_message">Message:</label></th><td><input type="text" name="message" id="id_message" required /></td></tr>
5
<tr><th><label for="id_sender">Sender:</label></th><td><input type="email" name="sender" id="id_sender" required /></td></tr>
6
<tr><th><label for="id_cc_myself">Cc myself:</label></th><td><input type="checkbox" name="cc_myself" id="id_cc_myself" /></td></tr>

如果表单是绑定的，输出的HTML将包含数据。

1
>>> data = {'subject': 'hello',
2
...         'message': 'Hi there',
3
...         'sender': 'foo@example.com',
4
...         'cc_myself': True}
5
>>> f = ContactForm(data)
6
>>> print(f)
7
<tr><th><label for="id_subject">Subject:</label></th><td><input id="id_subject" type="text" name="subject" maxlength="100" value="hello" required /></td></tr>
8
<tr><th><label for="id_message">Message:</label></th><td><input type="text" name="message" id="id_message" value="Hi there" required /></td></tr>
9
<tr><th><label for="id_sender">Sender:</label></th><td><input type="email" name="sender" id="id_sender" value="foo@example.com" required /></td></tr>
10
<tr><th><label for="id_cc_myself">Cc myself:</label></th><td><input type="checkbox" name="cc_myself" id="id_cc_myself" checked /></td></tr>

注意事项：

为了灵活性，输出不包含和
、
和
以及标签。需要我们程序员手动添加它们。
每个字段类型都由一个默认的HTML标签展示。注意，这些只是默认的，可以使用Widget 特别指定。
每个HTML标签的name属性名直接从ContactForm类中获取。
form使用HTML5语法，顶部需添加说明。

【1】渲染成文字段落as_p()#

该方法将form渲染成一系列
标签，每个
标签包含一个字段；

1
>>> f = ContactForm()
2
>>> f.as_p()
3
'<p><label for="id_subject">Subject:</label> <input id="id_subject" type="text" name="subject" maxlength="100" required /></p>\n<p><label for="id_message">Message:</label> <input type="text" name="message" id="id_message" required /></p>\n<p><label for="id_sender">Sender:</label> <input type="text" name="sender" id="id_sender" required /></p>\n<p><label for="id_cc_myself">Cc myself:</label> <input type="checkbox" name="cc_myself" id="id_cc_myself" /></p>'
4
>>> print(f.as_p())
5
<p><label for="id_subject">Subject:</label> <input id="id_subject" type="text" name="subject" maxlength="100" required /></p>
6
<p><label for="id_message">Message:</label> <input type="text" name="message" id="id_message" required /></p>
7
<p><label for="id_sender">Sender:</label> <input type="email" name="sender" id="id_sender" required /></p>
8
<p><label for="id_cc_myself">Cc myself:</label> <input type="checkbox" name="cc_myself" id="id_cc_myself" /></p>

【2】渲染成无序列表as_ul()#

该方法将form渲染成一系列
标签，每个
标签包含一个字段。
但不会自动生成

和

的任何HTML属性：

1
>>> f = ContactForm()
2
>>> f.as_ul()
3
'<li><label for="id_subject">Subject:</label> <input id="id_subject" type="text" name="subject" maxlength="100" required /></li>\n<li><label for="id_message">Message:</label> <input type="text" name="message" id="id_message" required /></li>\n<li><label for="id_sender">Sender:</label> <input type="email" name="sender" id="id_sender" required /></li>\n<li><label for="id_cc_myself">Cc myself:</label> <input type="checkbox" name="cc_myself" id="id_cc_myself" /></li>'
4
>>> print(f.as_ul())
5
<li><label for="id_subject">Subject:</label> <input id="id_subject" type="text" name="subject" maxlength="100" required /></li>
6
<li><label for="id_message">Message:</label> <input type="text" name="message" id="id_message" required /></li>
7
<li><label for="id_sender">Sender:</label> <input type="email" name="sender" id="id_sender" required /></li>
8
<li><label for="id_cc_myself">Cc myself:</label> <input type="checkbox" name="cc_myself" id="id_cc_myself" /></li>

【3】渲染成表格as_table()#

渲染成HTML表格。
它与print完全相同，事实上，当你print一个表单对象时，在后台调用的就是as_table()方法：

1
>>> f = ContactForm()
2
>>> f.as_table()
3
'<tr><th><label for="id_subject">Subject:</label></th><td><input id="id_subject" type="text" name="subject" maxlength="100" required /></td></tr>\n<tr><th><label for="id_message">Message:</label></th><td><input type="text" name="message" id="id_message" required /></td></tr>\n<tr><th><label for="id_sender">Sender:</label></th><td><input type="email" name="sender" id="id_sender" required /></td></tr>\n<tr><th><label for="id_cc_myself">Cc myself:</label></th><td><input type="checkbox" name="cc_myself" id="id_cc_myself" /></td></tr>'
4
>>> print(f)
5
<tr><th><label for="id_subject">Subject:</label></th><td><input id="id_subject" type="text" name="subject" maxlength="100" required /></td></tr>
6
<tr><th><label for="id_message">Message:</label></th><td><input type="text" name="message" id="id_message" required /></td></tr>
7
<tr><th><label for="id_sender">Sender:</label></th><td><input type="email" name="sender" id="id_sender" required /></td></tr>
8
<tr><th><label for="id_cc_myself">Cc myself:</label></th><td><input type="checkbox" name="cc_myself" id="id_cc_myself" /></td></tr>

【八】为错误信息添加CSS样式#

为一些特别强调的或者需要额外显示的内容设置醒目的CSS样式是一种常用做法，也是非常有必要的。
比如给必填字段加粗显示，设置错误文字为红色等等。
Form.error_css_class和Form.required_css_class属性就是做这个用的：

1
from django import forms
2

3
class ContactForm(forms.Form):
4
    error_css_class = 'error'
5
    required_css_class = 'required'
6

7
    # ... and the rest of your fields here

属性名是固定的，不可变（废话），通过赋值不同的字符串，表示给这两类属性添加不同的CSS的class属性。
以后Django在渲染form成HTML时将自动为error和required行添加对应的CSS样式。
上面的例子，其HTML看上去将类似：

1
>>> f = ContactForm(data)
2
>>> print(f.as_table())
3
<tr class="required"><th><label class="required" for="id_subject">Subject:</label>    ...
4
<tr class="required"><th><label class="required" for="id_message">Message:</label>    ...
5
<tr class="required error"><th><label class="required" for="id_sender">Sender:</label>      ...
6
<tr><th><label for="id_cc_myself">Cc myself:<label> ...
7
>>> f['subject'].label_tag()
8
<label class="required" for="id_subject">Subject:</label>
9
>>> f['subject'].label_tag(attrs={'class': 'foo'})
10
<label for="id_subject" class="foo required">Subject:</label>

【九】将上传的文件绑定到表单#

处理带有FileField和ImageField字段的表单比普通的表单要稍微复杂一点。
首先，为了上传文件，你需要确保你的
元素定义enctype为”multipart/form-data”：

1
<form enctype="multipart/form-data" method="post" action="/foo/">

其次，当你使用表单时，你需要绑定文件数据。
文件数据的处理与普通的表单数据是分开的，所以如果表单包含FileField和ImageField，绑定表单时你需要指定第二个参数，参考下面的例子。

1
# 为表单绑定image字段
2
>>> from django.core.files.uploadedfile import SimpleUploadedFile
3
>>> data = {'subject': 'hello',
4
...         'message': 'Hi there',
5
...         'sender': 'foo@example.com',
6
...         'cc_myself': True}
7
>>> file_data = {'mugshot': SimpleUploadedFile('face.jpg', <file data>)}
8
>>> f = ContactFormWithMugshot(data, file_data)

实际上，一般使用request.FILES作为文件数据的源：

1
# Bound form with an image field, data from the request
2
>>> f = ContactFormWithMugshot(request.POST, request.FILES)

构造一个未绑定的表单和往常一样，将表单数据和文件数据同时省略：

1
# Unbound form with an image field
2
>>> f = ContactFormWithMugshot()

【十】配置表单元素的HTML id属性和标签#

默认情况下，表单在渲染的时候会自动提供一个标签和id属性。id属性值是id_加表单字段的名字。
我们可以在Form的构造器中设置参数auto_id=False来关闭此行为。

1
>>> f = ContactForm(auto_id=False)
2
>>> print(f.as_table())
3
<tr><th>Subject:</th><td><input type="text" name="subject" maxlength="100" required></td></tr>
4
<tr><th>Message:</th><td><input type="text" name="message" required></td></tr>
5
<tr><th>Sender:</th><td><input type="email" name="sender" required></td></tr>
6
<tr><th>Cc myself:</th><td><input type="checkbox" name="cc_myself"></td></tr>
7
>>> print(f.as_ul())
8
<li>Subject: <input type="text" name="subject" maxlength="100" required></li>
9
<li>Message: <input type="text" name="message" required></li>
10
<li>Sender: <input type="email" name="sender" required></li>
11
<li>Cc myself: <input type="checkbox" name="cc_myself"></li>
12
>>> print(f.as_p())
13
<p>Subject: <input type="text" name="subject" maxlength="100" required></p>
14
<p>Message: <input type="text" name="message" required></p>
15
<p>Sender: <input type="email" name="sender" required></p>
16
<p>Cc myself: <input type="checkbox" name="cc_myself"></p>

如果auto_id设置为 True，则表现形式如下：

1
>>> f = ContactForm(auto_id=True)
2
>>> print(f.as_table())
3
<tr><th><label for="subject">Subject:</label></th><td><input id="subject" type="text" name="subject" maxlength="100" required></td></tr>
4
<tr><th><label for="message">Message:</label></th><td><input type="text" name="message" id="message" required></td></tr>
5
<tr><th><label for="sender">Sender:</label></th><td><input type="email" name="sender" id="sender" required></td></tr>
6
<tr><th><label for="cc_myself">Cc myself:</label></th><td><input type="checkbox" name="cc_myself" id="cc_myself"></td></tr>
7
>>> print(f.as_ul())
8
<li><label for="subject">Subject:</label> <input id="subject" type="text" name="subject" maxlength="100" required></li>
9
<li><label for="message">Message:</label> <input type="text" name="message" id="message" required></li>
10
<li><label for="sender">Sender:</label> <input type="email" name="sender" id="sender" required></li>
11
<li><label for="cc_myself">Cc myself:</label> <input type="checkbox" name="cc_myself" id="cc_myself"></li>
12
>>> print(f.as_p())
13
<p><label for="subject">Subject:</label> <input id="subject" type="text" name="subject" maxlength="100" required></p>
14
<p><label for="message">Message:</label> <input type="text" name="message" id="message" required></p>
15
<p><label for="sender">Sender:</label> <input type="email" name="sender" id="sender" required></p>
16
<p><label for="cc_myself">Cc myself:</label> <input type="checkbox" name="cc_myself" id="cc_myself"></p>

如果auto_id 被设置为包含’%s’部分的字符串格式，那么就是指定id的值，‘%s’部分会用表单字段的名字填充。比如auto_id=‘id_for_%s’:

1
>>> f = ContactForm(auto_id='id_for_%s')
2
>>> print(f.as_table())
3
<tr><th><label for="id_for_subject">Subject:</label></th><td><input id="id_for_subject" type="text" name="subject" maxlength="100" required></td></tr>
4
<tr><th><label for="id_for_message">Message:</label></th><td><input type="text" name="message" id="id_for_message" required></td></tr>
5
<tr><th><label for="id_for_sender">Sender:</label></th><td><input type="email" name="sender" id="id_for_sender" required></td></tr>
6
<tr><th><label for="id_for_cc_myself">Cc myself:</label></th><td><input type="checkbox" name="cc_myself" id="id_for_cc_myself"></td></tr>
7
>>> print(f.as_ul())
8
<li><label for="id_for_subject">Subject:</label> <input id="id_for_subject" type="text" name="subject" maxlength="100" required></li>
9
<li><label for="id_for_message">Message:</label> <input type="text" name="message" id="id_for_message" required></li>
10
<li><label for="id_for_sender">Sender:</label> <input type="email" name="sender" id="id_for_sender" required></li>
11
<li><label for="id_for_cc_myself">Cc myself:</label> <input type="checkbox" name="cc_myself" id="id_for_cc_myself"></li>
12
>>> print(f.as_p())
13
<p><label for="id_for_subject">Subject:</label> <input id="id_for_subject" type="text" name="subject" maxlength="100" required></p>
14
<p><label for="id_for_message">Message:</label> <input type="text" name="message" id="id_for_message" required></p>
15
<p><label for="id_for_sender">Sender:</label> <input type="email" name="sender" id="id_for_sender" required></p>
16
<p><label for="id_for_cc_myself">Cc myself:</label> <input type="checkbox" name="cc_myself" id="id_for_cc_myself"></p>

如果auto_id 被设置为任何其它的真值，比如不包含’%s’的字符串，相当于设置为True。
默认情况下，auto_id 被设置为 ‘id_%s’。

【十一】配置表单的渲染器#

实际上，我们在渲染表单的时候都会用到一个渲染器。
而用哪个渲染器是可配置的。
这个配置项叫做default_renderer，它的默认值为None，表示使用settings中FORM_RENDERER指定的渲染器。
我们可以在表单类中手动指定default_renderer，选择我们需要的渲染器：

1
from django import forms
2

3
class MyForm(forms.Form):
4
    default_renderer = MyRenderer()

或者：

1
form = MyForm(renderer=MyRenderer())

【十二】字段输入框的排序#

在我们使用 as_p(), as_ul() 和as_table()快捷方式生成HTML页面的input框时，这些input元素的先后顺序和表单类中字段定义的先后顺序是一致的。
如果想要调整顺序，可以使用Form类的field_order 属性。
默认情况下，Form.field_order=None，表示与字段采用同样顺序。
如果给field_order 提供一个列表值，那么首先按列表中列出的项排出，剩下的继续按原顺序排出。如果列表中有无效的字段名，将被忽略。

1
from django import forms
2

3
class MyForm(forms.Form):
4
    field_order = [...]

【十三】判断表单上传类型#

Form类有一个is_multipart() 方法，可以用来判断表单是上传文件还是键值对。如下所示：

1
>>> f = ContactFormWithMugshot()
2
>>> f.is_multipart()
3
True

这样，我们就可以在模板中，根据上传方式的不同，生成不同的表头：

1
{% if form.is_multipart %}
2
    <form enctype="multipart/form-data" method="post" action="/foo/">
3
{% else %}
4
    <form method="post" action="/foo/">
5
{% endif %}
6
{{ form }}
7
</form>

【十四】添加前缀#

可以为Form类添加prefix属性或参数，来给每个字段名添加一个前缀，比如：

1
>>> mother = PersonForm(prefix="mother")
2
>>> father = PersonForm(prefix="father")
3
>>> print(mother.as_ul())
4
<li><label for="id_mother-first_name">First name:</label> <input type="text" name="mother-first_name" id="id_mother-first_name" required></li>
5
<li><label for="id_mother-last_name">Last name:</label> <input type="text" name="mother-last_name" id="id_mother-last_name" required></li>
6
>>> print(father.as_ul())
7
<li><label for="id_father-first_name">First name:</label> <input type="text" name="father-first_name" id="id_father-first_name" required></li>
8
<li><label for="id_father-last_name">Last name:</label> <input type="text" name="father-last_name" id="id_father-last_name" required></li>

或者

1
>>> class PersonForm(forms.Form):
2
...     ...
3
...     prefix = 'person'

【十五】创建子类#

如果你创建一个Form类的子类，那么子类将自动拥有父类所有的字段。如下所示:

1
>>> class ContactFormWithPriority(ContactForm):
2
...     priority = forms.CharField()
3
>>> f = ContactFormWithPriority(auto_id=False)
4
>>> print(f.as_ul())
5
<li>Subject: <input type="text" name="subject" maxlength="100" required></li>
6
<li>Message: <input type="text" name="message" required></li>
7
<li>Sender: <input type="email" name="sender" required></li>
8
<li>Cc myself: <input type="checkbox" name="cc_myself"></li>
9
<li>Priority: <input type="text" name="priority" required></li>

可以同时继承多个父类：

1
>>> from django import forms
2
>>> class PersonForm(forms.Form):
3
...     first_name = forms.CharField()
4
...     last_name = forms.CharField()
5
>>> class InstrumentForm(forms.Form):
6
...     instrument = forms.CharField()
7
>>> class BeatleForm(InstrumentForm, PersonForm):
8
...     haircut_type = forms.CharField()
9
>>> b = BeatleForm(auto_id=False)
10
>>> print(b.as_ul())
11
<li>First name: <input type="text" name="first_name" required></li>
12
<li>Last name: <input type="text" name="last_name" required></li>
13
<li>Instrument: <input type="text" name="instrument" required></li>
14
<li>Haircut type: <input type="text" name="haircut_type" required></li>

在子类中，将某个父类中的字段设置为None，可以声明性地删除这个字段，也就是说子类不要父类的这个字段：

1
>>> from django import forms
2

3
>>> class ParentForm(forms.Form):
4
...     name = forms.CharField()
5
...     age = forms.IntegerField()
6

7
>>> class ChildForm(ParentForm):
8
...     name = None
9

10
>>> list(ChildForm().fields)
11
['age']

音乐

音乐

【一】引入#

【二】表单的绑定属性#

【1】Form.is_bound：#

【三】使用表单验证数据#

【1】Form.clean()#

【2】Form.is_valid()#

【3】Form.errors#

【4】Form.errors.as_data()#

【5】Form.errors.as_json(escape_html=False)#

【6】Form.add_error(field, error)#

【7】Form.has_error(field, code=None)#

【8】Form.non_field_errors()#

【9】对于没有绑定数据的表单#

【四】检查表单数据是否被修改#

【1】Form.has_changed()#

【2】Form.changed_data#

【五】访问表单中的字段#

【1】通过fileds属性访问表单的字段#

【2】修改Form实例的字段来改变字段在表单中的表示#

【六】访问cleaned_data#

【七】表单的HTML生成方式#

【1】渲染成文字段落as_p()#

【2】渲染成无序列表as_ul()#

【3】渲染成表格as_table()#

【八】为错误信息添加CSS样式#

【九】将上传的文件绑定到表单#

【十】配置表单元素的HTML id属性和标签#

【十一】配置表单的渲染器#

【十二】字段输入框的排序#

【十三】判断表单上传类型#

【十四】添加前缀#

【十五】创建子类#

支持与分享

音乐

Django表单API详解

【一】引入#

【二】表单的绑定属性#

【1】Form.is_bound：#

【三】使用表单验证数据#

【1】Form.clean()#

【2】Form.is_valid()#

【3】Form.errors#

【4】Form.errors.as_data()#

【5】Form.errors.as_json(escape_html=False)#

【6】Form.add_error(field, error)#

【7】Form.has_error(field, code=None)#

【8】Form.non_field_errors()#

【9】对于没有绑定数据的表单#

【四】检查表单数据是否被修改#

【1】Form.has_changed()#

【2】Form.changed_data#

【五】访问表单中的字段#

【1】通过fileds属性访问表单的字段#

【2】修改Form实例的字段来改变字段在表单中的表示#

【六】访问cleaned_data#

【七】表单的HTML生成方式#

【1】渲染成文字段落as_p()#

【2】渲染成无序列表as_ul()#

【3】渲染成表格as_table()#

【八】 为错误信息添加CSS样式#

【九】将上传的文件绑定到表单#

【十】配置表单元素的HTML id属性和 标签#

【十一】配置表单的渲染器#

【十二】字段输入框的排序#

【十三】判断表单上传类型#

【十四】添加前缀#

【十五】创建子类#

支持与分享

【八】为错误信息添加CSS样式#

【十】配置表单元素的HTML id属性和标签#