Django---form 详解

class BooleanField(**kwargs)：
    默认的Widget：CheckboxInput
    空值：False
    规范化为：Python 的True 或 False。
    如果字段带有required=True，验证值是否为True（例如复选框被勾上）。 
    错误信息的键：required

class CharField(**kwargs):
默认的Widget：TextInput
空值：‘‘（一个空字符串）
规范化为：一个Unicode 对象。
如果提供，验证max_length 或min_length。 否则，所有的输入都是合法的。
错误信息的键：required, max_length, min_length
有两个参数用于验证：

max_length
min_length
如果提供，这两个参数将确保字符串的最大和最小长度。

class ChoiceField(**kwargs)?
默认的Widget：Select
空值：‘‘（一个空字符串）
规范化为：一个Unicode 对象。
验证给定的值在选项列表中存在。
错误信息的键：required, invalid_choice
invalid_choice 错误消息可能包含%(value)s，它将被选择的选项替换掉。

接收一个额外的必选参数：choices
用来作为该字段选项的一个二元组组成的可迭代对象（例如，列表或元组）或者一个可调用对象。
例如：
YEAR_IN_SCHOOL_CHOICES = (
    (‘FR‘, ‘Freshman‘),
    (‘SO‘, ‘Sophomore‘),
    (‘JR‘, ‘Junior‘),
    (‘SR‘, ‘Senior‘),
)

class DateField(**kwargs)：
默认的Widget：DateInput
空值：None
规范化为：一个Python datetime.date 对象。
验证给出的值是一个datetime.date、datetime.datetime 或指定日期格式的字符串。
错误信息的键：required, invalid
接收一个可选的参数：

input_formats
一个格式的列表，用于转换一个字符串为datetime.date 对象。

class EmailField(**kwargs)
默认的Widget：EmailInput
空值：‘‘（一个空字符串）
规范化为：一个Unicode 对象。
验证给出的值是一个合法的邮件地址，使用一个适度复杂的正则表达式。
错误信息的键：required, invalid
具有两个可选的参数用于验证，max_length 和min_length。如果提供，这两个参数确保字符串的最大和最小长度。

class FileField(**kwargs)?
默认的Widget：ClearableFileInput
空值：None
规范化为：一个UploadedFile 对象，它封装文件内容和文件名为一个单独的对象。
可以验证非空的文件数据已经绑定到表单。
错误信息的键：required, invalid, missing, empty, max_length
具有两个可选的参数用于验证，max_length 和 allow_empty_file。如果提供，这两个参数确保文件名的最大长度，而且即使文件内容为空时验证也会成功。

class ImageField(**kwargs)?
默认的Widget：ClearableFileInput
空值：None
规范化为: An UploadedFile object that wraps the file content and file name into a single object.
验证文件数据已绑定到表单，并且该文件具有Pillow理解的图像格式。
错误信息的键：required, invalid, missing, empty, invalid_image
使用ImageField需要安装Pillow并支持您使用的图像格式。如果在上传图片时遇到损坏 图像错误，通常意味着Pillow不了解其格式。要解决这个问题，请安装相应的库并重新安装Pillow。

class MultipleChoiceField(**kwargs)?
默认的Widget：SelectMultiple
空值：[]（一个空列表）
规范化为：一个Unicode 对象列表。
验证给定值列表中的每个值都存在于选择列表中。
错误信息的键：required, invalid_choice, invalid_list
invalid_choice错误消息可能包含%(value)s，将替换为所选择的选项。

对于ChoiceField，需要一个额外的必需参数choices。

class ModelChoiceField(**kwargs)?
默认的Widget：Select
空值：None
规范化为：一个模型实例。
验证给定的id存在于查询集中。
错误信息的键：required, invalid_choice
可以选择一个单独的模型对像，适用于表示一个外键字段。 ModelChoiceField默认widet不适用选择数量很大的情况，在大于100项时应该避免使用它。

需要单个参数：
queryset
将导出字段选择的模型对象的QuerySet，将用于验证用户的选择。
ModelChoiceField也有两个可选参数：
empty_label
默认情况下，ModelChoiceField使用的<select>小部件将在列表顶部有一个空选项。您可以使用empty_label属性更改此标签的文本（默认为"---------"），也可以禁用空白标签完全通过将empty_label设置为None：
to_field_name
此可选参数用于指定要用作字段窗口小部件中选项的值的字段。确保它是模型的唯一字段，否则选定的值可以匹配多个对象。默认情况下，它设置为None，在这种情况下，将使用每个对象的主键。
例如：
field1 = forms.ModelChoiceField(queryset=...)
<select id="id_field1" name="field1">
<option value="obj1.pk">Object1</option>
<option value="obj2.pk">Object2</option>
...
</select>

class ModelMultipleChoiceField(**kwargs)
默认的Widget：SelectMultiple
空值：QuerySet (self.queryset.none())
规范化为： 模型实例的一个QuerySet。
验证在给定的值列表中的每个id存在于查询集中。
错误信息的键：required, list, invalid_choice, invalid_pk_value
invalid_choice消息可以包含%(value)s并且invalid_pk_value消息可以包含%(pk)s其将被适当的值代替。

允许选择适合于表示多对多关系的一个或多个模型对象。与ModelChoiceField一样，您可以使用label_from_instance自定义对象表示，queryset是必需的参数：

queryset
将导出字段选择的模型对象的QuerySet，将用于验证用户的选择。

class FooMultipleChoiceForm(forms.Form):
    foo_select = forms.ModelMultipleChoiceField(queryset=None)

    def __init__(self, *args, **kwargs):
        super(FooMultipleChoiceForm, self).__init__(*args, **kwargs)
        self.fields[‘foo_select‘].queryset = ...

{{ 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>