form组件博客整理 一.背景 我们之前在HTML页面中利用form表单向后端提交数据时，都会写一些获取用户输入的标签并且用form标签把它们包起来。 与此同时我们在好多场景下都需要对用户的输入做校验，比如校验用户是否输入，输入的长度和格式等正不正确。如果用户输入的 内容有错误就需要在页面上相应的位置显示对应的错误信息。Django form组件就实现了上面所述的功能 form组件主要功能如下: 生成页面可用的HTML标签 对用户提交的数据进行校验 保留上次输入的内容 二. 注册功能(普通方式) views.py: def register(request): error_msg='' if request.method=='POST': username = request.POST.get("name") pwd = request.POST.get("pwd") # 对注册信息做校验 if len(username) < 6: error_msg = "用户名长度不能小于6位" else: #将用户名和密码存到数据库 return Httpresponse(' 注册成功') return render(request,'register.html',{'error_msg':error_msg}) login.html 注册页面 二.注册功能(form组件) views.py 写类: from django import forms class RegForm(forms.Form): name = forms.CharField(label="用户名") pwd = forms.CharField(label="密码") 视图函数: def register2(request): form_obj = RegForm() if request.method == "POST": # 实例化form对象的时候，把post提交过来的数据直接传进去 form_obj = RegForm(request.POST) # 调用form_obj校验数据的方法 if form_obj.is_valid(): return HttpResponse("注册成功") return render(request, "register2.html", {"form_obj": form_obj}) login.html: widget=None, 插件，默认select插件 label=None, Label内容 initial=None, 初始值 help_text='', 帮助提示 ModelChoiceField(ChoiceField) ... django.forms.models.ModelChoiceField queryset, # 查询数据库中的数据 empty_label="---------", # 默认空显示内容 to_field_name=None, # HTML中value的值对应的字段 limit_choices_to=None # ModelForm中对queryset二次筛选 ModelMultipleChoiceField(ModelChoiceField) ... django.forms.models.ModelMultipleChoiceField TypedChoiceField(ChoiceField) coerce = lambda val: val 对选中的值进行一次转换 empty_value= '' 空值的默认值 MultipleChoiceField(ChoiceField) ... TypedMultipleChoiceField(MultipleChoiceField) coerce = lambda val: val 对选中的每一个值进行一次转换 empty_value= '' 空值的默认值 ComboField(Field) fields=() 使用多个验证，如下：即验证最大长度20，又验证邮箱格式 fields.ComboField(fields=[fields.CharField(max_length=20), fields.EmailField(),]) MultiValueField(Field) PS: 抽象类，子类中可以实现聚合多个字典去匹配一个值，要配合MultiWidget使用 SplitDateTimeField(MultiValueField) input_date_formats=None, 格式列表：['%Y--%m--%d', '%m%d/%Y', '%m/%d/%y'] input_time_formats=None 格式列表：['%H:%M:%S', '%H:%M:%S.%f', '%H:%M'] FilePathField(ChoiceField) 文件选项，目录下文件显示在页面中 path, 文件夹路径 match=None, 正则匹配 recursive=False, 递归下面的文件夹 allow_files=True, 允许文件 allow_folders=False, 允许文件夹 required=True, widget=None, label=None, initial=None, help_text='' GenericIPAddressField protocol='both', both,ipv4,ipv6支持的IP格式 unpack_ipv4=False 解析ipv4地址，如果是::ffff:192.0.2.1时候，可解析为192.0.2.1， PS：protocol必须为both才能启用 SlugField(CharField) 数字，字母，下划线，减号（连字符） ... UUIDField(CharField) uuid类型 五.校验 方式一: from django.forms import Form from django.forms import widgets from django.forms import fields from django.core.validators import RegexValidator class MyForm(Form): user = fields.CharField( validators=[RegexValidator(r'^[0-9]+$', '请输入数字'), RegexValidator(r'^159[0-9]+$', '数字必须以159开头')], ) 方式二: import re from django.forms import Form from django.forms import widgets from django.forms import fields from django.core.exceptions import ValidationError # 自定义验证规则 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 PublishForm(Form): title = fields.CharField(max_length=20, min_length=5, error_messages={'required': '标题不能为空', 'min_length': '标题最少为5个字符', 'max_length': '标题最多为20个字符'}, widget=widgets.TextInput(attrs={'class': "form-control", 'placeholder': '标题5-20个字符'})) # 使用自定义验证规则 phone = fields.CharField(validators=[mobile_validate, ], error_messages={'required': '手机不能为空'}, widget=widgets.TextInput(attrs={'class': "form-control", 'placeholder': u'手机号码'})) email = fields.EmailField(required=False, error_messages={'required': u'邮箱不能为空','invalid': u'邮箱格式错误'}, widget=widgets.TextInput(attrs={'class': "form-control", 'placeholder': u'邮箱'})) 六.ModelForm 本质帮助开发者对用户请求中的数据进行格式校验 form与model的终极结合。 class BookForm(forms.ModelForm): class Meta: model = models.Book fields = "__all__" labels = { "title": "书名", "price": "价格" } widgets = { "password": forms.widgets.PasswordInput(attrs={"class": "c1"}), } class Meta:下常用参数： model = models.Student # 对应的Model中的类 fields = "__all__" # 字段，如果是__all__,就是表示列出所有的字段 exclude = None # 排除的字段 labels = None # 提示信息 help_texts = None # 帮助提示信息 widgets = None # 自定义插件 error_messages = None # 自定义错误信息 示例: class GoodsModelForm(forms.ModelForm): class Meta: model = models.Goods fields = "__all__" error_messages = { 'title':{'required':'商品名称不能为空'} } def __init__(self,*args,**kwargs): (重写__init__给每一个字段加上样式) super().__init__(*args,**kwargs) for name,field in self.fields.items(): field.widget.attrs['class'] = 'form-control' 七.ModelFormSet 本质帮助开发者对用户请求中的数据进行批量格式校验。 class GoodsModelForm(forms.ModelForm): class Meta: model = models.Goods fields = "__all__" error_messages = { 'title':{'required':'商品名称不能为空'} } def __init__(self,*args,**kwargs): (重写__init__给每一个字段加上样式) super().__init__(*args,**kwargs) for name,field in self.fields.items(): field.widget.attrs['class'] = 'form-control' 视图中: from django.forms.models import modelformset_factory GoodsModelFormSet = modelformset_factory(model=models.Goods,form=GoodsModelForm,extra=1) 生成一个类 if request.method == "GET": form_set = GoodsModelFormSet() get请求实例化对象 return render(request,'multi_goods_add.html',{'form_set':form_set}) form_set = GoodsModelFormSet(data=request.POST) post请求 实例化时将用户传递过来的信息传进去, if form_set.is_valid(): form_set.save() else: print('校验失败') return render(request, 'multi_goods_add.html', {'form_set': form_set}) html中: 一定要加 { { form_set.management_form }} 八.将下拉框变成radio选择框: class GoodsModelForm(forms.ModelForm):
class Meta: model = models.Goods fields = "__all__" error_messages = { 'title':{'required':'商品名称不能为空'} }widgets = {
'source':forms.RadioSelect() }def __init__(self,*args,**kwargs):
super().__init__(*args,**kwargs)for name,field in self.fields.items():
if name == 'source': # print(field,type(field)) # from django.forms.models import ModelChoiceField field.empty_label = None else: field.widget.attrs['class'] = 'form-control'