Web框架之Django_08 重要组件（form组件、cookie和session组件）

摘要：

  • form组件

  • cookie组件

  • session组件

一、form组件

  • form介绍
    我们之前在html页面中利用form表单向后端提交数据时候，都需要对用户的输入进行校验，比如校验用户是否输入正确（长度、格式...），如果用户输入的内容有误则需要在相应的位置显示对应的错误信息来提醒用户，提高前端的交互效率。
    Django form组件就是实现上述功能的一个功能组件。
    from组件主要功能有：
    # 生成页面可用的html标签
    # 对用户条件的数据进行校验
    # 保留上次输入内容
  • 先来看看自己手写注册功能的过程： 
    # views.py
# 注册
def register(request):
    error_msg = ""
    if request.method == "POST":
        username = request.POST.get("name")
        pwd = request.POST.get("pwd")
        # 对注册信息做校验
        if len(username) < 6:
            # 用户长度小于6位
            error_msg = "用户名长度不能小于6位"
        else:
            # 将用户名和密码存到数据库
            return HttpResponse("注册成功")
    return render(request, "register.html", {"error_msg": error_msg})

# register.html
!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>注册页面</title>
</head>
<body>
<form action="/reg/" method="post">
    <p>
        用户名:
        <input type="text" name="name">
    </p>
    <p>
        密码：
        <input type="password" name="pwd">
    </p>
    <p>
        <input type="submit" value="注册">
        <p style="color: red">{{ error_msg }}</p>
    </p>
</form>
</body>
</html>

  • 校验数据
    使用form组件实现注册功能：

    from django import forms
# 按照Django form组件的要求自己写一个类
class MyForm(forms.Form):
    name = forms.CharField(label='用户名', max_length=6)
    pwd = forms.CharField(label='密码', max_length=8, min_length=4)

def register(request):
    form_obj = MyForm()
    if request.method == 'POST':
        # 实例化form对象的时候，把post提交过来的数据直接传进去
        form_obj = MyForm(request.POST)
        # 调用form_obj校验数据的方法
        if form_obj.is_valid():  # 这里is_valid()如果验证全部通过，则返回True
            return HttpResponse('注册成功')
    return render(request, 'register.html', {'form_obj': form_obj})

    这里我们使用PythonConsole来测试：

    依次输入：（带#的为结果）
from app01 import views
form_obj = views.MyForm({'name': 'hhh', 'pwd': '123'})
form_obj.is_valid()
#False
form_obj.errors
#{'pwd': ['Ensure this value has at least 4 characters (it has 3).']}
form_obj.cleaned_data
#{'name': 'hhh'}

    ## form_obj.is_valid()  校验提交的信息，如果全部通过，则返回True，否则为False
    ## from_obj.errors 查看错误的信息，结果是一个字典格式，key为错误的字段，value为错误的原因，注意这里面是一个列表，说明原因可以有多个，这里需要说明：所有校验未通过的字段及错误信息提示都在这里放着，以键值对的形式存放。
    ## form_obj.cleaned_data  查看校验通过的数据，这里存放这所有校验通过的字段及其值，以字典形式存放。
    特别补充：
    如果：多串字段：不进行校验，所以不会在cleaned_data和errors中
               少传字段： 也会校验少传的字段，会在errors中，且该字段描述：{'pwd': ['This field is required.']}
    所有Form中的字段默认都是要校验，但是可以通过设置required = False来更过。

  • 渲染标签 
    # views
from django import forms
# 按照Django form组件的要求自己写一个类
class MyForm(forms.Form):
    name = forms.CharField(max_length=6)
    pwd = forms.CharField(max_length=8, min_length=4)

def register(request):
    form_obj = MyForm()
    if request.method == 'POST':
        # 实例化form对象的时候，把post提交过来的数据直接传进去
        form_obj = MyForm(request.POST)
        # 调用form_obj校验数据的方法
        if form_obj.is_valid():  # 这里is_valid()如果验证全部通过，则返回True
            return HttpResponse('注册成功')
    return render(request, 'register.html', {'form_obj': form_obj})
    <!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<form action="/register/" method="post">
{#    .as_p代表将所有的字段都对应input框渲染给前端显示#}
    {{ form_obj.as_p }}

</form>
</body>
</html>

    Web框架之Django_08 重要组件（form组件、cookie和session组件）

    可以看到，前面的Name和Pwd是Django自己渲染加上的，如果想要自定义，可以在MyForm类的对应字段里加上：label='用户名'和label='密码'即可

    Web框架之Django_08 重要组件（form组件、cookie和session组件）

    上面是第一种渲染方式，可以看出可拓展性较差

  • 第二种渲染方式：
    多加几个校验字段 
    from django import forms
# 按照Django form组件的要求自己写一个类
class MyForm(forms.Form):
    name = forms.CharField(max_length=6, label='用户名')
    pwd = forms.CharField(max_length=8, min_length=4, label='密码')
    email = forms.EmailField(label='邮箱')
    <!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<form action="/register/" method="post">
<p>{{ form_obj.name }}</p>
<p>{{ form_obj.pwd }}</p>
<p>{{ form_obj.email }}</p>
</form>
</body>
</html>

    Web框架之Django_08 重要组件（form组件、cookie和session组件）只有input框！
    加入input框前的名字：

    <!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<form action="/register/" method="post">
<p>{{ form_obj.name.label }}{{ form_obj.name }}</p>
<p>{{ form_obj.pwd.label }}{{ form_obj.pwd }}</p>
<p>{{ form_obj.email.label }}{{ form_obj.email }}</p>
</form>
</body>
</html>

    Web框架之Django_08 重要组件（form组件、cookie和session组件）

    此种方法还是有缺点，比如字段如果有100个，难道要100个全部输吗？所以应该还有更好的方法：

  • 第三种渲染方式：
    <!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<form action="/register/" method="post">
{% for foo in form_obj %}
    <p>第三种渲染方式：{{ foo.label }}{{ foo }}</p>
{% endfor %}
</form>
</body>
</html>

    Web框架之Django_08 重要组件（form组件、cookie和session组件）

    这里提一下：如果想要取消前端校验，可以在form表单中加入：novalidate
    这里需要知道：
        1、如果Django创建的form表单在提交的时候数据不合法（校验不通过），则会自动保留填写的信息，不会清空。
        2、Django创建的表单是没有提交按钮的，需要自己创建。
    接下来，添加校验不通过时候的提示信息：只需在恰当的位置添加

    <!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<form action="/register/" method="post" novalidate>
{% for foo in form_obj %}
    <p>第三种渲染方式：{{ foo.label }}{{ foo }}<span>{{ foo.errors }}</span></p>
{% endfor %}
    <input type="submit">
</form>
</body>
</html>

    Web框架之Django_08 重要组件（form组件、cookie和session组件）

    这里，提示错误信息在下面显示，如果想让它在每个字段的input框后面显示可以加个0

    <!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<form action="/register/" method="post" novalidate>
{% for foo in form_obj %}
    <p>第三种渲染方式：{{ foo.label }}{{ foo }}<span>{{ foo.errors.0 }}</span></p>

{% endfor %}
    <input type="submit">
</form>
</body>
</html>

    Web框架之Django_08 重要组件（form组件、cookie和session组件）

    继续走向个性化：提示的错误信息是英文，我看不懂，那就改成中文：
    修改错误提示信息为自定义信息

    from django import forms
# 按照Django form组件的要求自己写一个类
class MyForm(forms.Form):
    name = forms.CharField(max_length=6, label='用户名', error_messages={
        'max_length': '用户名最大长度为6位',
        'required': '用户名必须不能为空'
    })
    pwd = forms.CharField(max_length=8, min_length=4, label='密码', error_messages={
        'max_length': '密码最大长度为8位',
        'min_length': '密码最小长度为4位',
        'required': '用户名必须不能为空'
    })
    email = forms.EmailField(label='邮箱', error_messages={
        'required': '邮箱必须不能为空',
        'invalid': '邮箱格式不合法'
    })

    测试测试：

    <!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<form action="/register/" method="post" novalidate>
{% for foo in form_obj %}
    <p>第三种渲染方式：{{ foo.label }}{{ foo }}<span>{{ foo.errors.0 }}</span></p>

{% endfor %}
    <input type="submit">
</form>
</body>
</html>

    Web框架之Django_08 重要组件（form组件、cookie和session组件）

    这里有个小点需要说明：默认google浏览器的表单输入框如果要求最大6位，就只能输入6位最大，再多输入没有反应，这个为了测试方便，可以认为在每次提交前通过右键检查，人为删除限制的html代码

    Web框架之Django_08 重要组件（form组件、cookie和session组件）

  • 常用字段与插件：
    这里系统的在补充一些Form类在创建的时候会涉及到的字段和插件，自对用于对用户请求数据的验证，插件用于自动生成html

    initial

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

    class LoginForm(forms.Form):
    username = forms.CharField(
        min_length=8,
        label="用户名",
        initial="张三"  # 设置默认值
    )
    pwd = forms.CharField(min_length=6, label="密码")

    error_messages(这个上面以提到）

    重写错误信息。

    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="密码")

    PasswordInput
    给对应字段的input框设置属性，类....

        pwd = forms.CharField(max_length=8, min_length=4, label='密码', error_messages={
        'max_length': '密码最大长度为8位',
        'min_length': '密码最小长度为4位',
        'required': '用户名必须不能为空'
    }, widget=forms.widgets.PasswordInput(attrs={'type': 'password'}))

# 将input改成password类型，这样输入的就不是明文了

    Web框架之Django_08 重要组件（form组件、cookie和session组件）

    radioSelect

    将下拉式选择框转变成单选形式

        gender = forms.ChoiceField(
        choices=((1, "男"), (2, "女"), (3, "保密")),
        label="性别",
        initial=3,
        widget=forms.widgets.RadioSelect()

    Web框架之Django_08 重要组件（form组件、cookie和session组件）

    单选Select

    class LoginForm(forms.Form):
    ...
    hobby = forms.ChoiceField(
        choices=((1, "篮球"), (2, "足球"), (3, "双色球"), ),
        label="爱好",
        initial=3,
        widget=forms.widgets.Select()
    )

    多选Select

    class LoginForm(forms.Form):
    ...
    hobby = forms.MultipleChoiceField(
        choices=((1, "篮球"), (2, "足球"), (3, "双色球"), ),
        label="爱好",
        initial=[1, 3],
        widget=forms.widgets.SelectMultiple()
    )

    单选checkbox

    class LoginForm(forms.Form):
    ...
    keep = forms.ChoiceField(
        label="是否记住密码",
        initial="checked",
        widget=forms.widgets.CheckboxInput()
    )

    多选checkbox

    class LoginForm(forms.Form):
    ...
    hobby = forms.MultipleChoiceField(
        choices=((1, "篮球"), (2, "足球"), (3, "双色球"),),
        label="爱好",
        initial=[1, 3],
        widget=forms.widgets.CheckboxSelectMultiple()
    )

    choice字段注意事项

    在使用选择标签时，需要注意choices的选项可以配置从数据库中获取，但是由于是静态字段 获取的值无法实时更新，需要重写构造方法从而实现choice实时更新。

    方式一：

    from django.forms import Form
from django.forms import widgets
from django.forms import fields

 
class MyForm(Form):
 
    user = fields.ChoiceField(
        # choices=((1, '上海'), (2, '北京'),),
        initial=2,
        widget=widgets.Select
    )
 
    def __init__(self, *args, **kwargs):
        super(MyForm,self).__init__(*args, **kwargs)
        # self.fields['user'].choices = ((1, '上海'), (2, '北京'),)
        # 或
        self.fields['user'].choices = models.Classes.objects.all().values_list('id','caption')

    方式二：

    from django import forms
from django.forms import fields
from django.forms import models as form_model

 
class FInfo(forms.Form):
    authors = form_model.ModelMultipleChoiceField(queryset=models.NNewType.objects.all())  # 多选
    # authors = form_model.ModelChoiceField(queryset=models.NNewType.objects.all())  # 单选
  • DjangoForm所有内置字段 
    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内置字段
    所有内置字段

相关文章：

  • 2022-12-23
  • 2022-12-23
  • 2021-10-31
  • 2021-08-31
  • 2022-12-23
猜你喜欢
  • 2022-12-23
  • 2021-11-27
  • 2021-09-23
  • 2022-02-23
  • 2022-12-23
  • 2021-06-11
  • 2021-12-29
相关资源
相似解决方案
热门标签
Java Python linux javascript Mysql C# Docker 算法 前端 SpringBoot Redis Vue spring 设计模式 .net core .net kubernetes c++ 数据库 数据结构 大数据 js 机器学习 微服务 Android Go 程序员 面试 JVM ASP.net core 云原生 人工智能 后端 PHP git CSS golang k8s Nginx Django mybatis 深度学习 多线程 React 架构 devops 爬虫 云计算 Spring Boot LeetCode