django之ModelForm组件

ModelForm组件是django中一个非常强大的组件，其功能主要有

一 校验字段

ModelForm组件的主要格式为：

继承组件

from django import forms
class UserModelForm(forms.ModelForm):

指定表

model = models.UserInfo

指定要显示的字段

fields='__all__'   #显示所有，常用的方式
或者
exclude=['password'] #排除某个字段
或者

fields=['username','password','confirm_password','email','gender','depart'] #此表中的字段决定了页面显示的排列顺序

插件：指定属性或者设置字段类型

 widgets = {
            'username': forms.TextInput(attrs={'class': 'form-control', 'placeholder': '用户名'}),
            'password': forms.PasswordInput(attrs={'class': 'form-control', 'placeholder': '密码'}),
            'email': forms.EmailInput(attrs={'class': 'form-control', 'placeholder': '邮箱'}),
            'gender': forms.Select(attrs={'class': 'form-control'}),
            'depart': forms.Select(attrs={'class': 'form-control'}),
        }

定制错误信息

        error_messages = {
            'email':{
                'required':'邮箱不能为空',
                'invalid':'邮箱格式错误',
            }
        }

设置显示的标签名称：

labels={"username":"用户名","password":"密码"}

设置钩子函数

def clean_confirm_password(self): #'clean_'加上字段名 这里先使用局部钩子
当设置了一个字段的钩子函数时，最后必须要返回这个字段
return confirm

在函数中使用

def user_add(request):
    if request.method == 'GET':
        form = UserModelForm()  #最开始访问的时候是没有数据的
        return render(request, 'user_form.html', {'form':form})
    form = UserModelForm(data=request.POST) #传入数据
    if form.is_valid(): #进行校验
        print(form.cleaned_data)
        form.save()
        return redirect('/crm/user/list/')
    return render(request, 'user_form.html', {'form': form})

区分 form.cleaned_data和form. errors

1  ModelForm组件对数据进行校验的时候，对于校验不合格的数据放入 form.errors
2  那么他们到底都长什么样子呢

#print(form.cleaned_data)
{'username': 'lu5', 'password': '123', 'gender': 1, 'depart': <Department: 部门-1>}

#print(form.errors)
<ul class="errorlist"><li>confirm_password<ul class="errorlist"><li>两次密码输入不一致，请重新输入</li></ul></li><li>email<ul class="errorlist"><li>邮箱格式错误</li></ul></li></ul>

一 校验字段

 下面一个例子：校验用户的信息，并且确认用户的密码

 

需要对原有数据进行编辑时，需要加入instance参数例如：

def user_edit(request,nid):
    obj = models.UserInfo.objects.filter(id=nid).first()

    if request.method == 'GET':
        form = UserModelForm(instance=obj) #注意此处
        return render(request, 'user_form.html', {'form':form})
    form = UserModelForm(data=request.POST,instance=obj) #注意此处
    if form.is_valid():
        form.save()
        return redirect('/crm/user/list/')
    return render(request, 'user_form.html', {'form': form})

另外：

django本身就有对字段检测的功能，只不过单纯的是对空的判断，一般显示的错误信息是英文，我们要显示为中文呢，怎么处理

LANGUAGE_CODE = 'zh-hans'
# LANGUAGE_CODE = 'en-us'