Django 的Form 类
Form包含各种字段(Field),每个Field也是一个类,每个Field包含一个widget的类,用来控制html元素的展示个属性等.
Form
所有的Form都作为django.forms.Form 的子类创建
form.is_bound 返回当前表单是否已绑定数据
hidden_fields() visible_fields() 分别返回所有隐藏的列和可见的列
Widget 类
每个Field都会根据字段类型对应一个默认的类,也可以手动指定widget的值来更改默认widget类,如下
name=forms.CharField(label=‘名称‘max_length=200,widget=forms.TextInput(attrs={‘class‘:‘form-control‘}))
widget.attrs
html属性的一个字典 #{‘class‘: ‘form-control‘, ‘required‘: ‘required‘}
字段的数据
不管表单提交的是什么数据，一旦通过调用is_valid() 成功验证（is_valid() 返回True），验证后的表单数据将位于form.cleaned_data 字典中。这些数据已经为你转换好为Python 的类型。
注
此时，你依然可以从request.POST 中直接访问到未验证的数据，但是访问验证后的数据更好一些。
手动渲染字段
手动渲染时要加上non_field_errors这个错误信息.
{{ form.non_field_errors }}
<div class="fieldWrapper">
{{ form.subject.errors }}
<label for="{{ form.subject.id_for_label }}">Email subject:</label>
{{ form.subject }}</div>
field 中有用的属性
- {{ field.label }}
- 字段的label，例如Email address。
- {{ field.label_tag }}
- 包含在HTML <label> 标签中的字段Label。它包含表单的label_suffix。例如，默认的label_suffix 是一个冒号：
<label for="id_email">Email address:</label>
- {{ field.id_for_label }}
- 用于这个字段的ID（在上面的例子中是id_email）。如果你正在手工构造label，你可能想使用它代替label_tag。如果你有一些内嵌的JavaScript 并且想避免硬编码字段的ID，这也是有用的。
- {{ field.value }}
- 字段的值，例如[email protected]。
- {{ field.html_name }}
- 输入元素的name 属性中将使用的名称。它将考虑到表单的前缀。
- {{ field.help_text }}
- 与该字段关联的帮助文档。
- {{ field.errors }}
- 输出一个<ul class="errorlist">，包含这个字段的验证错误信息。你可以使用{% for error in field.errors %}自定义错误的显示。 这种情况下，循环中的每个对象只是一个包含错误信息的简单字符串。
- {{ field.is_hidden }}
- 如果字段是隐藏字段，则为True，否则为False。作为模板变量，它不是很有用处，但是可以用于条件测试，例如：
{% if field.is_hidden %}
{% endif %}
- {{ field.field }}
- 表单类中的Field 实例，通过BoundField 封装。你可以使用它来访问Field 属性，例如{% char_field.field.max_length %}。
时间： 2024-08-08 08:35:37