Django Form组件

 1、背景

    平时我们在书写form表单时,经常都是手动的去写一些input标签,让用户输入一些功能,进行一些校验的判断,等等。Django中的form表单就能够帮我们去实现这些功能,比较便捷。

 2、Django form表单的功能

      1、生成页面可执行的HTML标签

      2、对应户的数据进行校验

      3、保留上次输入的内容

3.用Form表单实现

1.先写一个Form类

 

复制代码
from django import forms  # 导入forms 模块
from django.forms import widgets  # 导入forms 模块
class Myform(forms.Form):
    user = forms.CharField(
    max_length=30,
    min_length=6,
    required=True,
    # required True不可以空 CharField(约束条件 属性等) 例如min_length max_length 会给name前边生成一个lable标签
   error_messages={'max_length': '太长了', 'min_length': '太短了', 'required': '不能为空'},
    #widget为html插件,TextInput可生成对应的标签类型,attrs传入标签的属性字典 ) 
    widget=widgets.TextInput(attrs={'class':'form-control','id':'userinput'}),
pwd = forms.CharField( max_length=30, min_length=6, error_messages={'max_length': '太长了', 'min_length': '太短了'}, )
复制代码

 

 

2.写视图函数

复制代码
def index2(request):
    my_form = Myform({'user':'初始值1','pwd':'初始值2'})         # 实例化一个对象
    if request.method == "POST":
        # 实例化form对象的时候,把post提交过来的数据直接传进去
        my_form = Myform(request.POST)

        # 调用form_obj校验数据的方法 is_valid()
        if my_form.is_valid():
            # cleaned_data属性为form_obj对象校验后的数据字典
            # 可通过form_obj.get(属性名) 或者form_obj[属性名]  取值 之后可以进行业务处理
            print(my_form.cleaned_data['user'])
            return HttpResponse("成功")
    return render(request, "index2.html", locals())
复制代码

3.写html

<form action="/index2/" enctype="multipart/form-data" method="post" novalidate>   #novaldate 意思是浏览器不对表格进行验证,直接提交
    {{my_form.uesr.label}}{{ my_form.user }}{{ my_form.errors.user.0 }}  #my_form.errors.字段  这个产生的时一个集合,但往往我们只需要一条错误提示就足够了,所以只需要取第0个错误信息
    {{my_form.pwd.label}}{{ my_form.pwd }}{{ my_form.errors.pwd.0 }}  #所有{{}}的变量均可以用一句{{ my_form.as_p}}或者{{ my_form.as_ul}} {{ my_form.as_table}}生成所含字段,但并不推荐此法
    {% csrf_token %}
    <input type="submit" value="提交">
</form>

 

Django内置字段

复制代码
Field
    required=True,               是否允许为空
    widget=None,                 HTML插件(from django.forms import widgets) 设置属性:widget=forms.TextInput(attrs={'class': 'c1'}),

    label=None,                  用于生成Label标签或显示内容(前端obj.label--> 用户名:【】(输入框))
    initial=None,                初始值
    help_text='',                帮助信息(在标签旁边显示)
    error_messages=None,         错误信息 {'required': '不能为空', 'invalid': '格式错误'}
    show_hidden_initial=False,   是否在当前插件后面再加一个隐藏的且具有默认值的插件(可用于检验两次输入是否一直)
    validators=[],               自定义验证规则(正则表达式)
    localize=False,              是否支持本地化(比如时间数据,当地时间,UTC时间(比如东八区,自动加8小时))
    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,                  # 查询数据库中的数据(写model方法,该方法会在前端显示object,需要去对应的model写__str__)
    empty_label="---------",   # 默认空显示内容(比如下拉框第一行显示"请选择")
    to_field_name=None,        # HTML中value的值对应的字段(注意是标签中的value<option>)
    limit_choices_to=None      # ModelForm中对queryset二次筛选
     
ModelMultipleChoiceField(ModelChoiceField)
    ...                        django.forms.models.ModelMultipleChoiceField
 
 
     
TypedChoiceField(ChoiceField)
    coerce = lambda val: val   对选中的值进行一次转换(通常choice字段后端会受到字符串,如"1",但此处可以转化 比如int)
    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内置html插件

复制代码
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
复制代码

常用插件

复制代码
# 单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
# )
复制代码

注意:在使用选择标签时,需要注意choices的选项可以从数据库中获取,但是由于是静态字段 ***获取的值无法实时更新***,那么需要自定义构造方法(__init__)从而达到此目的。

 

复制代码
from app import models
from django.forms import fields,widgets,Form
class LoveForm (Form) :
    price = fields.IntegerField()
    user_id = fields.IntegerField(
    widget=widgets.Select(choices=((1,'上海'),(2,'北京')),))
    def __init__(self, *args, **kwargs):
        super(LoveForm,self).__init__(*args, **kwargs )
        self.fields['user_ id'].widget.choices = models.User.objects.values_list('id', 'username')
复制代码

 

posted on   匆匆过客23  阅读(136)  评论(0编辑  收藏  举报

< 2025年1月 >
29 30 31 1 2 3 4
5 6 7 8 9 10 11
12 13 14 15 16 17 18
19 20 21 22 23 24 25
26 27 28 29 30 31 1
2 3 4 5 6 7 8

统计

点击右上角即可分享
微信分享提示