Django框架4——form表单

HTML表单一直是交互性网站的支柱，使用form组件对用户通过表单提交的数据进行访问、有效性检查以及其他处理

从Request对象中获取数据

URL相关信息

属性/方法	说明	举例
request.path	除域名外的请求路径，以正斜杠开头	"/hellow/"
request.get_host()	主机名（比如，通常所说的域名）	"127.0.0.1:8000"or"www.example.com"
request.get_full_path()	请求路径，可能包含查询字符	"/hellow/?p=6"
request.is_secure()	如果通过HTTPS访问，返回True,否则返回False	True或False

request.META是一个字典，包含了所有本次HTTP请求的Header信息，比如用户IP地址和用户Agent(通常是浏览器的名称和版本号)，常见的有：

HTTP_USER_AGENT 用户浏览器的user-agent
REMOTE_ADDR 客户端IP

第一个Form类

表单框架最主要的用法是，为每一个将要处理的HTML的 <Form> 定义一个Form类。在这个例子中，我们只

有一个 <Form> ，因此我们只需定义一个Form类。这个类可以存在于任何地方，甚至直接写在 views.py

文件里也行，但惯例是把Form类都放到一个文件中：forms.py。在存放 views.py 的目录中，创建这

个文件，然后输入：

from django import forms

class RegisterForm(forms.Form):

    username = forms.CharField()

    pwd = forms.CharField()

    email = forms.EmailField(required = False)

这看上去简单易懂，并且很像在模块中使用的语法。表单中的每一个字段（域）作为Form类的属性，被展现

成Field类。这里只用到CharField和EmailField类型。每一个字段都默认是必填。要使email成为可选项，我

们需要指定required=False。

>>> from new.forms import RegisterForm

>>> r = RegisterForm()

>>> r

<RegisterForm bound=False, valid=Unknown, fields=(username;pwd;email)>

>>> print(r)

Form对象做的第一件事是将自己显示成HTML：

<tr><th><label for="id_username">Username:</label></th><td><input type="text" name="username" required id="id_username"></td></tr>

<tr><th><label for="id_pwd">Pwd:</label></th><td><input type="text" name="pwd" required id="id_pwd"></td></tr>

<tr><th><label for="id_email">Email:</label></th><td><input type="email" name="email" required id="id_email"></td></tr>

为了便于访问，Django用 <label> 标志，为每一个字段添加了标签。这个做法使默认行为尽可能合适。

默认输出按照HTML的< table >格式，另外有一些其它格式的输出：

>>> print(r.as_p())

<p><label for="id_username">Username:</label> <input type="text" name="username" required id="id_username"></p>

<p><label for="id_pwd">Pwd:</label> <input type="text" name="pwd" required id="id_pwd"></p>

<p><label for="id_email">Email:</label> <input type="email" name="email" required id="id_email"></p>

>>> print(r.as_ul())

![as_ul()](C:\Users\孙远新\OneDrive\Documents\django\图片\as_ul().jpg)<li><label for="id_username">Username:</label> <input type="text" name="username" required id="id_username"></li>

<li><label for="id_pwd">Pwd:</label> <input type="text" name="pwd" required id="id_pwd"></li>

<li><label for="id_email">Email:</label> <input type="email" name="email" required id="id_email"></li>

>>> print(r['username'])

<input type="text" name="username" required id="id_username">

Form对象做的第二件事是校验数据

>>> r.is_bound

True

调用任何绑定form的is_valid()方法，就可以知道它的数据是否合法。我们已经为每个字段传入了值，因此整

个Form是合法的：

>>> r.is_valid()

True

如果我们不传入email值，它依然是合法的。因为我们指定这个字段的属性required=False;但是，如果留空username或pwd，整个Form就不再合法了：

>>> r = RegisterForm({'username':'Amy','pwd':'abc13',})

>>> r.is_valid()

True

>>> r = RegisterForm({'pwd':'abc13','email':'amy@123.com'})

>>> r.is_valid()

False

如果多出其他属性,Form依然是合法的,

>>> r = RegisterForm({'username':'Amy','pwd':'abc13','w':24})

>>> r.is_valid()

True

查看字段的出错消息,Form实体都有一个errors属性，它为你提供了一个字段与错误消息相映射的字典表

>>> r.errors

{'username': ['This field is required.']}

你可以逐一查看每个字段的出错消息

>>> r['username'].errors

['This field is required.']

>>> r['pwd'].errors

[]

如果一个Form实体的数据是合法的，它就会有一个可用的cleaned_data属性。这是一个包含干净的提交

数据的字典。 Django的form框架不但校验数据，它还会把它们转换成相应的Python类型数据，这叫做清理数

据。例如Form实体的数据合法的情况下，可以清除掉{%csrf_token%}对应的name='csrfmiddlewaretoken'

>>> r.cleaned_data

{'pwd': 'abc13', 'email': 'amy@123.com'}

如果我们使用整数型或日期型，form框架会确保方法使用合适的Python整数型或datetime.date型对象。

在视图中使用Form对象

from django.shortcuts import render,redirect

from mysite.new.forms import RegisterForm

def register(request):

	if request.method == 'POST':

        form = RegisterForm(request.POST)

        if form.is_valid():

            cd = form.cleaned_data

            #创建用户  User.objects.creates(**cd)

            return redirect('/home/')

        else:

            return render(request,'register.html', {'form': form,})

    form = RegisterForm()

    return render(request,'register.html', {'form': form})

//register.html

<!DOCTYPE html>

<html lang="en">

<head>

	<meta charset="UTF-8">

	<title>Document</title>

</head>

<body>

	<form action=""  method='post' novalidate>

			<p><label for="">用户名</label>{{form.username}}<span class="error">{{form.errors.username.0}}</span></p>

			<p><label for="">密码</label>{{form.pwd}}<span class="error">{{form.errors.pwd.0}}</span> </p>

			<p><label for="">邮箱</label>{{form.pwd}}<span class="error">{{form.errors.email.0}}</span> </p>

		<input type="submit" value="确定">

	</form>

</body>

</html>

在浏览器中查看{{form.username}}

<input name="username" id="id_username" required="" type="text" value="xxx">

使用Form对象作为模板的好处：

input标签name属性的值自动与Form类中的字段保持一致，简化视图函数的代码
form.is_valid()为False,对输入的值进行返回，渲染在刷新面后的页面上

input标签的type默认为"text"，输入密码时要求为密文的形式，必须进行更改,此外为了页面的整体样式，还需要增加一些其他的属性

显示逻辑

class RegisterForm(forms.Form):

    #添加标签类名

    username = forms.CharField(label="用户名",widget=forms.TextInput(attrs={"class":"form-control"}),error_messages={'required':'该字段不能为空'})

    #

    pwd = forms.CharField(widget=forms.PasswordInput)

    email = forms.EmailField(required=False，error_messages={"invalid":"邮箱格式错误"})

自定义校验逻辑

#max_length=16

#min_length=8

from django import forms

from django.core.exceptions import ValidationError

from django.contrib.auth.models import User

class RegisterForm(forms.Form):

    username = forms.CharField(min_length=8,error_messages={'required':'该字段不能为空'})

    pwd = forms.CharField(widget=forms.PasswordInput)

    email = forms.EmailField(required=False，error_messages={"invalid":"邮箱格式错误"})

    def clean_username(self):

        username = self.cleaned_data['username']

        if Userinfo.objects.filter(username = username):

        	raise ValidationError("用户名已存在！")

        else:

            return username

Django的form系统自动寻找匹配的函数方法，该方法名称以clean_开头，并以字段名称结束。如果有这样的

方法，它将在校验时被调用。

特别地，clean_username()方法将在指定字段的默认校验逻辑执行之后*被调用。（本例中，在必

填CharField这个校验逻辑之后。）因为字段数据已经被部分处理，所以它被从self.cleaned_data中提取出来

了。同样，我们不必担心数据是否为空，因为它已经被校验过了。

forms.ValidationError型异常。这个异常的描述会被作为错误列表中的一项显示给用户

在函数的末尾显式地返回字段的值非常重要。我们可以在我们自定义的校验方法中修改它的值（或者把它转换

成另一种Python类型）。如果我们忘记了这一步，None值就会返回，原始的数据就丢失掉了。

指定标签

HTML表单中自动生成的标签默认是按照规则生成的：用空格代替下划线，首字母大写。如email的标签

是"Email" 。

自定义字段的标签

email = forms.EmailField(required=False, label='Your e‐mail address'*)

定制Form设计

class RegisterForm(forms.Form):

    username = forms.CharField(min_length=8,error_messages={'required':'该字段不能为空'},

                              widget=forms.TextInput(attrs={'placeholder':'输入用户名'})

    pwd = forms.CharField(widget=forms.PasswordInput)

    email = forms.EmailField(required=False，error_messages={"invalid":"邮箱格式错误"})

	'''

    def __init__(self, *args, **kwargs):

    	super().__init__(*args, **kwargs)

        for field in self.fields.values():

            field.widget.attrs.update({'class': 'form-control'})

	'''