django表单的Widgets使用详解
前言
不要将Widget与表单的fields字段混淆。表单字段负责验证输入并直接在模板中使用。而Widget负责渲染网页上HTML表单的输入元素和提取提交的原始数据。widget是字段的一个内在属性,用于定义字段在浏览器的页面里以何种HTML元素展现。
一、指定使用的widget
每个字段都有一个默认的widget类型。如果你想要使用一个不同的Widget,可以在定义字段时使用widget参数。像这样:
fromdjangoimportforms classCommentForm(forms.Form): name=forms.CharField() url=forms.URLField() comment=forms.CharField(widget=forms.Textarea)
这将使用一个TextareaWidget来展现表单的评论字段,而不是默认的TextInputWidget。
二、设置widget的参数
许多widget具有可选的额外参数,下面的示例中,设置了SelectDateWidget的years属性,注意参数的传递方法:
fromdjangoimportforms BIRTH_YEAR_CHOICES=('1980','1981','1982') FAVORITE_COLORS_CHOICES=( ('blue','Blue'), ('green','Green'), ('black','Black'), ) classSimpleForm(forms.Form): birth_year=forms.DateField(widget=forms.SelectDateWidget(years=BIRTH_YEAR_CHOICES)) favorite_colors=forms.MultipleChoiceField( required=False, widget=forms.CheckboxSelectMultiple, choices=FAVORITE_COLORS_CHOICES, )
三、为widget添加CSS样式
默认情况下,当Django渲染Widget为实际的HTML代码时,不会帮你添加任何的CSS样式,也就是说网页上所有的TextInput元素的外观是一样的。
看下面的表单:
fromdjangoimportforms classCommentForm(forms.Form): name=forms.CharField() url=forms.URLField() comment=forms.CharField()
这个表单包含三个默认的TextInputWidget,以默认的方式渲染,没有CSS类、没有额外的属性。每个Widget的输入框将渲染得一模一样,丑陋又单调:
>>>f=CommentForm(auto_id=False) >>>f.as_table()Name: Url: Comment:
在真正的网页中,你可ending不想让每个Widget看上去都一样。可能想要给comment一个更大的输入框,可能想让‘name'Widget具有一些特殊的CSS类。
可以在创建Widget时使用Widget.attrs参数来实现这一目的:
classCommentForm(forms.Form): name=forms.CharField(widget=forms.TextInput(attrs={'class':'special'})) url=forms.URLField() comment=forms.CharField(widget=forms.TextInput(attrs={'size':'40'}))
注意参数的传递方式!
这次渲染后的结果就不一样了:
>>>f=CommentForm(auto_id=False) >>>f.as_table()Name: Url: Comment:
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持毛票票。