在使用Form組件以前,咱們都是經過form表單來提交數據的,若是須要對form表單中的數據進行校驗,就要採用JQuery、ajax等來獲取各個用戶輸入的內容並進行判斷,若是不規範還要用一堆判斷去確認返回的結果。總之有些繁瑣,而Django中的Form組件則爲咱們提供了很便利的方法來完成以上操做。css
當咱們進行校驗時,前端能夠不進行校驗,可是後端是必須進行數據校驗的。由於前端的的防護簡直形如虛設,能夠在谷歌瀏覽器上經過 右鍵檢查--》ctrl+shift+c點擊對應的內容定位至對應代碼--》雙擊修改代碼(好比密碼顯示密文,能夠經過該方式將type修改成text讓密碼顯示爲明文)。html
Form組件能夠幫咱們完成一下三件事:前端
1. 首先須要先導入模塊,並定義一個Form類jquery
Form類中定義的字段其實就是Form組件校驗數據的依據,好比password長度咱們設置爲3~6,那麼當輸入的密碼長度不符合時就是校驗未經過。git
from django import forms # 乍一看是否是跟Django的ORM models派生類很像 class MyForm(forms.Form): # 定義name字段,最大長度6 name = forms.CharField(max_length=6) # 定義password字段,長度至少爲3,最大長度6 password = forms.CharField(max_length=6, min_length=3) # 定義email字段 email = forms.EmailField()
2. 實例化對象,實例化時能夠傳一個字典或者不傳web
實例化出的Form對象有is_valid()、errors、cleaned_data等方法。接下來在配置好的tests.py文件中測試一下。ajax
測試用的.py文件中必須爲如下格式:正則表達式
from django.test import TestCase # Create your tests here. import os import sys if __name__ == "__main__": os.environ.setdefault("DJANGO_SETTINGS_MODULE", "untitled1.settings") import django django.setup() # 這裏開始寫測試的代碼,須要導入模塊也要從這裏開始寫導入語法
測試結果以下,發現form_obj.errors打印爲空。數據庫
繼續測試,將實例化時傳入的字典修改一下:django
注意:
瞭解了校驗數據的方式以及錯誤信息存放處errors,接下來就是了解渲染標籤了。
首先要實例化一個Form空對象,而後將其傳至前端,使用模板語法進行渲染。
def register(request): # 實例化一個Form空對象 form_obj = MyForm() return render(request, 'register.html', locals()) # 這是自定義的Form類 class MyForm(forms.Form): name = forms.CharField(max_length=6) password = forms.CharField(max_length=6, min_length=3) email = forms.EmailField()
Form組件三種渲染的方式:
第一種(封裝性高,擴展性差):
{{ form_obj.as_p }}
執行以上代碼的效果:
執行{{ form_obj }}和{{ form_obj.as_table }},發現結果一致,因此看來默認是as_table:
第二種渲染方式:
<form action=""> <!--.label是取出字段屬性lable的值,未設置時默認用首字母大寫的字段名--> <p>{{ form_obj.name.label }}{{ form_obj.name }}</p> <p>{{ form_obj.password.label }}{{ form_obj.password }}</p> <p>{{ form_obj.email.label }}{{ form_obj.email }}</p> <input type="submit"> </form>
因此咱們能夠給字段設置lable屬性:
class MyForm(forms.Form): name = forms.CharField(max_length=6, label='用戶名') password = forms.CharField(max_length=6, min_length=3, label='密碼') email = forms.EmailField(label='郵箱')
如今看結果:
根據以上結果,能夠大膽猜想Form類實例化出的對象form_obj是一個可迭代對象!!!
第三種渲染方式(建議使用該方式):
<form action=""> <!--這裏的foo就是字段對象,好比form_obj.name--> {% for foo in form_obj %} <p>{{ foo.label }}{{ foo }}</p> {% endfor %} </form>
注意:Form組件只會幫咱們渲染獲取用戶輸入的標籤,提交按鈕須要咱們本身添加。
使用第三種渲染方式,手動添加提交按鈕:
<form action="" method="post"> {% for foo in form_obj %} <p>{{ foo.label }}{{ foo }}</p> {% endfor %} <input type="submit"> </form>
如今運行代碼,發現前端隨便輸入數據,點擊提交時會有提示了:
能夠給form表單設置novalidate取消前端的校驗:
<form action="" method="post" novalidate></form>
以前說後端的校驗時必須的,接下來咱們一塊兒看看後端校驗(前提是要關閉前端校驗,否則數據只要有錯都提交不到後端):
def register(request): form_obj = MyForm() if request.method == 'POST': print(request.POST) # 以前說Form類實例化能夠傳一個字典,而request.POST剛好是一個相似字典的對象 form_obj = MyForm(request.POST) print(form_obj.is_valid()) print(form_obj.cleaned_data) print(form_obj.errors) return render(request, 'register.html', locals())
輸入數據,看一下後端校驗的結果:
校驗數據未經過時咱們須要將錯誤信息展現在相應位置,經過增長一個span來實現:
<form action="" method="post" novalidate> {% for foo in form_obj %} <p>{{ foo.label }}{{ foo }}</p> <!--foo是字段對象,能夠經過.errors拿出錯誤信息,若是沒有則爲空--> <span>{{ foo.errors }}</span> {% endfor %} <input type="submit"> </form>
看相應結果:
結果不對對勁,錯誤信息通常是顯示在對應輸入框的後面,而此處錯誤信息顯示的仍是ul列表的形式,修改代碼{{ foo.errors.0 }}拿出第一個元素,同時將span標籤頁一塊兒放入p標籤中:
<form action="" method="post" novalidate> {% for foo in form_obj %} <p>{{ foo.label }}{{ foo }}<span>{{ foo.errors.0 }}</span></p> {% endfor %} <input type="submit"> </form>
接下來再看結果:
到這裏,有沒有疑惑爲何點擊提交後頁面刷新了而數據卻還在,其實這是由於後端將本來的form_obj替換了一個同名的,而裏面的數據就是前段提交的數據。
修改後端視圖函數代碼:
def register(request): form_obj = MyForm() if request.method == 'POST': print(request.POST) # 以前說Form類實例化能夠傳一個字典,而request.POST剛好是一個相似字典的對象 form_obj = MyForm(request.POST) # 若是校驗所有經過,返回消息 if form_obj.is_valid(): return HttpResponse('校驗所有經過') return render(request, 'register.html', locals())
3.1 自定義報錯信息
到如今爲止,咱們能夠發現報錯信息全是英文,咱們能夠自定義報錯信息,只須要經過在Form類定義的字段中增長error_messages={ 「報錯類型」:‘報錯信息’ }:
class MyForm(forms.Form): name = forms.CharField(max_length=6, label='用戶名', error_messages={ 'max_length': '用戶名最多6位', 'required': '用戶名不能爲空' }) password = forms.CharField(max_length=6, min_length=3, label='密碼',error_messages={ 'min_length': '密碼不能小於3位', 'max_length': '密碼最多6位', 'required': '密碼不能爲空' }) email = forms.EmailField(label='郵箱')
試驗結果:
要試驗用戶名超過6位的報錯,必須執行如下操做(前端防護真的菜):
3.2 密碼實現密文
密碼輸入是明文簡直不要太酸爽,將密碼變爲密文須要藉助字段的widget屬性(須要使用widgets模塊):
from django import forms # 若是forms.widgets點不出來就須要導入widgets from django.forms import widgets password = forms.CharField(max_length=6, min_length=3, label='密碼',
widget=widgets.PasswordInput())
3.2 實現註冊功能,且名字不含66
大體思路以下:
局部鉤子函數與全局鉤子函數:
在Form類中定義一個函數名爲 clean_字段名 的函數即爲局部鉤子函數,裏面能夠經過self.cleaned_data.get('字段名')來獲取字段的值,隨後在該函數中對該字段進行各類判斷,對應的錯誤信息經過self.add_error('字段名', '錯誤信息')添加。
全局鉤子函函數名爲 clean 的函數,裏面能夠對多個字段進行操做,最後返回self.cleaned_data。
使用鉤子函數時,咱們使用self.add_error是自定義異常,也能夠選擇主動拋出異常ValidationError,該異常拋出時會被Form組件檢測到並將異常主動加入errors中,並不會影響到服務端的運行。
from django.core.exceptions import ValidationError def clean_name(self): name = self.cleaned_data.get('name') if '666' in name: # 1.主動拋出異常 raise ValidationError("光喊666是不行的") # 2.自定義異常 self.add_error({'name','光喊666是不行的'}) return name
最終代碼以下:
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>register</title> <script src="https://cdn.bootcss.com/jquery/3.4.1/jquery.min.js"></script> <script src="https://cdn.bootcss.com/twitter-bootstrap/3.4.1/js/bootstrap.min.js"></script> <link href="https://cdn.bootcss.com/twitter-bootstrap/3.4.1/css/bootstrap.min.css" rel="stylesheet"> </head> <body> <form action="" 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>
from django.shortcuts import render, HttpResponse, reverse, redirect from app01 import models from django import forms from django.forms import widgets # Create your views here. def register(request): form_obj = MyForm() if request.method == 'POST': print(request.POST) # 以前說Form類實例化能夠傳一個字典,而request.POST剛好是一個相似字典的對象 form_obj = MyForm(request.POST) if form_obj.is_valid(): return HttpResponse('校驗所有經過') return render(request, 'register.html', locals()) class MyForm(forms.Form): name = forms.CharField(max_length=6, label='用戶名', error_messages={ 'max_length': '用戶名最多6位', 'required': '用戶名不能爲空' }) password = forms.CharField(max_length=6, min_length=3, label='密碼',error_messages={ 'min_length': '密碼不能小於3位', 'max_length': '密碼最多6位', 'required': '密碼不能爲空', }, widget=widgets.PasswordInput()) re_password = forms.CharField(max_length=6, min_length=3, label='確認密碼', widget=widgets.PasswordInput()) email = forms.EmailField(label='郵箱', error_messages={'invalid': '格式錯誤'}) def clean_name(self): name = self.cleaned_data.get('name') if '66' in name: self.add_error('name', '名字太6了可不行') return name def clean(self): password = self.cleaned_data.get('password') re_password = self.cleaned_data.get('re_password') if password != re_password: self.add_error('re_password', '兩次密碼不一致') return self.cleaned_data
注意:使用鉤子函數時,只有鉤子函數所需字段校驗經過了纔會去執行該鉤子函數,也就是說鉤子函數中self.add_error方法添加的錯誤信息顯示優先級是低於字段中error_messages屬性中定義的錯誤信息的。
舒適提示:
class LoginForm(forms.Form): username = forms.CharField( min_length=8, label="用戶名", initial="張三", error_messages={ "required": "不能爲空", "invalid": "格式錯誤", "min_length": "用戶名最短8位" } ... def __init__(self, *args, **kwargs): super(LoginForm, self).__init__(*args, **kwargs) for field in iter(self.fields): self.fields[field].widget.attrs.update({ 'class': 'form-control' })
建立Form類時,主要涉及字段與插件,字段字段用於對用戶請求數據的驗證,插件用於自動生成HTML。
1. initial
input框裏的初始值
class LoginForm(forms.Form): username = forms.CharField( min_length=8, label="用戶名", initial="張三" # 設置默認值 ) pwd = forms.CharField(min_length=6, label="密碼")
2. error_messages
自定義錯誤信息
class LoginForm(forms.Form): username = forms.CharField( min_length=8, label="用戶名", initial="張三", error_messages={ # '屬性名': '錯誤信息' "required": "不能爲空", "min_length": "用戶名最短8位" } ) pwd = forms.CharField(min_length=6, label="密碼")
3. radioSelect
通常用於性別選擇等。
class LoginForm(forms.Form): gender = forms.fields.ChoiceField( choices=((1, "男"), (2, "女"), (3, "保密")), label="性別", # 默認選擇第3個 initial=3, widget=forms.widgets.RadioSelect() )
4.單選Select
class LoginForm(forms.Form): hobby = forms.ChoiceField( choices=((1, "籃球"), (2, "足球"), (3, "雙色球"), ), label="愛好", initial=3, widget=forms.widgets.Select() )
5.多選Select
class LoginForm(forms.Form): hobby = forms.MultipleChoiceField( choices=((1, "籃球"), (2, "足球"), (3, "雙色球"), ), label="愛好", # 默認的選多個值時要用列表 initial=[1, 3], widget=forms.widgets.SelectMultiple() )
6.單選checkbox
class LoginForm(forms.Form): keep = forms.ChoiceField( label="是否記住密碼", initial="checked", widget=forms.widgets.CheckboxInput() )
6.多選checkbox
class LoginForm(forms.Form): hobby = forms.MultipleChoiceField( choices=((1, "籃球"), (2, "足球"), (3, "雙色球"),), label="愛好", initial=[1, 3], widget=forms.widgets.CheckboxSelectMultiple() )
小提示:ChoiceFIeld實例化的字段對象,widget默認是forms.widgets.Select(),CharField實例化的字段對象默認是forms.widgets.Input()。
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內置字段
在使用選擇標籤時,須要注意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()) # 單選
一般在Django項目中,咱們編寫的大部分都是與Django 的模型緊密映射的表單。 舉個例子,你也許會有個Book 模型,而且你還想建立一個form表單用來添加和編輯書籍信息到這個模型中。 在這種狀況下,在form表單中定義字段將是冗餘的,由於咱們已經在模型中定義了那些字段。
基於這個緣由,Django 提供一個輔助類來讓咱們能夠從Django 的模型建立Form,這就是ModelForm。
ModelForm顧名思義就Form和Django的Model數據庫模型結合體,能夠簡單、方便得對數據庫進行增長、編輯操做和驗證標籤的生成。
ModelForm是Django Model.py和Form組件的結合體,能夠簡單/快速使用 Form驗證和數據庫操做功能,但不如Form組件靈活,若是在使用Django作web開發過程當中驗證的數據和數據庫字段相關(能夠對錶進行增、刪、改操,注意 Many to many字段,也能夠級聯操做第3張關係表;),建議優先使用ModelForm,用起來更方便些,可是在使用ModelForm的時候慎用fields='__all__',獲取數據庫全部字段勢必形成性能損耗。
1. modelForm定義
class BookForm(forms.ModelForm): class Meta: model = models.Book fields = "__all__" labels = { "title": "書名", "price": "價格" } widgets = { "password": forms.widgets.PasswordInput(attrs={"class": "c1"}), }
2. class Meta下經常使用參數
model = models.Book # 對應的Model中的類 fields = "__all__" # 字段,若是是__all__,就是表示列出全部的字段 exclude = None # 排除的字段 labels = None # 提示信息 help_texts = None # 幫助提示信息 widgets = None # 自定義插件 error_messages = None # 自定義錯誤信息
3. ModelForm的驗證
與普通的Form表單驗證類型相似,ModelForm表單的驗證在調用is_valid() 或訪問errors 屬性時隱式調用。咱們能夠像使用Form類同樣自定義局部鉤子方法和全局鉤子方法來實現自定義的校驗規則。若是咱們不重寫具體字段並設置validators屬性的話,ModelForm是按照模型中字段的validators來校驗的。
4. save()方法
每一個ModelForm還具備一個save()方法。 這個方法根據表單綁定的數據建立並保存數據庫對象。 ModelForm的子類能夠接受現有的模型實例做爲關鍵字參數instance;若是提供此功能,則save()將更新該實例。 若是沒有提供,save() 將建立模型的一個新實例:
>>> from myapp.models import Book >>> from myapp.forms import BookForm # 根據POST數據建立一個新的form對象 >>> form_obj = BookForm(request.POST) # 建立書籍對象 >>> new_ book = form_obj.save() # 基於一個書籍對象建立form對象 >>> edit_obj = Book.objects.get(id=1) # 使用POST提交的數據更新書籍對象 >>> form_obj = BookForm(request.POST, instance=edit_obj) >>> form_obj.save()
舉個小例子:
from app02 import models from django.forms import ModelForm class UserModalForm(ModelForm): class Meta: model=models.UserInfo #(該字段必須爲 model 數據庫中表) fields= '__all__' #(該字段必須爲 fields 數據庫中表) def add(request): # 實例化models_form if request.method=='GET': obj = UserModalForm() return render(request,'register.html',locals()) else: obj=UserModalForm(request.POST) if obj.is_valid(): data=obj.cleaned_data obj.save() #form驗證經過直接 添加用戶信息到數據庫 return render(request, 'register.html', locals())
有興趣能夠百度自行學習。
1. RegexValidator驗證器
from django.forms import Form from django.forms import widgets from django.forms import fields from django.core.validators import RegexValidator class MyForm(Form): user = fields.CharField( validators=[RegexValidator(r'^[0-9]+$', '請輸入數字'), RegexValidator(r'^159[0-9]+$', '數字必須以159開頭')], )
2.自定義驗證函數
import re from django.forms import Form from django.forms import widgets from django.forms import fields from django.core.exceptions import ValidationError # 自定義驗證規則 def mobile_validate(value): mobile_re = re.compile(r'^(13[0-9]|15[012356789]|17[678]|18[0-9]|14[57])[0-9]{8}$') if not mobile_re.match(value): raise ValidationError('手機號碼格式錯誤') class PublishForm(Form): title = fields.CharField(max_length=20, min_length=5, error_messages={'required': '標題不能爲空', 'min_length': '標題最少爲5個字符', 'max_length': '標題最多爲20個字符'}, widget=widgets.TextInput(attrs={'class': "form-control", 'placeholder': '標題5-20個字符'})) # 使用自定義驗證規則 phone = fields.CharField(validators=[mobile_validate, ], error_messages={'required': '手機不能爲空'}, widget=widgets.TextInput(attrs={'class': "form-control", 'placeholder': u'手機號碼'})) email = fields.EmailField(required=False, error_messages={'required': u'郵箱不能爲空','invalid': u'郵箱格式錯誤'}, widget=widgets.TextInput(attrs={'class': "form-control", 'placeholder': u'郵箱'}))