第七章 python Django 表单

最新推荐文章于 2024-09-25 08:42:13 发布

python-学者

最新推荐文章于 2024-09-25 08:42:13 发布

阅读量249

点赞数

分类专栏： django 文章标签： django

本文链接：https://blog.youkuaiyun.com/w469001293/article/details/103796641

版权

django 专栏收录该内容

15 篇文章

订阅专栏

本文深入探讨了Django中的表单处理，从HTML表单到Django的表单类，包括表单的使用流程、验证数据、自定义验证规则以及错误信息的提取。讲解了CharField、EmailField等Field类型，以及MaxValueValidator、MinLengthValidator等验证器。同时，介绍了如何自定义验证手机号码是否注册过，以及确保提交的两个密码相等。此外，文章还讨论了ModelForm的使用，包括如何自定义错误消息和利用save方法保存数据。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

一、HTML中的表单：

单纯从前端的 html 来说，表单是用来提交数据给服务器的,不管后台的服务器用的是 Django 还是 PHP 语言还是其他语言。只要把 input 标签放在 form 标签中，然后再添加一个提交按钮，那么以后点击提交按钮，就可以将 input 标签中对应的值提交给服务器了。
.

二、Django中的表单：

Django 中的表单丰富了传统的 HTML 语言中的表单。在 Django 中的表单，主要做以下两件事：

1.渲染表单模板。
2.表单验证数据是否合法。
.

三、Django中表单使用流程【文件】

文件地址：
E:\Python3.8.0\python_item\python_diango\chapter06\1form_demo

在讲解 Django 表单的具体每部分的细节之前。我们首先先来看下整体的使用流程。这里以一个做一个留言板为例。首先我们在后台服务器定义一个表单类，继承自 django.forms.Form 。

1.留言板

示例代码如下：

# forms.py
from django import forms


# forms.py
class MessageBoardForm(forms.Form):
    title = forms.CharField(max_length=100,min_length=2, label='标题', error_messages={"min_lengtn":"最少不能少于1个字符！"})
    # Textarea，多行文本
    content = forms.CharField(widget=forms.Textarea, label='内容',error_messages={"required":"必须要传content字段！"})
    email = forms.EmailField(label='邮箱',error_messages={"required":"必须要传email字段！"})
    reply = forms.BooleanField(required=False, label='是否回复')

视图中：
根据是 GET 还是 POST 请求来做相应的操作。
如果是 GET 请求，那么返回一个空的表单；
如果是 POST 请求，那么将提交上来的数据进行校验。

示例代码如下：

# views.py
from django.shortcuts import render
from django.views.generic import View
from .forms import MessageBoardForm
from django.http import HttpResponse
from django.forms.utils import ErrorDict

class IndexView(View):
    def get(self, request):
        form = MessageBoardForm()
        return render(request, 'index.html', {'form': form})

    def post(self, request):
        form = MessageBoardForm(request.POST)

        if form.is_valid():
            title = form.cleaned_data.get('title')
            content = form.cleaned_data.get('content')
            email = form.cleaned_data.get('email')
            reply = form.cleaned_data.get('reply')
            print('='*30)
            print(title)
            print(content)
            print(email)
            print('='*30)
            return HttpResponse('success')
        else:
            print(form.errors.get_json_data)
            return HttpResponse('fail')

HTML—GET 请求

在使用 GET 请求的时候，我们传了一个 form 给模板，那么以后模板就可以使用 form 来生成一个表单的 html 代码。在使用 POST 请求的时候，我们根据前端上传上来的数据，构建一个新的表单，这个表单是用来验证数据是否合法的，如果数据都验证通过了，那么我们可以通
过 cleaned_data 来获取相应的数据。

在模板中渲染表单的 HTML
示例代码如下：

<form action="" method="post">
	<table>
		{{ form.as_table }}
		<tr>
			<td></td>
			<td><input type="submit" value="提交"></td>
		</tr>
	</table>
</form>

我们在最外面给了一个 form 标签，然后在里面使用了 table 标签来进行美化，在使用 form 对象渲染的时候，使用的是 table 的方式，当然还可以使用 ul 的方式（ as_ul ），也可以使用 p 标签的方式（ as_p ），并且在后面我们还加上了一个提交按钮。这样就可以生成一个表单了。

四、用表单验证数据【文件】

文件地址：
E:\Python3.8.0\python_item\python_diango\chapter06\2form_validator_demo

1.常用的Field：

使用 Field 可以是对数据验证的第一步。你期望这个提交上来的数据是什么类型，那么就使用什么类型的 Field 。

（1）CharField：

用来接收文本。参数：
max_length：这个字段值的最大长度。
min_length：这个字段值的最小长度。
required：这个字段是否是必须的。默认是必须的。
error_messages：在某个条件验证失败的时候，给出错误信息。

（2）EmailField：

用来接收邮件，会自动验证邮件是否合法。
错误信息的key： required 、 invalid 。

（3）FloatField：

用来接收浮点类型，并且如果验证通过后，会将这个字段的值转换为浮点类型。
参数：

max_value：最大的值。
min_value：最小的值。

错误信息的key： required 、 invalid 、 max_value 、 min_value 。

（4）IntegerField：

用来接收整形，并且验证通过后，会将这个字段的值转换为整形。参数：

max_value：最大的值。
min_value：最小的值。

错误信息的key： required 、 invalid 、 max_value 、 min_value 。

（5）URLField：

用来接收 url 格式的字符串。
错误信息的key： required 、 invalid 。

五、常用验证器

在验证某个字段的时候，可以传递一个 validators 参数用来指定验证器，进一步对数据进行过滤。验证器有很多，但是很多验证器我们其实已经通过这个 Field 或者一些参数就可以指定了。比如 EmailValidator ，我们可以通过 EmailField 来指定，比如 MaxValueValidator ，我们可以通过 max_value 参数来指定。以下是一些常用的验证器：

1. MaxValueValidator ：验证最大值。

2. MinValueValidator ：验证最小值。

3. MinLengthValidator ：验证最小长度。

4. MaxLengthValidator ：验证最大长度。

5. EmailValidator ：验证是否是邮箱格式。

6. URLValidator ：验证是否是 URL 格式。

7. RegexValidator ：正则表达式验证

8.手机号码是否正确

比如现在要验证手机号码是否合格，那么我们可以通过以下代码实现：

class MyForm(forms.Form):
	telephone = forms.CharField(validators=[validators.RegexValidator("1[345678]\d
	{9}",message='请输入正确格式的手机号码！')])

六、自定义验证

1.手机号是否注册过

有时候对一个字段验证，不是一个长度，一个正则表达式能够写清楚的，还需要一些其他复杂的逻辑，那么我们可以对某个字段，进行自定义的验证。比如在注册的表单验证中，我们想要验证手机号码是否已经被注册过了，那么这时候就需要在数据库中进行判断才知道。对某个字段进行自定义的验证方式是，定义一个方法，这个方法的名字定义规则是： clean_fieldname 。如果验证失
败，那么就抛出一个验证错误。比如要验证用户表中手机号码之前是否在数据库中存在。

示例代码如下：

class MyForm(forms.Form):
	telephone = forms.CharField(validators=[validators.RegexValidator("1[345678]\d{9}", message='请输入正确格式的手机号码！')])

	def clean_telephone(self):
		telephone = self.cleaned_data.get('telephone')
		exists = User.objects.filter(telephone=telephone).exists()
		if exists:
			raise forms.ValidationError("手机号码已经存在！") 
		return telephone

2.提交两个密码是否相等

以上是对某个字段进行验证，如果验证数据的时候，需要针对多个字段进行验证，那么可以重写 clean 方法。比如要在注册的时候，要判断提交的两个密码是否相等。

示例代码如下：

class MyForm(forms.Form):
	telephone = forms.CharField(validators=[validators.RegexValidator("1[345678]\d{9}", message='请输入正确格式的手机号码！')])
	pwd1 = forms.CharField(max_length=12) pwd2 = forms.CharField(max_length=12)
	
	def clean(self):
	cleaned_data = super().clean() pwd1 = cleaned_data.get('pwd1') pwd2 = cleaned_data.get('pwd2') 
	if pwd1 != pwd2:
		raise forms.ValidationError('两个密码不一致！')

七、提取错误信息

如果验证失败了，那么有一些错误信息是我们需要传给前端的。这时候我们可以通过以下属性来获取：

1. form.errors ：获取一个包含 html 标签的错误信息

2. form.errors.get_json_data() ：获取一个字典类型的错误信息

将某个字段的名字作为 key ，错误信息作为值的一个字典。

3. form.as_json() ：将 form.get_json_data() 返回的字典 dump 成 json 格式的字符串，方便进行传输

上述方法获取的字段的错误值，都是一个比较复杂的数据。比如以下：

{'username': [{'message': 'Enter a valid URL.', 'code': 'invalid'}, 
{'message': 'Ensure this value has at most 4 characters (it has 22).', 
'code': 'max_length'}]}

4. 错误信息放在一个列表中，而不是字典

那么如果我只想把错误信息放在一个列表中，而不要再放在一个字典中。这时候我们可以定义一个方法，把这个数据重新整理一份。

实例代码如下：

class MyForm(forms.Form):
	username = forms.URLField(max_length=4)
	
	def get_errors(self):
		errors = self.errors.get_json_data()
		new_errors = {}
		for key,message_dicts in errors.items(): 
			messages = []
			for message in message_dicts: 
				messages.append(message['message'])
			new_errors[key] = messages 
		return new_errors

这样就可以把某个字段所有的错误信息直接放在这个列表中。

5. ModelForm

在写表单的时候，会发现表单中的 Field 和模型中的 Field 基本上是一模一样的，而且表单中需要验证的数据，也就是我们模型中需要保存的。那么这时候我们就可以将模型中的字段和表单中的字段进行绑定。
比如现在有个 Article 的模型。

示例代码如下：

from django.db import models
from django.core import validators 
class Article(models.Model):
	title = models.CharField(max_length=10,validators=[validators.MinLengthValidator(li mit_value=3)])
	content = models.TextField()
	author = models.CharField(max_length=100) category = models.CharField(max_length=100)
	create_time = models.DateTimeField(auto_now_add=True)

在写表单的时候，就不需要把 Article 模型中所有的字段都一个个重复写一遍了。

示例代码如下：

from django import forms 

class MyForm(forms.ModelForm):
	class Meta:
		model = Article 
		fields = " all "

MyForm 是继承自 forms.ModelForm ，然后在表单中定义了一个 Meta 类，在 Meta 类中指定了 model=Article ，以及 fields=" all " ，这样就可以将 Article 模型中所有的字段都复制过来，进行验证。如果只想针对其中几个字段进行验证，那么可以给 fields 指定一个列表，将需要的字段写进去。比如只想验证 title 和 content ，

示例代码如下：

from django import forms 
class MyForm(forms.ModelForm):
	class Meta:
		model = Article
		fields = ['title','content']

如果要验证的字段比较多，只是除了少数几个字段不需要验证，那么可以使用 exclude 来代替 fields 。比如我不想验证 category ，

示例代码如下：

class MyForm(forms.ModelForm):
	class Meta:
		model = Article 
		exclude = ['category']

八、自定义错误消息

使用 ModelForm ，因为字段都不是在表单中定义的，而是在模型中定义的，因此一些错误消息无法在字段中定义。那么这时候可以在 Meta 类中，定义 error_messages ，然后把相应的错误消息写到里面去。

示例代码如下：

class MyForm(forms.ModelForm): 
class Meta:
model = Article 
	exclude = ['category'] error_messages ={
		'title':{
		'max_length': '最多不能超过10个字符！', 
		'min_length': '最少不能少于3个字符！'
		},
		'content': {
		'required': '必须输入content！',
		}
	}

1. save方法

ModelForm 还有 save 方法，可以在验证完成后直接调用 save 方法，就可以将这个数据保存到数据库中了。

示例代码如下：

form = MyForm(request.POST) 
if form.is_valid():
	form.save()
	return HttpResponse('succes') 
else:
	print(form.get_errors()) 
	return HttpResponse('fail')

这个方法必须要在 clean 没有问题后才能使用，如果在 clean 之前使用，会抛出异常。另外，我们在调用 save 方法的时候，如果传入一个 commit=False ，那么只会生成这个模型的对象，而不会把这个对象真正的插入到数据库中。比如表单上验证的字段没有包含模型中所有的字段，这时候就可以先创建对象，再根据填充其他字段，把所有字段的值都补充完成后，再保存到数据库中。

示例代码如下：

form = MyForm(request.POST) 
if form.is_valid():
	article = form.save(commit=False) 
	article.category = 'Python' 
	article.save()
	return HttpResponse('succes') 
else:
	print(form.get_errors()) 
	return HttpResponse('fail')