Django组件-forms组件

一、Forms组件

1. 校验字段功能

针对一个实例：注册用户讲解。

模型：models.py

class UserInfo(models.Model):
    name=models.CharField(max_length=32)
    pwd=models.CharField(max_length=32)
    email=models.EmailField()
    tel=models.CharField(max_length=32)

模板: register.html:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>

</head>
<body>

<form action="" method="post">
    {% csrf_token %}
    <div>
        <label for="user">用户名</label>
        <p><input type="text" name="name" id="name"></p>
    </div>
    <div>
        <label for="pwd">密码</label>
        <p><input type="password" name="pwd" id="pwd"></p>
    </div>
    <div>
        <label for="r_pwd">确认密码</label>
        <p><input type="password" name="r_pwd" id="r_pwd"></p>
    </div>
     <div>
        <label for="email">邮箱</label>
        <p><input type="text" name="email" id="email"></p>
    </div>
    <input type="submit">
</form>

</body>
</html>

视图函数：register

# forms组件
from django.forms import widgets

wid_01=widgets.TextInput(attrs={"class":"form-control"})
wid_02=widgets.PasswordInput(attrs={"class":"form-control"})

class UserForm(forms.Form):
    name=forms.CharField(max_length=32,
                         widget=wid_01
                         )
    pwd=forms.CharField(max_length=32,widget=wid_02)
    r_pwd=forms.CharField(max_length=32,widget=wid_02)
    email=forms.EmailField(widget=wid_01)
    tel=forms.CharField(max_length=32,widget=wid_01)



def register(request):

    if request.method=="POST":
        form=UserForm(request.POST)        # 实例化用户表单的字典数据
        if form.is_valid():		   # 返回True:通过验证,返回False:为不通过验证
            print(form.cleaned_data)       # 所有干净的字段以及对应的值,不在UserForm类里面的字段会										    
        else:
            print(form.cleaned_data)       # 不在UserForm类里面的字段会无视
            print(form.errors)             # ErrorDict : {"校验错误的字段":["错误信息",]}
            print(form.errors.get("name")) # ErrorList ["错误信息",]
        return HttpResponse("OK")
    form=UserForm()
    return render(request,"register.html",locals())

2. 渲染标签功能

2.1 渲染方式1

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
   <!-- 最新版本的 Bootstrap 核心 CSS 文件 -->
    <link rel="stylesheet" href="https://cdn.bootcss.com/bootstrap/3.3.7/css/bootstrap.min.css" integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous">
</head>
<body>
<h3>注册页面</h3>
<div class="container">
    <div class="row">
        <div class="col-md-6 col-lg-offset-3">

                <form action="" method="post">
                    {% csrf_token %}
                    <div>
                        <label for="">用户名</label>
                        {{ form.name }}
                    </div>
                    <div>
                        <label for="">密码</label>
                        {{ form.pwd }}
                    </div>
                    <div>
                        <label for="">确认密码</label>
                        {{ form.r_pwd }}
                    </div>
                    <div>
                        <label for=""> 邮箱</label>
                        {{ form.email }}
                    </div>

                    <input type="submit" class="btn btn-default pull-right">
                </form>
        </div>
    </div>
</div>



</body>
</html>

2.2 渲染方式2

<form action="" method="post">
                    {% csrf_token %}
                    
                    {% for field in form %}
                        <div>
                            <label for="">{{ field.label }}</label>
                            {{ field }}
                        </div>
                    {% endfor %}
                    <input type="submit" class="btn btn-default pull-right">
                
</form>

2.3 渲染方式3

<form action="" method="post">
    {% csrf_token %}
    
    {{ form.as_p }}
    <input type="submit" class="btn btn-default pull-right">

</form>

3. 显示错误与重置输入信息功能

3.1 视图

def register(request):

    if request.method=="POST":
        form=UserForm(request.POST)        # form表单的name属性值应该与form组件字段名称一致
        if form.is_valid():
            print(form.cleaned_data)       # 所有干净的字段以及对应的值
        else:
            print(form.cleaned_data)       #
            print(form.errors)             # ErrorDict : {"校验错误的字段":["错误信息",]}
            print(form.errors.get("name")) # ErrorList ["错误信息",]
        return render(request,"register.html",locals())
    form=UserForm()
    return render(request,"register.html",locals())

3.2 模板

<form action="" method="post" novalidate>
    {% csrf_token %}
    
    {% for field in form %}
        <div>
            <label for="">{{ field.label }}</label>
            {{ field }} <span class="pull-right" style="color: red">{{ field.errors.0 }}</span>
        </div>
    {% endfor %}
    <input type="submit" class="btn btn-default">

</form>

4. form组件的参数配置

设置标签的type类型: widget=widgets.PasswordInput
设置中文字段名: label="自定义"
设置自定义的错误信息显示: error_messages={"required":"此字段不可空"}
设置模板内标签的属性值：设置完type类型后在（）内 attrs={"属性名":"属性值"}

from django.forms import widgets
class UserForm(forms.Form):
    name = forms.CharField(min_length=4, label="用户名", 
    error_messages={"required": "该字段不能为空"},
 	widget=widgets.TextInput(attrs={"class": "form-control"}))
    
    pwd = forms.CharField(min_length=4, label="密码", widget=widgets.PasswordInput(attrs={"class": "form-control"}))

    r_pwd = forms.CharField(min_length=4, label="确认密码", widget=widgets.PasswordInput(attrs={"class": "form-control"}))

    email = forms.EmailField(label="邮箱", 
    error_messages={"required": "该字段不能为空", "invalid": "邮箱格式错误"},
    widget=widgets.TextInput(attrs={"class": "form-control"}))
    
    tel = forms.CharField(label="手机号", widget=widgets.TextInput(attrs={"class": "form-control"}))

5. 局部钩子与全局钩子

5.1 模板

# forms组件
from django.forms import widgets
from django.core.exceptions import NON_FIELD_ERRORS, ValidationError

wid_01=widgets.TextInput(attrs={"class":"form-control"})
wid_02=widgets.PasswordInput(attrs={"class":"form-control"})

from django.core.exceptions import ValidationError
class UserForm(forms.Form):
    name=forms.CharField(max_length=32,
                         widget=wid_01
                         )
    pwd=forms.CharField(max_length=32,widget=wid_02)
    r_pwd=forms.CharField(max_length=32,widget=wid_02)
    email=forms.EmailField(widget=wid_01)
    tel=forms.CharField(max_length=32,widget=wid_01)


    # 局部钩子
    def clean_name(self):
        val=self.cleaned_data.get("name")
        if not val.isdigit():
            return val
        else:
            raise ValidationError("用户名不能是纯数字!")

    # 全局钩子

    def clean(self):
        pwd=self.cleaned_data.get("pwd")
        r_pwd=self.cleaned_data.get("r_pwd")

        if pwd==r_pwd:
            return self.cleaned_data
        else:
            raise ValidationError('两次密码不一致!')


def register(request):

    if request.method=="POST":
        form=UserForm(request.POST)
        if form.is_valid():
            print(form.cleaned_data)       # 所有干净的字段以及对应的值
        else:
            clean_error=form.errors.get("__all__")  # 全局钩子错误
        return render(request,"register.html",locals())
    form=UserForm()
    return render(request,"register.html",locals())

5.2 视图

<form action="" method="post" novalidate>
            {% csrf_token %}

            {% for field in form %}
                <div>
                    <label for="">{{ field.label }}</label>
                    {{ field }}
                    <span class="pull-right" style="color: red">
                          {% if field.label == 'R pwd' %}
                          <span>{{ clean_error.0 }}</span>
                          {% endif %}
                          {{ field.errors.0 }}
                    </span>
                </div>
            {% endfor %}
            <input type="submit" class="btn btn-default">

</form>

二、ModelForm组件

1. `Form`组件和`ModelForm`区别

ModelForm是Django Model.py和Form组件的结合体，可以简单、快速使用 Form验证和数据库操作功能，但不如Form组件灵活
如果在使用Django做web开发过程中验证的数据和数据库字段相关(可以对表进行增、删、改操)，建议优先使用ModelForm，用起来更方便些。
ModelForm适合中小型应用程序。因为ModelForm是依赖于models的。而Form更适合大型应用程序。Django中Model负责操作数据库，并且具有简单的数据库验证功能(基本不用)；Form用于用户请求的验证，具有强悍的数据库验证功能；ModelForm是将二者合二为一，即可用于数据库操作(部分)，也可用于用户请求的验证(部分)。但由于ModelForm的耦合性太强，其作用一般用作于结构简单的小站点

2. ModelForm类的创建使用

models.py

from django.db import models											# 1 创建模型类

class Student(models.Model):
    name = models.CharField(max_length=5)
    age = models.IntegerField()
    birth = models.DateField()
    email = models.EmailField()
    createDate = models.DateField(auto_now_add=True)

3. Meta类的属性

forms.py

from app01.models import Student
from django.forms import ModelForm									# 2 导入创建的模型类及ModelForm类
from django.forms import widgets as wid  							# widgets用法的模块 因为重名，所以起个别名

class StudentModelForm(ModelForm):									# 3 创建类继承ModelForm类
    class Meta:													  # 4 类下在创建固定 Meta名的类，在类中做相应操作
        # 对应的Model中的哪个类校验
        model = Student  	
        
        # 对模型类中哪个字段校验，如果是 fields = "__all__" ,就是表示列出所有的字段校验
        fields =["name","age","email","birth"]
        
        #对模型类中哪个字段不校验
        exclude = ["createDate"]											  

        # 自定义错误信息
        error_messages = {'name': {'required': "用户名不能为空"},}
        
        # 自定义字段标签的属性
        widgets = {"birthday": wid.Input(attrs={"type": "date", 'class': 'form-control'}),}
        
        # labels，自定义在前端显示的名字
        labels = {"name": "用户名",}
        
        # 局部校验,局部钩子
        def clean_name(self):
            pass

4. 设置错误信息全局为中文

设置后所有input框的错误信息都会翻译成中文

在设置settings.py中，把 LANGUAGE_CODE = 'en-us' 的 'en-us' 改成'zh-hans'

5. 标签class属性全局设置

对于每个字段设置一次class会重复许多操作，对于通用的可以设置成全局

class UpdateUserModelForm(forms.ModelForm):
    class Meta:
        model = models.UserInfo
        fields = ['name', 'email', ]

    def __init__(self, *args, **kwargs):
        super(UpdateUserModelForm, self).__init__(*args, **kwargs)
        # 统一给ModelForm生成字段添加样式
        for name, field in self.fields.items():
            field.widget.attrs['class'] = 'form-control'

6. ModelForm的添加数据库

views.py

from forms import StudentModelForm								# 5 导入创建的ModelForm类StudentModelForm
# 添加的业务函数
def addstus(request):
    
    if request.method == "GET":
        # 6 实例化类生成 studentModelFormObj对象 传入模板，模板内就可调用生成input标签，模板内操作参forms渲染功能
        studentModelFormObj = StudentModelForm() 
        
        return render(request, "addstu.html", {"studentModelFormObj": studentModelFormObj})
    else:
      	# 7 对用户提交的数据实例化生成 studentModelFormObj 对象
        studentModelFormObj = StudentModelForm(data=request.POST)
       
    	# 8 对象.is_valid(): 验证用户输入是否合规则
        if studentModelFormObj.is_valid():
          	
            # 9 对象.save() 把本条用户输入的数据 create() 新增到数据库
            studentModelFormObj.save()
            return HttpResponse("添加成功！")
        else:
            return JsonResponse(studentModelFormObj.errors)

7. ModelForm的编辑数据库

views.py

# 修改的业务函数
def editstus(request,id):
    instance = Student.objects.get(pk=1)                           # 10 创建要修改的学生对象
    
    if request.method == "GET":
        
        # 11 创建传入学生对象的实例对象传给模板，模板内渲染的input标签的value值就会有此学生的数据
        studentModelFormObj = StudentModelForm(instance=instance)  
        
        return render(request, "editstu.html", {"studentModelFormObj": studentModelFormObj,"instance":instance})
    else:
        
     	# 12 实例化ModelForm类时，有instance=学生对象的参数，生成的对象.save()方法就会取用户输入的数据进行 update 修改
        studentModelFormObj = StudentModelForm(instance=instance,data=request.POST)
       
        if studentModelFormObj.is_valid():
		    studentModelFormObj.save()							# 13 校验用户输入合规则后进行修改
             return HttpResponse("编辑成功！")
        else:
            return JsonResponse(studentModelFormObj.errors)

posted @ 2022-07-08 11:00 晚点心动。阅读(44) 评论(0) 收藏举报

刷新页面返回顶部

晚点心动。

Django组件-forms组件

Django组件-forms组件

一、Forms组件

1. 校验字段功能

2. 渲染标签功能

2.1 渲染方式1

2.2 渲染方式2

2.3 渲染方式3

3. 显示错误与重置输入信息功能

3.1 视图

3.2 模板

4. form组件的参数配置

5. 局部钩子与全局钩子

5.1 模板

5.2 视图

二、ModelForm组件

1. Form组件和ModelForm区别

2. ModelForm类的创建使用

3. Meta类的属性

4. 设置错误信息全局为中文

5. 标签class属性全局设置

6. ModelForm的添加数据库

7. ModelForm的编辑数据库

公告

1. `Form`组件和`ModelForm`区别