【Django】Form组件
@
目录
Form组件介绍
在HTML页面中利用form表单向后端提交数据时，都会写一些获取用户输入的标签并且用form标签把它们包起来。
与此同时我们在好多场景下都需要对用户的输入做校验，比如校验用户是否输入，输入的长度和格式等正不正确。如果用户输入的内容有错误就需要在页面上相应的位置显示对应的错误信息。
Django form组件就实现了上面的功能。
先总结一下，form组件的主要功能如下：
- 生成页面可用的HTML标签
- 对用户提交的数据进行校验
- 保留上传输入的内容
一个简单的注册示例
form文件：
from django import forms
# 按照Django form组件的要求自己写一个类
# 且必须继承forms.Form
class RegForm(forms.Form):
user = forms.CharField(label="名称")
pwd = forms.CharField(label="密码", min_length=6)
视图文件：
from django.shortcuts import render, HttpResponse
from blog01 import forms # 导入上面的form文件
def register(request):
form_obj = forms.RegForm()
if request.method == 'POST':
form_obj = forms.RegForm(request.POST)
if form_obj.is_valid():
# 只有执行了is_valid之后，才可执行cleaned_data，否则会报错
# cleaned_data的数据是经过校验的
print(form_obj.cleaned_data)
return HttpResponse("注册成功!")
return render(request, 'register.html', {'form': form_obj})
HTML文件：
<body>
{# novalidate:阻止验证（form组件会自动验证）#}
<form action="" method="post" novalidate>
{% csrf_token %}
{# {{ form.as_p }} 以p标签的形式自动生成 #}
{# 下面为简单的自定义形式 #}
<p>
{{ form.user.label }}
{{ form.user }}
{# 错误提示信息 #}
{# {{ form.errors }} 生成form表单的所有错误信息（全局错误信息）#}
{# <span style="color: red">{{ form.user.errors }}</span> 指定字段的所有错误信息 #}
<span style="color: red">{{ form.user.errors.0 }}</span> {# 指定字段的所有错误信息的第一个 #}
</p>
<p>
{{ form.pwd.label }}
{{ form.pwd }}
<span style="color: red">{{ form.pwd.errors.0 }}</span>
</p>
<button>注册</button>
</form>
</body>
常用字段与插件
from django import forms
class RegForm(forms.Form):
user = forms.CharField(
label="名称", # 用于生成label标签或显示内容
# required=False, # 为False时，允许为空
min_length=2, # 最小长度
max_length=6, # 最大长度
initial='zyk01', # 初始值
error_messages={
'required': "用户名不能为空",
'invalid': "用户名格式错误",
'min_length': "用户名最短2位",
} # 自定义错误提示
)
pwd = forms.CharField(
label="密码",
min_length=6,
error_messages={
'required': "密码不能为空",
'invalid': "密码格式错误",
'min_length': "密码最短6位",
},
widget=forms.widgets.PasswordInput(), # 指定input的type类型为password
)
# ===================================================
#
# ===================================================
"""checkbox标签（单选）"""
keep = forms.fields.ChoiceField(
label="记住密码",
initial='checked', # 默认选中
widget=forms.widgets.CheckboxInput(),
)
"""checkbox标签（多选）"""
hobby01 = forms.fields.MultipleChoiceField(
label="爱好01",
choices=((1, "篮球"), (2, "足球"), (3, "乒乓球"),),
initial=[1, 2], # 默认选中1, 2
widget=forms.widgets.CheckboxSelectMultiple(),
)
"""radioSelect（等价于<input type="radio">）"""
gender = forms.fields.ChoiceField(
label="性别",
choices=((1, "男"), (2, "女"), (3, "阴阳人"),),
initial=1, # 默认选中1
widget=forms.widgets.RadioSelect(),
)
"""Select标签"""
hobby02 = forms.fields.ChoiceField(
choices=((1, "篮球"), (2, "足球"), (3, "双色球"),),
label="爱好02",
initial=3, # # 默认选中3
# widget=forms.widgets.Select(), # 实现单选Select
widget=forms.widgets.SelectMultiple(), # 实现多选Select
)
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类型
从数据库中获取数据
在使用选择标签时，需要注意choices的选项可以从数据库中获取，但由于是静态字段，获取的值无法实施更新，所以需要自定义构造方法从而达到此目的.
from django import forms
from blog01 import models
class RegForm(forms.Form):
hobby03 = forms.fields.ChoiceField(
label="爱好03",
# choices=models.Hobby.objects.values_list('id', 'name'),
widget=forms.widgets.CheckboxSelectMultiple(),
)
def __init__(self, *args, **kwargs):
super(RegForm, self).__init__(*args, **kwargs)
# self.fields['hobby03'].choices = ((1, 'Python'), (2, 'Django'),)
self.fields['hobby03'].choices = models.Hobby.objects.values_list('id','name')
校验示例
检验手机号是否合法
视图文件：
from django.shortcuts import render, HttpResponse
from blog01 import forms # 导入form文件
def register(request):
form_obj = forms.RegForm()
if request.method == 'POST':
form_obj = forms.RegForm(request.POST)
if form_obj.is_valid():
# 只有执行了is_valid之后，才可执行cleaned_data，否则会报错
# cleaned_data的数据是经过校验的
print(form_obj.cleaned_data)
return HttpResponse("注册成功!")
return render(request, 'register.html', {'form': form_obj})
HTML文件：
<body>
{# novalidate:阻止验证（form组件会自动验证）#}
<form action="" method="post" novalidate>
{% csrf_token %}
<p>
{{ form.phone.label }}
{{ form.phone }}
<span style="color: red">{{ form.phone.errors.0 }}</span>
</p>
<button>注册</button>
</form>
</body>
方式一（基本操作）
form文件：
from django import forms
from django.core.validators import RegexValidator
class RegForm(forms.Form):
phone = forms.fields.CharField(
label="手机号",
validators=[
RegexValidator(r'^1[3-9]\d{9}$', "号码不合法")
# RegexValidator(r"正则表达式", "错误提示信息")
],
)
方式二（自定义验证规则）
form文件：
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 RegForm(Form):
phone = fields.CharField(
label="手机号",
# 使用自定义验证规则
# validators=[校验器函数1, 校验器函数2]
validators=[mobile_validate, ],
error_messages={'required': "手机号不能为空", },
widget=widgets.TextInput(
attrs={'class': 'form-control', 'placeholder': u"手机号码"},
)
)
方式三（利用钩子）
forms文件：
import re
from django.forms import Form
from django.forms import widgets
from django.core.exceptions import ValidationError
class RegForm(Form):
phone = forms.fields.CharField(
label="手机号",
error_messages={'required': "手机号不能为空", },
widget=widgets.TextInput(
attrs={'class': 'form-control', 'placeholder': u"手机号码"},
)
)
def clean_phone(self):
value = self.cleaned_data.get('phone')
mobile_re = re.compile(r'^(13[0-9]|15[012356789]|17[678]|18[0-9]|14[57])[0-9]{8}$')
if mobile_re.match(value):
return value
raise ValidationError("手机号不合法")
验证密码一致性
视图文件同上⬆️
form文件：
from django.forms import Form
from django.core.validators import RegexValidator
class RegForm(Form):
pwd = forms.CharField(
label="密码",
min_length=6,
widget=widgets.PasswordInput(),
)
re_pwd = forms.CharField(
label="确认密码",
min_length=6,
widget=widgets.PasswordInput(),
)
def clean_re_pwd(self):
pwd = self.cleaned_data.get('pwd')
re_pwd = self.cleaned_data.get('re_pwd')
if pwd == re_pwd:
return re_pwd
raise ValidationError("密码不一致")
HTML文件：
<body>
{# novalidate:阻止验证（form组件会自动验证）#}
<form action="" method="post" novalidate>
{% csrf_token %}
{# {{ form.as_p }} 以p标签的形式自动生成 #}
<p>
{{ form.pwd.label }}
{{ form.pwd }}
<span style="color: red">{{ form.pwd.errors.0 }}</span>
</p>
<p>
{{ form.re_pwd.label }}
{{ form.re_pwd }}
<span style="color: red">{{ form.re_pwd.errors.0 }}</span>
</p>
<button>注册</button>
</form>
</body>
钩子
局部钩子
from django.forms import Form
class RegForm(Form):
test01 = forms.CharField()
test02 = forms.CharField()
test03 = forms.CharField()
# 局部钩子
def clean_test02(self):
test01 = self.cleaned_data.get('test01')
test02 = self.cleaned_data.get('test02')
test03 = self.cleaned_data.get('test03')
print(test01, test02, test03) # test03的值定会为None
return test02
"""
这里定义的是test02的钩子
! 定义哪个字段的钩子，就得返回哪个字段的值
此时的钩子只能获取test01与test02的值，而test03的值为None
因为test03字段在test02字段的下面，所以test02的钩子无法获取test03的值（更多可看源码）
"""
全局钩子
from django.forms import Form
class RegForm(Form):
test01 = forms.CharField()
test02 = forms.CharField()
test03 = forms.CharField()
# 全局钩子
def clean(self):
test01 = self.cleaned_data.get('test01')
test02 = self.cleaned_data.get('test02')
test03 = self.cleaned_data.get('test03')
print(test01, test02, test03)
return self.cleaned_data
"""
这里定义的是全局钩子
! 定义全局钩子, 要返回self.cleaned_data的数据
此时的钩子可以获取所有字段的值
"""
进阶
批量添加样式
通过重写form类的init方法来实现.
from django.forms import Form
class RegForm(Form):
test01 = forms.CharField()
test02 = forms.CharField()
test03 = forms.CharField()
def __init__(self, *args, **kwargs):
super(RegForm, self).__init__(*args, **kwargs)
for field in iter(self.fields):
self.fields[field].widget.attrs.update(
{
'class': 'form-control',
'placeholder': "test",
}
)
ModelForm
form 与 model 的终结结合
结合后将使用数据库字段的规则
from django import forms
class BookForm(forms.ModelForm):
class Meta:
model = models.Hobby
fields = '__all__'
labels = {
'name': "爱好",
}
widgets = {
'password': forms.widgets.PasswordInput(
# attrs={}
)
}
"""
class Meta常见参数如下：
model = models.Student # 对应的Model中的类
fields = "__all__" # 字段，如果是__all__,就是表示列出所有的字段；如果是列表, 则只使用列表内的字段
exclude = [] # 排除的字段
labels = None # 提示信息
help_texts = None # 帮助提示信息
widgets = None # 自定义插件
error_messages = None # 自定义错误信息
"""
Form套Form
视图文件：
# 生成每行可编辑的form套form的表单
from django.forms import modelformset_factory
def study_record(request, course_id):
FormSet = modelformset_factory(models.StudyRecord, StudyRecordForm, extra=0)
# 会自动在表单下面多生成一个form > extra=0:不生成
queryset = models.StudyRecord.objects.filter(course_record_id=course_id)
form_set = FormSet(queryset=queryset)
return render(request, 'crm/sutdy_record_list.html', {'form_set': form_set})
HTML文件：
{% for form in form_set %}
<tr>
{{ form.id }}
<td style="display: none">{{ form.student }}</td>
{# style="display: none" 可禁用编辑#}
<td>{{ forloop.counter }}</td>
<td>{{ form.instance.student.name }}</td>
<td>{{ form.attendance }}</td>
<td>{{ form.score }}</td>
<td>{{ form.homework_note }}</td>
</tr>
{% endfor %}
【Django】Form组件的更多相关文章
- django Form组件
django Form组件 Django的Form主要具有一下几大功能: 生成HTML标签 验证用户数据(显示错误信息) HTML Form提交保留上次提交数据 初始化页面显示内容 小试牛刀 1.创建 ...
- 9.24 Django Form组件
2018-9-23 20:10:04 这两天优化了自己图书管理系统 github 连接:https://github.com/TrueNewBee/pythonDemo 顺便整理了博客,写了好多总结, ...
- Django—Form组件
Django From简介 我们之前在HTML页面中利用form表单向后端提交数据时,都会写一些获取用户输入的标签并且用form标签把它们包起来. 与此同时我们在好多场景下都需要对用户的输入做校验,比 ...
- django form组件 cookies,session
django form组件 渲染标签 就是组件里面的字段在前端展示叫做渲染标签 校验数据 用户输入的数据提交给后端组件叫做校验数据 forms组件中定义的字段都是必须传值的(required=Tr ...
- 6月28日 Django form组件 和 modelform组件
Form介绍 我们之前在HTML页面中利用form表单向后端提交数据时,都会写一些获取用户输入的标签并且用form标签把它们包起来. 与此同时我们在好多场景下都需要对用户的输入做校验,比如校验用户是否 ...
- Python Web框架篇：Django Form组件
Form简介 在HTTP中,表单(form标签),是用来提交数据的,其action属性说明了其传输数据的方法:如何传.如何接收. 访问网站时,表单可以实现客户端与服务器之间的通信.例如查询,就用到了表 ...
- Web框架django[Form]组件
新手上路 Django的Form主要具有一下几大功能: 生成HTML标签 验证用户数据(显示错误信息) HTML Form提交保留上次提交数据 初始化页面显示内容 小试牛刀 1.创建Form类 # 创 ...
- 32.Django form组件
Form组件 Django的Form主要具有一下几大功能: 生成HTML标签 验证用户数据(显示错误信息) HTML Form提交保留上次提交数据 初始化页面显示内容 创建Form类时,主要涉及到 [ ...
- 饮冰三年-人工智能-Python-27 Django Form组件
Django的Form主要具有一下几大功能: 生成HTML标签 验证用户数据(显示错误信息) HTML Form提交保留上次提交数据 初始化页面显示内容 后台逻辑(导包+建类) from django ...
- 9.Django form组件
Form组件 Django的Form主要具有一下几大功能: 生成HTML标签 验证用户数据(显示错误信息) HTML Form提交保留上次提交数据 初始化页面显示内容 创建Form类时,主要涉及到 [ ...
随机推荐
- 运营商 WLAN
运营商 WLAN 运营商 WLAN 是 Android 9 中引入的一项功能,该功能可让设备自动连接到运营商实现的 WLAN 网络.在高度拥塞或信号覆盖范围较小的区域(如体育场或地铁站),运营商 WL ...
- Bomb HDU - 3555 数位dp
Code: #include<cstdio> #include<algorithm> #include<cstring> #include<string> ...
- react 中间件相关的一些源码解析
零.随便说说中间件 在react的使用中,我们可以将数据放到redux,甚至将一些数据相关的业务逻辑放到redux,这样可以简化我们组件,也更方便组件抽离.封装.复用,只是redux不能很好的处理异步 ...
- 洛谷1034 NOIP2002 矩形覆盖
问题描述 在平面上有 n 个点(n <= 50),每个点用一对整数坐标表示.例如:当 n＝4 时,4个点的坐标分另为:p1(1,1),p2(2,2),p3(3,6),P4(0,7). 这些点可以 ...
- Python组织文件 实践：拷贝某种类型的所有文件
#! python3 #chapter09-test01- 遍历目录树,查找特定扩展名的文件不论这些文件的位置在哪里,都将他们 #拷贝到一个新的文件夹中 import os,shutil,pprint ...
- 智能指针的->和 * 重载
- Linux下EPoll通信模型简析
EPoll基于I/O的事件通知机制,由系统通知用户那些SOCKET触发了那些相关I/O事件.事件中包括相应的文件描写叙述符以及事件类型.这样应用程序能够针对事件以及事件的source做相应的处理(Ac ...
- Codeforces Round #316 (Div. 2) B. Simple Game
思路:把n分成[1,n/2],[n/2+1,n],假设m在左区间.a=m+1,假设m在右区间,a=m-1.可是我居然忘了处理1,1这个特殊数据.被人hack了. 总结:下次一定要注意了,提交前一定要看 ...
- 同一台服务器部署多个WEB应用，SESSION冲突的解决方法
由于一台服务器上使用Tomcat部署多个WEB项目,而项目因为用到框架都是一样的,导致同时运行,session相互冲突,这个登录后,那个就得重新登录,造成了使用不方便,解决办法如下: 在server. ...
- Controller接口控制器2
5.ServletForwardingController 将接收到的请求转发到一个命名的servlet,具体示例如下: package cn.javass.chapter4.web.servlet; ...