Django之Form组件与ModelForm
Django的Form主要具有一下几大功能：
- 生成HTML标签
- 验证用户数据（显示错误信息）
- HTML Form提交保留上次提交数据
- 初始化页面显示内容
示例：
from django import forms from django.forms import fields class f1(forms.Form): user = fields.CharField( max_length=18, min_length=6, required=True, error_messages={ # 自定义错误提示 'required':'用户名不能为空', 'max_length':'太长了', 'min_length':'太短了', } ) pwd = fields.CharField( min_length=8, required=True, error_messages={ # 自定义错误提示 'required': '用户名不能为空', 'min_length': '太短了', } ) age = fields.IntegerField( required=True, error_messages={ 'required': '年龄不能为空', 'invalid': '格式错误,必须为数字', } ) email = fields.EmailField( required=True, min_length=8, error_messages={ 'required': '邮箱不能为空', 'invalid': '邮箱格式错误', } )
from django.shortcuts import render,HttpResponse,redirect ef form1(request): if request.method == "GET": obj = f1() return render(request,'form1.html',{'obj':obj}) else: obj = f1(request.POST) # 把form表单上的数据传过去 if obj.is_valid():# is_valid()判断是否验证成功了 # 已经验证过的用户提交的数据 # print(obj.cleaned_data) return redirect('/form1.html/') else: print('验证失败',obj.errors) # 错误信息 return render(request,'form1.html',{'obj':obj})
<form action="/form1.html/" method="POST"> <p>姓名：{{ obj.user }}{{ obj.errors.user.0 }}</p> <p>密码：{{ obj.pwd }}{{ obj.errors.pwd.0 }}</p> <p>年龄：{{ obj.age }}{{ obj.errors.age.0 }}</p> <p>邮箱：{{ obj.email }}{{ obj.errors.email.0 }}</p> <p><input type="submit" value="提交"></p> </form>
Form类
创建Form类时，主要涉及到 【字段】 和 【插件】，字段用于对用户请求数据的验证，插件用于自动生成HTML;
1、Django内置字段
Field required=True, 是否允许为空 widget=None, HTML插件 label=None, 用于生成Label标签或显示内容 initial=None, 初始值 help_text='', 帮助信息(在标签旁边显示) error_messages=None, 错误信息 {'required': '不能为空', 'invalid': '格式错误'} show_hidden_initial=False, 是否在当前插件后面再加一个隐藏的且具有默认值的插件（可用于检验两次输入是否一直） validators=[], 自定义验证规则 localize=False, 是否支持本地化 disabled=False, 是否可以编辑 label_suffix=None Label内容后缀 CharField(Field) max_length=None, 最大长度 min_length=None, 最小长度 strip=True 是否移除用户输入空白 IntegerField(Field) max_value=None, 最大值 min_value=None, 最小值 FloatField(IntegerField) ... DecimalField(IntegerField) max_value=None, 最大值 min_value=None, 最小值 max_digits=None, 总长度 decimal_places=None, 小数位长度 BaseTemporalField(Field) input_formats=None 时间格式化 DateField(BaseTemporalField) 格式：2015-09-01 TimeField(BaseTemporalField) 格式：11:12 DateTimeField(BaseTemporalField)格式：2015-09-01 11:12 DurationField(Field) 时间间隔：%d %H:%M:%S.%f ... RegexField(CharField) regex, 自定制正则表达式 max_length=None, 最大长度 min_length=None, 最小长度 error_message=None, 忽略，错误信息使用 error_messages={'invalid': '...'} EmailField(CharField) ... FileField(Field) allow_empty_file=False 是否允许空文件 ImageField(FileField) ... 注：需要PIL模块，pip3 install Pillow 以上两个字典使用时，需要注意两点： - form表单中 enctype="multipart/form-data" - view函数中 obj = MyForm(request.POST, request.FILES) URLField(Field) ... BooleanField(Field) ... NullBooleanField(BooleanField) ... ChoiceField(Field) ... choices=(), 选项，如：choices = ((0,'上海'),(1,'北京'),) required=True, 是否必填 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类型 ...
UUID是根据MAC以及当前时间等创建的不重复的随机字符串
2、Django内置插件：
TextInput(Input)
NumberInput(TextInput)
EmailInput(TextInput)
URLInput(TextInput)
PasswordInput(TextInput)
HiddenInput(TextInput)
Textarea(Widget)
DateInput(DateTimeBaseInput)
DateTimeInput(DateTimeBaseInput)
TimeInput(DateTimeBaseInput)
CheckboxInput
Select
NullBooleanSelect
SelectMultiple
RadioSelect
CheckboxSelectMultiple
FileInput
ClearableFileInput
MultipleHiddenInput
SplitDateTimeWidget
SplitHiddenDateTimeWidget
SelectDateWidget
常用选择插件
# 单radio，值为字符串 user = fields.CharField( initial=2, widget=widgets.RadioSelect(choices=((1,'上海'),(2,'北京'),)) ) # 单radio，值为字符串 user = fields.ChoiceField( choices=((1, '上海'), (2, '北京'),), initial=2, widget=widgets.RadioSelect ) # 单select，值为字符串 user = fields.CharField( initial=2, widget=widgets.Select(choices=((1,'上海'),(2,'北京'),)) ) # 单select，值为字符串 user = fields.ChoiceField( choices=((1, '上海'), (2, '北京'),), initial=2, widget=widgets.Select ) # 多选select，值为列表 user = fields.MultipleChoiceField( choices=((1,'上海'),(2,'北京'),), initial=[1,], widget=widgets.SelectMultiple ) # 单checkbox user = fields.CharField( widget=widgets.CheckboxInput() ) # 多选checkbox,值为列表 user = fields.MultipleChoiceField( initial=[2, ], choices=((1, '上海'), (2, '北京'),), widget=widgets.CheckboxSelectMultiple )
动态数据绑定
在使用选择标签时，需要注意choices的选项可以从数据库中获取，但是由于是静态字段 获取的值无法实时更新 ，那么需要自定义构造方法从而达到此目的。
方式一：推荐
from django import forms from django.forms import fields from django.forms import widgets from app01 import models class MyForm(forms.Form): price = fields.IntegerField() user_id = fields.IntegerField(
# widget = widgets.Select(choices=[(0,'老王'),(1,'小刘'),(2,'小李')]) 原始方法 # 动态绑定数据 数据库操作不写all()默认拿所有数据 # widget=widgets.Select(choices=models.UserInfo.objects.values_list('id','username')) widget = widgets.Select() # 新方法，通过__init__方法来实现动态更新数据 ) def __init__(self,*args,**kwargs): super().__init__(*args,*kwargs) # 当页面刷新一次，就要创建一次MyForm对象，执行__init__方法，就会重新从数据库拿数据 self.fields['user_id'].widget.choices = models.UserInfo.objects.values_list('id','username')
方式二：依赖models中的__str__方法
from django import forms from django.forms import fields from django.forms import widgets from app01 import models from django.forms.models import ModelChoiceField class MyForm(forms.Form): price = fields.IntegerField() user_id2 = ModelChoiceField( queryset=models.UserInfo.objects.all(), to_field_name='id', # 要以哪一列作为html中相应选择项的value值 ) # 但在html中显示的不是数据库中的值，而且一个一个的对象，要去models.py文件中写__str__方法，来返回要显示的值 class UserInfo(models.Model): username = models.CharField(max_length=32) email = models.EmailField(max_length=32) def __str__(self): return self.username
自定义验证规则
from django.forms import Form from django.forms import widgets from django.forms import fields from django.core.exceptions import ValidationError class MyForm(Form): user = fields.CharField( validators=[RegexValidator(r'^[0-9]+$', '请输入数字'), RegexValidator(r'^159[0-9]+$', '数字必须以159开头')], )
初始化数据
from django import forms from django.forms import fields class UserForm(forms.Form): id = fields.CharField() username = fields.CharField() email = fields.EmailField()
from django.shortcuts import render,redirect from app01 import models # Create your views here. from django import forms from django.forms import fields class UserForm(forms.Form): id = fields.CharField() username = fields.CharField() email = fields.EmailField() def user(request): user_list = models.UserInfo.objects.all() return render(request,'user.html',{'user_list':user_list}) def add_user(request): if request.method == 'GET': obj = UserForm() return render(request,'add_user.html',{'obj':obj}) else: obj = UserForm(request.POST) # 把数据从form表单拿来传入，去进行表单数据验证 if obj.is_valid(): # 判断是否验证通过 print(obj.cleaned_data) # 验证通过 # models.UserInfo.objects.create( # username=obj.cleaned_data['user'], # email=obj.cleaned_data['email'] # ) models.UserInfo.objects.create(**obj.cleaned_data) return redirect('/user/') else: return render(request, 'add_user.html', {'obj': obj}) def edit_user(request): if request.method == 'GET': nid = request.GET.get('nid') # 获取这条数据的id data = models.UserInfo.objects.filter(id=nid).first() obj = UserForm({'id':data.id,'username':data.username,'email':data.email}) # 把该字段上默认显示的值通过字典传过去，编辑时就会显示该字段原先默认的值 return render(request,'edit_user.html',{'obj':obj}) else: obj = UserForm(request.POST) if obj.is_valid(): models.UserInfo.objects.filter(id=request.POST.get('id')).update(**obj.cleaned_data) return redirect('/user/') else: return render(request, 'edit_user.html', {'obj': obj})
<body> <form method="post" action="/edit_user/" novalidate> {# novalidate 属性规定当提交表单时不对其进行验证。 #} {% csrf_token %} <p style="display: none">id:{{ obj.id }}</p> <p>用户名：{{ obj.username }}{{ obj.errors.username.0 }}</p> <p>邮箱：{{ obj.email }}{{ obj.errors.email.0 }}</p> <input type="submit" value="提交"> </form> </body> </html>
<form action="/add_user/" method="post" novalidate> {# novalidate 属性规定当提交表单时不对其进行验证。 #} {% csrf_token %} <p>用户名：{{ obj.username }}{{ obj.errors.username.0 }}</p> <p>邮箱：{{ obj.email }}{{ obj.errors.email.0 }}</p> <input type="submit" value="提交"> </form> </body>
参考https://www.cnblogs.com/wupeiqi/articles/6144178.html
扩展扩展：ModelForm
在使用Model和Form时，都需要对字段进行定义并指定类型，通过ModelForm则可以省去From中字段的定义
from django.forms import ModelForm
class AdminModelForm(forms.ModelForm): class Meta: model = models.Admin #与表关联 #fields = '__all__' #显示所有字段 fields = ['username', 'email'] # 显示指定的字段 widgets = { 'email' : forms.PasswordInput(attrs={'class':"alex"}), }
class CustomerForm(ModelForm): class Meta: model = models.CustomerInfo # 与表关联 # fields = ['name','consultant','status',] # 显示的字段 fields = '__all__' # 显示所有字段 def __new__(cls, *args, **kwargs): # 执行__init__之前会先执行__new__ print('__new__',cls,args,kwargs) for field_name in cls.base_fields: field_obj = cls.base_fields[field_name] field_obj.widget.attrs.update({'class':'form-control'}) # 给每个字段加上属性 return ModelForm.__new__(cls)
