一 form组件的存在,简化了form的验证等操作。
二 导入form
from django import forms
三 最简单的例子
前端代码
<form action="/form_login/" method="post"> <p>姓名:{{ formlogin.username }}</p> <p>密码:{{ formlogin.password }}</p> <p><input type="submit" value="提交"></p> </form>
视图代码
class FormLogin(forms.Form): username=forms.CharField(min_length=5, max_length=10, error_messages={'required': '不能为空!', 'min_length': '最小长度为5!', 'max_length': '最大长度为10!'}) password=forms.CharField(min_length=5, max_length=10, error_messages={'required': '不能为空!', 'min_length': '最小长度为5!', 'max_length': '最大长度为10!'}) #error_message={},自定义错误信息。如果没有这个参数,默认错误信息是英文。 def form_login(request): if request.method=='POST': formlogin=FormLogin(request.POST) #绑定数据的表单实例 formlogin=FormLogin() #未绑定数据的表单实例 print('formlogin',formlogin,type(formlogin)) return render(request,'form_login.html',{'formlogin':formlogin})
输出:
formlogin <tr><th><label for="id_username">Username:</label></th><td><input type="text" name="username" maxlength="10" minlength="5" required id="id_username" /></td></tr> <tr><th><label for="id_password">Password:</label></th><td><input type="text" name="password" maxlength="10" minlength="5" required id="id_password" /></td></tr> <class 'app01.views.FormLogin'>
Django给每个input框的id默认取值为id_+FormLogin的字段
四 form组件微进阶
准备知识
登录成功是cleaned_data 是个什么东西
def form_login(request): if request.method=='POST': formlogin=FormLogin(request.POST) if formlogin.is_valid(): print(formlogin.cleaned_data,type(formlogin.cleaned_data)) return HttpResponse('ok')
输出:
{'username': 'aaaaaaaaa', 'password': 'aaaaaa'} <class 'dict'>
cleaned_data是一个字典。
判断成功:,username=cleaned_data.get('username'),password=cleaned_data.get('password')。
User.objects.filter(username='username',password='password'),判断用户名,密码是否正确。
更为高端更为屌的写法是:User.objects.filter(**cleaned_data)。注意,input的name值须与与auth.user表的相关联的字段名保持一致。
判断失败:这才是我们更需要关心的重点。
登录不成功时,errors是个什么东西
def form_login(request): if request.method=='POST': formlogin=FormLogin(request.POST) if formlogin.is_valid(): print(formlogin.cleaned_data,type(formlogin.cleaned_data)) return redirect('/index/') else: print(formlogin.errors,type(formlogin.errors)) #formlogin.errers格式是ErrorDict return HttpResponse('ok')
输出:
<ul class="errorlist"><li>username<ul class="errorlist"><li>最小长度为5!</li></ul></li><li>password<ul class="errorlist"><li>最小长度为5!</li></ul></li></ul> <class 'django.forms.utils.ErrorDict'>
formlogin.errors通过get方法取其错误提示信息。
问题来了,用户输入的可能不符合规定的条件有好几个,假如由name='xxx'定位的input有三处错误,那么errors里对应对'xxx'后面跟的错误也是三个。需要一次性给用户提示出来吗?
实际上并不需要如此。取其索引值为0,一次一个的提示用户的错误信息即可。 在前面页面中,渲染时便可实现。通过点号 . 。句点符可以调用属性,key value值,索引。
核心代码
前端
<form action="/form_login/" method="post"> {% csrf_token %} <p>姓名:{{ formlogin.username }} <span>{{ error_all.username.0 }}</span></p> <p>密码:{{ formlogin.password }} <span>{{ error_all.password.0 }}</span></p> <p><input type="submit" value="提交"></p> </form>
视图函数
def form_login(request): if request.method=='POST': formlogin=FormLogin(request.POST) if formlogin.is_valid(): print(formlogin.cleaned_data,type(formlogin.cleaned_data)) return redirect('/index/') else: error_all=formlogin.errors return render(request,'form_login.html',{'error_all':error_all,'formlogin':formlogin})
五 form组件的进阶
1 widgets
官方文档地址:http://python.usyiyi.cn/documents/django_182/ref/forms/widgets.html
Widget 是Django 对HTML 输入元素的表示。Widget 负责渲染HTML和提取GET/POST 字典中的数据。
小贴士
不要将Widget 与表单字段搞混淆。表单字段负责验证输入并直接在模板中使用。Widget 负责渲染网页上HTML 表单的输入元素和提取提交的原始数据。但是,Widget 需要赋值给表单字段。
from django.forms import widgets
attrs参数
在真正得网页中,你可能不想让每个Widget 看上去都一样。可以指定‘type’ 属性使用的是新式的HTML5 输入类型。在创建Widget 时使用Widget.attrs 参数可以实现。
password=forms.CharField(min_length=5, max_length=10, error_messages={'required': '不能为空!', 'min_length': '最小长度为5!', 'max_length': '最大长度为10!'},widget=widgets.Textarea(attrs={'style': 'color:red'}))
其他形式:
widget=widgets.TextInput(attrs={'class':'form-control'})
widget=widgets.PasswordInput(attrs={'class':'form-control'})
2 表单字段 很重要!!
官方文档地址:http://python.usyiyi.cn/documents/django_182/ref/forms/fields.html
class Field(**kwargs)¶
创建一个表单类时,最重要的部分是定义表单的字段。每个字段都可以有自定义的验证逻辑,以及一些其它的钩子。
-
Field.
clean(value)
¶
虽然字段类主要使用在表单类中,但你也可以直接实例化它们来使用,以便更好地了解它们是如何工作的。每个字段实例都有一个clean()方法, 它接受一个参数,然后返回“清洁的”数据或者抛出一个django.forms.ValidationError异常:
>>> from django import forms >>> f = forms.EmailField() >>> f.clean('foo@example.com') 'foo@example.com' >>> f.clean('invalid email address') Traceback (most recent call last): ... ValidationError: ['Enter a valid email address.']