（1）原始表单#

• 我们之前在HTML页面中利用form表单向后端提交数据时
  • 都会写一些获取用户输入的标签并且用form标签把它们包起来。
• 与此同时我们在好多场景下都需要对用户的输入做校验
  • 比如校验用户是否输入
  • 输入的长度和格式等正不正确。
• 如果用户输入的内容有错误就需要在页面上相应的位置显示对应的错误信息.。

1
<form action="/your-name/" method="post">
2
    <label for="your_name">Your name: </label>
3
    <input id="your_name" type="text" name="your_name" value="{{ current_name }}">
4
    <input type="submit" value="OK">
5
</form>

• 这一行定义了我们的发送目的地/your-name/和HTTP方法POST。
• form元素内部还定义了一个说明标签和一个发送按钮submit，以及最关键的接收用户输入的元素。
• 具体的更多HTML语言相关内容，请自行学习。

Django form组件就实现了上面所述的功能。

（2）Django的表单系统#

• Django的Form表单类与Django模型描述对象的逻辑结构、行为以及它呈现给我们内容的形式的方式大致相同。
• 那为什么有了模型，还要自己创建表单类呢？
• 原因之一是模型中有一些字段你不需要用户从前端输入数据，或者需要用户额外输入一些非模型字段的数据。
• Form表单精确控制了这些行为，相当于你在用户HTML表单输入框和Django模型之间的中间件。

（1）前端页面#

1
<form action="" method="post">
2
    <p>username:
3
        <input type="text" class="form-control" name="username">
4
        <span style="color: red">{{ back_dict.username }}</span>
5
    </p>
6
    <p>password:
7
        <input type="password" class="form-control" name="password">
8
        <span style="color: red">{{ back_dict.password }}</span>
9

10
    </p>
11
    <input type="submit" class="btn btn-danger">
12
</form>

• ： - 定义一个表单，其中action属性为空字符串，这意味着表单默认提交到当前页面（或者在后端路由处理时会指定一个具体URL）。 - method属性设置为"post"，表示表单数据将以POST方式发送，这种方式可以更好地保护敏感信息，如密码，因为它不会在URL中显示。

• username:

  ： - 这部分创建了一个文本输入框，用户在此输入其用户名。 - class属性值为"form-control"，这是Bootstrap框架提供的CSS类，用来设定输入框的样式。 - name属性值为"username"，这个名称在服务器端接收表单数据时作为键名使用。
• {{ back_dict.username }}：
  • 这是一个动态内容展示区域
  • 根据所使用的模板引擎（如Jinja2、Vue.js等），{{ back_dict.username }}会被解析为从后台返回的错误提示信息
  • 如果用户名有误，这里会显示红色的错误提示。

• password:

  ： - 这部分创建了一个密码输入框，用户在此输入其密码。 - type属性值为"password"，这样输入的内容会以星号或其他符号代替显示，保护用户密码不被他人窥视。 - 同样具有form-control样式和name属性。
• {{ back_dict.password }}：
  • 与用户名输入框下方的span元素类似
  • 此处用于显示密码输入的错误提示信息。
• ：
  • 定义一个提交按钮，点击该按钮时，表单数据将会被发送至服务器。
  • class属性值为”btn btn-danger”，这是Bootstrap中用于创建危险主题样式的按钮。

（2）后端#

1
from django.shortcuts import render
2

3

4
# Create your views here.
5
def register(request):
6
    back_dict = {}
7
    if request.method == 'POST':
8
        username = request.POST.get('username')
9
        password = request.POST.get('password')
10
        if "啦啦啦" in username:
11
            back_dict['username'] = '用户名不符合格式！'
12
        if len(password) < 3:
13
            back_dict['password'] = '输入的密码长度不够！'
14

15
        '''
16
        无论是 get 请求 还是 post 请求，页面都能获取到字典
17
            get 请求时，字典是空的，没有值
18
            post 请求时 ，字典可能是非空的
19
        '''
20
    return render(request, 'ab_form.html',locals())

（3）路由#

1
from django.contrib import admin
2
from django.urls import path, re_path
3

4
from app01 import views
5

6
urlpatterns = [
7
    path('admin/', admin.site.urls),
8
    # form 组件引入
9
    re_path(r'^register/',views.register),
10
]

（4）用到的技术点#

• 手动书写前端HTML页面代码
  • 渲染HTML页面
• 后端对用户数据进行校验
  • 校验数据
• 对不符合要求的数据进行前端提示
  • 展示提示信息

（1）创建文件#

• 首先，在你当前app内新建一个forms.py文件（这个套路是Django的惯用手法，就像views.py，models.py等等）

（2）书写form表单类#

1
# 导入模块
2
from django import forms
3

4
# 按照Django form组件的要求自己写一个类 MyForm
5
class MyForm(forms.Form):
6
    # username : 字符串类型  最小三位，最大八位
7
    username = forms.CharField(max_length=8, min_length=3)
8
    # # username : 字符串类型  最小三位，最大八位 : 字符串类型  最小三位，最大八位
9
    password = forms.CharField(max_length=8, min_length=3)
10
    # email : 必须符合邮箱格式  xxx@xx.com
11
    email = forms.EmailField()

（3）注意事项#

• 提前导入forms模块
• 所有的表单类都要继承forms.Form类
• 每个表单字段都有自己的字段类型比如CharField，它们分别对应一种HTML语言中的元素中的表单元素。这一点和Django模型系统的设计非常相似。
• 例子中的label用于设置说明标签
• max_length限制最大长度为8。它同时起到两个作用，一是在浏览器页面限制用户输入不可超过8个字符，二是在后端服务器验证用户输入的长度不可超过8。

(警告：由于浏览器页面是可以被篡改、伪造、禁用、跳过的，所有的HTML手段的数据验证只能防止意外不能防止恶意行为，是没有安全保证的，破坏分子完全可以跳过浏览器的防御手段伪造发送请求！所以，在服务器后端，必须将前端当做“裸机”来对待，再次进行完全彻底的数据验证和安全防护！)

（准备数据）#

1
# 导入模块
2
from app01 import views
3

4
# 将想要传入的数据组织成字典的格式传入即可
5
form_obj = views.MyForm({"username":"dream","password":"521","eemail":"123"})

（1）数据是否合法(is_valid)#

• 每个Django表单的实例都有一个内置的is_valid()方法，用来验证接收的数据是否合法。

1
form_obj.is_valid()
2
# False

• 该方法，只有所有传入的数据都合法的情况下才会返回True

（2）查看合法的数据(cleaned_data)#

• 如果所有数据都合法，那么该方法将返回True，并将所有的表单数据转存到它的一个叫做cleaned_data的属性中，该属性是一个字典类型数据。

1
form_obj.cleaned_data
2
# {'username': 'dream', 'password': '521'}

（2）查看合法数据(changed_data)#

1
form_obj.changed_data
2
# ['username', 'password']

• 展示符合校验规则的数据

（3）查看不合法的数据(errors)#

1
form_obj.errors
2

3
# {'username': ['Ensure this value has at most 2 characters (it has 5).'], 'password': ['Ensure this value has at most 2 characters (it has 3).'], 'email': ['This field is required.']}

• 查看所有不符合规则的参数及不符合的原因
• 报错原因可能有多个

（4）多传参数是否会报错#

1
form_obj = views.MyForm({"username":"dream","password":"521","eemail":"123@qq.com","hobby":"music"})
2

3
form_obj.is_valid()
4
# True

• 校验数据只校验类中出现的字段
  • 如果有多传的字段会直接自动忽略

（4）少传参数是否会报错#

1
form_obj = views.MyForm({"username":"dream","password":"521"})
2

3
form_obj.errors
4
# {'email': ['This field is required.']}

• 校验数据
  • 默认情况下，类中所有的字段都必须传值

（5）小结#

• 默认情况下
  • 校验数据可以多传
  • 但是不能少传