Django--form表单组件

深碍√TFBOYSˉ_ 2023-08-17 16:35 103阅读 0赞

form组件的祖耀功能如下：

1、生成页面可用的HTML标签

2、对用户提交的数据进行校验

3、保留上次输入内容

## 使用form组件实现注册功能 ##

第一步需要一个form类

第二步实例化form对象

第三步查看校验数据是否合法

第四部查看校验的错误信息

第五步查看校验通过的数据

ps：

form中所有的字段默认都是必须传值的（required=True）

校验数据的时候可以多传（多传的数据不会做任何的校验>>>不会对form校验产生任何影响）

form组件校验数据是从上往下一次取值进行校验，校验通过的数据放到cleaned\_data中，校验失败的数据放到errors中

渲染数据：

form组件只帮你渲染获取用户输入的标签，不会帮你渲染提交按钮，所以按钮是需要手动进行添加的

渲染的三种方式：

<h1>第一种渲染方式(可扩展性较差)</h1>
    {
         { form_obj.as_p }}
    {
         { form_obj.as_ul }}

<h1>第二种渲染方式</h1>
                <form action="">
                    <p>{
        { form_obj.name.label }}{
        { form_obj.name }}</p>
                    <p>{
        { form_obj.password.label }}{
        { form_obj.password }}</p>
                    <p>{
        { form_obj.email.label }}{
        { form_obj.email }}</p>
                    <input type="submit">
                </form>

<h1>第三种渲染标签的方式</h1>
                    <form action="">
                        {
         % for foo in form_obj %}
                            <p>{
        { foo.label }}{
        { foo }}</p>
                        {
         % endfor %}
                    </form>

这里推荐使用第二种和第三种，一般是第三种使用较多

前端取消校验

form组件提交数据如果数据不合法，页面上会保留之前用户输入的信息，在使用form组件对模型表进行校验数据的时候，只需要保证字段的一直，那么在创建对象的时候你就直接\*\*form\_obj.cleaned\_data

<form action="" method="post" novalidate>
                {
         % for foo in form_obj %}
                    <p>
                        {
         { foo.label }}{
         { foo }}
                        <span>{
        { foo.errors.0 }}</span>
                    </p>
                {
         % endfor %}
                <input type="submit">
            </form>

### 钩子函数 ###

局部钩子（单个字段的校验利用局部钩子函数）

def clean_name(self):
        name = self.cleaned_data.get('name')
        if '666' in name:
        　　self.add_error('name','光喊666是不行的，要有真实力!')
        return name  # return还是要加上的，兼容性考虑

全局钩子（多个字段的校验利用全局钩子函数）

def clean(self):
                    password = self.cleaned_data.get('password')
                    confirm_password = self.cleaned_data.get('confirm_password')
                    if not password == confirm_password:
                        self.add_error('confirm_password',"两次密码不一致，你这个dsb!")
                    return self.cleaned_data

设置标签的样式

from django import forms
            from django.forms import widgets
            password = forms.CharField(max_length=8,min_length=3,error_messages={
                                'max_length': '密码最长8位',
                                'required': '密码不能为空',
                                'min_length':'密码最少3位'
                                },widget=widgets.PasswordInput(attrs={
        'class':'c1 form-control'}))
            
            
                    hobby = forms.ChoiceField(
                    choices=((1, "篮球"), (2, "足球"), (3, "双色球"),),
                    label="爱好",
                    initial=3,
                    widget=forms.widgets.Select()
                )
                hobby1 = forms.MultipleChoiceField(
                    choices=((1, "篮球"), (2, "足球"), (3, "双色球"),),
                    label="爱好",
                    initial=[1, 3],
                    widget=forms.widgets.SelectMultiple()
                )
    
                keep = forms.ChoiceField(
                    label="是否记住密码",
                    initial="checked",
                    widget=forms.widgets.CheckboxInput()
                )

看网页效果可以发现并且也验证了form的功能

前端页面是form类的对象生成的 --> 生成HTML标签功能

当用户名和密码输入为空或输错之后，页面后会进行提示 --> 用户提交校验功能

当用户输错之后 再次输入 上次的内容还会保留在input框中 --> 保留上次输入的内容

## Django Form所有内置的字段 ##

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][]

Field
        required=True,               是否允许为空
        widget=None,                 HTML插件
        label=None,                  用于生成Label标签或显示内容
        initial=None,                初始值
        help_text='',                帮助信息(在标签旁边显示)
        error_messages=None,         错误信息 {
         'required': '不能为空', 'invalid': '格式错误'}
        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类型

###  ###

转载于:https://www.cnblogs.com/tulintao/p/11562378.html

[ContractedBlock.gif]: https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif
[ExpandedBlockStart.gif]: /images/20230810/ef5975e31c094d30bfb09a04b4f69a42.png