经验首页 前端设计 程序设计 Java相关 移动开发 数据库/运维 软件/图像 大数据/云计算 其他经验
当前位置：技术经验 » 程序设计 » Django » 查看文章
Django中的forms组件实例详解
来源：jb51　　时间：2018/11/9 17:18:30　　对本文有异议

Form介绍

我们之前在HTML页面中利用form表单向后端提交数据时，都会写一些获取用户输入的标签并且用form标签把它们包起来。

与此同时我们在好多场景下都需要对用户的输入做校验，比如校验用户是否输入，输入的长度和格式等正不正确。如果用户输入的内容有错误就需要在页面上相应的位置显示对应的错误信息.。

Django form组件就实现了上面所述的功能。

总结一下，其实form组件的主要功能如下:

  • 生成页面可用的HTML标签
  • 对用户提交的数据进行校验
  • 保留上次输入内容

先在应用目录下my_forms.py定义好一个UserForm类

  1. from django import forms
  2.  from django.forms import widgets 
  3.    class UserForm(forms.Form):
  4.      username = forms.CharField(min_length=4, label='用户名',
  5.                    widget=widgets.TextInput(attrs={"class": "form-control"}),
  6.                    error_messages={
  7.                      "required": "用户名不能为空",
  8.                    })
  9.      pwd = forms.CharField(min_length=4, label='密码',
  10.                 error_messages={
  11.                   "required": "密码不能为空",
  12.                 },
  13.                 widget=widgets.PasswordInput(attrs={"class": "form-control"}))
  14.      r_pwd = forms.CharField(min_length=4, label='确认密码',
  15.                  widget=widgets.PasswordInput(attrs={"class": "form-control"}),
  16.                  error_messages={
  17.                    "required": "密码不能为空",
  18.                  })
  19.      email = forms.EmailField(label='邮箱',
  20.                  widget=widgets.EmailInput(attrs={"class": "form-control"}),
  21.                  error_messages={
  22.                    "required": '邮箱不能为空',
  23.                    "invalid": "邮箱格式错误",
  24.                  })
  25.      tel = forms.CharField(label='手机号',
  26.                 widget=widgets.TextInput(attrs={"class": "form-control"}),
  27.                 )

再写一个视图函数：

  在写一个视图函数

  1.    def reg(request):
  2.      form = UserForm()
  3.      if request.method == "POST":
  4.        print(request.POST)
  5.        # 实例化form对象的时候，把post提交过来的数据直接传进去
  6.        form = UserForm(request.POST) # form表单的name属性值应该与forms组件的字段名称一致
  7.        if form.is_valid():
  8.          print(form.cleaned_data)
  9.          return HttpResponse('注册成功')
  10.      return render(request, 'reg.html', locals())

login.html

  1.   <!DOCTYPE html>
  2.    <html lang="zh_CN">
  3.    <head>
  4.      <meta charset="UTF-8">
  5.      <meta http-equiv="x-ua-compatible" content="IE=edge">
  6.      <meta name="viewport" content="width=device-width, initial-scale=1">
  7.      <title>注册</title>
  8.    </head>
  9.    <body>
  10.    <h3>传统form表单</h3>
  11.    <form action="" method="post">
  12.      {% csrf_token %}
  13.      <p>用户名：<input type="text" name="username"></p>
  14.      <p>密码：<input type="password" name="pwd"></p>
  15.      <p>确认密码：<input type="password" name="r_pwd"></p>
  16.      <p>邮箱：<input type="email" name="email"></p>
  17.      <p>手机号：<input type="tel" name="tel"></p>
  18.      <p><input type="submit" value="提交"></p>
  19.    </form>
  20.    <h3>forms组件渲染方式1</h3>
  21.    <form action="" method="post" novalidate>
  22.      {% csrf_token %}
  23.      <p>{{ form.username.label }}：{{ form.username }} <span>{{ form.username.errors.0 }}</span></p>
  24.      <p>密码：{{ form.pwd }}
  25.        <span>{{ form.pwd.errors.0 }}</span></p>
  26.      <p>确认密码：{{ form.r_pwd }}
  27.        <span>{{ form.r_pwd.errors.0 }}</span></p>
  28.      <p>邮箱：{{ form.email }}
  29.        <span>{{ form.email.errors.0 }}</span></p>
  30.      <p>手机号：{{ form.tel }}
  31.        <span>{{ form.tel.errors.0 }}</span></p>
  32.      <p><input type="submit" value="提交"></p>
  33.    </form>
  34.    <h3>forms组件渲染标签方式2</h3>
  35.      <form action="" method="post" novalidate>
  36.        {% csrf_token %}
  37.        {% for field in form %}
  38.          <div class="form-group clearfix">
  39.            <label for="">{{ field.label }}</label>
  40.            {{ field }}
  41.            <span style="color: red" class="pull-right">{{ field.errors.0 }}</span>
  42.            {% if field.name == 'r_pwd' %}
  43.              <span style="color: red" class="pull-right">{{ errors.0 }}</span>
  44.            {% endif %}
  45.          </div>
  46.        {% endfor %}
  47.        <input type="submit" value="注册" class="btn btn-default pull-right">
  48.      </form>
  49.    <h3>forms组件渲染标签方式3  不推荐使用</h3>
  50.    <form action="" method="post">
  51.      {% csrf_token %}
  52.      {{ form.as_p }}
  53.      <input type="submit" value="注册">
  54.    </form>
  55.    </body>
  56.    </html>

看网页效果发现 也验证了form的功能：

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

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

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

Form那些事儿

常用字段与插件

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

initial

初始值，input框里面的初始值。

  1. class LoginForm(forms.Form):
  2.   username = forms.CharField(
  3.     min_length=8,
  4.     label="用户名",
  5.     initial="张三" # 设置默认值
  6.   )
  7.   pwd = forms.CharField(min_length=6, label="密码")

error_messages

重写错误信息。

  1. class LoginForm(forms.Form):
  2.   username = forms.CharField(
  3.     min_length=8,
  4.     label="用户名",
  5.     initial="张三",
  6.     error_messages={
  7.       "required": "不能为空",
  8.       "invalid": "格式错误",
  9.       "min_length": "用户名最短8位"
  10.     }
  11.   )
  12.   pwd = forms.CharField(min_length=6, label="密码")

password

  1. class LoginForm(forms.Form):
  2.   ...
  3.   pwd = forms.CharField(
  4.     min_length=6,
  5.     label="密码",
  6.     widget=forms.widgets.PasswordInput(attrs={'class': 'c1'}, render_value=True)
  7.   )

radioSelect

单radio值为字符串

  1. class LoginForm(forms.Form):
  2.   username = forms.CharField(
  3.     min_length=8,
  4.     label="用户名",
  5.     initial="张三",
  6.     error_messages={
  7.       "required": "不能为空",
  8.       "invalid": "格式错误",
  9.       "min_length": "用户名最短8位"
  10.     }
  11.   )
  12.   pwd = forms.CharField(min_length=6, label="密码")
  13.   gender = forms.fields.ChoiceField(
  14.     choices=((1, "男"), (2, "女"), (3, "保密")),
  15.     label="性别",
  16.     initial=3,
  17.     widget=forms.widgets.RadioSelect()
  18.   )

单选Select

  1. class LoginForm(forms.Form):
  2.   ...
  3.   hobby = forms.fields.ChoiceField(
  4.     choices=((1, "篮球"), (2, "足球"), (3, "双色球"), ),
  5.     label="爱好",
  6.     initial=3,
  7.     widget=forms.widgets.Select()
  8.   )

多选Select

  1. class LoginForm(forms.Form):
  2.   ...
  3.   hobby = forms.fields.MultipleChoiceField(
  4.     choices=((1, "篮球"), (2, "足球"), (3, "双色球"), ),
  5.     label="爱好",
  6.     initial=[1, 3],
  7.     widget=forms.widgets.SelectMultiple()
  8.   )

单选checkbox

  1. class LoginForm(forms.Form):
  2.   ...
  3.   keep = forms.fields.ChoiceField(
  4.     label="是否记住密码",
  5.     initial="checked",
  6.     widget=forms.widgets.CheckboxInput()
  7.   )

多选checkbox

  1. class LoginForm(forms.Form):
  2.   ...
  3.   hobby = forms.fields.MultipleChoiceField(
  4.     choices=((1, "篮球"), (2, "足球"), (3, "双色球"),),
  5.     label="爱好",
  6.     initial=[1, 3],
  7.     widget=forms.widgets.CheckboxSelectMultiple()
  8.   )

关于choice的注意事项：

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

方式一：

  1. from django.forms import Form
  2. from django.forms import widgets
  3. from django.forms import fields
  4.  
  5. class MyForm(Form):
  6.   user = fields.ChoiceField(
  7.     # choices=((1, '上海'), (2, '北京'),),
  8.     initial=2,
  9.     widget=widgets.Select
  10.   )
  11.   def __init__(self, *args, **kwargs):
  12.     super(MyForm,self).__init__(*args, **kwargs)
  13.     # self.fields['user'].choices = ((1, '上海'), (2, '北京'),)
  14.     # 或
  15.     self.fields['user'].choices = models.Classes.objects.all().values_list('id','caption')

方式二：

  1. from django import forms
  2. from django.forms import fields
  3. from django.forms import models as form_model
  4. class FInfo(forms.Form):
  5.   authors = form_model.ModelMultipleChoiceField(queryset=models.NNewType.objects.all()) # 多选
  6.   # authors = form_model.ModelChoiceField(queryset=models.NNewType.objects.all()) # 单选
  7. Django Form所有内置字段
  8. Field
  9.   required=True,        是否允许为空
  10.   widget=None,         HTML插件
  11.   label=None,         用于生成Label标签或显示内容
  12.   initial=None,        初始值
  13.   help_text='',        帮助信息(在标签旁边显示)
  14.   error_messages=None,     错误信息 {'required': '不能为空', 'invalid': '格式错误'}
  15.   validators=[],        自定义验证规则
  16.   localize=False,       是否支持本地化
  17.   disabled=False,       是否可以编辑
  18.   label_suffix=None      Label内容后缀
  19. CharField(Field)
  20.   max_length=None,       最大长度
  21.   min_length=None,       最小长度
  22.   strip=True          是否移除用户输入空白
  23. IntegerField(Field)
  24.   max_value=None,       最大值
  25.   min_value=None,       最小值
  26. FloatField(IntegerField)
  27.   ...
  28. DecimalField(IntegerField)
  29.   max_value=None,       最大值
  30.   min_value=None,       最小值
  31.   max_digits=None,       总长度
  32.   decimal_places=None,     小数位长度
  33. BaseTemporalField(Field)
  34.   input_formats=None     时间格式化  
  35. DateField(BaseTemporalField)  格式：2015-09-01
  36. TimeField(BaseTemporalField)  格式：11:12
  37. DateTimeField(BaseTemporalField)格式：2015-09-01 11:12
  38. DurationField(Field)      时间间隔：%d %H:%M:%S.%f
  39.   ...
  40. RegexField(CharField)
  41.   regex,           自定制正则表达式
  42.   max_length=None,      最大长度
  43.   min_length=None,      最小长度
  44.   error_message=None,     忽略，错误信息使用 error_messages={'invalid': '...'}
  45. EmailField(CharField)   
  46.   ...
  47. FileField(Field)
  48.   allow_empty_file=False   是否允许空文件
  49. ImageField(FileField)   
  50.   ...
  51.   注：需要PIL模块，pip3 install Pillow
  52.   以上两个字典使用时，需要注意两点：
  53.     - form表单中 enctype="multipart/form-data"
  54.     - view函数中 obj = MyForm(request.POST, request.FILES)
  55. URLField(Field)
  56.   ...
  57. BooleanField(Field) 
  58.   ...
  59. NullBooleanField(BooleanField)
  60.   ...
  61. ChoiceField(Field)
  62.   ...
  63.   choices=(),        选项，如：choices = ((0,'上海'),(1,'北京'),)
  64.   required=True,       是否必填
  65.   widget=None,        插件，默认select插件
  66.   label=None,        Label内容
  67.   initial=None,       初始值
  68.   help_text='',       帮助提示
  69. ModelChoiceField(ChoiceField)
  70.   ...            django.forms.models.ModelChoiceField
  71.   queryset,         # 查询数据库中的数据
  72.   empty_label="---------",  # 默认空显示内容
  73.   to_field_name=None,    # HTML中value的值对应的字段
  74.   limit_choices_to=None   # ModelForm中对queryset二次筛选
  75. ModelMultipleChoiceField(ModelChoiceField)
  76.   ...            django.forms.models.ModelMultipleChoiceField
  77. TypedChoiceField(ChoiceField)
  78.   coerce = lambda val: val  对选中的值进行一次转换
  79.   empty_value= ''      空值的默认值
  80. MultipleChoiceField(ChoiceField)
  81.   ...
  82. TypedMultipleChoiceField(MultipleChoiceField)
  83.   coerce = lambda val: val  对选中的每一个值进行一次转换
  84.   empty_value= ''      空值的默认值
  85. ComboField(Field)
  86.   fields=()         使用多个验证，如下：即验证最大长度20，又验证邮箱格式
  87.                 fields.ComboField(fields=[fields.CharField(max_length=20), fields.EmailField(),])
  88. MultiValueField(Field)
  89.   PS: 抽象类，子类中可以实现聚合多个字典去匹配一个值，要配合MultiWidget使用
  90. SplitDateTimeField(MultiValueField)
  91.   input_date_formats=None,  格式列表：['%Y--%m--%d', '%m%d/%Y', '%m/%d/%y']
  92.   input_time_formats=None  格式列表：['%H:%M:%S', '%H:%M:%S.%f', '%H:%M']
  93. FilePathField(ChoiceField)   文件选项，目录下文件显示在页面中
  94.   path,           文件夹路径
  95.   match=None,        正则匹配
  96.   recursive=False,      递归下面的文件夹
  97.   allow_files=True,     允许文件
  98.   allow_folders=False,    允许文件夹
  99.   required=True,
  100.   widget=None,
  101.   label=None,
  102.   initial=None,
  103.   help_text=''
  104. GenericIPAddressField
  105.   protocol='both',      both,ipv4,ipv6支持的IP格式
  106.   unpack_ipv4=False     解析ipv4地址，如果是::ffff:192.0.2.1时候，可解析为192.0.2.1， PS：protocol必须为both才能启用
  107. SlugField(CharField)      数字，字母，下划线，减号（连字符）
  108.   ...
  109. UUIDField(CharField)      uuid类型


Django Form内置字段

校验

方式一：

  1. from django.forms import Form
  2. from django.forms import widgets
  3. from django.forms import fields
  4. from django.core.validators import RegexValidator
  5. class MyForm(Form):
  6.   user = fields.CharField(
  7.     validators=[RegexValidator(r'^[0-9]+$', '请输入数字'), RegexValidator(r'^159[0-9]+$', '数字必须以159开头')],
  8.   )

方式二：

  1. import re
  2. from django.forms import Form
  3. from django.forms import widgets
  4. from django.forms import fields
  5. from django.core.exceptions import ValidationError
  6. # 自定义验证规则
  7. def mobile_validate(value):
  8.   mobile_re = re.compile(r'^(13[0-9]|15[012356789]|17[678]|18[0-9]|14[57])[0-9]{8}$')
  9.   if not mobile_re.match(value):
  10.     raise ValidationError('手机号码格式错误')
  11. class PublishForm(Form):
  12.   title = fields.CharField(max_length=20,
  13.               min_length=5,
  14.               error_messages={'required': '标题不能为空',
  15.                       'min_length': '标题最少为5个字符',
  16.                       'max_length': '标题最多为20个字符'},
  17.               widget=widgets.TextInput(attrs={'class': "form-control",
  18.                              'placeholder': '标题5-20个字符'}))
  19.   # 使用自定义验证规则
  20.   phone = fields.CharField(validators=[mobile_validate, ],
  21.               error_messages={'required': '手机不能为空'},
  22.               widget=widgets.TextInput(attrs={'class': "form-control",
  23.                              'placeholder': u'手机号码'}))
  24.   email = fields.EmailField(required=False,
  25.               error_messages={'required': u'邮箱不能为空','invalid': u'邮箱格式错误'},
  26.               widget=widgets.TextInput(attrs={'class': "form-control", 'placeholder': u'邮箱'}))

方式三：

  1.  def clean(self):
  2.      pwd = self.cleaned_data.get('pwd')
  3.      r_pwd = self.cleaned_data.get('r_pwd')
  4.      print(pwd, r_pwd)
  5.      if pwd and r_pwd:
  6.        if pwd == r_pwd:
  7.          return self.cleaned_data
  8.        raise ValidationError('两次密码不一致')
  9.      else:
  10.        return self.cleaned_data
  11.    def clean_username(self):
  12.      val = self.cleaned_data.get('username')
  13.      user = UserInfo.objects.filter(name=val)
  14.      if not user:
  15.        return val
  16.      else:
  17.        raise ValidationError("用户名已注册")
  18.    def clean_tel(self):
  19.      val = self.cleaned_data.get('tel')
  20.      if len(val) == 11:
  21.        return val
  22.      raise ValidationError('手机号格式错误')

总结：

  1. '''
  2.    局部钩子:
  3.      1、is_valid()
  4.      2、self.errors
  5.      3、self.full_clean()
  6.      4、self._clean_fields() 校验每一个字段
  7.     5、for 循环每一个字段名、验证规则对象
  8.      6、
  9.        验证通过：
  10.          value = field.clean(value)
  11.          self.cleaned_data[name] = value       添加到clean_data中
  12.          利用反射、钩子自定义验证规则
  13.          hasattr(self, 'clean_%s' % name)      写自定义方法
  14.          value = getattr(self, 'clean_%s' % name)() 执行自定义方法
  15.            pass:
  16.              self.cleaned_data[name] = value   添加到clean_data中
  17.            no_pass:
  18.              raise ValidationError(msg)     抛出异常
  19.        不通过：
  20.          raise ValidationError(msg)
  21.    全局钩子:
  22.      1、is_valid()
  23.      2、self.errors
  24.      3、self.full_clean() 
  25.      4、self._clean_form()  全部字段调用完成之后 调用
  26.      5、self.clean() 重写clean方法
  27.      6、全局钩子错误：forms.errors.get("__all__")
  28.    '''

总结

以上所述是小编给大家介绍的Django中的forms组件实例详解，希望对大家有所帮助，如果大家有任何疑问请给我留言，小编会及时回复大家的。在此也非常感谢大家对w3xue网站的支持！

 友情链接：直通硅谷 　点职佳 　北美留学生论坛

Django热门文章

  • django-rest-framework 自定义swagger过程详解
  • 前后端分离实现注册+登录（Vue3.0 + Django3.2)
  • 详解Django CAS 解决方案
  • python+Django实现防止SQL注入的办法
  • django 配置阿里云OSS存储media文件的例子
  • 【django-vue】封装logger 封装全局异常 封装response 数据库配置 用户表继承AbstractUser配置
  • django使用ckeditor上传图片
  • Django集成富文本编辑器summernote的实现步骤
  • 使用django和vue进行数据交互的方法步骤
  • python3.8+django2+celery5.2.7环境准备(python测试开发django)

    • Django推荐文章

  • 探索Django：从项目创建到图片上传的全方位指南
  • Django国际化与本地化指南
  • CentOS+Django+uWSGI+Celery+Supervisor配置
  • vue3 + element-plus 的 upload + axios + django 文件上传并保存
  • Django学习(三) 之 模板中标签的使用
  • 前后端分离实现注册+登录（Vue3.0 + Django3.2)
  • Django笔记三十二之session登录验证操作
  • Django笔记三十之log日志记录详解
  • 【django-vue】封装logger 封装全局异常 封装response 数据库配置 用户表继承AbstractUser配置
  • Luffy项目：2、项目需求（2），项目库的创建，软件开发目录，Django配置文件介绍

    • 本站QQ群：前端 618073944 | Java 606181507 | Python 626812652 | C/C++ 612253063 | 微信 634508462 | 苹果 692586424 | C#/.net 182808419 | PHP 305140648 | 运维 608723728

    W3xue 的所有内容仅供测试，对任何法律问题及风险不承担任何责任。通过使用本站内容随之而来的风险与本站无关。
    关于我们  |  意见建议  |  捐助我们  |  报错有奖  |  广告合作、友情链接（目前9元/月）请联系QQ：27243702 沸活量
    皖ICP备17017327号-2　皖公网安备34020702000426号