Form组件归类

一、Form类

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

1、Django内置字段如下：

  1 Field

  2     required=True,               是否允许为空

  3     widget=None,                 HTML插件

  4     label=None,                  用于生成Label标签或显示内容

  5     initial=None,                初始值

  6     help_text='',                帮助信息(在标签旁边显示)

  7     error_messages=None,         错误信息 {'required': '不能为空', 'invalid': '格式错误'}

  8     show_hidden_initial=False,   是否在当前插件后面再加一个隐藏的且具有默认值的插件（可用于检验两次输入是否一直）

  9     validators=[],               自定义验证规则

 10     localize=False,              是否支持本地化

 11     disabled=False,              是否可以编辑

 12     label_suffix=None            Label内容后缀

 13

 14

 15 CharField(Field)

 16     max_length=None,             最大长度

 17     min_length=None,             最小长度

 18     strip=True                   是否移除用户输入空白

 19

 20 IntegerField(Field)

 21     max_value=None,              最大值

 22     min_value=None,              最小值

 23

 24 FloatField(IntegerField)

 25     ...

 26

 27 DecimalField(IntegerField)

 28     max_value=None,              最大值

 29     min_value=None,              最小值

 30     max_digits=None,             总长度

 31     decimal_places=None,         小数位长度

 32

 33 BaseTemporalField(Field)

 34     input_formats=None          时间格式化

 35

 36 DateField(BaseTemporalField)    格式：2015-09-01

 37 TimeField(BaseTemporalField)    格式：11:12

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

 39

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

 41     ...

 42

 43 RegexField(CharField)

 44     regex,                      自定制正则表达式

 45     max_length=None,            最大长度

 46     min_length=None,            最小长度

 47     error_message=None,         忽略，错误信息使用 error_messages={'invalid': '...'}

 48

 49 EmailField(CharField)

 50     ...

 51

 52 FileField(Field)

 53     allow_empty_file=False     是否允许空文件

 54

 55 ImageField(FileField)

 56     ...

 57     注：需要PIL模块，pip3 install Pillow

 58     以上两个字典使用时，需要注意两点：

 59         - form表单中 enctype="multipart/form-data"

 60         - view函数中 obj = MyForm(request.POST, request.FILES)

 61

 62 URLField(Field)

 63     ...

 64

 65

 66 BooleanField(Field)

 67     ...

 68

 69 NullBooleanField(BooleanField)

 70     ...

 71

 72 ChoiceField(Field)

 73     ...

 74     choices=(),                选项，如：choices = ((0,'上海'),(1,'北京'),)

 75     required=True,             是否必填

 76     widget=None,               插件，默认select插件

 77     label=None,                Label内容

 78     initial=None,              初始值

 79     help_text='',              帮助提示

 80

 81

 82 ModelChoiceField(ChoiceField)

 83     ...                        django.forms.models.ModelChoiceField

 84     queryset,                  # 查询数据库中的数据

 85     empty_label="---------",   # 默认空显示内容

 86     to_field_name=None,        # HTML中value的值对应的字段

 87     limit_choices_to=None      # ModelForm中对queryset二次筛选

 88

 89 ModelMultipleChoiceField(ModelChoiceField)

 90     ...                        django.forms.models.ModelMultipleChoiceField

 91

 92

 93

 94 TypedChoiceField(ChoiceField)

 95     coerce = lambda val: val   对选中的值进行一次转换

 96     empty_value= ''            空值的默认值

 97

 98 MultipleChoiceField(ChoiceField)

 99     ...

100

101 TypedMultipleChoiceField(MultipleChoiceField)

102     coerce = lambda val: val   对选中的每一个值进行一次转换

103     empty_value= ''            空值的默认值

104

105 ComboField(Field)

106     fields=()                  使用多个验证，如下：即验证最大长度20，又验证邮箱格式

107                                fields.ComboField(fields=[fields.CharField(max_length=20), fields.EmailField(),])

108

109 MultiValueField(Field)

110     PS: 抽象类，子类中可以实现聚合多个字典去匹配一个值，要配合MultiWidget使用

111

112 SplitDateTimeField(MultiValueField)

113     input_date_formats=None,   格式列表：['%Y--%m--%d', '%m%d/%Y', '%m/%d/%y']

114     input_time_formats=None    格式列表：['%H:%M:%S', '%H:%M:%S.%f', '%H:%M']

115

116 FilePathField(ChoiceField)     文件选项，目录下文件显示在页面中

117     path,                      文件夹路径

118     match=None,                正则匹配

119     recursive=False,           递归下面的文件夹

120     allow_files=True,          允许文件

121     allow_folders=False,       允许文件夹

122     required=True,

123     widget=None,

124     label=None,

125     initial=None,

126     help_text=''

127

128 GenericIPAddressField

129     protocol='both',           both,ipv4,ipv6支持的IP格式

130     unpack_ipv4=False          解析ipv4地址，如果是::ffff:192.0.2.1时候，可解析为192.0.2.1， PS：protocol必须为both才能启用

131

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

133     ...

134

135 UUIDField(CharField)           uuid类型

136     ...

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

3、常用选择插件

# 单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【第15篇】：Django之Form组件归类

Form组件归类

最新文章

热门文章