Django form表单
程序员文章站
2022-05-29 13:25:41
Django Form表单 Form介绍 总结一下，其实Django form组件的主要功能如下: 生成页面可用的HTML标签 对用户提交的数据进行校验 保留上次输入内容 普通方式手写注册功能 views.py register.html register2.html 看网页效果发现 也验证了for ......
django form表单
form介绍
总结一下，其实django form组件的主要功能如下:
- 生成页面可用的html标签
- 对用户提交的数据进行校验
- 保留上次输入内容
普通方式手写注册功能
views.py
1 # 注册
2 def register(request):
3 error_msg = ""
4 if request.method == "post":
5 username = request.post.get("name")
6 pwd = request.post.get("pwd")
7 # 对注册信息做校验
8 if len(username) < 6:
9 # 用户长度小于6位
10 error_msg = "用户名长度不能小于6位"
11 else:
12 # 将用户名和密码存到数据库
13 return httpresponse("注册成功")
14 return render(request, "register.html", {"error_msg": error_msg})
register.html
1 <!doctype html>
2 <html lang="en">
3 <head>
4 <meta charset="utf-8">
5 <title>注册页面</title>
6 </head>
7 <body>
8 <form action="/reg/" method="post">
9 {% csrf_token %}
10 <p>
11 用户名:
12 <input type="text" name="name">
13 </p>
14 <p>
15 密码：
16 <input type="password" name="pwd">
17 </p>
18 <p>
19 <input type="submit" value="注册">
20 <p style="color: red">{{ error_msg }}</p>
21 </p>
22 </form>
23 </body>
24 </html>
register2.html
1 <!doctype html>
2 <html lang="en">
3 <head>
4 <meta charset="utf-8">
5 <title>注册2</title>
6 </head>
7 <body>
8 <form action="/reg2/" method="post" novalidate autocomplete="off">
9 {% csrf_token %}
10 <div>
11 <label for="{{ form_obj.name.id_for_label }}">{{ form_obj.name.label }}</label>
12 {{ form_obj.name }} {{ form_obj.name.errors.0 }}
13 </div>
14 <div>
15 <label for="{{ form_obj.pwd.id_for_label }}">{{ form_obj.pwd.label }}</label>
16 {{ form_obj.pwd }} {{ form_obj.pwd.errors.0 }}
17 </div>
18 <div>
19 <input type="submit" class="btn btn-success" value="注册">
20 </div>
21 </form>
22 </body>
23 </html>
看网页效果发现 也验证了form的功能：
• 前端页面是form类的对象生成的 -->生成html标签功能
• 当用户名和密码输入为空或输错之后 页面都会提示 -->用户提交校验功能
• 当用户输错之后 再次输入 上次的内容还保留在input框 -->保留上次输入内容
form_obj生成html代码的方式：
1.form_obj.as_p
2.自己挨个字段取
3.form表单实现机制
<form action="/reg/" method="post">
{% csrf_token %}
{% for field in form_obj %}
{{ field.label}}
{{ field}}
{% endfor %}
</form>
form那些事儿
常用字段与插件
创建form类时，主要涉及到 【字段】 和 【插件】，字段用于对用户请求数据的验证，插件用于自动生成html;
initial
初始值，input框里面的初始值。
1 class loginform(forms.form): 2 username = forms.charfield( 3 min_length=8, 4 label="用户名", 5 initial="张三" # 设置默认值 6 ) 7 pwd = forms.charfield(min_length=6, label="密码")
error_messages
重写错误信息
1 class loginform(forms.form):
2 username = forms.charfield(
3 min_length=8,
4 label="用户名",
5 initial="张三",
6 error_messages={
7 "required": "不能为空",
8 "invalid": "格式错误",
9 "min_length": "用户名最短8位"
10 }
11 )
12 pwd = forms.charfield(min_length=6, label="密码")
password
1 class loginform(forms.form):
2 ...
3 pwd = forms.charfield(
4 min_length=6,
5 label="密码",
6 widget=forms.widgets.passwordinput(attrs={'class': 'c1'}, render_value=true)
7 )
radioselect
单radio值为字符串
class loginform(forms.form):
username = forms.charfield(
min_length=8,
label="用户名",
initial="张三",
error_messages={
"required": "不能为空",
"invalid": "格式错误",
"min_length": "用户名最短8位"
}
)
pwd = forms.charfield(min_length=6, label="密码")
gender = forms.fields.choicefield(
choices=((1, "男"), (2, "女"), (3, "保密")),
label="性别",
initial=3,
widget=forms.widgets.radioselect()
)
单选select
1 class loginform(forms.form): 2 ... 3 hobby = forms.fields.choicefield( 4 choices=((1, "篮球"), (2, "足球"), (3, "双色球"), ), 5 label="爱好", 6 initial=3, 7 widget=forms.widgets.select() 8 )
多选select
1 class loginform(forms.form): 2 ... 3 hobby = forms.fields.multiplechoicefield( 4 choices=((1, "篮球"), (2, "足球"), (3, "双色球"), ), 5 label="爱好", 6 initial=[1, 3], 7 widget=forms.widgets.selectmultiple() 8 )
单选checkbox
1 class loginform(forms.form): 2 ... 3 keep = forms.fields.choicefield( 4 label="是否记住密码", 5 initial="checked", 6 widget=forms.widgets.checkboxinput() 7 )
多选checkbox
1 class loginform(forms.form): 2 ... 3 hobby = forms.fields.multiplechoicefield( 4 choices=((1, "篮球"), (2, "足球"), (3, "双色球"),), 5 label="爱好", 6 initial=[1, 3], 7 widget=forms.widgets.checkboxselectmultiple() 8 )
关于choice的注意事项：
在使用选择标签时，需要注意choices的选项可以从数据库中获取，但是由于是静态字段 ***获取的值无法实时更新***，那么需要自定义构造方法从而达到此目的。
方式一：
1 from django.forms import form
2 from django.forms import widgets
3 from django.forms import fields
4
5
6 class myform(form):
7
8 user = fields.choicefield(
9 # choices=((1, '上海'), (2, '北京'),),
10 initial=2,
11 widget=widgets.select
12 )
13
14 def __init__(self, *args, **kwargs):
15 super(myform,self).__init__(*args, **kwargs)
16 # self.fields['user'].choices = ((1, '上海'), (2, '北京'),)
17 # 或
18 self.fields['user'].choices = models.classes.objects.all().values_list('id','caption')
方式二：
1 from django import forms 2 from django.forms import fields 3 from django.forms import models as form_model 4 5 6 class finfo(forms.form): 7 authors = form_model.modelmultiplechoicefield(queryset=models.nnewtype.objects.all()) # 多选 8 # authors = form_model.modelchoicefield(queryset=models.nnewtype.objects.all()) # 单选
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类型
校验
方式一：
1 from django.forms import form 2 from django.forms import widgets 3 from django.forms import fields 4 from django.core.validators import regexvalidator 5 6 class myform(form): 7 user = fields.charfield( 8 validators=[regexvalidator(r'^[0-9]+$', '请输入数字'), regexvalidator(r'^159[0-9]+$', '数字必须以159开头')], 9 )
方式二：
1 import re
2 from django.forms import form
3 from django.forms import widgets
4 from django.forms import fields
5 from django.core.exceptions import validationerror
6
7
8 # 自定义验证规则
9 def mobile_validate(value):
10 mobile_re = re.compile(r'^(13[0-9]|15[012356789]|17[678]|18[0-9]|14[57])[0-9]{8}$')
11 if not mobile_re.match(value):
12 raise validationerror('手机号码格式错误')
13
14
15 class publishform(form):
16
17
18 title = fields.charfield(max_length=20,
19 min_length=5,
20 error_messages={'required': '标题不能为空',
21 'min_length': '标题最少为5个字符',
22 'max_length': '标题最多为20个字符'},
23 widget=widgets.textinput(attrs={'class': "form-control",
24 'placeholder': '标题5-20个字符'}))
25
26
27 # 使用自定义验证规则
28 phone = fields.charfield(validators=[mobile_validate, ],
29 error_messages={'required': '手机不能为空'},
30 widget=widgets.textinput(attrs={'class': "form-control",
31 'placeholder': u'手机号码'}))
32
33 email = fields.emailfield(required=false,
34 error_messages={'required': u'邮箱不能为空','invalid': u'邮箱格式错误'},
35 widget=widgets.textinput(attrs={'class': "form-control", 'placeholder': u'邮箱'}))
补充进阶
应用bootstrap样式
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta http-equiv="x-ua-compatible" content="ie=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="stylesheet" href="/static/bootstrap/css/bootstrap.min.css">
<title>login</title>
</head>
<body>
<div class="container">
<div class="row">
<form action="/login2/" method="post" novalidate class="form-horizontal">
{% csrf_token %}
<div class="form-group">
<label for="{{ form_obj.username.id_for_label }}"
class="col-md-2 control-label">{{ form_obj.username.label }}</label>
<div class="col-md-10">
{{ form_obj.username }}
<span class="help-block">{{ form_obj.username.errors.0 }}</span>
</div>
</div>
<div class="form-group">
<label for="{{ form_obj.pwd.id_for_label }}" class="col-md-2 control-label">{{ form_obj.pwd.label }}</label>
<div class="col-md-10">
{{ form_obj.pwd }}
<span class="help-block">{{ form_obj.pwd.errors.0 }}</span>
</div>
</div>
<div class="form-group">
<label class="col-md-2 control-label">{{ form_obj.gender.label }}</label>
<div class="col-md-10">
<div class="radio">
{% for radio in form_obj.gender %}
<label for="{{ radio.id_for_label }}">
{{ radio.tag }}{{ radio.choice_label }}
</label>
{% endfor %}
</div>
</div>
</div>
<div class="form-group">
<div class="col-md-offset-2 col-md-10">
<button type="submit" class="btn btn-default">注册</button>
</div>
</div>
</form>
</div>
</div>
<script src="/static/jquery-3.2.1.min.js"></script>
<script src="/static/bootstrap/js/bootstrap.min.js"></script>
</body>
</html>
批量添加样式
可通过重写form类的init方法来实现。
class loginform(forms.form):
username = forms.charfield(
min_length=8,
label="用户名",
initial="张三",
error_messages={
"required": "不能为空",
"invalid": "格式错误",
"min_length": "用户名最短8位"
}
...
def __init__(self, *args, **kwargs):
super(loginform, self).__init__(*args, **kwargs)
for field in iter(self.fields):
self.fields[field].widget.attrs.update({
'class': 'form-control'
})
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 # 自定义错误信息
参考来源：https://www.cnblogs.com/liwenzhou/p/8747872.html
上一篇： Day1 Python入门学习，第一周