ModelForm

和form表單不同的ModelForm，form表單不需要重新規劃欄位，而是直接從 ORM中取出資料

modelform建立

在models中

class UserType(models.Model):
    title = models.CharField(max_length=32)
    roles = models.ManyToManyField('Role')

views中

from django.forms import Form,ModelForm
from django.forms import fields
from django.forms import widgets as wd
class UserTypeModeForm(ModelForm):
    title = fields.CharField(max_length=6,required=True,widget=wd.Textarea())

    class Meta:
        model = models.UserType
        fields = "__all__"

        error_messages = {
            'title':{'required':'名稱不能為空','invalid':'格式錯誤'}
        }
        widgets = {
            'title':wd.TextInput(attrs={'class':'c1'})
        }

    def clean(self):

        return self.cleaned_data

class Meta中寫入關聯的model

新增資料

def user_type_add(request):
    if request.method == "GET":
        form = UserTypeModeForm()
        return render(request,'user_type_add.html',{'form':form})
    else:
        form = UserTypeModeForm(request.POST)
        if form.is_valid():
            form.instance.recv_date = ctime
            form.save()
            return redirect('/usertype/')
        else:
            return render(request, 'user_type_add.html', {'form': form})

form.save()驗證成功之後利用一句話就實現了儲存到資料庫操作
** form.instance.recv_date = ctime**可以通過form.instance.模型欄位新增到clean_data裡面

修改資料

def user_type_edit(request,nid):
    obj = models.UserType.objects.filter(id=nid).first()
    if not obj:
        return HttpResponse('...')

    if request.method == 'GET':
        # 顯示預設值
        form = UserTypeModeForm(instance=obj)
        return render(request,'user_type_edit.html',{'form':form})
    else:

        print(QueryDict(request.body))
        form = UserTypeModeForm(instance=obj,data=request.POST)
        if form.is_valid():
            form.save()
            return redirect('/usertype/')
        else:
            return render(request, 'user_type_edit.html', {'form': form})

form = UserTypeModeForm(instance=obj,data=request.POST)在修改中需要傳入在instance對應的模型物件，再在data傳入新資料

ModelForm的相關

ModelForm
    a.  class Meta:
            model,                           # 對應Model的
            fields=None,                     # 欄位
            exclude=None,                    # 排除欄位
            labels=None,                     # 提示資訊
            help_texts=None,                 # 幫助提示資訊
            widgets=None,                    # 自定義外掛
            error_messages=None,             # 自定義錯誤資訊（整體錯誤資訊from django.core.exceptions import NON_FIELD_ERRORS）
            field_classes=None               # 自定義欄位類 （也可以自定義欄位）
            localized_fields=('birth_date',) # 本地化，如：根據不同時區顯示資料
            如：
                資料庫中
                    2016-12-27 04:10:57
                setting中的配置
                    TIME_ZONE = 'Asia/Shanghai'
                    USE_TZ = True
                則顯示：
                    2016-12-27 12:10:57
    b. 驗證執行過程
        is_valid -> full_clean -> 鉤子 -> 整體錯誤
 
    c. 字典欄位驗證
        def clean_欄位名(self):
            # 可以丟擲異常
            # from django.core.exceptions import ValidationError
            return "新值"
    d. 用於驗證
        model_form_obj = XXOOModelForm()
        model_form_obj.is_valid()
        model_form_obj.errors.as_json()
        model_form_obj.clean()
        model_form_obj.cleaned_data
    e. 用於建立
        model_form_obj = XXOOModelForm(request.POST)
        #### 頁面顯示，並提交 #####
        # 預設儲存多對多
            obj = form.save(commit=True)
        # 不做任何操作，內部定義 save_m2m（用於儲存多對多）
            obj = form.save(commit=False)
            obj.save()      # 儲存單表資訊
            obj.save_m2m()  # 儲存關聯多對多資訊
 
    f. 用於更新和初始化
        obj = model.tb.objects.get(id=1)
        model_form_obj = XXOOModelForm(request.POST,instance=obj)
        ...
 
        PS: 單純初始化
            model_form_obj = XXOOModelForm(initial={...})

ModelForm的ClassMeta

class Meta:
# 這個是input前面的提示
labels = {
    'username':'使用者名稱',
    'password':'密碼',  
}
# 這個是input後面的提示
help_texts = {
    'username': '* 必須輸入使用者名稱',
    ...
}
# 修改元件的型別和增加類名等
from django.forms import widgets as Fwidgets
widgets = {
    'username':Fwidgets.Textarea(attrs={'class':'c1'})
}

# 修改錯誤資訊提示
error_messages = {
    # 定義所有的錯誤資訊
    '__all__':{
          ...   
    }
    ...
    'email':{
        'required':'郵箱不能為空',
        'invalid':'郵箱格式錯誤',
    }
}

# 自定義匹配格式
field_class:{
    ...
    'email':fields.URLField,
}
# 本地化，時區，
localized_fields = ('ctime',)