form组件-字段

Posted 506941763lcj

tags:

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

Form类

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

1、Django内置字段如下:

  1 Field
  2     required=True,               是否允许为空
  3     widget=None,                 HTML插件(from django.forms import widgets) 设置属性:widget=forms.TextInput(attrs={class: c1}),
  4 
  5     label=None,                  用于生成Label标签或显示内容(前端obj.label--> 用户名:【】(输入框))
  6     initial=None,                初始值
  7     help_text=‘‘,                帮助信息(在标签旁边显示)
  8     error_messages=None,         错误信息 {required: 不能为空, invalid: 格式错误}
  9     show_hidden_initial=False,   是否在当前插件后面再加一个隐藏的且具有默认值的插件(可用于检验两次输入是否一直)
 10     validators=[],               自定义验证规则(正则表达式)
 11     localize=False,              是否支持本地化(比如时间数据,当地时间,UTC时间(比如东八区,自动加8小时))
 12     disabled=False,              是否可以编辑
 13     label_suffix=None            Label内容后缀
 14 
 15 
 16 CharField(Field)                 字符串字段, 用于较短的字符串.CharField 要求必须有一个参数 maxlength, 用于从数据库层和Django校验层限制该字段所允许的最大字符数.
 17     max_length=None,             最大长度
 18     min_length=None,             最小长度
 19     strip=True                   是否移除用户输入空白
 20 
 21 IntegerField(Field)              用于保存一个整数
 22     max_value=None,              最大值
 23     min_value=None,              最小值
 24 
 25 FloatField(IntegerField)
 26     一个浮点数. 必须 提供两个参数:
 27         #   参数              描述
 28         # max_digits          总位数(不包括小数点和符号)
 29         # decimal_places      小数位数
 30                 # 举例来说, 要保存最大值为 100 (小数点后保存2位),你要这样定义字段:
 31                 #
 32                 # models.FloatField(..., max_digits=5, decimal_places=2)
 33                 # 要保存最大值一百万(小数点后保存10位)的话,你要这样定义:
 34                 #
 35                 # models.FloatField(..., max_digits=19, decimal_places=10)
 36     ...
 37 
 38 DecimalField(IntegerField)
 39     max_value=None,              最大值
 40     min_value=None,              最小值
 41     max_digits=None,             总长度
 42     decimal_places=None,         小数位长度
 43 
 44 BaseTemporalField(Field)
 45     input_formats=None          时间格式化
 46 
 47 DateField(BaseTemporalField)    格式:2015-09-01
 48 
 49 TimeField(BaseTemporalField)    格式:11:12
 50 DateTimeField(BaseTemporalField)格式:2015-09-01 11:12
 51 
 52 DurationField(Field)            时间间隔:%d %H:%M:%S.%f
 53     ...
 54 
 55 RegexField(CharField)
 56     regex,                      自定制正则表达式
 57     max_length=None,            最大长度
 58     min_length=None,            最小长度
 59     error_message=None,         忽略,错误信息使用 error_messages={invalid: ...}
 60 
 61 EmailField(CharField)
 62     ...
 63 
 64 FileField(Field)
 65     allow_empty_file=False     是否允许空文件
 66 
 67 ImageField(FileField)
 68     ...
 69     注:需要PIL模块,pip3 install Pillow
 70     以上两个字典使用时,需要注意两点:
 71         - form表单中 enctype="multipart/form-data"
 72         - view函数中 obj = MyForm(request.POST, request.FILES)
 73 
 74 URLField(Field)
 75      # 用于保存 URL. 若 verify_exists 参数为 True (默认), 给定的 URL 会预先检查是否存在( 即URL是否被有效装入且
 76       # 没有返回404响应).
 77     ...
 78 
 79 
 80 BooleanField(Field)
 81     ...
 82 
 83 NullBooleanField(BooleanField)
 84     # A true/false field. admin 用 checkbox 来表示此类字段.
 85     ...
 86 
 87 ChoiceField(Field)
 88     ...
 89     choices=(),                选项,如:choices = ((0,上海),(1,北京),)
 90     required=True,             是否必填
 91     widget=None,               插件,默认select插件
 92     label=None,                Label内容
 93     initial=None,              初始值
 94     help_text=‘‘,              帮助提示
 95 
 96 
 97 ModelChoiceField(ChoiceField)
 98     ...                        django.forms.models.ModelChoiceField
 99     queryset,                  # 查询数据库中的数据(写model方法,该方法会在前端显示object,需要去对应的model写__str__)
100     empty_label="---------",   # 默认空显示内容(比如下拉框第一行显示"请选择")
101     to_field_name=None,        # HTML中value的值对应的字段(注意是标签中的value<option>)
102     limit_choices_to=None      # ModelForm中对queryset二次筛选
103 
104 ModelMultipleChoiceField(ModelChoiceField)
105     ...                        django.forms.models.ModelMultipleChoiceField
106 
107 
108 
109 TypedChoiceField(ChoiceField)
110     coerce = lambda val: val   对选中的值进行一次转换(通常choice字段后端会受到字符串,如"1",但此处可以转化 比如int)
111     empty_value= ‘‘            空值的默认值
112 
113 MultipleChoiceField(ChoiceField)
114     ...
115 
116 TypedMultipleChoiceField(MultipleChoiceField)
117     coerce = lambda val: val   对选中的每一个值进行一次转换
118     empty_value= ‘‘            空值的默认值
119 
120 ComboField(Field)
121     fields=()                  使用多个验证,如下:即验证最大长度20,又验证邮箱格式
122                                fields.ComboField(fields=[fields.CharField(max_length=20), fields.EmailField(),])
123 
124 MultiValueField(Field)
125     PS: 抽象类,子类中可以实现聚合多个字典去匹配一个值,要配合MultiWidget使用
126 
127 SplitDateTimeField(MultiValueField)
128     input_date_formats=None,   格式列表:[%Y--%m--%d, %m%d/%Y, %m/%d/%y]
129     input_time_formats=None    格式列表:[%H:%M:%S, %H:%M:%S.%f, %H:%M]
130 
131 FilePathField(ChoiceField)     文件选项,目录下文件显示在页面中
132     path,                      文件夹路径
133     match=None,                正则匹配
134     recursive=False,           递归下面的文件夹
135     allow_files=True,          允许文件
136     allow_folders=False,       允许文件夹
137     required=True,
138     widget=None,
139     label=None,
140     initial=None,
141     help_text=‘‘
142 
143 GenericIPAddressField
144     protocol=both,           both,ipv4,ipv6支持的IP格式
145     unpack_ipv4=False          解析ipv4地址,如果是::ffff:192.0.2.1时候,可解析为192.0.2.1, PS:protocol必须为both才能启用
146 
147 SlugField(CharField)           数字,字母,下划线,减号(连字符)(只能包含这些)
148     ...
149 
150 UUIDField(CharField)           uuid类型
151     ...

2.实例:

技术分享图片
 1 from django.shortcuts import render,redirect
 2 from django.forms import widgets
 3 # Create your views here.
 4 from django import forms
 5 from django.forms import fields
 6 from app02.models import UserIn
 7 from app02 import models
 8 
 9 class TestForm(forms.Form):
10     user=fields.CharField(
11         required=True,#是否必填
12         max_length=16,#最大长度
13         min_length=6,#最小长度
14         error_messages={},#错误提示
15         # lable=‘用户名‘,
16         initial=请输入用户名,
17         help_text=asasdasd,
18         show_hidden_initial=False,
19         # widget=widgets.Textarea(),
20         label=用户名,
21         # disabled=True,
22         # label_suffix=‘:‘,
23     )
24 
25     age=fields.IntegerField(
26         label=年龄,
27         max_value=20,
28         min_value=12,
29         error_messages={
30             max_value:太长了,
31             min_value: 太短了,
32         }
33     )
34     email=fields.EmailField(
35         label=邮箱,
36     )
37     img=fields.FileField()
38     #下拉框
39     city=fields.ChoiceField(
40         choices=[(1,北京),(2,上海),(3,深圳)],
41         initial=2,
42     )
43     #多选框
44     hobby=fields.MultipleChoiceField(
45         choices=[(1,篮球),(2,唱歌),(3,高尔夫)],
46         initial=[1,2]#多选
47     )
48 
49 
50 def test(request):
51     if request.method==GET:
52         obb=TestForm()
53         return render(request,test.html,{obb:obb})
54     else:
55         obb=TestForm(request.POST,request.FILES)
56         obb.is_valid()
57         print(obb.cleaned_data)
58         return render(request,test.html,{"obb":obb})
59            
View Code

3.Django内置插件:

 1 TextInput(Input)
 2 NumberInput(TextInput)
 3 EmailInput(TextInput)
 4 URLInput(TextInput)
 5 PasswordInput(TextInput)
 6 HiddenInput(TextInput)
 7 Textarea(Widget)
 8 DateInput(DateTimeBaseInput)
 9 DateTimeInput(DateTimeBaseInput)
10 TimeInput(DateTimeBaseInput)
11 CheckboxInput
12 Select
13 NullBooleanSelect
14 SelectMultiple
15 Radioselect
16 CheckboxSelectMultiple
17 FileInput
18 ClearableFileInput
19 MultipleHiddenInput
20 SplitDateTimeWidget
21 SplitHiddenDateTimeWidget
22 SelectDateWidget

4.常用选择插件

 1 # 单radio,值为字符串
 2 # user = fields.CharField(
 3 #     initial=2,
 4 #     widget=widgets.RadioSelect(choices=((1,‘上海‘),(2,‘北京‘),))
 5 # )
 6  
 7 # 单radio,值为字符串
 8 # user = fields.ChoiceField(
 9 #     choices=((1, ‘上海‘), (2, ‘北京‘),),
10 #     initial=2,
11 #     widget=widgets.RadioSelect
12 # )
13  
14 # 单select,值为字符串
15 # user = fields.CharField(
16 #     initial=2,
17 #     widget=widgets.Select(choices=((1,‘上海‘),(2,‘北京‘),))
18 # )
19  
20 # 单select,值为字符串
21 # user = fields.ChoiceField(
22 #     choices=((1, ‘上海‘), (2, ‘北京‘),),
23 #     initial=2,
24 #     widget=widgets.Select
25 # )
26  
27 # 多选select,值为列表
28 # user = fields.MultipleChoiceField(
29 #     choices=((1,‘上海‘),(2,‘北京‘),),
30 #     initial=[1,],
31 #     widget=widgets.SelectMultiple
32 # )
33  
34  
35 # 单checkbox
36 # user = fields.CharField(
37 #     widget=widgets.CheckboxInput()
38 # )
39  
40  
41 # 多选checkbox,值为列表
42 # user = fields.MultipleChoiceField(
43 #     initial=[2, ],
44 #     choices=((1, ‘上海‘), (2, ‘北京‘),),
45 #     widget=widgets.CheckboxSelectMultiple
46 # )

 

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

form组件-字段

第六章forms组件

Django-Form组件之字段

Form组件使用

form组件

如何使用 redux-form 在不同组件(向上一个组件)中显示 FieldArray 中的字段