Django基础(9): 表单Forms的高级使用技巧
本文是Django基础(5): 表单forms的设计与使用的进阶篇。上文里我们介绍了如何设计表单(forms),如何使用表单及进行表单验证。这次我们将分享些Django表单的一些高级使用技巧。辛苦码字不易,欢迎转载点赞!
自定义字段属性和错误信息
对于每个字段你可以设置其是否为必需,最大长度和最小长度。你还可以针对每个属性自定义错误信息,见下面代码。
from django import forms class LoginForm(forms.Form): username = forms.CharField( required=True, max_length=20, min_length=6, error_messages={ 'required': '用户名不能为空', 'max_length': '用户名长度不得超过20个字符', 'min_length': '用户名长度不得少于6个字符', } ) password = forms.CharField( required=True, max_length=20, min_length=6, error_messages={ 'required': '密码不能为空', 'max_length': '密码长度不得超过20个字符', 'min_length': '密码长度不得少于6个字符', } )
对于基继承ModelForm类的表单, 我们可以在Meta选项下widget中来自定义错误信息,如下面代码所示:
from django.forms import ModelForm, Textarea from myapp.models import Author class AuthorForm(ModelForm): class Meta: model = Author fields = ('name', 'title', 'birth_date') widgets = { 'name': Textarea(attrs={'cols': 80, 'rows': 20}), # 关键是这一行 } labels = { 'name': _('Author'), } help_texts = { 'name': _('Some useful help text.'), } error_messages = { 'name': { 'max_length': _("This writer's name is too long."), }, }
自定义表单输入的widget和css属性
Django forms的每个字段你都可以选择你喜欢的输入widget,比如多选,复选框。你还可以定义每个widget的css属性。如果你不指定,Django会使用默认的widget,有时比较丑。
比如下面这段代码定义了表单姓名字段的输入控件为Textarea,还指定了其样式css。
from django import forms class ContactForm(forms.Form): name = forms.CharField( max_length=255, widget=forms.Textarea( attrs={'class': 'custom'}, ), )
设置widget可以是你的表单大大美化,方便用户选择输入。比如下面案例里对年份使用了SelectDateWidget,颜色则使用了复选框CheckboxSelectMultiple。单选可以用RadioSelect和Select。常见文本输入可以用TextInput和TextArea。
from django import forms BIRTH_YEAR_CHOICES = ('1980', '1981', '1982') COLORS_CHOICES = ( ('blue', 'Blue'), ('green', 'Green'), ('black', 'Black'), ) class SimpleForm(forms.Form): birth_year = forms.DateField(widget=forms.SelectDateWidget(years=BIRTH_YEAR_CHOICES)) favorite_colors = forms.MultipleChoiceField( required=False, widget=forms.CheckboxSelectMultiple, choices=COLORS_CHOICES, )
表单数据初始化和实例化
有时我们需要对表单设置一些初始数据,我们可以通过initial方法,如下所示。
form = ContactForm( initial={ 'name': 'First and Last Name', },)
其编辑修改类应用场景中,我们还要给表单提供现有对象的数据,而不是渲染一张空表单。这个过程叫表单与数据的结合。
对于由继承ModelForm类的表单,我们可以按如下方法对表单进行实例化,如下面代码所示:
contact = Contact.objects.get(id=1) form = ContactForm(instance = contact)
对于自定义的表单,可以设置default_data。对于用户提交的数据,括号里可以使用request.POST。
default_data = {'name': 'John', 'email': '[email protected]', } form = ContactForm(default_data)
自定义表单验证validators
对于表单验证除了通过clean方法自定义验证外,你还可以选择自定义validators。例如下面案例中,如果用户输入的手机号不符合要求,表单就会返回手机号码格式错误的验证信息。
from django.core.exceptions import ValidationError import re def mobile_validate(value): mobile_re = re.compile(r'^(13[0-9]|15[012356789]|17[678]|18[0-9]|14[57])[0-9]{8}$') if not mobile_re.match(value): raise ValidationError('手机号码格式错误') class UserInfo(forms.Form): email = forms.EmailField(error_messages={'required': u'邮箱不能为空'},) mobile = forms.CharField(validators=[mobile_validate, ], error_messages={'required': u'手机不能为空'}, widget=forms.TextInput(attrs={'class': "form-control", 'placeholder': u'手机号码'}),)
一个页面同时提交2张或多张表单
很多情况下我们希望用户在同一页面上点击一个按钮能同时提交2张或多张表单,这时我们可以在模板中给每个表单取不同的名字,如form1和form2(如下面代码所示)。注: form1和form2分别对应forms.py里的Form1()和Form2()。
<form > {{ form1.as_p }} {{ form2.as_p }} </form>
然后用户点击提交后,我们就可以在视图里了对用户提交的数据进行分别处理了,如下面代码所示。
if request.method == 'POST': form1 = Form1( request.POST,prefix="form1") form2 = Form2( request.POST,prefix="form2") if form1.is_valid() or form2.is_valid(): pass else: form1 = Form1(prefix="form1") form2 = Form2(prefix="form2")