当你创建一个 Form 类时，最重要的部分是定义表单的字段。每个字段都有自定义的验证逻辑，以及其他一些钩子。
虽然你主要会在 Form 类中使用 Field 类，但你也可以实例化它们并直接使用它们来更好地了解它们的工作原理。每个 Field 实例都有一个 clean() 方法，它接受一个参数，要么引发一个 django.core.exceptions.ValidationError 异常，要么返回清理后的值：
>>> from django import forms\n>>> f = forms.EmailField()\n>>> f.clean("foo@example.com")\n'foo@example.com'\n>>> f.clean("invalid email address")\nTraceback (most recent call last):\n...\nValidationError: ['Enter a valid email address.']\n每个 Field 类的构造函数至少需要这些参数。有些 Field 类需要额外的、特定的字段参数，但以下参数应 始终 接受：
requiredLink to this heading#默认情况下，每个 Field 类都假定该值是必需的，因此如果传递一个空值 -- 无论是 None 还是空字符串（""）-- 那么 clean() 将引发一个 ValidationError 异常：
>>> from django import forms\n>>> f = forms.CharField()\n>>> f.clean("foo")\n'foo'\n>>> f.clean("")\nTraceback (most recent call last):\n...\nValidationError: ['This field is required.']\n>>> f.clean(None)\nTraceback (most recent call last):\n...\nValidationError: ['This field is required.']\n>>> f.clean(0)\n'0'\n>>> f.clean(True)\n'True'\n>>> f.clean(False)\n'False'\n要指定字段为 不 必需的，请将 required=False 传递给 Field 构造函数：
>>> f = forms.CharField(required=False)\n>>> f.clean("foo")\n'foo'\n>>> f.clean("")\n''\n>>> f.clean(None)\n''\n>>> f.clean(0)\n'0'\n>>> f.clean(True)\n'True'\n>>> f.clean(False)\n'False'\n如果一个 Field 有 required=False，而你给 clean() 传递一个空值，那么 clean() 将返回一个 规范化 的空值，而不是引发 ValidationError。对于 CharField，将返回 empty_value，默认为一个空字符串。对于其他 Field 类，它可能是 None。（这因字段而异。）
必填表单字段的部件有 required HTML 属性。将 Form.use_required_attribute 属性设置为 False 就可以禁用。由于在添加和删除表单集时，浏览器的验证可能不正确，所以表单集的表单中不包含 required 属性。
labelLink to this heading#label 参数让你指定该字段的“人类友好”标签。当 Field 在 Form 中显示时，会用到这个标签。
As explained in 将表单输出为 HTML, the default label for a\nField is generated from the field name by converting all underscores to\nspaces and upper-casing the first letter. Specify a string for label if\nthat default behavior doesn't result in an adequate label. Use an empty string\n("") to hide the label.
以下是一个完整的示例 Form，它为其两个字段实现了 label。我们指定了 auto_id=False 以简化输出：
>>> from django import forms\n>>> class CommentForm(forms.Form):\n... name = forms.CharField(label="Your name")\n... url = forms.URLField(label="Your website", required=False)\n... comment = forms.CharField()\n...\n>>> f = CommentForm(auto_id=False)\n>>> print(f)\n<div>Your name:<input type="text" name="name" required></div>\n<div>Your website:<input type="url" name="url"></div>\n<div>Comment:<input type="text" name="comment" required></div>\nlabel_suffixLink to this heading#label_suffix 参数允许你以每个字段为基础覆盖表单的 label_suffix：
>>> class ContactForm(forms.Form):\n... age = forms.IntegerField()\n... nationality = forms.CharField()\n... captcha_answer = forms.IntegerField(label="2 + 2", label_suffix=" =")\n...\n>>> f = ContactForm(label_suffix="?")\n>>> print(f)\n<div><label for="id_age">Age?</label><input type="number" name="age" required id="id_age"></div>\n<div><label for="id_nationality">Nationality?</label><input type="text" name="nationality" required id="id_nationality"></div>\n<div><label for="id_captcha_answer">2 + 2 =</label><input type="number" name="captcha_answer" required id="id_captcha_answer"></div>\ninitialLink to this heading#initial 参数让你指定在未绑定的 Form 中渲染这个 Field 时要使用的初始值。
要指定动态初始数据，请参见 Form.initial 参数。
这个用例是当你想要显示一个 "空" 表单，其中一个字段被初始化为特定的值时。例如：
\n>>> from django import forms\n>>> class CommentForm(forms.Form):\n... name = forms.CharField(initial="Your name")\n... url = forms.URLField(initial="https://")\n... comment = forms.CharField()\n...\n>>> f = CommentForm(auto_id=False)\n>>> print(f)\n<div>Name:<input type="text" name="name" value="Your name" required></div>\n<div>Url:<input type="url" name="url" value="https://" required></div>\n<div>Comment:<input type="text" name="comment" required></div>\n你可能会想，为什么不在显示表单时直接传递初始值的字典作为数据呢？如果你这样做，你会触发验证，并且 HTML 输出将包含任何验证错误：
\n>>> class CommentForm(forms.Form):\n... name = forms.CharField()\n... url = forms.URLField()\n... comment = forms.CharField()\n...\n>>> default_data = {"name": "Your name", "url": "https://"}\n>>> f = CommentForm(default_data, auto_id=False)\n>>> print(f)\n<div>Name:\n <input type="text" name="name" value="Your name" required>\n</div>\n<div>Url:\n <ul class="errorlist"><li>Enter a valid URL.</li></ul>\n <input type="url" name="url" value="https://" required aria-invalid="true">\n</div>\n<div>Comment:\n <ul class="errorlist"><li>This field is required.</li></ul>\n <input type="text" name="comment" required aria-invalid="true">\n</div>\n这就是为什么 initial 值只在未绑定的表单中显示。对于绑定的表格，HTML 输出将使用绑定的数据。
还要注意，如果没有提供特定字段的值，initial 值 不 会用作验证的 "回退" 数据。initial 值仅用于初始表单显示：
>>> class CommentForm(forms.Form):\n... name = forms.CharField(initial="Your name")\n... url = forms.URLField(initial="https://")\n... comment = forms.CharField()\n...\n>>> data = {"name": "", "url": "", "comment": "Foo"}\n>>> f = CommentForm(data)\n>>> f.is_valid()\nFalse\n# The form does *not* fallback to using the initial values.\n>>> f.errors\n{'url': ['This field is required.'], 'name': ['This field is required.']}\n而不是一个常量，你也可以传递任何可调用的对象：
\n>>> import datetime\n>>> class DateForm(forms.Form):\n... day = forms.DateField(initial=datetime.date.today)\n...\n>>> print(DateForm())\n<div><label for="id_day">Day:</label><input type="text" name="day" value="2023-02-11" required id="id_day"></div>\n只有在显示未绑定的表单时，而不是在定义表单时，才会对可调用对象表单执行。
\nwidgetLink to this heading#widget 参数让你指定一个 Widget 类，以便在渲染这个 Field 时使用。参见 部件 了解更多信息。
help_textLink to this heading#help_text 参数让你为这个 Field 指定描述性文本。如果你提供了 help_text，当 Field 被一个方便的 Form 方法（例如 as_ul()）渲染时，它将显示在 Field` 旁边。
就像模型字段的 help_text 一样，这个值在自动生成的表单中并没有被 HTML 封装。
以下是一个完整的示例 Form，它为其两个字段实现了 help_text。我们指定了 auto_id=False 以简化输出：
>>> from django import forms\n>>> class HelpTextContactForm(forms.Form):\n... subject = forms.CharField(max_length=100, help_text="100 characters max.")\n... message = forms.CharField()\n... contact_email = forms.EmailField(help_text="Your email (so we can reply).")\n...\n>>> f = HelpTextContactForm(auto_id=False)\n>>> print(f)\n<div>Subject:<div class="helptext">100 characters max.</div><input type="text" name="subject" maxlength="100" required></div>\n<div>Message:<input type="text" name="message" required></div>\n<div>Contact email:<div class="helptext">Your email (so we can reply).</div><input type="email" name="contact_email" maxlength="320" required></div>\n当字段有帮助文本时，它使用 aria-describedby HTML 属性与其输入关联。如果小部件在 <fieldset> 中渲染，则 aria-describedby 会添加到此元素，否则会添加到小部件的 <input>：
>>> from django import forms\n>>> class UserForm(forms.Form):\n... username = forms.CharField(max_length=255, help_text="e.g., user@example.com")\n...\n>>> f = UserForm()\n>>> print(f)\n<div>\n<label for="id_username">Username:</label>\n<div class="helptext" id="id_username_helptext">e.g., user@example.com</div>\n<input type="text" name="username" maxlength="255" required aria-describedby="id_username_helptext" id="id_username">\n</div>\n当添加自定义的 aria-describedby 属性时，请确保以所需的顺序还包括 help_text 元素的 id （如果使用）。对于屏幕阅读器用户，描述将按照它们在 aria-describedby 中出现的顺序进行阅读：
>>> class UserForm(forms.Form):\n... username = forms.CharField(\n... max_length=255,\n... help_text="e.g., user@example.com",\n... widget=forms.TextInput(\n... attrs={"aria-describedby": "custom-description id_username_helptext"},\n... ),\n... )\n...\n>>> f = UserForm()\n>>> print(f["username"])\n<input type="text" name="username" aria-describedby="custom-description id_username_helptext" maxlength="255" id="id_username" required>\nerror_messagesLink to this heading#error_messages 参数允许你覆盖字段将引发的默认消息。传递一个字典，其中的键与你想要覆盖的错误消息匹配。例如，这是默认的错误消息：
>>> from django import forms\n>>> generic = forms.CharField()\n>>> generic.clean("")\nTraceback (most recent call last):\n ...\nValidationError: ['This field is required.']\n以下是一个自定义错误消息的示例：
\n>>> name = forms.CharField(error_messages={"required": "Please enter your name"})\n>>> name.clean("")\nTraceback (most recent call last):\n ...\nValidationError: ['Please enter your name']\n在下面的 内置字段类 一节中，每个 Field 定义了它所使用的错误信息键。
validatorsLink to this heading#validators 参数让你为这个字段提供一个验证函数列表。
更多信息请参见 验证器文档。
\nlocalizeLink to this heading#localize 参数可以实现表单数据输入和渲染输出的本地化。
有关更多信息，请参阅 格式本地化文档。
\ndisabledLink to this heading#disabled 布尔参数设置为 True 时，使用 disabled HTML 属性禁用表单字段，使其不能被用户编辑。即使用户篡改了提交给服务器的字段值，也会被忽略，而采用表单初始数据的值。
template_nameLink to this heading#template_name 参数允许在使用 as_field_group() 渲染字段时使用自定义模板。默认情况下，该值设置为 "django/forms/field.html"。可以通过覆盖此属性来为每个字段更改它，或者更一般地，可以通过覆盖默认模板来更改它，另请参阅 覆盖内置字段模板。
bound_field_classLink to this heading#The bound_field_class attribute allows a per-field override of\nForm.bound_field_class.
has_changed()Link to this heading#has_changed() 方法用于确定字段值是否与初始值发生了变化。返回 True 或 False。
See the Form.has_changed documentation for more information.
Field 类Link to this heading#当然，forms 库附带了一组 Field 类，代表了常见的验证需求。本节将对每个内置字段进行说明。
对于每个字段，我们描述了在你没有指定 widget 时使用的默认部件。我们还指定了当你提供一个空值时返回的值（参见上文 required 一节以了解其含义）。
BooleanFieldLink to this heading#默认部件：CheckboxInput
空值：False
规范化为：Python 的 True 或 False 值。
如果字段有 required=True，则验证该值是否为 True （例如，复选框被选中）。
错误信息键：required
CharFieldLink to this heading#默认部件：TextInput
空值：不管你给 empty_value 的是什么。
规范化为：一个字符串。
如果提供了 max_length 和 min_length，则使用 MaxLengthValidator 和 MinLengthValidator。否则，所有输入都有效。
错误信息键：required、max_length、min_length
具有以下可选的验证参数：
\n如果提供了这些参数，这些参数确保字符串的长度最多或至少是给定的长度。
\n如果 True （默认），该值将被去掉前导和尾部的空白。
用来表示“空”的值。默认为空字符串。
\nChoiceFieldLink to this heading#默认部件：Select
空值：'' （空字符串）
规范化为：一个字符串。
验证给定值是否存在于选择列表中。
错误信息键：required、invalid_choice
invalid_choice 错误信息可能包含 %(value)s，该信息将被替换为选定的选择。
需要一个额外的参数：
\n可以是一个包含 2 元组的可迭代对象，用作此字段的选项，也可以是返回这种可迭代对象的可调用对象。此参数接受与模型字段的 choices 参数相同的格式。有关更多详细信息，请参阅 模型字段参考文档中的 choices。如果该参数是可调用的，它将在每次初始化字段的表单时进行评估，以及在渲染时进行评估。默认为一个空列表。
DateFieldLink to this heading#默认部件：DateInput
空值：None
规范化为：Python 的 datetime.date 对象。
验证给定值是 datetime.date、datetime.datetime 或以特定日期格式化的字符串。
错误信息键：required、invalid
需要一个可选的参数：
\n一个用于尝试将字符串转换为有效的 datetime.date 对象的格式迭代器。
如果未提供 input_formats 参数，则默认的输入格式将从活动区域设置的 DATE_INPUT_FORMATS 键中获取，或者如果禁用了本地化，则从 DATE_INPUT_FORMATS 获取。另请参阅 格式本地化。
DateTimeFieldLink to this heading#默认部件：DateTimeInput
空值：None
规范化为：Python 的 datetime.datetime 对象。
验证给定的值是 datetime.datetime、datetime.date 或以特定日期时间格式化的字符串。
错误信息键：required、invalid
需要一个可选的参数：
\n一个用于尝试将字符串转换为有效的 datetime.datetime 对象的格式迭代器，除了 ISO 8601 格式。
该字段始终接受 ISO 8601 格式的日期或类似于 parse_datetime() 可识别的日期字符串。以下是一些示例：
'2006-10-25 14:30:59'
'2006-10-25T14:30:59'
'2006-10-25 14:30'
'2006-10-25T14:30'
'2006-10-25T14:30Z'
'2006-10-25T14:30+02:00'
'2006-10-25'
如果未提供 input_formats 参数，则默认的输入格式将从活动区域设置的 DATETIME_INPUT_FORMATS 和 DATE_INPUT_FORMATS 键中获取，或者如果禁用了本地化，则从 DATETIME_INPUT_FORMATS 和 DATE_INPUT_FORMATS 获取。另请参阅 格式本地化。
DecimalFieldLink to this heading#当 Field.localize 为 False 时是 NumberInput 否则，该字段的默认表单部件是 TextInput。
空值：None
规范化为：Python 的 decimal。
验证给定的值是否为十进制数。如果提供了 max_value 和 min_value，则使用 MaxValueValidator 和 MinValueValidator。如果提供了 step_size，则使用 StepValueValidator。前导和尾随空格会被忽略。
错误消息键: required, invalid, max_value, min_value, max_digits, max_decimal_places, max_whole_digits, step_size。
max_value 和 min_value 错误信息可能包含 %(limit_value)s，将用适当的限制代替。同样，max_digits、max_decimal_places 和 max_whole_digits 错误信息可能包含 %(max)s。
接受五个可选参数：
\n这些控制着字段中允许的数值范围，应以 decimal.Decimal 值的形式给出。
值中允许的最大数字（小数点前的数字加上小数点后的数字，去掉前导零）。
\n允许的最大小数位数。
\n限制有效输入为 step_size 的整数倍。如果还提供了 min_value，则将其添加为偏移量以确定步长是否匹配。
DurationFieldLink to this heading#默认部件：TextInput
空值：None
规范化为：Python 的 timedelta。
验证给定值是否是一个字符串，可以转换成 timedelta。该值必须在 datetime.timedelta.min 和 datetime.timedelta.max 之间。
错误信息键：required、invalid、overflow
接受 parse_duration() 理解的任何格式。
EmailFieldLink to this heading#默认部件：EmailInput
空值：不管你给 empty_value 的是什么。
规范化为：一个字符串。
使用 EmailValidator 来验证给定的值是一个有效的电子邮件地址，使用一个适度复杂的正则表达式。
错误信息键：required、invalid
具有可选参数 max_length、min_length 和 empty_value，它们的工作方式与 CharField 相同。max_length 参数默认为 320（参见 RFC 3696 Section 3）。
FileFieldLink to this heading#默认部件：ClearableFileInput
空值：None
规范化为：一个 UploadedFile 对象，它将文件内容和文件名包装成一个单一对象。
可以验证非空文件数据已经绑定到表单中。
错误信息键：required、invalid、missing、empty、max_length
具有可选的验证参数：max_length 和 allow_empty_file。如果提供了这些参数，它们确保文件名最多为给定的长度，并且即使文件内容为空，验证也将成功。
要了解更多关于 UploadedFile 对象的信息，请看 文件上传文档。
当你在表单中使用 FileField 时，你还必须记住 将文件数据绑定到表单中。
max_length 错误指的是文件名的长度。在该键的错误信息中，%(max)d 将被替换为最大文件名长度，%(length)d 将被替换为当前文件名长度。
FilePathFieldLink to this heading#默认部件：Select
空值：'' （空字符串）
规范化为：一个字符串。
验证选择是否存在于选择列表中。
错误信息键：required、invalid_choice
该字段允许从某个目录内的文件中选择。它需要五个额外的参数；只有 path 是必须的。
你想要列出的内容的目录的绝对路径。该目录必须存在。
\n如果 False （默认），只提供 path 的直接内容作为选择。如果 True，目录将被递归递进，所有的子目录将被列为选择。
正则表达式模式；只允许将名称与此表达式相匹配的文件作为选择。
\nOptional. Either True or False. Default is True. Specifies\nwhether files in the specified location should be included. Either this\nor allow_folders must be True.
Optional. Either True or False. Default is False. Specifies\nwhether folders in the specified location should be included. Either\nthis or allow_files must be True.
FilePathField has the following method:
Scans the directory at path and refreshes the field's\nchoices. This is called automatically during __init__(), but it can\nalso be called explicitly to pick up files added to the directory\nafter the field was first instantiated (usually at server startup). For\nexample, call it in a form's __init__() to get fresh choices per\nrequest:
class MyForm(forms.Form):\n my_file = forms.FilePathField(path="/path/to/dir")\n\n def __init__(self, *args, **kwargs):\n super().__init__(*args, **kwargs)\n self.fields["my_file"].set_choices()\nFloatFieldLink to this heading#当 Field.localize 为 False 时是 NumberInput 否则，该字段的默认表单部件是 TextInput。
空值：None
规范化为：Python 的浮点数。
验证给定的值是否为浮点数。如果提供了 max_value 和 min_value，则使用 MaxValueValidator 和 MinValueValidator。如果提供了 step_size，则使用 StepValueValidator。允许前导和尾随空格，就像 Python 的 float() 函数一样。
错误消息键: required, invalid, max_value, min_value, step_size。
接受三个可选参数：
\n这些控制了该字段允许的数值范围。
\n限制有效输入为 step_size 的整数倍。如果还提供了 min_value，则将其添加为偏移量以确定步长是否匹配。
GenericIPAddressFieldLink to this heading#一个包含 IPv4 或 IPv6地址 的字段。
\n默认部件：TextInput
空值：'' （空字符串）
规范化为：一个字符串。IPv6 地址的规范化如下所述。
验证给定的值是一个有效的 IP 地址。
Error message keys: required, invalid, max_length
IPv6 地址规范化遵循 RFC 4291 Section 2.2 第 2.2 节，包括使用该节第 3 段建议的 IPv4 格式，如 ::fffff:192.0.2.0。例如，2001:0::0:01 将被标准化为 2001::1，::fffff:0a0a:0a0a 将被标准化为 ::fffff:10.10.10.10。所有字符都转换为小写。
接受三个可选参数：
\n将有效输入限制为指定协议。接受的值是 both （默认）、IPv4 或 IPv6。匹配是不区分大小写的。
解压 IPv4 映射地址，如 ::fffff:192.0.2.1。如果启用该选项，该地址将被解压为 192.0.2.1。默认为禁用。只有当 protocol 设置为 'both' 时才会启用。
Defaults to 39, and behaves the same way as it does for\nCharField.
ImageFieldLink to this heading#默认部件：ClearableFileInput
空值：None
规范化为：一个 UploadedFile 对象，它将文件内容和文件名包装成一个单一对象。
验证文件数据是否已经绑定到表单中。同时使用 FileExtensionValidator 来验证 Pillow 是否支持文件扩展名。
错误信息键：required、invalid、missing、empty、invalid_image
使用 ImageField 需要安装支持你使用的图像格式的 pillow。如果你在上传图像时遇到 corrupt image 错误，通常意味着 Pillow 无法理解其格式。要解决此问题，请安装适当的库并重新安装 Pillow。
当你在表单中使用 ImageField 时，你还必须记住 将文件数据绑定到表单。
在字段被清理和验证后，UploadedFile 对象将具有一个额外的 image 属性，其中包含 Pillow 的 Image 实例，用于检查文件是否为有效的图像。Pillow 在验证图像后关闭底层文件描述符，因此虽然可以访问非图像数据属性，如 format、height 和 width，但不能在不重新打开文件的情况下使用访问底层图像数据的方法，比如 getdata() 或 getpixel()。例如：
>>> from PIL import Image\n>>> from django import forms\n>>> from django.core.files.uploadedfile import SimpleUploadedFile\n>>> class ImageForm(forms.Form):\n... img = forms.ImageField()\n...\n>>> file_data = {"img": SimpleUploadedFile("test.png", b"file data")}\n>>> form = ImageForm({}, file_data)\n# Pillow closes the underlying file descriptor.\n>>> form.is_valid()\nTrue\n>>> image_field = form.cleaned_data["img"]\n>>> image_field.image\n<PIL.PngImagePlugin.PngImageFile image mode=RGBA size=191x287 at 0x7F5985045C18>\n>>> image_field.image.width\n191\n>>> image_field.image.height\n287\n>>> image_field.image.format\n'PNG'\n>>> image_field.image.getdata()\n# Raises AttributeError: 'NoneType' object has no attribute 'seek'.\n>>> image = Image.open(image_field)\n>>> image.getdata()\n<ImagingCore object at 0x7f5984f874b0>\n此外，UploadedFile.content_type 如果 Pillow 能够确定图片的内容类型，则会以图片的内容类型进行更新，否则会设置为 None。
IntegerFieldLink to this heading#当 Field.localize 为 False 时是 NumberInput 否则，该字段的默认表单部件是 TextInput。
空值：None
规范化为：Python 的整数。
验证给定的值是否为整数。如果提供了 max_value 和 min_value，则使用 MaxValueValidator 和 MinValueValidator。如果提供了 step_size，则使用 StepValueValidator。允许前导和尾随空格，就像 Python 的 int() 函数一样。
错误消息键: required, invalid, max_value, min_value, step_size
max_value、min_value 和 step_size 的错误消息可能包含 %(limit_value)s，它将被适当的限制值替换。
接受三个可选的验证参数：
\n这些控制了该字段允许的数值范围。
\n限制有效输入为 step_size 的整数倍。如果还提供了 min_value，则将其添加为偏移量以确定步长是否匹配。
JSONFieldLink to this heading#一个接受 JSON 编码数据的字段 JSONField。
默认部件：Textarea
空值：None
规范化为：JSON 值的 Python 表示（通常为 dict、list 或 None），取决于 JSONField.decoder。
验证给定值是否为有效的 JSON。
错误信息键：required、invalid
需要两个可选的参数：
\nA json.JSONEncoder subclass to serialize data types not\nsupported by the standard JSON serializer (e.g. datetime.datetime\nor UUID). For example, you can use the\nDjangoJSONEncoder class.
默认为 json.JSONEncoder。
A json.JSONDecoder subclass to deserialize the input. Your\ndeserialization may need to account for the fact that you can't be\ncertain of the input type. For example, you run the risk of returning a\ndatetime that was actually a string that just happened to be in the\nsame format chosen for datetimes.
The decoder can be used to validate the input. If\njson.JSONDecodeError is raised during the deserialization,\na ValidationError will be raised.
默认为 json.JSONDecoder。
MultipleChoiceFieldLink to this heading#默认部件：SelectMultiple
空值：[] （空列表）
规范化为：一个字符串列表。
验证给定值列表中的每个值是否存在于选择列表中。
错误信息键：required、invalid_choice、invalid_list
invalid_choice 错误信息可能包含 %(value)s，该信息将被替换为选定的选择。
与 ChoiceField 一样，多了一个必要参数 choices。
NullBooleanFieldLink to this heading#默认部件：NullBooleanSelect
空值：None
规范化为：Python 的 True、False 或 None 值。
不验证任何东西（也就是说，它从不引起 ValidationError）。
NullBooleanField 可以通过提供部件 choices 来与诸如 Select 或 RadioSelect 等部件一起使用。
NullBooleanField(\n widget=Select(\n choices=[\n ("", "Unknown"),\n (True, "Yes"),\n (False, "No"),\n ]\n )\n)\nRegexFieldLink to this heading#默认部件：TextInput
空值：不管你给 empty_value 的是什么。
规范化为：一个字符串。
使用 RegexValidator 来验证给定的值是否匹配某个正则表达式。
错误信息键：required、invalid
需要一个额外的参数：
\n一个正则表达式，可以是字符串，也可以是编译后的正则表达式对象。
\n也接受 max_length、min_length、strip 和 empty_value，它们的工作原理和 CharField 一样。
默认值为 False。如果启用，将在验证正则表达式之前进行 strip。
SlugFieldLink to this heading#默认部件：TextInput
空值：不管你给 empty_value 的是什么。
规范化为：一个字符串。
使用 validate_slug 或 validate_unicode_slug 来验证给定值是否只包含字母、数字、下划线和连字符。
错误信息键：required、invalid
这个字段用于在表单中表示一个模型 SlugField。
需要两个可选的参数：
\n一个布尔值，指示该字段除了接受 ASCII 字母外，还接受 Unicode 字母。默认值为 False。
用来表示“空”的值。默认为空字符串。
\nTimeFieldLink to this heading#默认部件：TimeInput
空值：None
规范化为：Python 的 datetime.time 对象。
验证给定值是 datetime.time 或以特定时间格式化的字符串。
错误信息键：required、invalid
需要一个可选的参数：
\n一个用于尝试将字符串转换为有效的 datetime.time 对象的格式迭代器。
如果未提供 input_formats 参数，则默认的输入格式将从活动区域设置的 TIME_INPUT_FORMATS 键中获取，或者如果禁用了本地化，则从 TIME_INPUT_FORMATS 获取。另请参阅 格式本地化。
TypedChoiceFieldLink to this heading#就像 ChoiceField 一样，除了 TypedChoiceField 需要两个额外的参数 coerce 和 empty_value。
默认部件：Select
空值：不管你给 empty_value 的是什么。
规范化为：coerce 参数提供的类型的值。
验证给定的值是否存在于选择列表中，并且可以被强制执行。
错误信息键：required、invalid_choice
需要额外的参数：
\n接受一个参数并返回一个强制值的函数。例子包括内置的 int、float、bool 和其他类型。默认为身份函数。请注意，强制执行发生在输入验证之后，所以可以强制执行到一个不存在于``choices``中的值。
用来表示“空”的值。默认为空字符串；None 是另一种常见的选择。请注意，这个值不会被 coerce 参数中给出的函数强制执行，所以要据此选择。
TypedMultipleChoiceFieldLink to this heading#就像 MultipleChoiceField 一样，只是 TypedMultipleChoiceField 需要两个额外的参数：coerce 和 empty_value。
默认部件：SelectMultiple
空值：不管你给 empty_value 的是什么。
归法化为：coerce 参数提供的类型值列表。
验证给定的值是否存在于选择列表中，并且可以被强制执行。
错误信息键：required、invalid_choice
invalid_choice 错误信息可能包含 %(value)s，该信息将被替换为选定的选择。
需要两个额外的参数，coerce 和 empty_value，如 TypedChoiceField。
URLFieldLink to this heading#默认部件：URLInput
空值：不管你给 empty_value 的是什么。
规范化为：一个字符串。
使用 URLValidator 来验证给定值是一个有效的 URL。
错误信息键：required、invalid
具有可选参数 max_length、min_length、empty_value，它们的工作方式与 CharField 中的一样，并且还有一个额外的参数：
The scheme assumed for URLs provided without one. Defaults to\n"https". For example, if assume_scheme is "https" and the\nprovided value is "example.com", the normalized value will be\n"https://example.com".
UUIDFieldLink to this heading#该字段将接受作为 UUID 构造函数的 hex 参数的任何字符串格式。
Field 类Link to this heading#ComboFieldLink to this heading#默认部件：TextInput
空值：'' （空字符串）
规范化为：一个字符串。
根据 ComboField 参数指定的每个字段验证给定值。
错误信息键：required、invalid
需要一个额外的必要参数。
\n应该用来验证字段值的字段列表（按照提供的顺序）。
\n>>> from django.forms import ComboField\n>>> f = ComboField(fields=[CharField(max_length=20), EmailField()])\n>>> f.clean("test@example.com")\n'test@example.com'\n>>> f.clean("longemailaddress@example.com")\nTraceback (most recent call last):\n...\nValidationError: ['Ensure this value has at most 20 characters (it has 28).']\nMultiValueFieldLink to this heading#默认部件：TextInput
空值：'' （空字符串）
规范化为：子类的 compress 方法返回的类型。
根据作为 MultiValueField 参数指定的每个字段验证给定值。
错误信息键：required、invalid、incomplete
将多个字段的逻辑聚合在一起产生一个值。
\n这个字段是抽象的，必须被子类化。与单值字段相反， MultiValueField 的子类不能实现 clean()，而是——实现 compress()。
需要一个额外的必要参数。
\nA tuple of fields whose values are cleaned and subsequently combined\ninto a single value. Each value of the field is cleaned by the\ncorresponding field in fields -- the first value is cleaned by the\nfirst field, the second value is cleaned by the second field, etc.\nOnce all fields are cleaned, the list of clean values is combined into\na single value by compress().
还需要一些可选的参数：
\n默认值为 True，在这种情况下，如果没有为任何字段提供值，就会出现 required 验证错误。
Field.required 属性设置为 False 时，可将单个字段设置为 False，使其成为可选字段。如果没有为必填字段提供任何值，就会出现 incomplete 的验证错误。
可以在 MultiValueField 子类上定义一个默认的 incomplete 错误信息，也可以在每个单独的字段上定义不同的信息。例如：
from django.core.validators import RegexValidator\n\n\nclass PhoneField(MultiValueField):\n def __init__(self, **kwargs):\n # Define one message for all fields.\n error_messages = {\n "incomplete": "Enter a country calling code and a phone number.",\n }\n # Or define a different message for each field.\n fields = (\n CharField(\n error_messages={"incomplete": "Enter a country calling code."},\n validators=[\n RegexValidator(r"^[0-9]+$", "Enter a valid country calling code."),\n ],\n ),\n CharField(\n error_messages={"incomplete": "Enter a phone number."},\n validators=[RegexValidator(r"^[0-9]+$", "Enter a valid phone number.")],\n ),\n CharField(\n validators=[RegexValidator(r"^[0-9]+$", "Enter a valid extension.")],\n required=False,\n ),\n )\n super().__init__(\n error_messages=error_messages,\n fields=fields,\n require_all_fields=False,\n **kwargs\n )\n必须是 django.forms.MultiWidget 的子类。默认值是 TextInput，在这种情况下可能不是很有用。
取一个有效值的列表，并返回这些值的“压缩”版本——在一个单一值中。例如，SplitDateTimeField 是一个子类，它将一个时间字段和一个日期字段合并成一个 datetime 对象。
这个方法必须在子类中实现。
\nSplitDateTimeFieldLink to this heading#默认部件：SplitDateTimeWidget
空值：None
规范化为：Python 的 datetime.datetime 对象。
验证给定值是 datetime.datetime 或以特定日期时间格式化的字符串。
错误信息键：required、invalid、invalid_date、invalid_time
需要两个可选的参数：
\n用于将字符串转换为有效的 datetime.date 对象的格式列表。
如果没有提供 input_date_formats 参数，则使用 DateField 的默认输入格式。
用于将字符串转换为有效的 datetime.time 对象的格式列表。
如果没有提供 input_time_formats 参数，则使用 TimeField 的默认输入格式。
Two fields are available for representing relationships between\nmodels: ModelChoiceField and\nModelMultipleChoiceField. Both of these fields require a\nsingle queryset parameter that is used to create the choices for\nthe field. Upon form validation, these fields will place either one\nmodel object (in the case of ModelChoiceField) or multiple model\nobjects (in the case of ModelMultipleChoiceField) into the\ncleaned_data dictionary of the form.
对于更复杂的用途，你可以在声明表单字段时指定 queryset=None，然后在表单的 __init__() 方法中填充 queryset：
class FooMultipleChoiceForm(forms.Form):\n foo_select = forms.ModelMultipleChoiceField(queryset=None)\n\n def __init__(self, *args, **kwargs):\n super().__init__(*args, **kwargs)\n self.fields["foo_select"].queryset = ...\nModelChoiceField 和 ModelMultipleChoiceField 都有一个 iterator 属性，它指定了在生成选择时用于迭代查询集的类。详见 迭代关系选择。
ModelChoiceFieldLink to this heading#默认部件：Select
空值：None
规范化为：一个模型实例。
验证给定的 id 是否存在于查询集中。
错误信息键：required、invalid_choice
invalid_choice 错误信息可能包含 %(value)s，该信息将被替换为选定的选择。
允许选择一个单一的模型对象，适合代表一个外键。请注意，当条目数量增加时，ModelChoiceField 的默认部件变得不实用。你应该避免将其用于超过 100 个项目。
需要一个参数：
\n由模型对象组成的 QuerySet，从中得出字段的选择，用于验证用户的选择。它在表单渲染时被执行。
ModelChoiceField 还接受几个可选参数：
By default the <select> widget used by ModelChoiceField will\nhave an empty choice at the top of the list. You can change the text of\nthis label (which is "- Select an option -" by default) with the\nempty_label attribute, or you can disable the empty label entirely\nby setting empty_label to None:
# A custom empty label\nfield1 = forms.ModelChoiceField(queryset=..., empty_label="(Nothing)")\n\n# No empty label\nfield2 = forms.ModelChoiceField(queryset=..., empty_label=None)\n请注意，如果 ModelChoiceField 是必填的并且具有默认的初始值，或者 widget 设置为 RadioSelect 并且 ModelChoiceField.blank 参数为 False，则不会创建空选择项（无论 empty_label 的值如何）。
这个可选参数用于指定字段，作为字段的小组件中选择的值。请确保它是模型的唯一字段，否则所选的值可能会匹配多个对象。默认情况下，它被设置为 None，在这种情况下，将使用每个对象的主键。例如：
# No custom to_field_name\nfield1 = forms.ModelChoiceField(queryset=...)\n会产生：
\n<select id="id_field1" name="field1">\n<option value="obj1.pk">Object1</option>\n<option value="obj2.pk">Object2</option>\n...\n</select>\n和：
\n# to_field_name provided\nfield2 = forms.ModelChoiceField(queryset=..., to_field_name="name")\n会产生：
\n<select id="id_field2" name="field2">\n<option value="obj1.name">Object1</option>\n<option value="obj2.name">Object2</option>\n...\n</select>\n在使用 RadioSelect 小部件时，这个可选的布尔参数确定是否创建一个空选择项。默认情况下，blank 是 False，在这种情况下不会创建空选择项。
ModelChoiceField 也有属性：
用于从 queryset 中生成字段选择的迭代器类。默认情况下， ModelChoiceIterator。
模型的 __str__() 方法将被调用，以生成用于字段选择的对象的字符串表示。要提供自定义的表示，请将 ModelChoiceField 子类化，并覆盖 label_from_instance。该方法将接收一个模型对象，并应返回一个适合表示它的字符串。例如：
from django.forms import ModelChoiceField\n\n\nclass MyModelChoiceField(ModelChoiceField):\n def label_from_instance(self, obj):\n return "My Object #%i" % obj.id\nModelMultipleChoiceFieldLink to this heading#默认部件：SelectMultiple
空值：一个空的 QuerySet （self.queryset.none()）。
规范化为：一个模型实例的 QuerySet。
验证给定值列表中的每个 id 是否存在于查询集中。
错误信息键：required、invalid_list、invalid_choice、invalid_pk_value
invalid_choice 信息可能包含 %(value)s，invalid_pk_value 信息可能包含 %(pk)s，将用适当的值代替。
允许选择一个或多个模型对象，适合表示多对多关系。与 ModelChoiceField 一样，你可以使用 label_from_instance 来自定义对象的表示。
需要一个参数：
\n需要一个可选的参数：
\nModelMultipleChoiceField 也有属性：
默认情况下， ModelChoiceField 和 ModelMultipleChoiceField 使用 ModelChoiceIterator 来生成它们的字段 choices。
当迭代时，ModelChoiceIterator 产生一个二元元组选择，包含 ModelChoiceIteratorValue 实例作为每个选择的第一个 value 元素。ModelChoiceIteratorValue 封装了选择值，同时保持了对源模型实例的引用，可用于自定义部件的实现，例如，将 data-* attributes 添加到 <option>。
例如，考虑以下模型：
\nfrom django.db import models\n\n\nclass Topping(models.Model):\n name = models.CharField(max_length=100)\n price = models.DecimalField(decimal_places=2, max_digits=6)\n\n def __str__(self):\n return self.name\n\n\nclass Pizza(models.Model):\n topping = models.ForeignKey(Topping, on_delete=models.CASCADE)\n你可以使用 Select 部件子类将 Topping.price 的值作为 HTML 属性 data-price，包含在每个 <option> 元素中：
from django import forms\n\n\nclass ToppingSelect(forms.Select):\n def create_option(\n self, name, value, label, selected, index, subindex=None, attrs=None\n ):\n option = super().create_option(\n name, value, label, selected, index, subindex, attrs\n )\n if value:\n option["attrs"]["data-price"] = value.instance.price\n return option\n\n\nclass PizzaForm(forms.ModelForm):\n class Meta:\n model = Pizza\n fields = ["topping"]\n widgets = {"topping": ToppingSelect}\n这将使 Pizza.topping 选择为：
<select id="id_topping" name="topping" required>\n<option value="" selected>---------</option>\n<option value="1" data-price="1.50">mushrooms</option>\n<option value="2" data-price="1.25">onions</option>\n<option value="3" data-price="1.75">peppers</option>\n<option value="4" data-price="2.00">pineapple</option>\n</select>\n对于更高级的用法，你可以将 ModelChoiceIterator 子类化，以自定义产生的二元元组选择。
ModelChoiceIteratorLink to this heading#指定给 ModelChoiceField`和:class:`ModelMultipleChoiceField 的 iterator 属性的默认类。迭代器，从查询集中产生二元元组选择。
需要一个参数：
\nModelChoiceField 或 ModelMultipleChoiceField 的实例来迭代和产生选择。
ModelChoiceIter 有以下方法：
产生二元元组选择，格式为 ChoiceField.chips 使用的 (value, label)。第一个 value 元素是一个 ModelChoiceIteratorValue 实例。
ModelChoiceIteratorValueLink to this heading#需要两个参数：
\n选择的值。该值用于呈现 HTML <option> 元素的 value 属性。
来自查询集的模型实例。该实例可以在自定义的 ChoiceWidget.create_option() 实现中被访问，以调整渲染的 HTML。
ModelChoiceIteratorValue 有以下方法：
返回 value 作为一个字符串在 HTML 中显示。
如果内置的 Field 类不能满足你的需求，你可以创建自定义的 Field 类。为此，创建一个 django.forms.Field 的子类。它唯一的要求是实现一个 clean() 方法，并且它的 __init__() 方法接受上面提到的核心参数 (required, label, initial, widget, help_text)。
You can also customize how a field will be accessed by overriding\nbound_field_class or override\nField.get_bound_field() if you need more flexibility when creating\nthe BoundField:
Takes an instance of Form and the name of the field.\nThe returned BoundField instance will be used when accessing the\nfield in a template.
See 自定义 BoundField for examples of overriding a BoundField.