使用Django提供得forms 表單模塊構建得表單結構,能夠在數據出現錯誤,返回頁面中仍能夠保留以前輸入得數據,一樣能夠限制字段條件;
1. 在app 包路徑 建立一個forms_to.py 用於定義類:html
from django import forms from django.forms import widgets # 經過定義一個 類 來設置全部的標籤類型 # IntegerField 只容許爲數字 # CharField 爲字符串 # EmailField 格式須要爲 Email class RegForm(forms.Form): # 長度最多 12 字符,最少 6 字符; # 當超出該字符時,瀏覽器會阻止多餘字符得輸入; # 當少於這些字符時,會返回 min_length 得提示 (可自定義) username = forms.CharField( max_length=12, min_length=6, error_messages={"required": "該字段不能爲空", "min_length":"最少爲6字符", "max_length":"最多爲12個字符"}) password = forms.IntegerField( # widgets.PasswordInput() 用於渲染密碼 加密 widget=widgets.PasswordInput(), error_messages={"invalid": "格式錯誤,必須爲數字"} ) repeat_password = forms.CharField( # 能夠添加 標籤屬性 widget=widgets.PasswordInput(attrs={"class": "pwd"}) error_messages={"required": "該字段不能爲空",} ) email = forms.EmailField() umout = forms.CharField( # 用戶 渲染 select 標籤下拉框 widget=widgets.Select(choices=((1, "上海"), (2, "北京"))) )
2. 在views.py中引入forms_to.py 並實例化該類:前端
from django.shortcuts import render,redirect,HttpResponse # 導入自定義的 forms_to form表單類 from app01 import forms_to def reg(request): # 若是請求方式爲 POST 獲取前端傳入的 值 if request.method == "POST": # 將傳入的值,放入到 RegForm 進行實例化 regForm = forms_to.RegForm(request.POST) # 傳入值的實例化數據,有一個is_valid 屬性;當全部的驗證都經過的時候返回 True if regForm.is_valid(): # 所有正確 數據 依照字典的形式 都存放在 regForm.cleaned_data 裏面 print("全對:", regForm.cleaned_data) # {'email': 'asdfsdf@qq.com', 'umout': '1', 'password': 'asdfasdf', 'username': 'asdfas', 'repeat_password': 'safdsaf'} username = regForm.cleaned_data.get("username") password = regForm.cleaned_data.get("password") # 將獲取的數據存入數據庫便可 else: # 只要有錯誤,就會走 else # 並在 regForm.errors 存放 錯誤得部分 # 在regForm.cleaned_data 存放 正確得部分 # print(regForm.errors.get("username")[0]) # 存放 錯誤的信息 print(regForm.cleaned_data) return render(request, "reg.html", {"regForm": regForm}) # 實例化 RegForm 類 並將 實例化的結果傳給 前端渲染 regForm=forms_to.RegForm() return render(request, "reg.html", {"regForm": regForm})
3. 在views.py中引入forms_to.py 並實例化該類:python
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Title</title> <style> .error{ color: red; } </style> </head> <body> <form action="/reg/" method="post"> {% csrf_token %} {# 模板中使用regForm 獲取實例化得方法 #} {# regForm.errors.username.0 獲取傳入錯誤得第一個錯誤 #} <p>姓名{{ regForm.username }}<span class="error">{{ regForm.errors.username.0 }}</span></p> <p>密碼{{ regForm.password }}<span class="error">{{ regForm.errors.password.0 }}</span></p> <p>確認密碼{{ regForm.repeat_password }}<span class="error">{{ regForm.errors.repeat_password.0 }}</span></p> <p>郵箱{{ regForm.email }}<span class="error">{{ regForm.errors.email.0 }}</span></p> <p>城市{{ regForm.umout }}</p> <p><input type="submit" value="提交"></p> </form> </body> </html>
Field required=True, 是否容許爲空 widget=None, HTML插件 label=None, 用於生成Label標籤或顯示內容 initial=None, 初始值 help_text='', 幫助信息(在標籤旁邊顯示) error_messages=None, 錯誤信息 {'required': '不能爲空', 'invalid': '格式錯誤'} show_hidden_initial=False, 是否在當前插件後面再加一個隱藏的且具備默認值的插件(可用於檢驗兩次輸入是否一直) 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類型 ...
# 單radio,值爲字符串 # user = fields.CharField( # initial=2, # widget=widgets.RadioSelect(choices=((1,'上海'),(2,'北京'),)) # ) # 單radio,值爲字符串 # user = fields.ChoiceField( # choices=((1, '上海'), (2, '北京'),), # initial=2, # widget=widgets.RadioSelect # ) # 單select,值爲字符串 # user = fields.CharField( # initial=2, # widget=widgets.Select(choices=((1,'上海'),(2,'北京'),)) # ) # 單select,值爲字符串 # user = fields.ChoiceField( # choices=((1, '上海'), (2, '北京'),), # initial=2, # widget=widgets.Select # ) # 多選select,值爲列表 # user = fields.MultipleChoiceField( # choices=((1,'上海'),(2,'北京'),), # initial=[1,], # widget=widgets.SelectMultiple # ) # 單checkbox # user = fields.CharField( # widget=widgets.CheckboxInput() # ) # 多選checkbox,值爲列表 # user = fields.MultipleChoiceField( # initial=[2, ], # choices=((1, '上海'), (2, '北京'),), # widget=widgets.CheckboxSelectMultiple # )