一、Django 中的form组件实现了如下的功能
1、生成页面可用的HTML标签
2、对用户提交的数据进行校验
3、保留上次输入内容(回显)
二、使用form组件步骤
1、导入form组件:from django import forms
2、编写类继承form.Forms
3、创建对象
4、生成页面
{{xx.as_p}}、{{xx.as_ul}}、{{xx.as_table}}
三、后端代码如下
1、导入的模块与创建类对象
from django.shortcuts import render,HttpResponse
from django import forms #导入form组件
from django.core.validators import ValidationError #自定义error类
from django.core.validators import RegexValidator #正则检验类
from django.forms import widgets # 设置显示样式模块(可以传css,如,attrs={'class':'phone'})
class Django_form(forms.Form): #创建form组件类
username = forms.CharField(
label='用户名',
required=True, #代表后端校验
min_length=3, #最少3个数
error_messages={
'required':'用户名必填!!!',
'min_length':'用户名至少3位???'
} #重写上面检验抛出的error内容
)
password = forms.CharField(
label='密码',
required=True,
min_length=6,
error_messages={
'required':'密码必填??',
'min_length':'密码至少6位'
},
#实现输入异常后依然密码回显的功能(wedgets)模块
widget=widgets.PasswordInput(render_value=True)
)
phone = forms.CharField(
label='手机号码',
required=True,
error_messages={
'required':'手机号不能为空!!!'
},
#自定义校验(正则校验)
validators=[
RegexValidator(r'^\d+$','必须是数字'),
RegexValidator(r'^1[356789]\d{9}$','手机号格式不正确')
],
#设置(自定义)显示样式
widget = widgets.TextInput(attrs={'class':'phone'})
)
#重写clearn方法
def clean(self):
data = self.cleaned_data
username = data.get('username')
if username !=None:
if username.find('sb')!=-1:
error = ValidationError('要符合社会主义价值观')
self.add_error('username',error)
raise error
return self.cleaned_data
2、登录视图函数
def login(request):
forms_obj = Django_form() #创建forms组件对象
if request.method=='POST':
forms_obj = Django_form(request.POST)
print(forms_obj)
if forms_obj.is_valid():
data = forms_obj.cleaned_data
username = data.get('username')
pwd = data.get('password')
print(username,pwd)
return HttpResponse('okkkk')
#get请求
return render(request,'app01/login.html',locals())
四、HTML代码
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
</head>
<style>
.phone{
color: red;
}
</style>
<body>
<form action="" method="post" novalidate>
{% csrf_token %}
{{ forms_obj.username.label }}:{{ forms_obj.username }}{{ forms_obj.username.errors.0 }}<br/>
{{ forms_obj.password.label }} :{{ forms_obj.password }}{{ forms_obj.password.errors.0 }}<br/><br/>
{{ forms_obj.phone.label }} :{{ forms_obj.phone }}{{ forms_obj.phone.errors.0 }}<br/><br/>
<input type="submit" value="提交">
</form>
</body>
</html>
```
五、Django Form 所有内置字段
Field
required=True, 是否允许为空
widget=None, HTML插件
label=None, 用于生成Label标签或显示内容
initial=None, 初始值
help_text='', 帮助信息(在标签旁边显示)
error_messages=None, 错误信息 {'required': '不能为空', 'invalid': '格式错误'}
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类型
Django Form内置字段