Django组件——forms组件

一、校验字段功能

  通过注册用户这个实例来学习校验字段功能。

1、模型:models.py

from django.db import models

# Create your models here.

class UserInfo(models.Model):
    name = models.CharField(max_length=32)
    pwd = models.CharField(max_length=32)
    email = models.EmailField()
    tel = models.CharField(max_length=32)

  修改配置后,完成数据库迁移操作,可以查看到UserInfo表已经创建完成。

2、模板:reg.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<form action="" method="post">
    {% csrf_token %}
    <p>用户名<input type="text" name="name"></p>
    <p>密码<input type="text" name="pwd"></p>
    <p>确认密码<input type="text" name="r_pwd"></p>
    <p>邮箱<input type="text" name="email"></p>
    <p>手机号<input type="text" name="tel"></p>
    <input type="submit">
</form>
</body>
</html>

3、视图函数:views.py

from django.shortcuts import render,HttpResponse
# Create your views here.
from django import forms   # 引入forms组件

class UserForm(forms.Form):   # 必须继承forms.Form
    name = forms.CharField(min_length=4)
    pwd = forms.CharField(min_length=4)
    r_pwd = forms.CharField(min_length=4)
    email = forms.EmailField()
    tel = forms.CharField()

def reg(request):
    if request.method=="POST":
        print(request.POST)
        # 生成forms对象后,传入字典就可以做一个个值的校验
        # form = UserForm({"name": "yuan", "email": "[email protected]", "xxx":"alex"})
        form = UserForm(request.POST)   # form表单的name属性值应该与forms组件的字段名称一致,不一致的键值不会去做校验
        print(form.is_valid())     # 返回True/False
        # 帮忙校验
        if form.is_valid():  # 注意:form.is_valid是帮忙校验返回布尔值的,true或false(所有都通过才返回true)
            # 类定义的字段均符合要求,返回true,有多的字段直接忽略
            print(form.cleaned_data)   # {'name': 'yuan', 'pwd': '1234', 'r_pwd': '1234', 'email': '[email protected]', 'tel': '123123'}
        else:
            # 有正确也有错误信息也是返回false
            print(form.cleaned_data)   # 字段值符合要求的放在cleaned_data    {'name': 'yuan', 'pwd': '123456', 'tel': '123123'}
            print(form.errors)         # 字段不符合要求的对应的键作为键,错误信息作为值   <ul class="errorlist"><li>r_pwd<ul class="errorlist">...
            print(type(form.errors))   # <class 'django.forms.utils.ErrorDict'>  还是一个字段类型
            print(form.errors.get("r_pwd"))     # <ul class="errorlist"><li>This field is required.</li></ul>
            print(type(form.errors.get("r_pwd")))    # <class 'django.forms.utils.ErrorList'> 用列表存放错误信息
            print(form.errors.get("r_pwd")[0])   # 获取到报错信息:This field is required.
        """
        form.is_valid()  校验返回布尔值
        if 所有的字段校验成功,则form.cleaned_data:{"name": "yuan", "email": "[email protected]"}
        如果校验失败,则form.errors放入所有错误的字段。
        """
        return HttpResponse("OK")
    return render(request, "reg.html")

注意:

(1)引入forms组件,定义的类必须继承forms.Form,forms类定义过的属性默认非空。

from django import forms   # 引入forms组件

class UserForm(forms.Form):   # 必须继承forms.Form
    name = forms.CharField(min_length=4)
    pwd = forms.CharField(min_length=4)
    r_pwd = forms.CharField(min_length=4)
    email = forms.EmailField()
    tel = forms.CharField()

(2)生成forms对象,需要注意的是给对象传入字典就可以做一个个值的校验:

form = UserForm({"name": "yuan", "email": "[email protected]", "xxx":"alex"})

  但是我们需要的是form表单属性与forms组件字段的校验,因此需要把request.POST传入forms对象:

form = UserForm(request.POST)  

  form表单的name属性值应该与forms组件的字段名称一致,不一致的键值不会去做校验

(3)form.is_valid() :做校验返回布尔值的,所有都通过才返回True,否则返回False。与forms组件字段无关的键值不影响返回结果。

if form.is_valid():  # 注意:form.is_valid是帮忙校验返回布尔值的,true或false(所有都通过才返回true)
    # 类定义的字段均符合要求,返回true,有多的字段直接忽略
    print(form.cleaned_data)   # {'name': 'yuan', 'pwd': '1234', 'r_pwd': '1234', 'email': '[email protected]', 'tel': '123123'}
else:
    # 有正确也有错误信息也是返回false
    print(form.cleaned_data)   # 字段值符合要求的放在cleaned_data    {'name': 'yuan', 'pwd': '123456', 'tel': '123123'}
    print(form.errors)         # 字段不符合要求的对应的键作为键,错误信息作为值   <ul class="errorlist"><li>r_pwd<ul class="errorlist">...

(4)form.cleaned_data:字段值符合要求的放在cleaned_data中。字典数据类型。

(5)form.errors:字段不符合要求的对应的键作为键,错误信息作为值。虽然返回结果比较复杂,但依然是字典数据类型,可以通过form.errors.get(“不符合的键”)来拿到键值,键值为列表数据类型。因此可以通过form.errors.get("不符合键")[0]拿到错误信息

二、渲染标签功能

1、渲染方式一:

视图函数:将forms空对象传给模板

from django import forms   # 引入forms组件

class UserForm(forms.Form):   # 必须继承forms.Form
    # forms.CharField和forms.EmailField会渲染为input标签
    name = forms.CharField(min_length=4)    # 默认label是字段名
    pwd = forms.CharField(min_length=4, label="密码")   # 如果需要中文label可以手动设置
    r_pwd = forms.CharField(min_length=4, label="确认密码")
    email = forms.EmailField(label="邮箱")
    tel = forms.CharField(label="手机")

def reg(request):
    form = UserForm()
    return render(request, "reg.html", locals())

模板:

<h3>form组件渲染方式1</h3>
<form action="" method="post">
    {% csrf_token %}
    <p>{{ form.name.label }}
        {{ form.name }}
    </p>
    <p>{{ form.pwd.label }}
        {{ form.pwd }}
    </p>
    <p>{{ form.r_pwd.label }}
        {{ form.r_pwd }}
    </p>
    <p>{{ form.email.label }}
        {{ form.email }}
    </p>
    <p>{{ form.tel.label }}
        {{ form.tel }}
    </p>
    <input type="submit">
</form>

渲染效果:

  

2、渲染方式二

  其他与方式一同理,但是用for循环获取forms对象内字段。

<h3>forms组件渲染方式2</h3>
<form action="" method="post">
    {% csrf_token %}
    {% for field in form %}
        <p>
            <label for="">{{ field.label }}</label>
            {{ field }}
        </p>
    {% endfor %}
    <input type="submit">
</form>

  渲染效果:

  

3、渲染方式三

  调用form对象的组件:as_p,即完成渲染。缺点是结构固定。(还有一种是as_ul)

<hr>
<h3>forms组件渲染方式3</h3>
<form action="" method="post">
    {% csrf_token %}
    {{ form.as_p }}
</form>

  渲染效果:

  

猜你喜欢

转载自www.cnblogs.com/xiugeng/p/9299083.html