froms组件

'''
*

• 检验性组件：forms组件(组件有很多 类似于功能模块)

  前戏

  '''
  写一个注册功能
  	获取用户名和密码 利用form表单提交数据
  	在后端判断用户名和密码是否符合一定的条件
  		用户名中不能含有金品梅
  		密码不能少于三位
  	如果不符合条件 需要你将提示信息展示到前端页面 
  '''
  <form action="" method="post">
      <p>
          username:<input type="text" name="username">
          <span style="color: red">{{ back_dic.username }}</span>
      </p>
      <p>
          password<input type="password" name="password">
          <span style="color: red">{{ back_dic.password }}</span>
      </p>
      <input type="submit" class="btn btn-primary">
  </form>
  
  def ab_form(request):
      back_dic = {'username':'','password':''}
      if request.method == 'POST':
          username = request.POST.get('username')
          password = request.POST.get('password')
          if '金品梅' in username:
              back_dic['username'] = '不符合社会主义核心价值观'
          if len(password) < 3:
              back_dic['password'] = '不能太短!'
      return render(request,'ab_form.html',locals())
  '''
  无论是post请求还是get请求
  页面都能够获取到字典 只不过get请求来的时候 字典值都是空的
  而post请求来之后 字典可能有值
  '''
  
  
  
  '''
  1 手动书写前端获取用户数据的html代码			渲染html代码
  2 后端对用户数据进行校验					  校验数据
  3 对不符合要求得数据进行前端提示			    展示提示信息
  
  forms件
  	能够完成得事情
  		1 渲染html代码
  		2 检验数据
  		3 展示提示信息
  		
  为什么数据校验非要去后端 不能再前端利用js直接完成呢？
  	数据校验前端可有可无
  	但是后端必须要有！！！
  	
  	因为前端得校验是弱不禁风得 你可以直接修改
  	或者利用爬虫程序绕过后端提交数据
  	
  eg:
  	购物网站
  		选取了货物之后 会计算一个价格发送给后端 如果后端不做价格得校验
  		
  		实际是获取到用户选择得所有商品得主键值
  		然后再后端查询出所有商品得价格 再次计算一遍
  		如果跟前端一致 那么完成支付如果不一致直接拒绝
  '''
  

  基本使用

  from django import forms
  class MyForm(forms.Form):
      # username 字符串类型 最小3位 最大8位
      username = forms.CharField(min_length=3,max_length=8)
      # password 字符串类型 最小3位 最大8位
      password = forms.CharField(min_length=3,max_length=8)
      # email 字段必须符合邮箱格式
      email = forms.EmailField()
  

  校验数据

  '''
  1 测试环境得准备 可以自己拷贝代码准备
  2 其实在pycharm里面已经帮你准备了一个测试环境
  	pycharm console
  '''
  
  from app01 import views
  # 1 将带校验得数据组织成字典得形式传入即可
  form_obj = views.MyForm({'username':'ycc','password':'123','email':'123'})
  # 2 判断数据是否合法 注意该方法只有在所有得数据全部合法得情况下才会返回True
  form_obj.is_valid()
  False
  # 3 查看所有检验通过得数据
  form_obj.cleaned_data
  {'username': 'ycc', 'password': '123'}
  # 4 查看所有不符合检验规则以及不符合得原因
  form_obj.errors
  {'email': ['Enter a valid email address.']}
  # 5 校验数据只校验类中出现得字段 多传不影响 多传得字段直接忽略
  form_obj = views.MyForm({'username':'ycc','password':'123','email':'123@qq.com','hobby':'play'})
  form_obj.is_valid()
  True
  form_obj.cleaned_data
  {'username': 'ycc', 'password': '123', 'email': '123@qq.com'}
  form_obj.errors
  {}
  # 6 校验数据 默认情况下 类里面所有得字段都必须被传值
  form_obj = views.MyForm({'username':'ycc','password':'123',})
  form_obj.is_valid()
  False
  form_obj.cleaned_data
  {'username': 'ycc', 'password': '123'}
  form_obj.errors
  {'email': ['This field is required.']}
  '''
  也就意味着检验数据得时候 默认情况下数据可以多传但是绝不可能少传
  '''
  

  渲染标签

  '''
  forms组件只会自动帮你渲染获取用户输入得标签(input select radio checkbox)
  不能帮你渲染提交按钮
  '''
  
  def index(request):
      # 1 先产生一个空对象
      form_obj = MyForm()
      # 2 直接将该空对象传递给html页面
      return render(request,'index.html',locals())
  
  # 前端利用空对象做操作
  <form action="" method="post">
  <p>第一种渲染方式:代码书写极少 封装程度太高 不便于后续得扩展 一般情况下只在本地测试使用</p>
      {{ form_obj.as_p }}
      {{ form_obj.as_ul }}
      {{ form_obj.as_table }}
  <p>第二种渲染方式:扩展性很强，但是需要书写得代码太多 一般情况下步使用</p>
      {{ form_obj.username.label }}:{{ form_obj.username }}
      {{ form_obj.password.label }}:{{ form_obj.password }}
      {{ form_obj.email.label }}:{{ form_obj.email }}
  <p>第三种渲染方式:代码书写简单 并且扩展性也高</p>
      {% for form in form_obj %}
          <p>{{ form.label }}:{{ form }}</p>
      {% endfor %}
  </form>
  
  '''
  label属性默认展示得是类中定义得字段首字母大写得形式
  也可以自己修改 直接给字段对象加label属性即可
  	 username = forms.CharField(min_length=3,max_length=8,label='用户名')
  '''
  

  展示提示信息

  '''
  浏览器会自动帮你检验数据 但是前端的校验弱不禁风
  如何让浏览器不做检验
  '''
  
  def index(request):
      # 1 先产生一个空对象
      form_obj = MyForm()
      if request.method == 'POST':
          # 获取用户数据并校验
          '''
          1 数据获取繁琐
          2 校验数据需要构成字段的格式传入才行
          ps:但是request.POST可以看成就是一个字典
          '''
          # 3 检验数据
          form_obj = MyForm(request.POST)
          # 4 判断数据是否合法
          if form_obj.is_valid():
              # 5 如果合法 操作数据库存储数据
              return HttpResponse('ok')
          # 6 不合法 有错误
      # 2 直接将该空对象传递给html页面
      return render(request,'index.html',locals())
  
  {% for form in form_obj %}
          <p>
              {{ form.label }}:{{ form }}
              <span style="color: red">{{ form.errors.0 }}</span>
          </p>
      {% endfor %}
      <input type="submit" class="btn btn-info">
      
  '''
  1 必备条件 get请求和post传给html页面对象变量名必须一样
  	# 1 先产生一个空对象
      form_obj = MyForm()
      # 3 检验数据
      form_obj = MyForm(request.POST)
  2 forms组件当你的数据不合法的情况下 会保存你上次的数据 让你基于之前的结果进行修改 更加的人性化
  '''
  # 针对错误的提示信息还可以自定制
  class MyForm(forms.Form):
      # username 字符串类型 最小3位 最大8位
      username = forms.CharField(min_length=3,max_length=8,label='用户名',
                                 error_messages={
                                     'min_length':'用户名最少3位',
                                     'max_length':'用户名最多8位',
                                     'required':'用户名不能为空',
                                 }
                                 )
      # password 字符串类型 最小3位 最大8位
      password = forms.CharField(min_length=3,max_length=8,
                                 error_messages={
                                     'min_length': '密码最少3位',
                                     'max_length': '密码名最多8位',
                                     'required': '密码不能为空',
                                 }
                                 )
      # email 字段必须符合邮箱格式
      email = forms.EmailField(error_messages={
                                     'invalid':'邮箱格式不正确',
                                     'required':'邮箱不能为空',
                                 })
  
  

• forms组件其他参数级补充知识点(必会)

  label 字段名
  error_messages 自定义报错信息
  initial 默认值
  required =False/True 控制字段是否必填
  
  '''
  1 字段没有样式
  2 针对不同类型的input如何修改
  	text
  	password
  	date
  	radio
  	checkbox
  	...	
  '''
  widget=forms.widgets.TextInput(attrs={'class':'form-control c1 c2',})
  # 多个属性值的话 直接空格隔开即可
  
  
  # 第一道关卡里还支持正则校验
      from django.core.validators import RegexValidator
      phone = forms.CharField(
              validators=[
                  RegexValidator(r'^[0-9]+$', '请输入数字'),
                  RegexValidator(r'^159[0-9]+$', '数字必须以159开头')
              ],
      )
  

  其他类型渲染

  # radioSelect
      gender = forms.fields.ChoiceField(
          choices=((1, "男"), (2, "女"), (3, "保密")),
          label="性别",
          initial=3,
          widget=forms.widgets.RadioSelect()
      )
  
      # 单选Select
      hobby = forms.ChoiceField(
          choices=((1, "篮球"), (2, "足球"), (3, "双色球"),),
          label="爱好",
          initial=3,
          widget=forms.widgets.Select()
      )
  
      # 多选Select
      hobby1 = forms.MultipleChoiceField(
          choices=((1, "篮球"), (2, "足球"), (3, "双色球"),),
          label="爱好",
          initial=[1, 3],
          widget=forms.widgets.SelectMultiple()
      )
  
      # 单选checkbox
      keep = forms.ChoiceField(
          label="是否记住密码",
          initial="checked",
          widget=forms.widgets.CheckboxInput()
      )
  
      # 多选checkbox
      hobby2 = forms.MultipleChoiceField(
          choices=((1, "篮球"), (2, "足球"), (3, "双色球"),),
          label="爱好",
          initial=[1, 3],
          widget=forms.widgets.CheckboxSelectMultiple()
      )
  

• forms组件源码

  '''
  切入点：
  	form_obj.is_valid()
  '''
  def is_valid(self):
      	"""
          Returns True if the form has no errors. Otherwise, False. If errors are
          being ignored, returns False.
          """
      return self.is_bound and not self.errors
  # 如果is_valid要返回True的话 那么self.is_bound要为True self.errors要为False
  
  self.is_bound = data is not None or files is not None  # 只要传值了肯定为True
  
  @property
  def errors(self):
      "Returns an ErrorDict for the data provided for the form"
      if self._errors is None:
          self.full_clean()
      return self._errors  # 在crtl 点击errors 可看到self._errors = None  默认是None
  
  # forms组件所有的功能基本都出自于该方法
  def full_clear(self):
      self._clean_fields()  # 检验字段+局部钩子
      self._clean_form()  # 全局钩子
      self._post_clean()  #