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

<divclass="fieldWrapper">{{form.subject.errors}}<labelfor="{{form.subject.id_for_label}}">Emailsubject:</label>{{form.subject}}</div>

field 中有用的属性


`field`.`get_XXX_display` #xx指字段名.

当定义的字段为关系字段,选择字段,bool等等,

django会自动生成一个get_xx_display的方法来生成这些字段的展示数据.

is_end_state = models.SmallIntegerField('是否', default=0,choices=[(0,'否'),(1,'是')])

is_end_state = models.SmallIntegerField('是否', default=0,choices=[(0,'否'),(1,'是')])

当字段类型为CharField时使用get_xx_display,获取到的值为本身,

直接打印出来为0或者1,使用get_xx_display打印出来则为定义字段时的则为是/否


{{field.label}}

字段的label，例如Emailaddress。

{{field.label_tag}}

包含在HTML<label>标签中的字段Label。它包含表单的label_suffix。例如，默认的label_suffix是一个冒号：

<labelfor="id_email">Emailaddress:</label>

{{field.id_for_label}}

用于这个字段的ID（在上面的例子中是id_email）。如果你正在手工构造label，你可能想使用它代替label_tag。如果你有一些内嵌的JavaScript 并且想避免硬编码字段的ID，这也是有用的。

{{field.value}}

字段的值，例如someone@example.com。

{{field.html_name}}

输入元素的name 属性中将使用的名称。它将考虑到表单的前缀。

{{field.help_text}}

与该字段关联的帮助文档。

{{field.errors}}

输出一个<ulclass="errorlist">，包含这个字段的验证错误信息。你可以使用{%forerrorinfield.errors%}自定义错误的显示。这种情况下，循环中的每个对象只是一个包含错误信息的简单字符串。

{{field.is_hidden}}

如果字段是隐藏字段，则为True，否则为False。作为模板变量，它不是很有用处，但是可以用于条件测试，例如：

{%iffield.is_hidden%}{%endif%}

{{field.field}}

表单类中的Field实例，通过BoundField封装。你可以使用它来访问Field属性，例如{%char_field.field.max_length%}。