djano之form表单的使用
作者：互联网
一、使用说明
1. 创建一个forms.py的文件,放在指定的app当中,然后在里面写表单.
2. 表单是通过类实现的,继承自forms.Form,然后在里面定义要验证的字段.
3. 在表单中,创建字段跟模型是一模一样的,但是没有null=True或者blank=True等这几种参数了,有的参数是required=True/False.
4. 使用is_valid()方法可以验证用户提交的数据是否合法,而且HTML表单元素的name必须和django中的表单的name保持一致,否则匹配不到.
5. is_bound属性:用来表示form是否绑定了数据,如果绑定了,则返回True,否则返回False.
6. cleaned_data:这个是在is_valid()返回True的时候,保存用户提交上来的数据.
二、表单说明
示例代码：
from django import forms
class LoginForm(forms.Form):
username = forms.CharField(max_length=16, min_length=8, strip=True, error_messages={
"max_length": "用户名长度超过16位",
"min_length": "用户名长度小于8位",
"required": "用户名不能为空"
})
password = forms.CharField(strip=True, error_messages={
"required": "密码不能为空"
})
forms模块中的字段样式：
__all__ = (
'Field', 'CharField', 'IntegerField',
'DateField', 'TimeField', 'DateTimeField', 'DurationField',
'RegexField', 'EmailField', 'FileField', 'ImageField', 'URLField',
'BooleanField', 'NullBooleanField', 'ChoiceField', 'MultipleChoiceField',
'ComboField', 'MultiValueField', 'FloatField', 'DecimalField',
'SplitDateTimeField', 'GenericIPAddressField', 'FilePathField',
'SlugField', 'TypedChoiceField', 'TypedMultipleChoiceField', 'UUIDField',
)
forms模块中用于验证的字段参数：
Field
required=True#请求不能为空
widget=None#HTML插件
label=None#用于生成lable标签或显示内容
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类型
...
自定义错误信息：
在字段参数中有一个error_messages的参数，其值是一个字典，键表示不符合的字段验证名，值表示自定义的错误信息
from django import forms
class LoginForm(forms.Form):
username = forms.CharField(max_length=16, min_length=8, strip=True, error_messages={
"max_length": "用户名长度超过16位",
"min_length": "用户名长度小于8位",
"required": "用户名不能为空"
})
password = forms.CharField(strip=True, error_messages={
"required": "密码不能为空"
})
三、使用表单
注:虽然form可以生成前端页面,但这个功能实际用的少,主要是是用form表单的验证功能.
from .forms import RegisterFrom
from .models import User
def register(request):
if request.method == 'GET':
form = RegisterFrom()
return render(request,'ts22/register.html',
context={'form':form})
elif request.method == 'POST':
form = RegisterFrom(request.POST)
if form.is_valid():
username = form.cleaned_data.get('username')
password = form.cleaned_data.get('password')
password_repeat = form.cleaned_data.get('password_repeat')
email = form.cleaned_data.get('email')
if password == password_repeat:
user = User.objects.create(username=username, password=password,email=email)
return HttpResponse('注册成功!')
else:
return HttpResponse('注册失败!')
else:
return HttpResponse('注册失败!')
# Create your views here.
class LoginView(views.View):
def get(self, request):
return render(self.request, 'user/login.html')
def post(self, request):
# 将提交的参数传进表单中，逐一比较验证
form = LoginForm(request.POST)
print(request.POST)
print(form)
# 表单验证通过
if form.is_valid():
username = form.cleaned_data.get("username")
password = form.changed_data.get("password")
user_info = User.objects.filter(username=username).first()
if user_info.get("username", None) and (user_info.get("password") == password):
return HttpResponse("登陆成功！")
else:
return HttpResponse("用户名不存在！")
# 表单验证失败，获取失败的信息进行处理
else:
# <tr><th><label for="id_username">Username:</label></th><td><ul class="errorlist"><li>用户名长度小于8位</li></ul><input type="text" name="username" value="admin" maxlength="16" minlength="8" required id="id_username"></td></tr>
# <tr><th><label for="id_password">Password:</label></th><td><input type="text" name="password" value="asd2743075" required id="id_password"></td></tr>
# <ul class="errorlist"><li>username<ul class="errorlist"><li>用户名长度小于8位</li></ul></li></ul>
print(form.errors)
# {'username': [ValidationError(['用户名长度小于8位'])]}
print(form.errors.as_data())
# {"username": [{"message": "\u7528\u6237\u540d\u957f\u5ea6\u5c0f\u4e8e8\u4f4d", "code": "min_length"}]}
print(form.errors.as_json())
return HttpResponse(form.errors.as_json())
四、参考：https://www.liujiangblog.com/course/django/153
标签：username,None,form,表单,forms,length,djano,True 来源： https://www.cnblogs.com/loveprogramme/p/12457254.html