day 66 form组件、forms组件的钩子函数-蒲公英云

forms组件

需求示例：获取用户输入后端判断用户输入的内容是否合法，如果不合法前端渲染对应的错误信息

传统：

def register(request):
    back_dic = {
     'username': '', 'password': ""}
    if request.method == 'POST':
        username = request.POST.get('username')
        pwd = request.POST.get('password')
        if '666' in username:
            res = "不能有666"
            back_dic['username'] = res
        if pwd == "123":
            res = "密码太简单"
            back_dic['password'] = res
    return render(request, 'reg.html', locals())

html:

</head>
<body>
<form action="" method="post">
{% csrf_token %}
    <p><input type="text" name="username">
        <span>{
     { back_dic.username }}</span>
    </p>
    <p><input type="text" name="password">
        <span>{
     { back_dic.password }}</span>
    </p>
    <input type="submit">
    </form>
</body>
</html>

用forms组件来实现：校验数据、渲染页面、展示提示信息

一、校验数据、【前后端都可以校验数据，前端可以没有，但是后端一定要有】　

　　1.校验数据，需要一个类，继承forms.Form

from django import forms
class Myform(forms.Form):
    username = forms.CharField(max_length=8)
    password = forms.CharField(max_length=6, min_length=3)
    email = forms.EmailField()

　　2. 给forms组件传参数（字典的形式）　

　　　　obj = views.Myform({‘username’: ‘egion’, ‘passowrod’: ‘123’})

　　3.查看数据校验结果

　　　　obj.is_valid()

　　4. 查看干净的数据

　　　obj.cleaned_data ==> 正确的以字典形式放入{‘username’: ‘egondsb2’, ‘password’: ‘123’}

　　5. 查看不正确的数据

　　　obj.errors ==> 错误的放入{‘password’: [‘Ensure this value has at least 3 characters (it has 2).’],

　　　　　　　　　　　　　　　　‘email’: [‘This field is required.’]}

from app01 import views
obj = views.Myform({
     "username":"egondsb", "password": "123"})
obj.is_valid()
False
obj.cleaned_data
{
      'password': '123'}
obj.errors
{
      'username': ['Ensure this value has at most 6 characters (it has 7).'], 'email': ['This field is required.']}

　　ps: forms组件中所有的字段默认都是必填的（不能为空）

　　　　在数据都满足forms组件校验规则的情况下，多传的数据不作校验，

补充：正则校验数据

from  django.core.validators import RegexValidator
phone = forms.CharField(validators=[RegexValidator(r'^[0-9]+$', '请输入数字'), 
                                    RegexValidator(r'^159[0-9]+$', '必须以159开头')])

RegexValidator验证器

from django.forms import Form
from django.forms import widgets
from django.forms import fields
from django.core.validators import RegexValidator
class MyForm(Form):
    user = fields.CharField(
        validators=[RegexValidator(r'^[0-9]+$', '请输入数字'), RegexValidator(r'^159[0-9]+$', '数字必须以159开头')],
    )

自定义验证函数

二. 渲染页面、 forms组件只能帮你渲染获取用户输入（输入框、选择框、下拉框。。。）提交按钮也得自己写

　　前端页面识别到是forms组件时，也会校验数据长度，

　　form表单取消前端校验的提示信息：

　 initial 初始值， input框里面的初始值

　　views:

def reg1(request):
    form_obj = Myform()
    return render(request, 'reg1.html', locals())

　　1.第一种渲染页面的方式【扩展性不高，本地测试】 as_p 、| as_ul

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <title>Title</title>
</head>
<body>
<form action="" method="post">
    {
      % csrf_token %}
    <p>forms第一种渲染标签的方式</p>
{
      #    {
      { form_obj.as_p }} p标签包裹着#}
    {
      { form_obj.as_ul }}  li标签包裹着
{
      #lable展示的信息默认情况下是字段名首字母大写#}
</form>
</body>
</html>

　　2. 第二种，输入框与label名需自己写，缺点是，当字段比较多时，需要一个个的写，麻烦！包裹p标签

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <title>Title</title>
</head>
<body>
<form action="" method="post">
    <p>forms第二种渲染标签的方式</p>
    <p>
        {
      { form_obj.username.label }}{
      { form_obj.username }} {
      # forms对象点字段名拿到的是对应的输入框 #}
    </p>
    <p>
        {
      { form_obj.password.label }}{
      { form_obj.password }} {
      # forms对象点字段名拿到的是对应的输入框 #}
    </p>
</form>

　　3.第三种，常用方式

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <title>Title</title>
</head>
<body>
<form action="" method="post" novalidate>
    {
      % csrf_token %}
    {
      % for foo in form_obj %}
        <p>{
      { foo.label }}{
      { foo }}
        <span>{
     { foo.errors.0 }}</span>
        </p>
    {
      % endfor %}
    <input type="submit">
</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类型

三.展示信息

　1. label名，错误息信, 密码密文【from django.forms import widgets】，等可以在类中先定义

from django import forms
from django.forms import widgets
class Myform(forms.Form):
    username = forms.CharField(max_length=8, label="用户名", initial="张三", error_messages={
     "required": "用户名不能为空",
                                                                          "max_length": "用户名长度不能超过8位"})
    password = forms.CharField(max_length=6, min_length=3,
                               widget=forms.widgets.PasswordInput(attrs={
     "class": "form-control c1"}),
                               error_messages={
     "required": "邮箱不能为空", "invalid": "邮箱格式不正确"})
    email = forms.EmailField()

choice字段、多选checkbox、单选select、radioSelect、password

class Myform2(forms.Form):
    gender = forms.fields.ChoiceField(
        choices=((1, "男"), (2, "女"), (3, "保密")),
        label="性别",
        initial=3,
        widget=forms.widgets.RadioSelect()
    )
    hobby = forms.MultipleChoiceField(
        choices=((1, "篮球"), (2, "足球"), (3, "双色球"),),
        label="爱好",
        initial=[1, 3],
        widget=forms.widgets.CheckboxSelectMultiple()
    )
    keep = forms.ChoiceField(
        label="是否记住密码",
        initial="checked",
        widget=forms.widgets.CheckboxInput()
    )
    hobby1 = forms.ChoiceField(
        choices=((1, "篮球"), (2, "足球"), (3, "双色球"), ),
        label="爱好",
        initial=3,
        widget=forms.widgets.Select()
    )
    username = forms.CharField(
        min_length=8,
        label="用户名",
        initial="张三",
        error_messages={
            "required": "不能为空",
            "invalid": "格式错误",
            "min_length": "用户名最短8位"
        }
    )
def reg2(request):
    myform2 = Myform2()
    if request.method == "POST":
        myform2 = Myform2(request.POST)
        if myform2.is_valid():
            print(myform2.cleaned_data)
    return render(request, "reg2.html", locals())

在django中测试脚本：

1.新建一个test文件：

import os
import sys
if __name__ == "__main__":
    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "day66ajaxformdata.settings")
    import django
    django.setup()
    # 将要测试的代码导入
    from app01 import models
    print(models.Userinfo.objects.all())

import os
import sys
if __name__ == "__main__":
    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "day66ajaxformdata.settings")
    import django
    django.setup()
    # 将要测试的代码导入
    # from app01 import models
    # print(models.Userinfo.objects.all())
    from app01 import views
    obj = views.Myform({
     'username': "egon", "password": '123'})
    print(obj.is_valid())

python console 中测试，直接导入需要测试的文件，下面以测试上面forms组件为例

　　python Console中

from app01 import views
obj = views.Myform({
     "username":"egondsb", "password": "123"})
obj.is_valid()   # 校验数据结果
False
obj.cleaned_data
{
      'password': '123'}
obj.errors
{
      'username': ['Ensure this value has at most 6 characters (it has 7).'], 'email': ['This field is required.']}

forms组件的钩子函数 Hook方法【在form类中写钩子函数】

数据校验顺序：先校验字段中的条件，再走钩子函数规则

局部钩子【校验单个字段】 : 在用户名中不能有666字样

from django import forms
from django.forms import widgets
from  django.core.validators import RegexValidator
class Myform(forms.Form):
    username = forms.CharField(max_length=8, label="用户名", initial="张三", error_messages={
     "required": "用户名不能为空",
                                                                          "max_length": "用户名长度不能超过8位"})
    password = forms.CharField(max_length=6, min_length=3,
                               widget=forms.widgets.PasswordInput(attrs={
     "class": "form-control c1"}),
                               error_messages={
     "required": "邮箱不能为空", "invalid": "邮箱格式不正确"})
    email = forms.EmailField()
    phone = forms.CharField(validators=[RegexValidator(r'^[0-9]+$', '请输入数字'),
                                        RegexValidator(r'^159[0-9]+$', '必须以159开头')])
    def clean_username(self):
        # 用户名不能有666
        username = self.cleaned_data.get('username')
        if "666" in username:
            self.add_error('username', '光喊666是不行的')
            return username

全局钩子【校验多个字段】：两次密码需一致

from django import forms
from django.forms import widgets
from  django.core.validators import RegexValidator
class Myform(forms.Form):
    username = forms.CharField(max_length=8, label="用户名", initial="张三", error_messages={
     "required": "用户名不能为空",
                                                                          "max_length": "用户名长度不能超过8位"})
    password = forms.CharField(max_length=6, min_length=3,
                               widget=forms.widgets.PasswordInput(attrs={
     "class": "form-control c1"}),)
    confirm_password = forms.CharField(max_length=8, min_length=3, label="确认密码",
                                       widget=forms.widgets.PasswordInput(attrs={
     "class": "form-control c1"}))
    email = forms.EmailField(error_messages={
     "required": "邮箱不能为空", "invalid": "邮箱格式不正确"})
    phone = forms.CharField(validators=[RegexValidator(r'^[0-9]+$', '请输入数字'),
                                        RegexValidator(r'^159[0-9]+$', '必须以159开头')])
    def clean_username(self):
        # 用户名不能有666
        username = self.cleaned_data.get('username')
        if "666" in username:
            self.add_error('username', '光喊666是不行的')
            return username
    def clean(self):
        password = self.cleaned_data.get('password')
        confirm_password = self.cleaned_data.get('confirm_password')
        if password != confirm_password:
            self.add_error("confirm_password", "两次密码不一致")
            return self.cleaned_data