首页 > 代码库 > django之form

django之form

对于前端提交数据,通常都使用form表单来提交数据给服务器,那么通常我们会对form提交的数据进行校验,如特殊字符(浏览器、解释器或数据库能识别的字符串),合法性和数据库比对进行校验,并且希望匹配错误能保存数据重新返回客户端方便客户端重新填写,而这一功能django的form已经为我们做好了。

django为我们做的form主要有两大功能

一、对用户数据进行正则匹配(使用对象封装的正则表达式)

二、帮助我们自动生成标签到模版文件,并把未能匹配成功的数据放进去。(实现了保存用户输入的数据,增加唉客户的体验效果)

 

技术分享
#建议form类的字段名和数据库的名一样,这样方便数据库取出的数据直接放入form对象中而不需要我们做特殊处理
from django import forms
from django.core.exceptions import ValidationError
#form匹配规则类
class PublishForm(forms.Form):

    user_type_choice = (
        (0, u普通用户),
        (1, u高级用户),
    )

    user_type = forms.IntegerField(widget=forms.widgets.Select(choices=user_type_choice,
                                                                  attrs={class: "form-control"}))

    title = forms.CharField(max_length=20,
                            min_length=5,
                            error_messages={required: u标题不能为空,
                                            min_length: u标题最少为5个字符,
                                            max_length: u标题最多为20个字符},
                            widget=forms.TextInput(attrs={class: "form-control",
                                                          placeholder: u标题5-20个字符}))

    memo = forms.CharField(required=False,
                           max_length=256,
                           widget=forms.widgets.Textarea(attrs={class: "form-control no-radius", placeholder: u详细描述, rows: 3}))

    phone = forms.CharField(validators=[mobile_validate, ],
                            error_messages={required: u手机不能为空},
                            widget=forms.TextInput(attrs={class: "form-control",
                                                          placeholder: u手机号码}))

    email = forms.EmailField(required=False,
                            error_messages={required: u邮箱不能为空,invalid: u邮箱格式错误},
                            widget=forms.TextInput(attrs={class: "form-control", placeholder: u邮箱}))
#接收数据的视图函数
def publish(request):
    ret = {status: False, data: ‘‘, error: ‘‘, summary: ‘‘}
    if request.method == POST:
        request_form = PublishForm(request.POST)
        if request_form.is_valid():
            request_dict = request_form.clean()
            print request_dict
            ret[status] = True
        else:
            error_msg = request_form.errors.as_json()
            ret[error] = json.loads(error_msg)
    return HttpResponse(json.dumps(ret))
正则匹配

 

技术分享
from django.forms import Form
from django.forms import widgets
from django.forms import fields
 
class MyForm(Form):
    user = fields.CharField(
        widget=widgets.TextInput(attrs={id: i1, class: c1})
    )
 ###attrs 给创建标签添加属性
    gender = fields.ChoiceField(
        choices=((1, ), (2, ),),  ###也可以是数据库中获得
        initial=2,  ###默认值
        widget=widgets.RadioSelect
    )
 
    city = fields.CharField(
        initial=2,
        widget=widgets.Select(choices=((1,上海),(2,北京),))
    )
 
    pwd = fields.CharField(
        widget=widgets.PasswordInput(attrs={class: c1}, render_value=http://www.mamicode.com/True)
    )
创建form类
技术分享
from django.shortcuts import render, redirect
from .forms import MyForm
 
 
def index(request):
    if request.method == "GET":
        obj = MyForm()
        return render(request, index.html, {form: obj})
    elif request.method == "POST":
        obj = MyForm(request.POST, request.FILES)
        if obj.is_valid():
            values = obj.clean()
            print(values)
        else:
            errors = obj.errors
            print(errors)
        return render(request, index.html, {form: obj})
    else:
        return redirect(http://www.google.com)
视图函数
技术分享
<form action="/" method="POST" enctype="multipart/form-data">
    <p>{{ form.user }} {{ form.user.errors }}</p>
    <p>{{ form.gender }} {{ form.gender.errors }}</p>
    <p>{{ form.city }} {{ form.city.errors }}</p>
    <p>{{ form.pwd }} {{ form.pwd.errors }}</p>
    <input type="submit"/>
</form>


#不建议使用form.as_p,因为form.as_p是遍历form对象来创建标签,不够灵活
模板文件
技术分享
    <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>
其他常用的标签
技术分享
class MyForm(Form):
    user = fields.CharField(    validators=[RegexValidator(r^[0-9]+$, 请输入数字),
     RegexValidator(r^159[0-9]+$, 数字必须以159开头)],)
对象规则和自定义正则同时匹配

 

在使用form创建标签的功能时,可以使用的属性或字段

技术分享
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类型
View Code
技术分享
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
form 所有的标签
技术分享
# 单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
# )
常使用插件的具体用法

 

 

 

在此form的功能已经实现,但在使用的都是静态字段,没办法事实更新(如select是从数据库取到的,数据库更新后而form对象字段没有更新),此时需要一个构造方法,使得每次创建form对象都可以查询数据库,代码如下:

技术分享
class Stu_Form(Form):
    name=fields.RegexField(.*,error_messages={invalid:请输入正确格式,required:不能为空},
                           widget=widgets.TextInput(attrs={class:form-control}))
    email=fields.EmailField(error_messages={invalid:请输入正确的邮箱,required:不能为空},
                            widget=widgets.TextInput(attrs={class: form-control})  )
    age=fields.IntegerField(min_value=http://www.mamicode.com/18,max_value=28,error_messages={required:不能为空,
                                                                      min_value:必须大于18,
                                                                      max_value:必须小于28},
                            widget=widgets.TextInput(attrs={class: form-control}))
    cls_id=fields.IntegerField(widget=widgets.Select(attrs={class: form-control}))
    def __init__(self,*args,**kwargs):
        super(Stu_Form,self).__init__(*args,**kwargs)
        self.fields[cls_id].widget.choices=models.Classes.objects.values_list(id,cname)
View Code

也可以使用django给我们使用的ModelChoiceField和ModelMultipleChoiceField字段来实现

技术分享
class FInfo(forms.Form):
    authors = form_model.ModelMultipleChoiceField(queryset=models.NNewType.objects.all())
    # authors = form_model.ModelChoiceField(queryset=models.NNewType.objects.all())
.ModelMultipleChoiceField,ModelChoiceField

 

自定义正则规则

技术分享
import re
from django.forms import Form
from django.forms import widgets
from django.forms import fields
from django.core.exceptions import ValidationError

def mobile_validate(value):
    mobile_re = re.compile(r^(13[0-9]|15[012356789]|17[678]|18[0-9]|14[57])[0-9]{8}$)
    if not mobile_re.match(value):
        raise ValidationError(手机号码格式错误)


class PublishForm(Form):
 
 
    title = fields.CharField(max_length=20,
                            min_length=5,
                            error_messages={required: 标题不能为空,
                                            min_length: 标题最少为5个字符,
                                            max_length: 标题最多为20个字符},
                            widget=widgets.TextInput(attrs={class: "form-control",
                                                          placeholder: 标题5-20个字符}))
 
 
    # 使用自定义验证规则
    phone = fields.CharField(validators=[mobile_validate, ],
                            error_messages={required: 手机不能为空},
                            widget=widgets.TextInput(attrs={class: "form-control",
                                                          placeholder: u手机号码}))
View Code

 

 

同时生成多个标签进行验证

技术分享
from django.forms import Form
from django.forms import widgets
from django.forms import fields
 
from django.core.validators import RegexValidator
 
 
############## 自定义字段 ##############
class PhoneField(fields.MultiValueField):
    def __init__(self, *args, **kwargs):
        # Define one message for all fields.
        error_messages = {
            incomplete: Enter a country calling code and a phone number.,
        }
        # Or define a different message for each field.
        f = (
            fields.CharField(
                error_messages={incomplete: Enter a country calling code.},
                validators=[
                    RegexValidator(r^[0-9]+$, Enter a valid country calling code.),
                ],
            ),
            fields.CharField(
                error_messages={incomplete: Enter a phone number.},
                validators=[RegexValidator(r^[0-9]+$, Enter a valid phone number.)],
            ),
            fields.CharField(
                validators=[RegexValidator(r^[0-9]+$, Enter a valid extension.)],
                required=False,
            ),
        )
        super(PhoneField, self).__init__(error_messages=error_messages, fields=f, require_all_fields=False, *args,
                                         **kwargs)
 
    def compress(self, data_list):
        """
        当用户验证都通过后,该值返回给用户
        :param data_list:
        :return:
        """
        return data_list
 
############## 自定义插件 ##############
class SplitPhoneWidget(widgets.MultiWidget):
    def __init__(self):
        ws = (
            widgets.TextInput(),
            widgets.TextInput(),
            widgets.TextInput(),
        )
        super(SplitPhoneWidget, self).__init__(ws)
 
    def decompress(self, value):
        """
        处理初始值,当初始值initial不是列表时,调用该方法
        :param value:
        :return:
        """
        if value:
            return value.split(,)
        return [None, None, None]
View Code

 

django之form