Django Form表单
Form介绍
总结一下，其实Django form组件的主要功能如下:
- 生成页面可用的HTML标签
- 对用户提交的数据进行校验
- 保留上次输入内容
form表单的作用： 1.生成HTML代码 2.验证 3.把验证的错误显示在页面上并保留原始数据 form表单的基本使用： form_obj生成HTML代码的方式 1.form_obj.as_p 2.自己挨个字段取 3.{% for field in form_obj %} {{field.label}} {{field}} {% endfor %}
普通方式手写注册功能
views.py
代码语言：javascript复制 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
代码语言：javascript复制 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
代码语言：javascript复制 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表单实现机制
代码语言：javascript复制<form action="/reg/" method="post">
{% csrf_token %}
{% for field in form_obj %}
{{ field.label}}
{{ field}}
{% endfor %}
</form>Form那些事儿
常用字段与插件
创建Form类时，主要涉及到 【字段】 和 【插件】，字段用于对用户请求数据的验证，插件用于自动生成HTML;
initial
初始值，input框里面的初始值。
代码语言：javascript复制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
重写错误信息
代码语言：javascript复制 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
代码语言：javascript复制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值为字符串
代码语言：javascript复制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
代码语言：javascript复制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
代码语言：javascript复制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
代码语言：javascript复制1 class LoginForm(forms.Form):
2 ...
3 keep = forms.fields.ChoiceField(
4 label="是否记住密码",
5 initial="checked",
6 widget=forms.widgets.CheckboxInput()
7 )多选checkbox
代码语言：javascript复制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的选项可以从数据库中获取，但是由于是静态字段 ***获取的值无法实时更新***，那么需要自定义构造方法从而达到此目的。
方式一：
代码语言：javascript复制 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')方式二：
代码语言：javascript复制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类型Django Form内置字段
校验
方式一：
代码语言：javascript复制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 )方式二：
代码语言：javascript复制 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>Django form应用Bootstrap样式简单示例
批量添加样式
可通过重写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的终极结合。
代码语言：javascript复制class BookForm(forms.ModelForm):
class Meta:
model = models.Book
fields = "__all__"
labels = {
"title": "书名",
"price": "价格"
}
widgets = {
"password": forms.widgets.PasswordInput(attrs={"class": "c1"}),
}class Meta:下常用参数：
代码语言：javascript复制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
