Django中的form表单

  1. 云栖社区>
  2. 博客>
  3. 正文

Django中的form表单

任平生78 2017-10-06 18:05:00 浏览613
展开阅读全文

我们在某个网站注册账号的时候,总会遇到下面的情况:

限定用户名的长度最少8位
用户输入的密码最短8位,最长28位
还有用户输入的手机号或者邮箱验证等

这些情况都可以由Django的form来实现。

Django中的form表单的定义

Django的表单系统中,所有的表单都继承自django.forms.Form

基于Django的表单系统,主要分两类:

  • 基于django.forms.Form:所有表单类的父类
  • 基于django.forms.ModelForm:与模型类绑定的Form

Django的form的使用

先在views.py中自定义一个MyForm类

class MyForm(forms.Form):
    user=forms.CharField()
    age=forms.IntegerField()
    email=forms.EmailField()

然后再定义一个reg的视图函数

    def reg(request):
        form_obj=MyForm()       # 实例化一个MyForm类
    
        return render(request,"reg.html",{"form_obj":form_obj})

再生成一个reg的网页,配置好路由表,reg.html的内容如下:

    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>Title</title>
    </head>
    <body>
    <h4>{{ error_message }}</h4>
    <form action="/reg/" method="post">
        {% csrf_token %}
        {{ form_obj.as_p }}
    </form>
    </body>
    </html>

启动程序,用浏览器打开http://127.0.0.1:8000/reg/后,可以看到浏览器上的页面如下:

img_196c3d370f7f17fb6ac00d45e344b3d9.png

在MyForm类中定义了用户名user,年龄age和邮箱email三个注册项,而在前端页面上就显示了三个标签。

所以可以知道这三个标签是由form_obj这个对象创建出来的。

在前端页面提示用户输入信息时都是英文格式,想变成汉语格式的应该怎么办呢???

把上面定义的MyForm类修改

class MyForm(forms.Form):
    user=forms.CharField(label="用户")
    age=forms.IntegerField(label="年龄")
    email=forms.EmailField(label="邮箱")

刷新网页,显示页面如下

img_e46244974bff4f8cc891b812981ee9c2.png

查看网页的源码,每个标签由一个label标签和input标签组成,而且每个标签都被一个p标签包围,

img_7202ed1b5a8fa9afbdb1022dcfd58411.png

在前端页面上只写了form_obj.as_p,所以所有标签都是由Django的模板语言按照form表单的语法渲染出来的。

这种方式生成的代码封装性很好,但是可拓展性太差了。

如果我想在p标签里面再添加一些别的装饰呢,这又怎么办呢???

修改前端页面的代码

    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>Title</title>
    </head>
    <body>
    <h4>{{ error_message }}</h4>
    <form action="/reg/" method="post">
        {% csrf_token %}
        <p>姓名:{{ form_obj.user }}</p>
        <p>年龄:{{ form_obj.age }}</p>
        <p>邮箱:{{ form_obj.email }}</p>
        <input type="submit">
    </form>
    </body>
    </html>
    

在这里,我们就生成一个姓名,年龄和邮箱的文本,其余的交由form来渲染,渲染结果如下:

img_7326c3457ce6cbe92c19bb9bbb5a32cf.png

再来看网页的源码

img_3ab3aab14d666dea17f6ec46905ee65b.png

原来的label标签已经没有了,取而代之的是自定义的文本,而且只剩下一个input标签了。

而且可以看到每个标签的type属性不一样,跟MyForm类里定义的字段类型是一样的。

在MyForm类中定义的用户名user字段的类型是CharField类型,渲染后变成了text类型
在MyForm类中定义的用户名age字段的类型是IntegerField类型,渲染后变成了number类型
在MyForm类中定义的用户名email字的类型是EmailField类型,渲染后变成了email类型

而且其name属性和id属性的值都跟MyForm类中定义的字段是一样的。

看完了源码,现在什么信息都不输入就点击提交按钮会发生什么呢??

img_1fa6f93d3c2815d61b71d77c36d0bcff.png

浏览器提示信息告诉我们用户信息这一栏不能为空。

在用户信息栏里输入信息,再次点击提交按钮,又会在年龄栏中提示不能为空。

在这里如果我们向年龄信息栏中输入的是字母或特殊符号,也会输入不上,而只能输入数字。

因为在MyForm类中定义字段时使用了Integer类型。

同样的,在邮箱字段里也有同样的输入要求。

对用户输入的用户名和密码的长度进行设定

修改MyForm

class MyForm(forms.Form):
    user = forms.CharField(label="用户",min_length=5,max_length=12)
    age = forms.IntegerField(label="年龄")
    email = forms.EmailField(label="邮箱")

刷新浏览器,看会发生什么情况??

img_8eeb11ab600e7c0813241efffe7fd155.png

提示必须输入的信息的长度不能小于5。

修改reg视图函数

def reg(request):
    if request.method=='POST':
        form_post=MyForm(request.POST)

        print(form_post.is_valid())
    form_obj=MyForm()

    return render(request,"reg.html",{"form_obj":form_obj})

打开IE浏览器,填写如下信息,然后提交

img_c55d8aa49bf3be27d1b440e65efcc24b.png

在服务端后台打印的信息如下

False

可以看到is.valid()方法返回的是一个布尔值。

按照正确的要求填写并提交信息后,后台才会打印True

可以知道,Django的form到底有多少层校验取决于views.py的类中每个字段的类型及参数的个数.

如果用户输入的信息符合设定的要求,那么接下来就必须把用户填写的注册信息添加到数据库中。

先修改视图函数,看Django的form把用户输入的数据转换成什么样子的了。

    def reg(request):
        if request.method=='POST':
            form_post=MyForm(request.POST)
    
            if form_post.is_valid():
                print("data:",form_post.cleaned_data)
    
        form_obj=MyForm()
    
        return render(request,"reg.html",{"form_obj":form_obj})

刷新浏览器,重新输入注册信息,打印如下

data: {'user': 'aaaaaa', 'age': 100, 'email': 'bbbb@qq.com'}

可以看到Django的form把用户输入的信息封装成一个字典了。

此时添加数据库就可以使用关键字参数了。

    def reg(request):
        if request.method=='POST':
            form_post=MyForm(request.POST)
    
            if form_post.is_valid():
                print("data:",form_post.cleaned_data)
    
                models.UserInfo.objects.create_user(**form_post)
    
        form_obj=MyForm()
    
        return render(request,"reg.html",{"form_obj":form_obj})

进行校验的时候,如果出现错误,就应该把错误信息返回,该怎么做呢??

先打印下错误信息及错误信息的类型

    def reg(request):
        if request.method=='POST':
            form_post=MyForm(request.POST)
    
            if form_post.is_valid():
                print("data:",form_post.cleaned_data)
    
                models.UserInfo.objects.create_ue(**form_post)
            else:
                print(form_post.errors)
                
                print(type(form_post.errors))
        form_obj=MyForm()
    
        return render(request,"reg.html",{"form_obj":form_obj})

打印信息如下:

    <ul class="errorlist">
    <li>user<ul class="errorlist"><li>This field is required.</li></ul></li>
    <li>age<ul class="errorlist"><li>This field is required.</li></ul></li>
    <li>email<ul class="errorlist"><li>This field is required.</li></ul></li></ul>
    
    <class 'django.forms.utils.ErrorDict'>

可以看到,返回的错误信息是一个字典。

既然是一个字典类型,那么就可以取出其中的值。

    def reg(request):
        if request.method=='POST':
            form_post=MyForm(request.POST)
    
            if form_post.is_valid():
                print("data:",form_post.cleaned_data)
    
                models.UserInfo.objects.create_ue(**form_post)
            else:
                print("user_errors:",form_post.errors["user"])
                print("age_errors:",form_post.errors["age"])
                print("email_errors:",form_post.errors["email"])
                
        form_obj=MyForm()
    
        return render(request,"reg.html",{"form_obj":form_obj})

打印结果如下:

user_errors: <ul class="errorlist"><li>This field is required.</li></ul>
age_errors: <ul class="errorlist"><li>This field is required.</li></ul>
email_errors: <ul class="errorlist"><li>This field is required.</li></ul>

返回的信息是一个<ul><li>标签,其错误信息的内容为"This field is required."

修改views.py文件

    def reg(request):
        if request.method=='POST':
            form_post=MyForm(request.POST)
    
            if form_post.is_valid():
                print("data:",form_post.cleaned_data)
    
                models.UserInfo.objects.create_user(**form_post)
            else:
                errors_obj=form_post.errors
                print("user_errors:",errors_obj["user"])
                print("age_errors:",errors_obj["age"])
                print("email_errors:",errors_obj["email"])
    
        form_obj=MyForm()
    
    return render(request,"reg.html",{"form_obj":form_obj,"errors_obj":errors_obj})

修改前端网页reg.html

    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>Title</title>
    </head>
    <body>
    <h4>{{ error_message }}</h4>
    <form action="/reg/" method="post">
        {% csrf_token %}
        <p>姓名:{{ form_obj.user }}<span>{{ errors_obj.user.0 }}</span></p>
        <p>年龄:{{ form_obj.age }}<span>{{ errors_obj.age.0 }}</span></p>
        <p>邮箱:{{ form_obj.email }}<span>{{ errors_obj.email.0 }}</span></p>
        <input type="submit">
    </form>
    </body>
    </html>

这样就可以把错误信息渲染到前端网页了,如下所示,正常打开网页时,不会显示错误信息

img_005140179e14c0c269698fc997f42a84.png

当输入的信息不符合定义的要求时,就显在网页上显示错误信息了

img_348ea40b31383d79de33d3f140ca7187.png

如果想自定义在前端网页上显示的错误信息,该怎么办呢?

修改MyForm类,如下

class MyForm(forms.Form):
    user = forms.CharField(label="用户",min_length=5,max_length=12,error_messages={"required":"用户名必填"})
    age = forms.IntegerField(label="年龄",error_messages={"required":"年龄必填"})
    email = forms.EmailField(label="邮箱",error_messages={"required":"邮箱必填"})

此时,再次刷新浏览器,点击提交按钮,显示如下

img_414fa2fca1da190322592429a5b751ca.png

网友评论

登录后评论
0/500
评论