Django里的forms 内置字段

Django里的forms 内置字段

一、 forms 内置字段 

1. Field    # 有 Field 类型，其他类型基本都有 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 内容后缀 

2. CharField(Field) 

    max_length=None,             最大长度 

    min_length=None,             最小长度 

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

3. IntegerField(Field) 

    max_value=None,              最大值 

    min_value=None,              最小值 

4. FloatField(IntegerField) 

    ... 

5. DecimalField(IntegerField) 

    max_value=None,              最大值 

    min_value=None,              最小值 

    max_digits=None,             总长度 

    decimal_places=None,         小数位长度 

6. BaseTemporalField(Field) 

    input_formats=None          时间格式化    

7. DateField(BaseTemporalField)    格式：2015-09-01 

8. TimeField(BaseTemporalField)    格式：11:12 

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

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

    ... 

11. RegexField(CharField) 

    regex,                      自定制正则表达式 

    max_length=None,            最大长度 

    min_length=None,            最小长度 

    error_message=None,         忽 略 ， 错 误 信 息 使 用 

error_messages={'invalid': '...'} 

12. EmailField(CharField) 

    ... 

13. FileField(Field) 

    allow_empty_file=False     是否允许空文件 

14. ImageField(FileField)  

    ... 

    注：需要 PIL 模块，pip3 install Pillow 

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

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

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

15. URLField(Field) 

    ... 

16. BooleanField(Field) 

    ... 

17. NullBooleanField(BooleanField) 

    ... 

18. ChoiceField(Field) 

    ... 

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

    required=True,             是否必填 

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

    label=None,                Label 内容 

    initial=None,              初始值 

    help_text='',              帮助提示 

19. ModelChoiceField(ChoiceField) 

    ...                        django.forms.models.ModelChoiceField 

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

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

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

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

20. ModelMultipleChoiceField(ModelChoiceField) 

    ...                  django.forms.models.ModelMultipleChoiceField 

21. TypedChoiceField(ChoiceField) 

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

    empty_value= ''            空值的默认值 

22. MultipleChoiceField(ChoiceField) 

    ... 

23. TypedMultipleChoiceField(MultipleChoiceField) 

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

    empty_value= ''            空值的默认值 

24. ComboField(Field) 

    fields=()                  使用多个验证，如下：即验证最大长度20，又 验 证 邮 箱 格 式 fields.ComboField(fields=[fields.CharField(max_length=20), fields.EmailField(),]) 

25. MultiValueField(Field) 

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

26. 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'] 

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

    path,                        文件夹路径 

    match=None,                 正则匹配 

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

    allow_files=True,              允许文件 

    allow_folders=False,           允许文件夹 

    required=True, 

    widget=None, 

    label=None, 

    initial=None, 

    help_text='' 

28. GenericIPAddressField 

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

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

29. SlugField(CharField)        数字，字母，下划线，减号(连字符) 

    ... 

30. UUIDField(CharField)       uuid 类型 

二、 Field widget 字段 

1. 处理 input 的部件 

TextInput(Input) 

NumberInput(TextInput) 

EmailInput(TextInput) 

URLInput(TextInput) 

PasswordInput(TextInput) 

HiddenInput(TextInput) 

Textarea(Widget) 

DateInput(DateTimeBaseInput) 

DateTimeInput(DateTimeBaseInput) 

TimeInput(DateTimeBaseInput) 

2. Selector 和 checkbox 部件 

CheckboxInput 

Select 

NullBooleanSelect 

SelectMultiple 

RadioSelect 

CheckboxSelectMultiple 

3. File upload 部件 

FileInput 

ClearableFileInput 

4. 合成部件 

MultipleHiddenInput 

SplitDateTimeWidget 

SplitHiddenDateTimeWidget 

SelectDateWidget 

三、 常用选择插件 

1. 单 radio，值为字符串 

user = fields.CharField( 

    initial=2, 

    widget=widgets.RadioSelect(choices=((1,'上海'),(2,'北京'),)) 

) 

2. # 单 radio，值为字符串 

user = fields.ChoiceField( 

    choices=((1, '上海'), (2, '北京'),), 

    initial=2, 

    widget=widgets.RadioSelect 

) 

3. 单 select，值为字符串 

user = fields.CharField( 

    initial=2, 

    widget=widgets.Select(choices=((1,'上海'),(2,'北京'),)) 

) 

4. 单 select，值为字符串 

user = fields.ChoiceField( 

    choices=((1, '上海'), (2, '北京'),), 

    initial=2, 

    widget=widgets.Select 

) 

5. 多选 select，值为列表 

user = fields.MultipleChoiceField( 

    choices=((1,'上海'),(2,'北京'),), 

    initial=[1,], 

    widget=widgets.SelectMultiple 

) 

6. 单 checkbox 

user = fields.CharField( 

    widget=widgets.CheckboxInput() 

) 

7. 多选 checkbox,值为列表 

user = fields.MultipleChoiceField( 

    initial=[2, ], 

    choices=((1, '上海'), (2, '北京'),), 

    widget=widgets.CheckboxSelectMultiple 

) 

---