Python之路71-Django form组件

Posted

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Python之路71-Django form组件相关的知识,希望对你有一定的参考价值。

目录

一、介绍

二、示例

三、form类

四、常用选择插件

五、自定义验证规则

六、初始化数据


一、介绍

Django的form主要具有以下几大功能

生成HTML标签

验证用户数据(显示错误信息)

HTML form提交保留上次提交数据

初始化页面显示内容


二、示例


url.py

from django.conf.urls import url
from django.contrib import admin

from app01 import views

urlpatterns = [
    url(r‘^admin/‘, admin.site.urls),
    url(r‘^fm/‘, views.fm),
]


views.py

from django import forms
from app01 import models
from django.forms import widgets
from django.forms import fields


class FM(forms.Form):
    # 字段本身只做验证
    user = fields.CharField(error_messages={"required": "用户名不能为空"},
                           widget=widgets.Textarea(attrs={"class": "c1"}))
    pwd = fields.CharField(
        max_length=12,
        min_length=6,
        error_messages={"required": "密码不能为空", "max_length": "密码长度不能大于16", "min_length": "密码长度不能小于6",},
        widgets=widgets.PasswordInput()
    )
    email = fields.EmailField(error_messages={"required": "邮箱不能为空", "invalid": "邮箱格式错误"})


def fm(request):
    if request.method == "GET":
        obj = FM()
        return render(request, "fm.html", {"obj": obj})
    elif request.method == "POST":
        # 获取用户的所有数据
        # 每条数据请求的验证
        # 成功:获取所有正确的信息
        # 失败:页面显示错误信息
        obj = FM(request.POST)
        res = obj.is_valid()
        if res:
            models.UserInfo.objects.create(**obj.cleaned_data)
        else:
            return render(request, "fm.html", {"obj": obj})


fm.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <form action="/fm/" 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类

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


1.Django内置字段

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内容后缀
 
 
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)
    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类型
    ...


注:UUID是根据MAC以及当前时间等创建的不重复的随机字符串

>>> import uuid    # make a UUID based on the host ID and current time
    >>> uuid.uuid1()    # doctest: +SKIP
    UUID(‘a8098c1a-f86e-11da-bd1a-00112444be1e‘)    # make a UUID using an MD5 hash of a namespace UUID and a name
    >>> uuid.uuid3(uuid.NAMESPACE_DNS, ‘python.org‘)
    UUID(‘6fa459ea-ee8a-3ca4-894e-db77e160355e‘)    # make a random UUID
    >>> uuid.uuid4()    # doctest: +SKIP
    UUID(‘16fd2706-8baf-433b-82eb-8c7fada847da‘)    # make a UUID using a SHA-1 hash of a namespace UUID and a name
    >>> uuid.uuid5(uuid.NAMESPACE_DNS, ‘python.org‘)
    UUID(‘886313e1-3b8a-5372-9b90-0c9aee199e5d‘)    # make a UUID from a string of hex digits (braces and hyphens ignored)
    >>> x = uuid.UUID(‘{00010203-0405-0607-0809-0a0b0c0d0e0f}‘)    # convert a UUID to a string of hex digits in standard form
    >>> str(x)    ‘00010203-0405-0607-0809-0a0b0c0d0e0f‘

    # get the raw 16 bytes of the UUID
    >>> x.bytes
    b‘\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\x0c\r\x0e\x0f‘

    # make a UUID from a 16-byte string
    >>> uuid.UUID(bytes=x.bytes)
    UUID(‘00010203-0405-0607-0809-0a0b0c0d0e0f‘)


2.Django内部插件

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


四、常用选择插件



五、自定义验证规则



六、初始化数据


本文出自 “八英里” 博客,请务必保留此出处http://5921271.blog.51cto.com/5911271/1930342

以上是关于Python之路71-Django form组件的主要内容,如果未能解决你的问题,请参考以下文章

python之路_自定义forms组件

Python之路第二十一篇:Django之Form组件

西游之路——python全栈——Django的form组件初识

西游之路——python全栈——Form组件字段及动态绑定

Python Day71 django分页及session介绍

71.Django13——Auth组件