經過名字咱們能夠看出來,這個組件的功能就是把model和form組合起來,先來一個簡單的例子來看一下這個東西怎麼用:好比咱們的數據庫中有這樣一張學生表,字段有姓名,年齡,愛好,郵箱,電話,住址,註冊時間等等一大堆信息,如今讓你寫一個建立學生的頁面,你的後臺應該怎麼寫呢?首先咱們會在前端一個一個羅列出這些字段,讓用戶去填寫,而後咱們從後天一個一個接收用戶的輸入,建立一個新的學生對象,保存其實,重點不是這些,而是合法性驗證,咱們須要在前端判斷用戶輸入是否合法,好比姓名必須在多少字符之內,電話號碼必須是多少位的數字,郵箱必須是郵箱的格式這些固然能夠一點一點手動寫限制,各類判斷,這毫無問題,除了麻煩咱們如今有個更優雅(之後在Python相關的內容裏,要多用「優雅」這個詞,而且養成習慣)的方法:ModelForm先來簡單的,生硬的把它用上,再來加驗證條件。css
# 在項目中能夠建一個modelform.py的文件,也能夠寫在視圖函數中。只要在調用它的地方可以引入就好。 # 在這裏面也要把model中的類引入到該文件中 # 首先導入ModelForm和model from django.forms import ModelForm # 把midel中的全部的類都導入或者導入你要的類, from app01.models import * # 定義一個類,好比就叫StudentList,這個類要繼承ModelForm,在這個類中再寫一個元類Meta(規定寫法,並注意首字母是大寫的) # 在這個元類中,有如下屬性(部分): class StudentList(ModelForm): class Meta: model = Student # 對應的Model中的類 fields = "__all__" # 字段,若是是__all__,就是表示列出全部的字段 # 也能夠本身定製直接寫fields=['name','age']只要這些字段 exclude = None # 排除的字段 # error_messages用法: error_messages = { 'name': {'required': "用戶名不能爲空", }, 'age': {'required': "年齡不能爲空", }, } # widgets用法,好比把輸入用戶名的input框給爲Textarea # 首先得導入模塊 from django.forms import widgets as wid # 由於重名,因此起個別名 widgets = { "name": wid.Textarea(attrs={"class": "c1"}) # 還能夠自定義屬性 } # labels,自定義在前端顯示的名字 labels = { "name": "用戶名" }
上面是一個.py的文件,如labels={}後面不能加逗號(',')。html
咱們在視圖函數中使用modelform前端
from django.shortcuts import render # Create your views here. def student(request): if request.method == 'GET': # 實例化這個類 student_list = StudentList() # 把這個實例傳到前段 return render(request,'student.html',{'student_list':student_list}) # return render(request,'student.html',locals()) 和上面的效果同樣
在前段咱們能夠和form組件同樣拿取數據{{ student_list.as_p }} 一下,全部的字段就都出來了,能夠用as_p顯示所有,也能夠經過for循環這數據庫
student_list,拿到的是一個個input框,如今咱們就不用as_p,手動把這些input框搞出來,as_p拿到的頁面太醜。
首先 for循環這個student_list,拿到student對象,直接在前端打印這個student,是個input框student.label ,拿到數據庫中每一個字段的verbose_name ,若是沒有設置這個屬性,拿到的默認就是字段名,還能夠經過student.errors.0 拿到錯誤信息有了這些,咱們就能夠經過bootstrap,本身拼出來想要的樣式了,好比:django
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>歡迎註冊</title> <link rel="stylesheet" href="/static/bootstrap/css/bootstrap.min.css"> <link rel="stylesheet" href="/static/mystyle.css"> </head> <body> <div class="container"> <div class="row"> <div class="col-md-6 col-md-offset-3"> <form novalidate autocomplete="off" action="/reg/" method="post" class="form-horizontal reg-form" enctype="multipart/form-data"> {% csrf_token %} {# {{ student_list.as_p }}#} {% for student in student_list %} <div class="form-group"> <label for="{{ student.id_for_label}}"class="col-sm-2 control-label">{{ student.label }}</label> <div class="col-sm-8">{{ student }}<span class="help-block">{{ student.errors.0 }}</span> </div> </div> {% endfor %} <div class="form-group"> <label class="col-sm-2 control-label">頭像</label> <div class="col-sm-8"> <label for="id_avatar"><img id="avatar-img" src="/static/img/default.png" alt=""></label> <input accept="image/*" type="file" name="avatar" id="id_avatar" style="display: none"> <span class="help-block"></span> </div> </div> <div class="form-group"> <div class="col-sm-offset-2 col-sm-10 col-md-offset-3"> <button type="button" class="btn btn-success" id="reg-submit">註冊</button> </div> </div> </form> </div> </div> </div> </body> </html>
如今還缺一個input框的form-contral樣式,能夠考慮在後臺的widget裏面添加bootstrap
from django.forms import widgets as wid #由於重名,因此起個別名 widgets = { "name":wid.TextInput(attrs={'class':'form-control'}), "age":wid.NumberInput(attrs={'class':'form-control'}), "email":wid.EmailInput(attrs={'class':'form-control'}) }
上面也可使用js找到全部的input標籤加上這個樣式,小程序
保存數據的時候,不用挨個取數據了,只須要save一下app
def student(request): student_list = StudentList(request.POST) if request.method == 'POST': student_list = StudentList(request.POST) if student_list.is_valid(): student_list.save() return redirect(request, 'student_list.html', {'student_list': student_list}) return render(request,'student.html',{'student_list':student_list})
若是不用ModelForm,編輯的時候得顯示以前的數據吧,還得挨個取一遍值,若是ModelForm,只須要加一個instance=obj(obj是要修改的數據庫的一條數據的對象)就能夠獲得一樣的效果
保存的時候要注意,必定要注意有這個對象(instance=obj),不然不知道更新哪個數據ide
from django.shortcuts import render,HttpResponse,redirect from django.forms import ModelForm # Create your views here. from app01 import models def test(request): # model_form = models.Student model_form = models.Student.objects.all() return render(request,'test.html',{'model_form':model_form}) class StudentList(ModelForm): class Meta: model = models.Student #對應的Model中的類 fields = "__all__" #字段,若是是__all__,就是表示列出全部的字段 exclude = None #默認排除的字段爲None labels = None #默認提示信息爲None help_texts = None #默認幫助提示信息爲None widgets = None #默認自定義插件爲None error_messages = None #默認自定義錯誤信息爲None #error_messages用法: error_messages = { 'name':{'required':"用戶名不能爲空",}, 'age':{'required':"年齡不能爲空",}, } #widgets用法,好比把輸入用戶名的input框給爲Textarea #首先得導入模塊 from django.forms import widgets as wid #由於重名,因此起個別名 widgets = { "name":wid.Textarea } #labels,自定義在前端顯示的名字 labels= { "name":"用戶名" } def student(request): student_list = StudentList(request.POST) if request.method == 'POST': student_list = StudentList(request.POST) if student_list.is_valid(): student_list.save() return redirect(request, 'student_list.html', {'student_list': student_list}) return render(request, 'student.html', {'student_list': student_list}) def student_edit(request,pk): obj = models.Student.objects.filter(pk=pk).first() if not obj: return redirect('test') if request.method == 'POST': student_list = StudentList(request.POST, instance=obj) if student_list.is_valid(): student_list.save() return redirect(request, 'student_list.html', {'student_list': student_list}) student_list = StudentList(instance=obj) return render(request, 'student_edit.html', {'student_list': student_list})
總結: 從上邊能夠看到ModelForm用起來是很是方便的,好比增長修改之類的操做。可是也帶來額外很差的地方,model和form之間耦合了。若是不耦合的話,mf.save()方法也沒法直接提交保存。 可是耦合的話使用場景一般侷限用於小程序,寫大程序就最好不用了。函數