django中form组件的详细用法

it2026-02-19 5

核心：不同的类字段+内置插件类对应的验证规则不一样，一定不要选错字段类和内置插件类

1. Form组件的主要功能

HTML form提交数据后自动保留上次提交的数据对用户提交的数据进行验证并生成错误信息生成HTML标签初始化页面显示内容实时数据更新

2. Form的处理流程

在应用下面创建forms.py用来存放form组件的类创建form类，类里面创建前端需要传入的字段在views视图函数中进行对数据验证处理，成功进行跳转到新页面和失败返回到原来的页面。模板HTML渲染页面

3. 创建表单类

from django import forms from django.forms import fields from django.forms import widgets # 创建MyForms类 class MyForms(forms.Form): user = fields.CharField( # 用户名 label="用户名：", max_length=16, min_length=6, required=True, error_messages={ "max_length": "用户名长度必须小于16位", "min_length": "用户名长度必须大于6位", "required": "用户名不能为空", }, widget=widgets.TextInput() ) pwd = fields.CharField( # 密码 label="密码：", max_length=20, min_length=6, required=True, error_messages={ "max_length": "密码长度必须小于20位", "min_length": "密码长度必须大于6位", "required": "密码不能为空", }, # widgets 是一个插件 widget=widgets.PasswordInput() # 将Input框的类型设置成password类型 ) gender = fields.ChoiceField( # 性别 label="性别：", choices=((1, '男'), (2, '女'),), initial=2, widget=widgets.RadioSelect # 加上此选项就可以将下拉框变成单选框 ) email = fields.EmailField( # 邮箱 label="邮箱", required=True, error_messages={ "Invalid": "邮箱格式有误", "required": "邮箱不能为空", }, widget=widgets.EmailInput() )

4. 视图函数中的代码

from django.shortcuts import render, HttpResponse from test1.forms import LoginForms # 注册页面 def register(request): if request.method == "GET": obj = LoginForms() return render(request, "test1/register.html", context={"obj": obj}) if request.method == "POST": obj = LoginForms(request.POST) # 提交数据都放在request.POST里面的 # for k, v in obj.errors.items(): # obj.errors返回的是字典 # print(k, v, type(v), v[0]) print(obj) if obj.is_valid(): # 通过is_valid方法，检验所有的POST请求提交的数据，如果有一个没通过校验，都无法将数据添加到cleaned_data中。 print(obj) # cleaned_data 是经过校验的数据,它的数据类型是一个字典 print(obj.cleaned_data, type(obj.cleaned_data)) return HttpResponse("验证成功") else: # 取出验证失败的信息,方便定位问题,给用用户提示 ErrorDict = obj.errors return HttpResponse(ErrorDict.values()) return render(request, "test1/register.html", context={"obj": obj})

5. html模板中的代码如下：

<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>注册</title> </head> <body> {#novalidate 关闭django form表单自带的一些校验机制， autocomplete='on' 可以让输入框输入的数据保留下来，在刷新页面的时候不被清空#} <form action="{% url "test1:register" %}" method="post" novalidate autocomplete="on"> {% csrf_token %} {# {{ obj.as_p }} #} {# {{ obj.user.label }}: {# 单独生成label标签 #} {# {{ obj.user }} {# 单独生成input标签 #} <p> {{ obj.user.label_tag }} {#生成 lable 标签#} {{ obj.user }}<br> {#生成user的input标签#} {# obj.errors 是一个字典，通过.user拿到user这个键值对#} {# 再通过.error拿到一个django form 表单自动生成的<u>l标签下的<li>标签的错误信息，最后通过.0索引取到错误信息 #} <span style="color: red; font-size: 10px;">{{ obj.errors.user.0 }}</span> </p> <p> {{ obj.pwd.label_tag }} {{ obj.pwd }}<br> <span style="color: red; font-size: 10px;">{{ obj.errors.pwd.0 }}</span> </p> <p> {{ obj.gender.label_tag }} {{ obj.gender }}<br> <span style="color: red; font-size: 10px;">{{ obj.errors.gender.0 }}</span> </p> <p> {{ obj.email.label_tag }} {{ obj.email }}<br> <span style="color: red; font-size: 10px;">{{ obj.errors.email.0 }}</span> </p> <p> <input type="submit" value="注册"> </p> </form> </body> </html>

6. form常用的内置插件

内置插件都是搭配着widgets自定义HTML插件使用的因此需要导入模块widgets

1. TextInput(Input) # 文本输入框 2. NumberInput(TextInput) # 数字文本输入框 3. EmailInput(TextInput) # 邮箱输入框 4. URLInput(TextInput) # url输入框 5. PasswordInput(TextInput) # 密码输入框 6. HiddenInput(TextInput) # 隐藏输入框 7. Textarea(Widget) # 多行文本输入框 8. DateInput(DateTimeBaseInput) # 日期输入框 9. DateTimeInput(DateTimeBaseInput) # 日期时间输入框 10. TimeInput(DateTimeBaseInput) # 时间输入框 11. CheckboxInput # 多选框 12. Select # 下拉框 13. NullBooleanSelect # 含空值的布尔下拉框 14. SelectMultiple # 多选下拉框 15. RadioSelect # 单选 16. CheckboxSelectMultiple # 多选 17. FileInput # 文件选择框

7. obj.errors 类型和内容

8. 总结：

1、自动成成<p>标签和<input>的方法： {{ form_obj.as_p}} # 自动生成<p>标签并且里边如果有属性会生成<input>标签 2、注册标签不会自动生成，需要单独生成 <p> <input type="submit" value="注册"> </p> 3、单独生成label和input标签 {{ obj.user.label }}: {# 单独生成label标签 #} {{ obj.user }} {# 单独生成input标签 #} 4、给实例化的对象获取所有的POST请求的数据，这样就可以通过对象.属性拿值了 if request.method == "POST": obj = MyForms(request.POST) 5、 if obj.is_valid(): # 通过is_valid方法，检验所有的POST请求提交的数据，如果有一个没通过校验，都无法将数据添加到cleaned_data中。 # cleaned_data 是经过校验的数据,它的数据类型是一个字典 print(obj.cleaned_data, type(obj.cleaned_data))

9. 常用字段与插件

（1）initial：设置初始值，默认值

# 创建MyForms类 class LoginForms(forms.Form): username = forms.CharField( initial="张三", # 设置默认值 label="用户名", # label标签 min_length=8, # 用户名最小长度为8 required=True, # 用户名必须输入 error_messages={ "min_length": "用户名长度必须大于8位", "required": "用户名不能为空", } )

（2）radioSelect

# 创建MyForms类 class LoginForms(forms.Form): # gender = forms.fields.ChoiceField 先设置成ChoiceField gender = forms.fields.ChoiceField( label="性别", initial=3, choices=((1, "男"), (2, "女"), (3, "保密")), # 通过插件widgests设置成单选框 widget=forms.widgets.RadioSelect() )

（3）单选Select

# 创建MyForms类 class LoginForms(forms.Form): hobby = forms.fields.ChoiceField( label="爱好", initial=3, choices=((1, "乒乓球"), (2, "羽毛球"), (3, "篮球")), # 通过widgest 插件设置成单选下拉框 widget=forms.widgets.Select(), )

（4）多选Select

# 创建MyForms类 class LoginForms(forms.Form): hobby2 = forms.fields.MultipleChoiceField( label="爱好2", initial=[1, 3], choices=((1, "CF"), (2, "LOL"), (3, "DNF")), widget=forms.widgets.SelectMultiple(), )

（5）单选checkbox

# 创建MyForms类 class LoginForms(forms.Form): remember = forms.fields.NullBooleanField( label="记住用户名", initial="checked", widget=forms.widgets.CheckboxInput(), )

（6）多选checkbox

# 创建MyForms类 class LoginForms(forms.Form): hero = forms.fields.MultipleChoiceField( label="三国英雄", initial=[1, 2], choices=((1, "刘备"), (2, "曹操"), (3, "孙权")), widget=forms.widgets.CheckboxSelectMultiple() )

10. 自定义初始化方法

在使用选择标签的时候，也就是在指定有关于choices的那些选择框，里边的数据是可以从数据库中获取的，也就不需要手动去代码中添加，而是通过 models.Classes.objects.all().values_list('id','caption')就能够动态的将数据库中的相关信息添加到选项框中，但是他只能获取静态的值，当数据库中有新的数据更新进去的时候，就无法获取（相对的，如果重启一次服务也能获取到），这时就需要自定义一个初始化方法。

# 创建MyForms类 class LoginForms(forms.Form): city = forms.fields.ChoiceField( label="城市", initial=2, choices=City.objects.all().values_list("id", "name"), ) def __init__(self, *args, **kwargs): # 调用父类的初始化方法 super(LoginForms, self).__init__(*args, **kwargs) self.fields['city'].choices = City.objects.all().values_list('id', 'name') # 动态从数据库中获取值

11. Django Form所有内置字段

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类型 Django Form内置字段

12. 校验，正则校验RegexValidator

from django.core.validators import RegexValidator # 创建MyForms类 class LoginForms(forms.Form): user = forms.fields.CharField( label="用户", validators=[ RegexValidator(r"^[0-9]+$", "请输入数字"), RegexValidator(r"^153[0-9]*$", "数字必须以153开头") ], )

13. ValidationError

from django.core.exceptions import ValidationError def clean_phone(self): value = self.cleaned_data.get('phone') if re.match(r'^1[3-9]\d{9}$',value): return value raise ValidationError('手机号不正经')

14. 局部钩子函数校验

def clean_re_pwd(self): # 通过对象.cleaned_data.get（字段）获取字段信息，且注意顺序，确认密码必须写在密码之后，不然会造成，校验还没完成就去获取值，是获取不到的 pwd = self.cleaned_data.get('pwd') re_pwd = self.cleaned_data.get('re_pwd') if pwd == re_pwd: return re_pwd raise ValidationError('两次密码不一致')

15. 全局钩子函数校验

def clean(self): pwd = self.cleaned_data.get('pwd') re_pwd = self.cleaned_data.get('re_pwd') if pwd == re_pwd: return self.cleaned_data self.add_error('re_pwd','两次密码不一致') raise ValidationError('两次密码不一致') # 定义全局钩子函数的时候，函数名必须是clean # 全局钩子的特点是，先对所有的字段进行一次校验，然后再从校验的结果中，进行二次校验，返回一个cleaned_data # 给校验的字段添加提示的错误信息，方法是对象.add_error('字段名称','错误信息内容'）

最新回复(0)