JinLinC个人在线文档库

Appearance

Form表单 ​

表单可以将我们日常填写的表联系起来，通过集合信息交付给指定的人或位置

从Web的角度来说，通过前端的表单模块填写后端服务所需要的信息，填写完后，提交给后端服务的一个工具

表单一般分为四个部分：提交地址，提交方法，表单组件，提交按钮

html
<form action="", method="GET">
<input type="text">
<input type="submit" value="提交">

form表单标签，用于定义一个表格，有两个方法（attr）：action（连接到哪里）和method（提交的方法）

input标签，用于输入相关的信息，该标签有以下的type可选项：

元素描述
text文本字段
password密码域，用户输入不显示
radio单选按钮
checkbox复选框
button普通按钮
submit提交按钮
reset重置按钮
hidden隐藏域，一般是用于提交密钥的
file文本域，上传文件/图像

在Django中使用表单 ​

表单只会处理get和post请求，在get中，实例化表单对象，将form表单渲染到模板；在psot中，实例化表单对象，并将request.POST对象传给表单

其他配置如settings.py，子路由，路由，模板配置参考之前的配置

在templates文件夹下创建register.html文件：

html
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>注册</title>
</head>
<body>
    <form action="{% url 'regiser' %}" method="POST">
        {% csrf_token %}<!--传入密钥，是获取到的提交数据可以在网页显示-->
        <input type="text" placeholder="用户名" name="username"/>
        <br>
        <input type="password" placeholder="密码" name="password"/>
        <br>
        <input type="submit" value="注册"/>
    </form>
</body>
</html>

在应用文件夹下中的views.py中编写视图

py
from django.shortcuts import render
from django.views.generic import View
from django.http import HttpResponse

class Regiser(View):
    def get(self, request):
        return render(request, 'register.html')
    
    # 表单提交方法
    def post(self, request):
       	username = request.POST.get('username')
        password = request.POST.get('password')
        # 将获取到提交的数据渲染在网页的页面上
        return HttpResponse('username: {}, password: {}'.format(username, password))

在子路由中进行以下的配置：

py
from django.urls import path
from .views import Regiser

urlpatterns = [
    # 同时设置路径的别名，用于表单的连接跳转
    path('', Regiser.as_view(), name=='regiser') 
]

以上的方法是通过html创建一个表单，也是推荐的创建表单的方法，这种方式创建的表单可以进行二次的美化

当然我们也可以使用Django中内置的方法进行表单的创建，在应用文件夹中创建一个forms.py文件来创建表单，文件内容如下：

py
from django import froms  # 从forms中导入fields中的对象
from django,froms import fields  # 字段来源于fields

# 定义一个表单类
class Auth(froms.Form):
    # required=True表示表单中用户名是必须要填写的
    userame = fields.CharField(max_length=10, required=True)
    userame = fields.CharField(widget=forms.PasswordInput)

常见内置表单的字段类型：

类型描述
CharField文本类型
EmailField验证是否是有效的email格式
URLField验证是否是有效的url地址
GenericIPAddressField验证ip类型
TimeField验证是否为datetime.time或指定格式的字符串
DateField验证日期格式，通过参数input_formats定义日期格式
ChoiceField选择类型，通过参数choices设置内容
BooleanField复选框，当required=True时默认勾选
IntegerField验证值是否为整形
FloatField验证值是否为浮点类型
FileField文件上传，allow_empty_file设置是否为空
ImageField验证上传的文件是否为图片

内置表单字段属性：

属性描述
required是否必填，默认为True
widget设置input的type样式
label设置标签名
initial设置初始值
localize是否支持时间本地化，时区不同时显示相应的时间
disabled是否可编辑
error_messages设置错误消息，字典类型，对属性错误进行说明
max_length设置最大长度
min_length设置最小长度
validators自定义验证规则

在views.py进行下述的修改：

py
from django.shortcuts import render
from django.views.generic import View
from django.http import HttpResponse
from .forms import Auth

class Regiser(View):
    def get(self, request):
        form = Auth()
        return render(request, 'register.html', {'form': form})
    
    # 表单提交方法
    def post(self, request):
        form = Auth(request.POST)
        # 进行设置的规则验证
        if form.is_valid():
            username = form.cleaned_data.get('username')
            password = form.cleaned_data.get('password')
            # 将获取到提交的数据渲染在网页的页面上
            return HttpResponse('username: {}, password: {}'.format(username, password))
        return HttpResponse('ERROR')

在register.html页面中进行渲染：

html
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>注册</title>
</head>
<body>
    <form action="{% url 'regiser' %}" method="POST">
        {% csrf_token %}<!--传入密钥，是获取到的提交数据可以在网页显示-->
        {{ form.as_table }}
        <input type="submit" value="注册"/>
    </form>
</body>
</html>

表单在前端自动展示的方法：

方法（用两个大括号包裹）描述
form直接使用
form.as_table在table标签中展示
form.as_p生成在p标签内
form.as_ul在ul标签中通过li标签的形式展示

表单在前端手动展示的方法：

方法（用两个大括号包裹）描述
form.subject.errors展示项目验证失败时返回的错误，可迭代循环
form.subject.id_for_label展示项目label的名称（该标签需要手动书写label标签）
form.subject.label_tag该字段的label封装在响应式的html<label>标签中
form.subject正式展示输入该字段的位置
form.subject.value展示默认的初始值
form.subject.is_hidden是否隐藏字段（True或者False）

For循环展示错误：

html
{% if form.subject.errors %}
	<ol>
     {% for error in form.subject.errors %}
     	<li><strong>{{ error|escape }}</strong></li>
     {% endfor %}
	</ol>
{% endif %}

网站登录表单验证 ​

在根目录中创建一个templates文件夹，在应用文件夹中创建表单文件forms.py，同时在settings.py中进行相关的配置（TEMPLATES中的DIRS）和配置根路由

在forms.py中进行编写，声明一个简单的表单：

py
from django import forms
from django.forms import fields

class Auth(forms.Form):
    username = fields.CharField(
        max_length=10,
        min_length=4,
        # 设置表单的label标签
        label='用户名',
    )
    password = fields.CharField(
        # 设置进行密文处理
        widget=forms.PasswordInput(),
        label='密码',
        min_length=10,
    )
    
    # 全局验证
    def clean(self):
        username = self.cleaned_data.get('username', '')
        password = self.cleaned_data.get('password', '')
        
        if not username:
            raise forms.ValidationError('用户名不可为空')
            
        if len(username) > 10:
            raise forms.ValidationError('用户名不可超过十个字符')
            
        if not username:
            raise forms.ValidationError('用户名不可为空')
     
    # 局部验证（单独验证，对单个字段进行验证） clean必须要写在前面，为前缀
    def clean_username(self):
        username = self.cleaned_data.get('username', '')   
        if len(username) > 5:
            raise forms.ValidationError('用户名不可超过五个字符')
    	return username

在views.py中编写视图：

py
from django.shortcuts import render
from django.views.generic import View
from django.http import HttpResponse
from .forms import Auth

class Register(View):
    def get(self, request):
        # 实例化表单
        form = Auth()
        return render(request, 'register.html', {'form': form})
    
    def post(self, request):
        form = Auth(request.POST)
        # 进行设置的规则验证
        if form.is_valid():
            # 获取数据，没有数据默认为空
            username = form.cleaned_data.get('username', '')
            password = form.cleaned_data.get('password', '')
            # 将获取到提交的数据渲染在网页的页面上
            return HttpResponse('username: {}, password: {}'.format(username, password))
        return render(request, 'register.html', {'form': form})

配置子路由：

python
from django.urls import path
from .views import Register

urlpatterns = [
    path('', Register.as_view(), name='register'),
]

在templates文件夹中创建一个页面文件register.html：

html
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>注册</title>
</head>
<body>
    <!--通过别名指向路由-->
    <form action="{% url 'regiser' %}" method="POST">
        {% csrf_token %}<!--传入密钥，是获取到的提交数据可以在网页显示-->
        {% for item in form %}
        	<div>
                <label for="{{ item.id_for_label }}">{{ item.label }}</label>
                {{ item }}
        	</div>
        	<!--自定义消息显示：显示局部错误-->
        	<p>{{ item.errors.as_text }}</p>
        {% endfor %}
       		<!--自定义消息显示：显示全局错误-->
        	<span>{{ form.non_field_errors }}</span>
        <input type="submit" value="注册"/>
    </form>
</body>
</html>

模型表单 ​

模型表单是model层与form表单结合起来，通过表单层为中介，渲染出前端表单，并通过表单直接读取数据库

模型表单基础模块继承于：forms.ModelForm

Released under the MIT License.

Copyright © 2023-present JinLinC