封装字段 英文 表单 API¶

绑定和非绑定表单

一个 实例要么是 绑定 到一组数据，要么是 未绑定。

要创建一个未绑定的 实例，实例化类：

>>> f = ContactForm()

要将数据绑定到表单中，将数据以字典的形式传递给你的 类构造函数的第一个参数：

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

在这个字典中，键是字段名，对应于 类中的属性。值是你要验证的数据。这些数据通常是字符串，但不要求它们是字符串；你传递的数据类型取决于 ，我们稍后会看到。

Form.

如果你需要在运行时区分绑定和未绑定的表单实例，请检查表单的 属性的值：

>>> f = ContactForm()
>>> f.is_bound
False
>>> f = ContactForm({'subject': 'hello'})
>>> f.is_bound
True

需要注意的是，传递一个空的字典会创建一个空数据的 绑定 表单：

>>> f = ContactForm({})
>>> f.is_bound
True

如果你有一个绑定的 实例，并想以某种方式改变数据，或者你想将一个未绑定的 实例绑定到一些数据，请创建另一个 实例。没有办法改变一个 实例中的数据。一旦创建了一个 实例，你应该认为它的数据是不可改变的，不管它是否有数据。