一、DjangoForm組件介紹

我們之前在html頁面中利用form表單向后端提交數(shù)據(jù)時，都會寫一些獲取用戶輸入的標(biāo)簽并且用form標(biāo)簽把它們包起來。

與此同時我們在好多場景下都需要對用戶的輸入做校驗，比如驗證用戶是否輸入，輸入的長度和格式等是否正確，如果用戶輸入的內(nèi)容有錯誤就需要在頁面上相應(yīng)的位置顯示對應(yīng)的錯誤信息。

Django Form組件就實現(xiàn)了上面所述的功能。

1、生成頁面可用的html標(biāo)簽（生成input框）

2、對用戶提交的數(shù)據(jù)進(jìn)行校驗

3、錯誤信息的展示

4、保留上次的輸入

缺點：只能生成form表單里面的內(nèi)容，form標(biāo)簽需要自己建立，提交的按鈕需要自己寫，csrf_token也需要自己添加

二、form組件的字段和插件

創(chuàng)建form類時，主要涉及到【字段】和【插件】，字段用于對用戶請求數(shù)據(jù)的驗證，插件用于自動生成html

字段創(chuàng)建，默認(rèn)為input框中的類型為text，可以通過插件來修改成按鈕，多選框等等。

想通過插件修改，需要導(dǎo)入插件模塊：from django.forms import widgets

1、字段

CharField(參數(shù))? 所有的字段都繼承Field類，初始化都是TextFied，改變type都可以通過widgets改變

注：所有的字段類型都可以用CharField，然后通過widgets來修改

ChoiceField()? ?選擇類的字段

通過widgets可改變?yōu)?#xff1a;widget = forms.widgets.radioSelect()

　　radioSelect(單選按鈕)

　　Select（單選下拉）

　　SelectMultiple（多選下拉）

　　checkbox（單選方形按鈕）

　　checkboxSelectMultiple(多選方形按鈕)

示例：如何使用choiseField字段，及使用數(shù)據(jù)庫中的數(shù)據(jù)
class LoginForm(forms.Form):...hobby = forms.fields.ChoiceField(# choices=((1, "籃球"), (2, "足球"), (3, "雙色球"),),choices= models.Hobby.object.all().values_list("id", "name")label="愛好",initial=[1, 3],widget=forms.widgets.CheckboxSelectMultiple()) # 上面choices就用到了從數(shù)據(jù)庫中獲取數(shù)據(jù)，但這種方式，每次更改數(shù)據(jù)庫，都需要重啟項目，前端才能更新信息

關(guān)于choice的注意事項：

在使用選擇標(biāo)簽字段時，需要注意choices的選項可以從數(shù)據(jù)庫中獲取，但時由于時靜態(tài)字段，獲取的值無法實時更新，即

中途向數(shù)據(jù)庫中添加數(shù)據(jù)，前端不會實時更新，需要重啟項目的問題，但重啟項目明顯不好，故可通過構(gòu)造函數(shù)，每次查詢時，都先去數(shù)據(jù)庫中查一下使用的數(shù)據(jù)庫中的字段。將如下的方法也放到類中即可。

方案一

def __init__(self, *args, **kwargs):super().__init__(*args, **kwargs)self.fields['hobby3'].choices = models.Hobby.objects.all().values_list('id', 'name')

注：其中fields代表的是自定義form類中所有的字段
注：當(dāng)定義了__init__方法，那么類中對應(yīng)字段的choices就可以刪掉了

方案二

from django import forms from django.forms import fields from django.forms import models as form_modelclass FInfo(forms.Form):authors = form_model.ModelMultipleChoiceField(queryset=models.NNewType.objects.all()) # 多選# authors = form_model.ModelChoiceField(queryset=models.NNewType.objects.all()) # 單選

DjangoForm所有的內(nèi)置字段

Fieldrequired=True, 是否允許為空widget=None, HTML插件label=None, 用于生成Label標(biāo)簽或顯示內(nèi)容initial=None, 初始值help_text='', 幫助信息(在標(biāo)簽旁邊顯示)error_messages=None, 錯誤信息 {'required': '不能為空', 'invalid': '格式錯誤'}validators=[], 自定義驗證規(guī)則localize=False, 是否支持本地化disabled=False, 是否可以編輯label_suffix=None Label內(nèi)容后綴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, 小數(shù)位長度BaseTemporalField(Field)input_formats=None 時間格式化 DateField(BaseTemporalField) 格式：2015-09-01 TimeField(BaseTemporalField) 格式：11:12 DateTimeField(BaseTemporalField)格式：2015-09-01 11:12DurationField(Field) 時間間隔：%d %H:%M:%S.%f...RegexField(CharField)regex, 自定制正則表達(dá)式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函數(shù)中 obj = MyForm(request.POST, request.FILES)URLField(Field)...BooleanField(Field) ...NullBooleanField(BooleanField)...ChoiceField(Field)...choices=(), 選項，如：choices = ((0,'上海'),(1,'北京'),)required=True, 是否必填widget=None, 插件，默認(rèn)select插件label=None, Label內(nèi)容initial=None, 初始值help_text='', 幫助提示ModelChoiceField(ChoiceField)... django.forms.models.ModelChoiceFieldqueryset, # 查詢數(shù)據(jù)庫中的數(shù)據(jù)empty_label="---------", # 默認(rèn)空顯示內(nèi)容to_field_name=None, # HTML中value的值對應(yīng)的字段limit_choices_to=None # ModelForm中對queryset二次篩選 ModelMultipleChoiceField(ModelChoiceField)... django.forms.models.ModelMultipleChoiceFieldTypedChoiceField(ChoiceField)coerce = lambda val: val 對選中的值進(jìn)行一次轉(zhuǎn)換empty_value= '' 空值的默認(rèn)值MultipleChoiceField(ChoiceField)...TypedMultipleChoiceField(MultipleChoiceField)coerce = lambda val: val 對選中的每一個值進(jìn)行一次轉(zhuǎn)換empty_value= '' 空值的默認(rèn)值ComboField(Field)fields=() 使用多個驗證，如下：即驗證最大長度20，又驗證郵箱格式fields.ComboField(fields=[fields.CharField(max_length=20), fields.EmailField(),])MultiValueField(Field)PS: 抽象類，子類中可以實現(xiàn)聚合多個字典去匹配一個值，要配合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=''GenericIPAddressFieldprotocol='both', both,ipv4,ipv6支持的IP格式unpack_ipv4=False 解析ipv4地址，如果是::ffff:192.0.2.1時候，可解析為192.0.2.1， PS：protocol必須為both才能啟用SlugField(CharField) 數(shù)字，字母，下劃線，減號（連字符）...UUIDField(CharField) uuid類型 Django Form內(nèi)置字段

2、參數(shù)

label? ? ? ?顯示的文本，如input框前的“用戶名：”

initail? ? ? ?初始化的值，即默認(rèn)值

required? ? 是否必填，required=True

help_text? ?在input框后的提示信息

error_messages?={"min_length": '太短了'，"required"： '此數(shù)字必須填寫'} ?定義字段，驗證不通過時提示的錯誤信息，格式為字典? ?

widget = forms.widgets.PasswrodInput(attrs={'class': "form_contronl"})? ? 加插件，可以改變input框的類型，也可以為input標(biāo)簽加各種屬性，如class，style等等。

validators = [驗證器1，]? ?里面可以時django默認(rèn)的驗證器，也可以自己定義驗證方法，然后放入其中

?3、驗證

1、djangoForm組件字段驗證順序

form_obj.is_vaild()==> 通過則將字段加入clean_data字典集合中，如果不通過，則報錯，不會將對應(yīng)字段名加入到字典中，故后面自定義的方法是拿不到字段的

　　　　|

django自己的clean(self) 方法??

　　　　|

自定義的clean_字段名 的方法 ==>? 系統(tǒng)會通過反射檢索是否自定義以clean_開頭的方法，如果有就執(zhí)行

　　　　|

自定義的clean(self) 方法? ==> 這個方法是全局的，對所有的字段校驗，本質(zhì)是復(fù)寫django的clean方法

2、form校驗的幾種方式

　　validators = [驗證器1，]?

　　2.1、內(nèi)置的驗證

　　　　max_length/min_length

　　　　required

　　2.2、自定義驗證器

　　　　方式一、　　　　

• from django.core.Validators import RegexCalidator 有很多這樣的類，這個是正則驗證的模塊validators=[RegexValidator(r'^[a-zA-Z][a-zA-Z0-9_@]{4,18}', '4~18個字符，首字符為字母')]格式為：前部分為正則，后半部分為提示信息

　　 　方式二、　　　　　　　

• # 定義函數(shù)
  from django.core.exceptions import ValidationErrordef validator_check(value):# 定義方法，設(shè)計規(guī)則，用于驗證if 'sex' in value:raise ValidationError('含有非法字符')
  
  然后在類中的字段 validators中調(diào)用方法即可，validators = [validator_check] # 不用加括號

　　2.3、利用鉤子函數(shù)自定義驗證

?

　　　　鉤子，框架級別的東西，流程過程中，預(yù)留一些空白，有，就進(jìn)行驗證，沒有就過

?

　　　　鉤子函數(shù)，利用反射hasattr，拿到方法的字符串，有就執(zhí)行，沒有就過

?

　　　　局部：單獨為某個字段設(shè)置? ? ? ? ? ? ?

• clean_字段名（self）:通過校驗：返回當(dāng)前校驗的值 【for循環(huán)校驗】不通過:raise ValidationError('不通過') 報錯為什么報錯？ 因為源碼中通過try捕獲到錯誤，放入到err_diact中，繼續(xù)執(zhí)行其它的程序

  全局：所有的字段都校驗完了，才回執(zhí)行，里面只有通過的字段

• clean(self)：通過校驗：返回 self.cleaned_data不通過：self.add_error('re_wd', '兩次密碼不一致')raise ValidationError('不通過') 報錯

?

PS：form表單中，如果在form標(biāo)簽中加入屬性novalidate ,則前端不會做校驗。

三、定義一個form組件

1、創(chuàng)建

　　可在視圖中創(chuàng)建，但最好在app下單獨建立一個py文件，如myform.py

　　1.1、導(dǎo)入模塊 from? django? import? forms

　　1.2、定義form類，繼承forms.Form(只能定義若干個數(shù)據(jù)庫表中的字段)? 或 forms.Models（可批量定義）

　　1.3、定義字段（可以是數(shù)據(jù)庫中的，那么值就需要通過orm操作獲取數(shù)據(jù)庫中的值）

　　示例：　　?

from django import forms from django.forms import widgets # 插件的意思，就是改變【字段】input的類型，如checkbox等等 from django.core.validators import RegexValidator # 用于校驗，正則class MyForms(forms.Form):username = forms.CharField(label='用戶名',help_text='人生庫端4444', # input框右邊的提示語min_length=4,initial='不能小于5個字符',error_messages={'min_length': '長度不符合規(guī)則'},widget=widgets.TextInput(attrs={'class': 'form-control'}),validators=[RegexValidator(r'^[a-zA-Z][a-zA-Z0-9_@]{4,18}', '4~18個字符，首字符為字母')])password = forms.CharField(label='密碼',# 密碼默認(rèn)明文顯示，可通過插件修改widget=widgets.PasswordInput(attrs={'class': 'form-control'}),hobby2 = forms.ChoiceField(label='love：下拉多選', initial=3, choices=((1, 'lan'), (2, 'qiu'), (3, 'dd')),widget=widgets.SelectMultiple(attrs={'class': 'form-control'}) # 下拉多選 ) )

?2、使用

　　2.1、后端使用：views.py　　

• from app_name.myform import MyFormdef view_func(request):form_obj = MyForm() 實例化if request.method == 'POSt':form_obj = MyForm(request.POST) 將接收到的數(shù)據(jù)傳進(jìn)去form_obj.is_vaild() 做校驗，后臺自動完成form_obj.cleaned_data 字典，已經(jīng)通過校驗的所有字段，沒有通過，不會放入到里面return render(request, 'index.html' , {'form_obj': form_obj})注：兩次實例化變量名都為form_obj這樣優(yōu)化代碼，不然post請求驗證不過，返回錯誤信息，還要寫一個return。

　　2.2、前端使用　　

• {{form_obj}} 直接生成所有的字段,不過沒有格式
  
  {{form_obj.name.lable_tag}} 直接生成一個lable的標(biāo)簽
  
  {{form_obj.as_p}} 所有的字段生成input框，每個input外面時p標(biāo)簽生成的html代碼如下以as_p為例：<P><lable for='{{form_obj.name.id_for_label}}'>{{form_obj.name.label}}</lable><input></p>{{form_obj.as_table/as_ui}}{{form_obj.name}} name字段生成的input框，框的類型type和定義時charField定義有關(guān){{form_obj.name.label}} name的標(biāo)簽顯示的文字，如用戶名{{form_obj.name.id_for_label}} input框的id，用于與label標(biāo)簽的for關(guān)聯(lián){{form_obj.name.errors}} 該字段后臺驗證返回來的所有的錯誤{{form_obj.name.errors.0}} 該字段后臺驗證返回來的所有的錯誤的第一個錯誤，所有的錯誤放在一個字典中{{form_obj.errors}} form表單的所有的錯誤

四、應(yīng)用bootstrap樣式，如何使用form組件

方式一：一個一個字段寫

<!DOCTYPE html> <html lang="en"> <head><meta charset="UTF-8"><meta http-equiv="x-ua-compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1"><link rel="stylesheet" href="/static/bootstrap/css/bootstrap.min.css"><title>login</title> </head> <body> <div class="container"><div class="row"><form action="/login2/" method="post" novalidate class="form-horizontal">{% csrf_token %}<div class="form-group"><label for="{{ form_obj.username.id_for_label }}"class="col-md-2 control-label">{{ form_obj.username.label }}</label><div class="col-md-10">{{ form_obj.username }}<span class="help-block">{{ form_obj.username.errors.0 }}</span></div></div><div class="form-group"><label for="{{ form_obj.pwd.id_for_label }}" class="col-md-2 control-label">{{ form_obj.pwd.label }}</label><div class="col-md-10">{{ form_obj.pwd }}<span class="help-block">{{ form_obj.pwd.errors.0 }}</span></div></div><div class="form-group"><label class="col-md-2 control-label">{{ form_obj.gender.label }}</label><div class="col-md-10"><div class="radio">{% for radio in form_obj.gender %}<label for="{{ radio.id_for_label }}">{{ radio.tag }}{{ radio.choice_label }}</label>{% endfor %}</div></div></div><div class="form-group"><div class="col-md-offset-2 col-md-10"><button type="submit" class="btn btn-default">注冊</button></div></div></form></div> </div><script src="/static/jquery-3.2.1.min.js"></script> <script src="/static/bootstrap/js/bootstrap.min.js"></script> </body> </html>

?方式二：通過for循環(huán)，直接通過field即可

<div class="panel panel-primary"><div class="panel-heading ">編輯頁面</div><div class="panel-body"><form class="form-horizontal " method="post">{% csrf_token %}{% for field in customer_form_obj %}<div class="form-group "><label for="{{ field.id_for_label }}" class="col-sm-2 control-label">{{ field.label }}</label><div class="col-sm-10 ">{{ field }}</div><span class="help-block">{{ field.errors.0 }}</span></div>{% endfor %}<button type="submit" class="btn btn-lg btn-success btn-block center-block">提交</button></form></div> </div>

五、form組件批量添加樣式

可通過重寫form類的init方法來實現(xiàn)。?

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中下來框中值的選取范圍？

1.? 可以將model的實例以參數(shù)instance=obj傳入，在form組件中引用self.instance 來操作orm，進(jìn)行限制

2. 在post請求時，data= request.POST ,instance=obj?

- views.py # 客戶的增刪改查 def customer_change(request, edit_id=None):"""要求添加完成后還回到之前的頁面"""if re.match('^/del_customer/(\d+)/$', request.path_info):check_obj = models.Customer.objects.filter(id=edit_id)if not check_obj:return HttpResponse("目標(biāo)不存在，非法操作")check_obj.delete()next_url = request.GET.get('next_url', '')return redirect(next_url)msg = ""edit_obj = models.Customer.objects.filter(id=edit_id).first()customer_form_obj = forms.CustomerForm(instance=edit_obj)if request.method == "POST":next_url = request.GET.get('next_url', '')customer_form_obj = forms.CustomerForm(data=request.POST, instance=edit_obj)if customer_form_obj.is_valid():customer_form_obj.save()return redirect(to=next_url)else:msg = "請按要求填寫信息"- forms.py class ConsultRecordForm(BaseStyle):def __init__(self, *args, **kwargs):super().__init__(*args, **kwargs)# 限制添加客戶跟進(jìn)記錄，只能選擇自己的客戶self.fields['customer'].widget.choices = [(i.id, i) for i in self.instance.consultant.customers.all()]# 限制添加客戶記錄，銷售下拉只能是自己self.fields['consultant'].widget.choices = [(self.instance.consultant.id, self.instance.consultant), ]class Meta:model = models.ConsultRecordfields = '__all__'exclude = ['delete_status']widgets = {'consultant': forms.widgets.Select()}

六、ModelForm

form與model的終極結(jié)合，可直接使用models中的所有字段

class BookForm(forms.ModelForm):class Meta:model = models.Bookfields = "__all__"labels = {"title": "書名","price": "價格"}widgets = {"password": forms.widgets.PasswordInput(attrs={"class": "c1"}),}

class Meta:下常用參數(shù)：

model = models.Student # 對應(yīng)的Model中的類 fields = "__all__" # 字段，如果是__all__,就是表示列出所有的字段 exclude = None # 排除的字段 labels = None # 提示信息 help_texts = None # 幫助提示信息 widgets = None # 自定義插件 error_messages = None # 自定義錯誤信息

轉(zhuǎn)載于:https://www.cnblogs.com/sunxiuwen/p/9741998.html

總結(jié)

以上是生活随笔為你收集整理的Django框架-Form组件的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。