Django--Form组件

一 . Form介绍

复制代码
我们之前一下用form表单向后台提交数据, 里面写的是input标签. 我们在好多场景下需要对用户输入的内容进行校验,比如说注册信息.
Django form组件就实现了上述的功能
form组件主要功能:
    生成页面可用HTML标签
    对用户提交的数据进行校验
    保留上次输入的内容
复制代码

  使用form组件实现注册功能

复制代码
# views.py文件
from django import forms

# 按照Django form组件的要求自己写一个类
class RegForm(forms.Form):
    username = forms.CharField(label="用户名")  # 括号里面写一些校验规则,下面会介绍
    password = forms.CharField(label="密码")
# 类属性名字是什么,前端标签里面的name值就是什么, 现在的类属性就好比input标签里面的name=username,name=password 
复制代码

  在写一个视图函数

复制代码
def register(request):
    form_obj = RegForm()
    # print(request.POST)
    if request.method == "POST":
        # 实例化form对象的时候, 把post提交过来的数据直接传进去
        form_obj = RegForm(data=request.POST)  # 就好比request.POST.get('username')  request.POST.get('password')
        # print(form_obj.is_valid())  # 如果用户输入的有一个错误就是False,全对才是True
        if form_obj.is_valid():
            print(form_obj.cleaned_data)  # 打印用户输入对的数据  这个清洗后的数据必须写在is_valid后面
        # else:
            # print(form_obj.errors.as_data())  # 拿错误信息
        return render(request, 'register.html', {'form_obj':form_obj})
    else:
        return render(request, 'register.html', {'form_obj': form_obj})
复制代码

  register.html

复制代码
{% load static %}
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
    <!--bootstrap-->
    <link href="{% static 'bootstrap/css/bootstrap.min.css' %}" rel="stylesheet">

</head>
<body>
<form action="{% url 'register' %}" method="post" novalidate>
    {% csrf_token %}
{#                <p>{{ form_obj.as_p }}</p>#}   <!--拿所有的标签-->
        <p>
            {{ form_obj.username.label }}
            {{ form_obj.username }}
            <span style="color: red">
                {{ form_obj.username.errors.0 }}  <!--拿错误信息,errors拿到的是列表.所以用索引-->
            </span>

        </p>
        <p>
            {{ form_obj.password.label }}
            {{ form_obj.password }}
            <span style="color: red">
                {{ form_obj.password.errors.0 }}
            </span>

        </p>
        <p>
            {{ form_obj.re_password.label }}
            {{ form_obj.re_password }}
            {{ form_obj.re_password.errors.0 }}
        </p>
        <p>
            {{ form_obj.userinfo.label }}  <!--由于是标签所以想要显示作者名字不能直接.name 要在models里面写def__str__(self)-->
            {{ form_obj.userinfo }}
            {{ form_obj.userinfo.errors.0 }}
        </p>
    <button class="btn btn-primary btn-lg btn-block">注 册</button>
</form>
</body>
</html>
复制代码

二 . form表单的常用字段插件

  initial

复制代码
class LoginForm(forms.Form):
    username = forms.CharField(  
        min_length=8,
        label="用户名",
        initial="张三"  # 设置默认值
    )
    pwd = forms.CharField(min_length=6, label="密码")
复制代码

  error_messages(重写错误信息)

复制代码
class LoginForm(forms.Form):
    username = forms.CharField(
        min_length=8,
        label="用户名",
        initial="张三",
        error_messages={
            "required": "不能为空",
            "invalid": "格式错误",
            "min_length": "用户名最短8位"
        }
    )
复制代码

  password

复制代码
class LoginForm(forms.Form):
    ...
    pwd = forms.CharField(
        min_length=6,
        label="密码",
        widget=forms.PasswordInput(attrs={'class': 'c1'}, render_value=True)
    )   # 让密码变成密文
# attrs里面可以设置bootstrap样式   
复制代码

  RadioSelect

复制代码
class LoginForm(forms.Form):
    username = forms.CharField(  #其他选择框或者输入框,基本都是在这个CharField的基础上通过插件来搞的
        min_length=8,
        label="用户名",
        initial="张三",
        error_messages={
            "required": "不能为空",
            "invalid": "格式错误",
            "min_length": "用户名最短8位"
        }
    )
    pwd = forms.CharField(min_length=6, label="密码")
    gender = forms.fields.ChoiceField(
        choices=((1, "男"), (2, "女"), (3, "保密")),
        label="性别",
        initial=3,
        widget=forms.RadioSelect()  # 后面括号写不行都行
    )
复制代码

  单选Select

复制代码
class LoginForm(forms.Form):
    ...
    hobby = forms.fields.ChoiceField(
        choices=((1, "篮球"), (2, "足球"), (3, "双色球"), ),
        label="爱好",
        initial=3,
        widget=forms.Select
    )
复制代码

  单选checkbox

复制代码
class LoginForm(forms.Form):
    ...
    keep = forms.fields.ChoiceField(
        label="是否记住密码",
        initial="checked",
        widget=forms.CheckboxInput
    )
复制代码

  多选checkbox

复制代码
class LoginForm(forms.Form):
    ...
    hobby = forms.fields.MultipleChoiceField(
        choices=((1, "篮球"), (2, "足球"), (3, "双色球"),),
        label="爱好",
        initial=[1, 3],
        widget=forms.widgets.CheckboxSelectMultiple
    )
复制代码

  choice字段注意事项

    在选择标签时, 需要注意choice的选项可以从数据库中拿, 但是由于是静态字段, 获取的值无法实时更新, 需要重写构造方法从而实现choice实时更新

  方式一

复制代码
from django.forms import Form
from django.forms import widgets
from django.forms import fields

class MyForm(Form):
 
    user = fields.ChoiceField(
        # choices=((1, '上海'), (2, '北京'),),
        initial=2,
        widget=widgets.Select
    )
 
    def __init__(self, *args, **kwargs):
        super(MyForm,self).__init__(*args, **kwargs)
        # self.fields['user'].choices = ((1, '上海'), (2, '北京'),)
        # 或
        self.fields['user'].choices = models.Classes.objects.all().values_list('id','caption')
复制代码

  方式二

复制代码
from django import forms
from django.forms import fields
from django.forms import models as form_model

class FInfo(forms.Form):
    authors = form_model.ModelMultipleChoiceField(queryset=models.NNewType.objects.all())  # 多选
    # authors = form_model.ModelChoiceField(queryset=models.NNewType.objects.all())  # 单选
复制代码

三 . Form所有内置字段

 内置字段

四 . 字段校验

  RegexValidator验证器

复制代码
from django.forms import Form
from django.forms import widgets
from django.forms import fields
from django.core.validators import RegexValidator
 
class MyForm(Form):
    user = fields.CharField(
        validators=[RegexValidator(r'^[0-9]+$', '请输入数字'), RegexValidator(r'^159[0-9]+$', '数字必须以159开头')],
    )
复制代码

  自定义验证函数

复制代码
import re
from django.forms import Form
from django.forms import widgets
from django.forms import fields
from django.core.exceptions import ValidationError
 
 
# 自定义验证规则
def mobile_validate(value):    # value是形参,接收前端输入的内容
    mobile_re = re.compile(r'^(13[0-9]|15[012356789]|17[678]|18[0-9]|14[57])[0-9]{8}$')
    if not mobile_re.match(value):   # 返回True or False
        raise ValidationError('手机号码格式错误')  #自定义验证规则的时候,如果不符合你的规则,需要自己发起错误

# 使用自定义验证规则
    phone = fields.CharField(validators=[mobile_validate, ],
                            error_messages={'required': '手机不能为空'},
                            widget=widgets.TextInput(attrs={'class': "form-control",
                                                          'placeholder': u'手机号码'}))
复制代码

五 . Hook钩子方法

  进行进一步验证可以用钩子方法

  局部钩子

    我们在Form类中定义clean_字段名()方法,就能实现对特定的钩子进行校验.

复制代码
class LoginForm(forms.Form):
    username = forms.CharField(
        min_length=8,
        label="用户名",
        initial="张三",
        error_messages={
            "required": "不能为空",
            "invalid": "格式错误",
            "min_length": "用户名最短8位"
        },
        widget=forms.widgets.TextInput(attrs={"class": "form-control"})
    )
    ...
    # 定义局部钩子,用来校验username字段,之前的校验股则还在,给你提供了一个添加一些校验功能的钩子
    def clean_username(self):
        value = self.cleaned_data.get("username")
        if "666" in value:
            raise ValidationError("光喊666是不行的")
        else:
            return value    # 一定要return
复制代码

  全局钩子

    我们在form类中定义clean()方法, 对全局进行校验, 字段校验玩,局部校验完, 最后执行全局校验.

复制代码
class LoginForm(forms.Form):
    ...
    password = forms.CharField(
        min_length=6,
        label="密码",
        widget=forms.widgets.PasswordInput(attrs={'class': 'form-control'}, render_value=True)
    )
    re_password = forms.CharField(
        min_length=6,
        label="确认密码",
        widget=forms.widgets.PasswordInput(attrs={'class': 'form-control'}, render_value=True)
    )
    ...
    # 定义全局的钩子,用来校验密码和确认密码字段是否相同,执行全局钩子的时候,cleaned_data里面肯定是有了通过前面验证的所有数据
    def clean(self):
        password_value = self.cleaned_data.get('password')
        re_password_value = self.cleaned_data.get('re_password')
        if password_value == re_password_value:
            return self.cleaned_data #全局钩子要返回所有的数据
        else:
            self.add_error('re_password', '两次密码不一致')     # 给哪个字段添加报错信息,直接add_error('字段名', '报错信息')
            raise ValidationError('两次密码不一致')  # 这个必须写             
  # 并且clean_data里面会自动清除这个re_password的值,所以打印clean_data的时候会看不到它
复制代码

 六 . ModelForm

  如果需要验证的字段和models.py文件中的字段是紧密映射的表单,我们如果用form去一个一个得写,会显的冗余,这样我么就可以用ModelForm去写

  ModelForm定义(form与model的终级结合)

复制代码
from django import forms
from crm import models

class RegForm(forms.ModelForm):
    # 如果Mate里面不能不能满足你需要的验证,要在外面写(如下),报错信息也要写在这里才能生效
    password = forms.CharField(
            widget=forms.PasswordInput,
            label='密码',
            min_length=6,
            max_length=16,
            error_messages={'min_length': '不能小于6位'}
          ) class Meta: model = models.UserProfile # 对应models中的类 fields = '__all__' # 拿到所有的字段 # print(fields) exclude = ['is_active'] # 除了哪个字段 labels = { 'username': '用户名' # 前边的那个label改成'用户名',还有一种方法,就是在models里面写上verbose_name='用户名'. } # 下面的报错信息不会生效,因为在Mata中写的只对默认生成的字段有效 error_messages = { 'required': '不能为空', } # 批量添加样式,让所有的输入框都有class = form-control的属性 def __init__(self, *args, **kwargs): super().__init__(*args, **kwargs) for field in self.fields.values(): field.widget.attrs.update({'class': 'form-control'})
复制代码

   class Mate下的常用参数

复制代码
model = models.类名
fields = '__all__'   # 拿到所有的字段
exclude = ['name','age']  #除了这两个字段剩下的全要
labels = {'username': '用户名'}  # 把label的名字改成'用户名'
help_texts = '只能输入数字,字母,下划线'   # 提示输入数字,字母,下划线
widgets = None   # 自定义插件
error_messages = None  # 自定义错误信息
复制代码

  save()方法

复制代码
def register(request):
    if request.method == 'GET':
        form_obj = RegForm()
        return render(request, 'register.html', {'form_obj': form_obj})
    else:
        form_obj = RegForm(request.POST)
        # 对数据库进行校验
        if form_obj.is_valid():
            form_obj.save()  # 把你提供的数据按照相应的位置插进去,有就插,没有就不插
            return HttpResponse('ok')
            # return redirect('login')
        return render(request, 'register.html', {'form_obj': form_obj})
复制代码
posted @ 2019-04-08 21:15  截击机1  阅读(136)  评论(0编辑  收藏  举报