9.Django form组件

Form组件

Django的Form主要具有一下几大功能：

  • 生成HTML标签
  • 验证用户数据（显示错误信息）
  • HTML Form提交保留上次提交数据
  • 初始化页面显示内容

创建Form类时，主要涉及到 【字段】 和 【插件】，字段用于对用户请求数据的验证，插件用于自动生成HTML;

1.内置字段

Field
    required=True,               是否允许为空
    widget=None,                 HTML插件
    label=None,                  用于生成Label标签或显示内容
    initial=None,                初始值
    help_text=‘‘,                帮助信息(在标签旁边显示)
    error_messages=None,         *错误信息 {‘required‘: ‘不能为空‘, ‘invalid‘: ‘格式错误‘}
    show_hidden_initial=False,   是否在当前插件后面再加一个隐藏的且具有默认值的插件（可用于检验两次输入是否一直）
    validators=[],               *自定义验证规则 下面有介绍具体用法
    localize=False,              是否支持本地化
    disabled=False,              是否可以编辑
    label_suffix=None            Label内容后缀

*注：继承field的字段  field里面的参数都可以用

CharField(Field)
    max_length=None,             最大长度
    min_length=None,             最小长度
    strip=True                   是否移除用户输入空白

IntegerField(Field)
    max_value=None,              最大值
    min_value=None,              最小值

FloatField(IntegerField)
    ...

DecimalField(IntegerField)
    max_value=None,              最大值
    min_value=None,              最小值
    max_digits=None,             总长度
    decimal_places=None,         小数位长度

BaseTemporalField(Field)
    input_formats=None          时间格式化   

DateField(BaseTemporalField)    格式：2015-09-01
TimeField(BaseTemporalField)    格式：11:12
DateTimeField(BaseTemporalField)格式：2015-09-01 11:12

DurationField(Field)            时间间隔：%d %H:%M:%S.%f
    ...

RegexField(CharField)           *等同于CharField加上validators
    regex,                      自定制正则表达式
    max_length=None,            最大长度
    min_length=None,            最小长度
    error_message=None,         忽略，错误信息使用 error_messages={‘invalid‘: ‘...‘}

EmailField(CharField)
    ...

FileField(Field)
    allow_empty_file=False     是否允许空文件 *上传文件

ImageField(FileField)
    ...
    注：需要PIL模块，pip3 install Pillow
    以上两个字典使用时，需要注意两点：
        - form表单中 enctype="multipart/form-data"
        - view函数中 obj = MyForm(request.POST, request.FILES)

URLField(Field)
    ...

BooleanField(Field)
    ...

NullBooleanField(BooleanField)
    ...

*ChoiceField(Field)            *单选下拉框
    ...
    choices=(),                选项，如：choices = ((0,‘上海‘),(1,‘北京‘),)
    required=True,             是否必填
    widget=None,               插件，默认select插件
    label=None,                Label内容
    initial=None,              初始值
    help_text=‘‘,              帮助提示

ModelChoiceField(ChoiceField)  *多选下拉框
    ...                        django.forms.models.ModelChoiceField
    queryset,                  # 查询数据库中的数据
    empty_label="---------",   # 默认空显示内容
    to_field_name=None,        # HTML中value的值对应的字段
    limit_choices_to=None      # ModelForm中对queryset二次筛选

ModelMultipleChoiceField(ModelChoiceField)
    ...                        django.forms.models.ModelMultipleChoiceField

TypedChoiceField(ChoiceField)
    coerce = lambda val: val   对选中的值进行一次转换
    empty_value= ‘‘            空值的默认值

MultipleChoiceField(ChoiceField)
    ...

TypedMultipleChoiceField(MultipleChoiceField)
    coerce = lambda val: val   对选中的每一个值进行一次转换
    empty_value= ‘‘            空值的默认值

ComboField(Field)
    fields=()                  使用多个验证，如下：即验证最大长度20，又验证邮箱格式
                               fields.ComboField(fields=[fields.CharField(max_length=20), fields.EmailField(),])

MultiValueField(Field)         *被继承
    PS: 抽象类，子类中可以实现聚合多个字典去匹配一个值，要配合MultiWidget使用

SplitDateTimeField(MultiValueField)    *一下生成三个输入框
    input_date_formats=None,   格式列表：[‘%Y--%m--%d‘, ‘%m%d/%Y‘, ‘%m/%d/%y‘]
    input_time_formats=None    格式列表：[‘%H:%M:%S‘, ‘%H:%M:%S.%f‘, ‘%H:%M‘]

FilePathField(ChoiceField)     *文件选项，目录下文件显示在页面中 提交时是文件路径
    path,                      文件夹路径
    match=None,                正则匹配
    recursive=False,           递归下面的文件夹
    allow_files=True,          允许文件
    allow_folders=False,       允许文件夹
    required=True,
    widget=None,
    label=None,
    initial=None,
    help_text=‘‘

GenericIPAddressField
    protocol=‘both‘,           both,ipv4,ipv6支持的IP格式
    unpack_ipv4=False          解析ipv4地址，如果是::ffff:192.0.2.1时候，可解析为192.0.2.1， PS：protocol必须为both才能启用

SlugField(CharField)           数字，字母，下划线，减号（连字符）
    ...

UUIDField(CharField)           uuid类型
    ...

Django内置字段

Django内置字段

2.内置插件

* 插件用于生成HTML，所有的插件都可以用attrs={‘class‘:‘c1‘}创建默认值

TextInput(Input)
NumberInput(TextInput)
EmailInput(TextInput)
URLInput(TextInput)
PasswordInput(TextInput)
HiddenInput(TextInput)
Textarea(Widget)
DateInput(DateTimeBaseInput)
DateTimeInput(DateTimeBaseInput)
TimeInput(DateTimeBaseInput)
CheckboxInput
Select
NullBooleanSelect
SelectMultiple
RadioSelect
CheckboxSelectMultiple
FileInput
ClearableFileInput
MultipleHiddenInput
SplitDateTimeWidget
SplitHiddenDateTimeWidget
SelectDateWidget

Django内置插件

3.表单验证

views.py

from django.shortcuts import render,redirect,HttpResponse
from django import forms

class Verification(forms.Form):
    # 跟表单提交的name值一一对应进行验证
    user = forms.CharField(error_messages={‘required‘: ‘用户名不能为空‘})
    pwd = forms.CharField(
        max_length=12,
        min_length=6,
        error_messages={‘required‘: ‘密码不能为空‘, ‘min_length‘: ‘密码长度不能小于6位‘,
                        ‘max_length‘: ‘密码长度不能大于12位‘}
    )
    email = forms.EmailField(error_messages={‘required‘: ‘用户名不能为空‘, ‘invalid‘: ‘邮箱格式不正确‘})

def login(request):
    if request.method == "GET":
        obj = Verification()
        return render(request, ‘login.html‘, {‘obj‘: obj})
    elif request.method == "POST":
        # 获取用户所有数据
        # 每条数据请求的验证
        # 成功：获取所有的正确的信息
        # 失败：显示错误信息
        obj = Verification(request.POST)
        result = obj.is_valid()  # 进行验证 True/False
        if result:
            print(obj.cleaned_data)  # 用户提交的正确信息
        else:
            print(obj.errors.as_json)  # 所有错误信息 obj.errors
            return render(request, ‘login.html‘, {‘obj‘: obj})  # 传入obj

        return redirect(‘/login/‘)

login.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <form action="/login/" method="post">
        {% csrf_token  %}
        <p>用户：{{ obj.user }}{{ obj.errors.user.0 }}</p>
        <p>密码：{{ obj.pwd }}{{ obj.errors.pwd.0 }}</p>
        <p>邮箱：{{ obj.email }}{{ obj.errors.email.0 }}</p>
        <input type="submit" name="提交" />
    </form>
</body>
</html>

其它标签的使用

<form method="POST" enctype="multipart/form-data">
        {% csrf_token %}

            {{ form.xxoo.label }}
            {{ form.xxoo.id_for_label }}
            {{ form.xxoo.label_tag }}
            {{ form.xxoo.errors }}
            <p>{{ form.user }} {{ form.user.errors }}</p>
            <input type="submit" />
    </form>

其他标签有

其他标签使用

cleaned_data（字典）创建和更新

models.UserInfo.objects.create(**obj.cleaned_data)
models.UserInfo.objects.filter(id=1).update(**obj.cleaned_data)

4.更多验证方式

views.py

from django.shortcuts import render,redirect,HttpResponse
from django import forms
from django.forms import widgets
from django.forms import fields

class Verification(forms.Form):
    # 跟表单提交的name值一一对应进行验证
    user = fields.CharField(
        widget=widgets.Textarea(attrs={‘class‘:‘c1‘}),      # 定制样式，变成长框输入，添加样式class=c1
        label="用户名："           # 左边显示信息
    )
    pwd = fields.CharField(
        max_length=12,
        min_length=6,
        widget=widgets.PasswordInput()      # 定制密码格式
    )
    f = fields.FileField()      # 上传文件
    p = fields.FilePathField(path=‘app01‘)      # 显示路径 提交数据为路径值
    email = fields.EmailField()
    city1 = fields.ChoiceField(         # 单选下拉框
        choices=[(0, ‘上海‘), (1, ‘广州‘), (2, ‘东莞‘)]
    )
    city2 = fields.MultipleChoiceField(     # 多选下拉框
        choices=[(0, ‘上海‘), (1, ‘广州‘), (2, ‘东莞‘)]
    )

def login(request):
    if request.method == "GET":
        obj = Verification()
        return render(request, ‘login.html‘, {‘obj‘: obj})
    elif request.method == "POST":
        # 获取用户所有数据
        # 每条数据请求的验证
        # 成功：获取所有的正确的信息
        # 失败：显示错误信息
        obj = Verification(request.POST)
        result = obj.is_valid()  # 进行验证 True/False
        if result:
            print(obj.cleaned_data)  # 用户提交的正确信息
        else:
            print(obj.errors.as_json)  # 所有错误信息 obj.errors
            return render(request, ‘login.html‘, {‘obj‘: obj})  # 传入obj

        return redirect(‘/login/‘)

login.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <form action="/login/" method="post">
        {% csrf_token  %}
        <p>{{ obj.user }}{{ obj.errors.user.0 }}</p>
        <p>{{ obj.pwd }}{{ obj.errors.pwd.0 }}</p>
        <p>{{ obj.email }}{{ obj.errors.email.0 }}</p>
        <p>{{ obj.f }}{{ obj.errors.f.0 }}</p>
        <p>{{ obj.p }}</p>
        <p>{{ obj.city1 }}</p>
        <p>{{ obj.city2 }}</p>
        <input type="submit" name="提交" />
    </form>
</body>
</html>

5.常用插件

# 单radio，值为字符串
user = fields.CharField(
    initial=2,
    widget=widgets.RadioSelect(choices=((1,‘上海‘),(2,‘北京‘),))
)

# 单radio，值为字符串
user = fields.ChoiceField(
    choices=((1, ‘上海‘), (2, ‘北京‘),),
    initial=2,
    widget=widgets.RadioSelect
)

# 单select，值为字符串
user = fields.CharField(
    initial=2,
    widget=widgets.Select(choices=((1,‘上海‘),(2,‘北京‘),))
)

# 单select，值为字符串
user = fields.ChoiceField(
    choices=((1, ‘上海‘), (2, ‘北京‘),),
    initial=2,
    widget=widgets.Select
)

# 多选select，值为列表
user = fields.MultipleChoiceField(
    choices=((1,‘上海‘),(2,‘北京‘),),
    initial=[1,],
    widget=widgets.SelectMultiple
)

# 单checkbox
user = fields.CharField(
    widget=widgets.CheckboxInput()
)

# 多选checkbox,值为列表
user = fields.MultipleChoiceField(
    initial=[2, ],
    choices=((1, ‘上海‘), (2, ‘北京‘),),
    widget=widgets.CheckboxSelectMultiple

Django选择插件

6.初始化默认显示数据

views.py

from django.shortcuts import render,redirect,HttpResponse
from django import forms
from django.forms import widgets
from django.forms import fields

class Verification(forms.Form):
    # 跟表单提交的name值一一对应进行验证
    user = fields.CharField(
        widget=widgets.Textarea(attrs={‘class‘:‘c1‘}),      # 定制样式，变成长框输入，添加样式class=c1
        label="用户名："           # 左边显示信息
    )
    pwd = fields.CharField(
        max_length=12,
        min_length=6,
        widget=widgets.PasswordInput()      # 定制密码格式
    )
    # f = fields.FileField()      # 上传文件
    p = fields.FilePathField(path=‘app01‘)      # 显示路径 提交数据为路径值
    email = fields.EmailField()
    city1 = fields.ChoiceField(         # 单选下拉框
        choices=[(0, ‘上海‘), (1, ‘广州‘), (2, ‘东莞‘)]
    )
    city2 = fields.MultipleChoiceField(     # 多选下拉框
        choices=[(0, ‘上海‘), (1, ‘广州‘), (2, ‘东莞‘)]
    )

def login(request):
    if request.method == "GET":
        # 从数据库中把数据获取到
        dic = {
            ‘user‘:‘root‘,
            ‘pwd‘:‘123123‘,
            ‘email‘:‘[email protected]‘,
            ‘city1‘:2,
            ‘city2‘:[1,2],
        }
        obj = Verification(initial=dic)   #设置初始默认显示
        return render(request, ‘login.html‘, {‘obj‘: obj})
    elif request.method == "POST":
        obj = Verification(request.POST)
        result = obj.is_valid()  # 进行验证 True/False
        if result:
            print(obj.cleaned_data)  # 用户提交的正确信息
        else:
            print(obj.errors.as_json)  # 所有错误信息 obj.errors
            return render(request, ‘login.html‘, {‘obj‘: obj})  # 传入obj

        return redirect(‘/login/‘)

login.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <form action="/login/" method="post">
        {% csrf_token  %}
        <p>{{ obj.user }}{{ obj.errors.user.0 }}</p>
        <p>{{ obj.pwd }}{{ obj.errors.pwd.0 }}</p>
        <p>{{ obj.email }}{{ obj.errors.email.0 }}</p>
{#        <p>{{ obj.f }}{{ obj.errors.f.0 }}</p>#}
        <p>{{ obj.p }}</p>
        <p>{{ obj.city1 }}</p>
        <p>{{ obj.city2 }}</p>
        <input type="submit" name="提交" />
    </form>
</body>
</html>

原文地址：https://www.cnblogs.com/gaidy/p/12085130.html

时间： 2024-10-08 23:53:41

9.Django form组件的相关文章

Django ==&gt; Form 组件

Django ==> Form 组件 目录: 1.基本使用 2.form中字段和插件 3.自定义验证规则 4.动态加载数据到form中 Action: 1.基本使用 django 中的Form组件有一下功能: 1.生成html标签 2.验证用户数据(显示错误信息) 3.html form 提交保留上次提交数据 4.初始化页面显示内容 要使用 form 类,首先需要创建这个类,方法如下: from django.forms import Form from django.forms import

17 Django Form组件

目录 一.Form 介绍 二.注册功能校验数据案例 1.普通方式手写注册功能 2. 使用Form组件实现注册功能校验数据 三.Form组件如何校验数据 四.Form组件如何渲染前端页面 方式一: 方式二: 方式三: 五.Form组件如何展示错误信息 六.Form组件 参数 七.Form组件 钩子函数 1. 局部钩子函数 2. 全局钩子函数 一.Form 介绍 我们之前在HTML页面中利用form表单向后端提交数据时,都会写一些获取用户输入的标签并且用form标签把它们包起来. 与此同时我们在好多

[oldboy-django][2深入django]Form组件功能： 数据格式验证 + 保留上次输入的值（如果有很多输入项，这样正确项不必重复输入，错误项也能提示错误信息）

1 需求:登录或者注册页面存在以下问题 - 无法记住上次提交的内容,(如果有很多输入项,这样正确项不必重复输入,错误项也能提示错误信息)- 重复进行提交数据的校验(数据是否为空,长度大小等等) 2 django的Form组件实现 2.1 Form组件实现数据验证方法 2.1.1 流程操作 - 定义规则(数据的格式,字段必须和表单上name属性一致) class LoginForm(Form): 字段名 = fields.xxFields(参数) # 定义了一个输入框的数据格式要求 实例化对象ob

Django——form组件

之前我们已经学习了HTML中的基本标签--form表单,我们经常使用它向后台提交数据,常规的form表单是这样的: <form action="" method="post"> <p>用户名:<input type="text" name="user"></p> <p>密码:<input type="text" name="pwd&

django form组件扩展

1简单扩展 利用form组件自带的正则扩展: a.方式一 from django.forms import Form from django.forms import widgets from django.forms import fields from django.core.validators import RegexValidator class MyForm(Form): user = fields.CharField( error_messages={'invalid': '...

Django form组件 与 cookie/session

目录 一.form组件 二.cookie.session 一.form组件 1.1 以注册功能为例 注册功能 1.渲染前端标签获取用户输入 --> 渲染标签 2.获取用户输入传递到后端校验 --> 校验数据 3.校验未通过展示错误信息 --> 展示信息 ps:校验数据:前后端都可以校验,但是前端可以不做,后端必须得做!!! 1.2 校验数据 校验数据 第一步需要一个form类 from django import forms class MyForm(forms.Form): name

Django Form组件实例：登录界面[Form表单提交，Ajax提交]

"""本例中使用Form和Ajax进行了数据提交,Form提交有一个问题,就是输入错误的数据,刷新之后原有的数据会丢失.注意到Form组件可以生成HTML标签,将Form生成的对象传到前端,就可以保留原有的内容,具体见下文:""" 1 from django.shortcuts import * 2 from app02 import models 3 import json 4 5 # Create your views here. 6 def

django Form组件 上传文件

上传文件 注意:FORM表单提交文件要有一个参数enctype="multipart/form-data" 普通上传: urls: url(r'^f1/',views.f1), url(r'^f2/',views.f2), views: def f1(request): if request.method == "GET": return render(request,'f1.html') else: import os #导入os模块 #request.get /

Django——form组件is_valid校验机制

#先来归纳一下整个流程#(1)首先is_valid()起手,看seld.errors中是否值,只要有值就是flase#(2)接着分析errors.里面判断_errors是都为空,如果为空返回self.full_clean(),否则返回self._errors#(3)现在就要看full_clean(),是何方神圣了,里面设置_errors和cleaned_data这两个字典,一个存错误字段,一个存储正确字段.#(4)在full_clean最后有一句self._clean_fields(),表示校验