Django之ModelForm詳解

時間 2019-11-08

標籤 django modelform 詳解欄目 Python 简体版

原文原文鏈接

前言

　　這是一個神奇的組件，經過名字咱們能夠看出來，這個組件的功能就是把model和form組合起來。先來一個簡單的例子來看一下這個東西怎麼用：html

　　好比咱們的數據庫中有這樣一張學生表，字段有姓名，年齡，愛好，郵箱，電話，住址，註冊時間等等一大堆信息，如今讓你寫一個建立學生的頁面，你的後臺應該怎麼寫呢？前端

首先咱們會在前端一個一個羅列出這些字段，讓用戶去填寫，而後咱們從後天一個一個接收用戶的輸入，建立一個新的學生對象，保存起來。數據庫

　　其實，重點不是這些，而是合法性驗證，咱們須要在前端判斷用戶輸入是否合法，好比姓名必須在多少字符之內，電話號碼必須是多少位的數字，郵箱必須是郵箱的格式這些。固然能夠一點一點手動寫限制，各類判斷，這毫無問題，不過比較麻煩。django

　　咱們如今有個更優雅（之後在Python相關的內容裏，要多用「優雅」這個詞，而且養成習慣）的方法：ModelFormbootstrap

　　先來簡單的，生硬的把它用上，再來加驗證條件：瀏覽器

首先導入ModelFormapp

from django.forms import ModelForm

　　在視圖函數中，定義一個類，好比就叫StudentList，這個類要繼承ModelForm，在這個類中再寫一個原類Meta（規定寫法，並注意首字母是大寫的）ide

在這個原類中，有如下屬性（部分）：函數

class StudentList(ModelForm):
    class Meta:
        model = models.Student  #對應的Model中的類
        fields = "__all__"      #字段，若是是__all__,就是表示列出全部的字段
        exclude = None          #排除的字段
        labels = None           #提示信息
        help_texts = None       #幫助提示信息
        widgets = None          #自定義插件
        error_messages = 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":"用戶名"
        }

若是想增長一個字段，就在class Meta 以前寫這個字段。而後在url對應的視圖函數中實例化這個類，把這個對象傳給前端。ui

def student(request):

    if request.method == 'GET':
        student_list = StudentList()
        return render(request,'student.html',{'student_list':student_list})

而後前端只須要 {{ 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 拿到錯誤信息，還有student.field，是拿到每一個字段，若是這個字段是多對多字段，還能stuent.field.queryset，拿到全部關聯的字段，還能stuent.field.queryset.model，拿到全部關聯的字段的類。有了這些，咱們就能夠經過bootstrap，本身拼出來想要的樣式了

好比：

<body>
    <div class="container" >
        <h1>student</h1>
        <form method="POST" novalidate>
            {% csrf_token %}
{#            {{ student_list.as_p }}#}
            {% for student in student_list %}
                <div class="form-group col-md-6">
                 {# 拿到數據字段的verbose_name,沒有就默認顯示字段名 #}
                    <label class="col-md-3 control-label">{{ student.label }}</label>
                   <div class="col-md-9" style="position: relative;">{{ student }}</div>
                </div>
            {% endfor %}

            <div class="col-md-2 col-md-offset-10">
                <input type="submit" value="提交" class="btn-primary">
            </div>
        </form>
    </div>
</body>

如今還缺一個input框的form-control樣式，能夠考慮在後臺的widget裏面添加。

好比這樣：

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一下。

def student(request):

    if request.method == 'GET':
        student_list = StudentList()
        return render(request,'student.html',{'student_list':student_list})
    else:
        student_list = StudentList(request.POST)
        if student_list.is_valid():
            student_list.save()
        return redirect(request,'student_list.html',{'student_list':student_list})

編輯數據：

若是不用ModelForm，編輯的時候得顯示以前的數據吧，還得挨個取一遍值，若是ModelForm，只須要加一個instance=obj（obj是要修改的數據庫的一條數據的對象）就能夠獲得一樣的效果。

保存的時候要注意，必定要注意有這個對象（instance=obj），不然不知道更新哪個數據。

代碼示例：

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          #排除的字段
        labels = None           #提示信息
        help_texts = None       #幫助提示信息
        widgets = None          #自定義插件
        error_messages = 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):

    if request.method == 'GET':
        student_list = StudentList()
        return render(request,'student.html',{'student_list':student_list})
    else:
        student_list = StudentList(request.POST)
        if student_list.is_valid():
            student_list.save()
        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 == "GET":
        student_list = StudentList(instance=obj)
        return render(request,'student_edit.html',{'student_list':student_list})

    else:
        student_list = StudentList(request.POST,instance=obj)
        if student_list.is_valid():
            student_list.save()
        return render(request,'student_edit.html',{'student_list':student_list})

使用ModelForm編輯數據

對於驗證規則，不少瀏覽器都比較智能，會自動幫咱們作一些驗證，能夠在form表單上加 novalidate 屬性就能夠不讓瀏覽器爲咱們作驗證

ModelForm還支持全部form的功能，好比鉤子，因此咱們就能夠經過鉤子來自定義驗證規則

寫法和forms的寫法同樣：

class AuthorForm(forms.ModelForm):
    class Meta:
        model = Author
        fields = ('name', 'title')

    def clean_name(self):
        if ...
             return self.clean_data['name']
       else:
             raise ValidationError（‘sdgsadga’）
        ...

相關標籤/搜索

每日一句

每一个你不满意的现在，都有一个你没有努力的曾经。