131 lines
4.8 KiB
Markdown
131 lines
4.8 KiB
Markdown
|
# 如何使用 Python Django 表单
|
|||
|
|
|
|||
|
|
> 原文：<https://www.pythoncentral.io/how-to-use-python-django-forms/>
|
|||
|
|
|
|||
|
|
## Django 形式
|
|||
|
|
|
|||
|
|
什么是 HTML 表单？它有什么样的用例？
|
|||
|
|
|
|||
|
|
> 网页上的 web 表单、web 表单或 HTML 表单允许用户输入发送到服务器进行处理的数据。表单可以类似于纸张或数据库表单，因为 web 用户使用复选框、单选按钮或文本字段来填写表单。例如，表单可用于输入运输或信用卡数据以订购产品，或者可用于从搜索引擎检索搜索结果。
|
|||
|
|
>
|
|||
|
|
> [Wikipedia](https://en.wikipedia.org/wiki/Form_(HTML) "Webforms on Wikipedia")
|
|||
|
|
|
|||
|
|
HTML 表单是从客户端应用程序向服务器发送数据的最常见方式。在本文中，我们将学习如何使用 Django 的表单库来处理 HTML 表单。
|
|||
|
|
|
|||
|
|
## 使用 Django 表单库的好处
|
|||
|
|
|
|||
|
|
在之前的一篇文章中，[为您的第一个 Python Django 应用程序](https://www.pythoncentral.io/writing-views-to-upload-posts-for-your-first-python-django-application/ "Writing Views to Upload Posts for Your First Python Django Application")编写上传帖子的视图，我们学习了如何使用`request.POST`变量从 HTML 表单中检索数据。然而，仅仅检索数据是不够的，因为我们可能希望处理数据验证，并避免在模板中手动编写 HTML 表单。
|
|||
|
|
|
|||
|
|
幸运的是，Django 的表单库提供了以下好处:
|
|||
|
|
|
|||
|
|
* 从表单小部件自动生成 HTML 表单。
|
|||
|
|
* 根据一组规则验证提交的数据。
|
|||
|
|
* 如果有错误，重新显示 HTML 表单。
|
|||
|
|
* 将提交的数据转换成 Python 兼容的类型。
|
|||
|
|
|
|||
|
|
### 基本概念
|
|||
|
|
|
|||
|
|
在我们深入讨论编写表单的细节之前，我们需要了解以下概念:
|
|||
|
|
|
|||
|
|
* **Widget** :一个 Python 类，将自己呈现为 HTML 形式。
|
|||
|
|
* **字段**:验证数据的 Python 类，例如限制最大字符数的`CharField`。
|
|||
|
|
* **表单**:字段的集合。
|
|||
|
|
* **表单资产**:与呈现表单相关联的 CSS 和 Javascript。
|
|||
|
|
|
|||
|
|
设计正确的话，`Form`库与其他 Django 组件是分离的，比如数据库层甚至模板。通过将`Form`库与 Django 的其余部分分离，我们可以独立于应用程序的其余部分编写和测试表单，这增加了应用程序的可维护性。
|
|||
|
|
|
|||
|
|
### 表单和视图
|
|||
|
|
|
|||
|
|
现在让我们继续创建一个表单对象，它表示`myblog/forms.py`中的一个`Post`。
|
|||
|
|
|
|||
|
|
```py
|
|||
|
|
|
|||
|
|
from django import forms
|
|||
|
|
类后置形式(形式。形式):
|
|||
|
|
内容=形式。CharField(max _ length = 256)
|
|||
|
|
created _ at = forms。DateTimeField()
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
然后我们创建一个新的视图，返回我们在上下文中的表单。
|
|||
|
|
|
|||
|
|
```py
|
|||
|
|
|
|||
|
|
from myblog.forms import PostForm
|
|||
|
|
def POST _ Form _ Upload(request):
|
|||
|
|
if request . method = = ' GET ':
|
|||
|
|
Form = PostForm()
|
|||
|
|
else:
|
|||
|
|
# A POST 请求:处理表单上传
|
|||
|
|
form = PostForm(request。POST) #从请求绑定数据。投寄成一种邮件形式
|
|||
|
|
#如果数据有效，则继续创建新的帖子并重定向用户
|
|||
|
|
If form . is _ valid():
|
|||
|
|
content = form . cleaned _ data[' content ']
|
|||
|
|
created _ at = form . cleaned _ data[' created _ at ']
|
|||
|
|
post = m . post . objects . create(content，
|
|||
|
|
created _ at = created _ at)
|
|||
|
|
return httpresponseredict(reverse(' post _ detail '，
|
|||
|
|
kwargs={'post_id': post.id})
|
|||
|
|
return render(request，' post/post_form_upload.html '，{
|
|||
|
|
'form': form，
|
|||
|
|
})
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
然后我们创建一个新的模板，在`myblog/templates/post_form_upload.html`的 HTML 页面中呈现我们的表单。
|
|||
|
|
|
|||
|
|
```py
|
|||
|
|
|
|||
|
|
<form action='/post/form_upload.html' method='post'>{% csrf_token %}
|
|||
|
|
|
|||
|
|
{{ form.as_p }}
|
|||
|
|
|
|||
|
|
<input type='submit' value='Submit' />
|
|||
|
|
|
|||
|
|
</form>
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
最后，我们修改`myblog/urls.py`以追加以下条目:
|
|||
|
|
|
|||
|
|
```py
|
|||
|
|
|
|||
|
|
urlpatterns = patterns('',
|
|||
|
|
|
|||
|
|
...
|
|||
|
|
|
|||
|
|
url(r'^post/form_upload.html$',
|
|||
|
|
|
|||
|
|
'myblog.views.post_form_upload', name='post_form_upload'),
|
|||
|
|
|
|||
|
|
...
|
|||
|
|
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
现在我们可以访问 URL `http://localhost:8000/post/form_upload.html`来看看我们新的帖子表单页面:
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
我们的空表单页面。
|
|||
|
|
|
|||
|
|
填写表格并点击“提交”会将您重定向到新帖的详细信息页面:
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
我们的表格填好了。
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
提交后我们的页面。
|
|||
|
|
|
|||
|
|
因为“内容”和“创建者”字段都是必填的，所以当您试图上传一个空字段时，会出现一个错误。
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
所需输入误差..
|
|||
|
|
|
|||
|
|
## 总结和提示
|
|||
|
|
|
|||
|
|
在本文中，我们学习了如何使用 Django 的表单库来处理 HTML 表单。虽然手工创建 HTML 表单是常见的做法，但是创建 Django 的表单对象可以提供更好的可维护性、可读性和功能性。在下一篇文章中，我们将学习如何使用 Django 的`ModelForm`从模型中自动生成表单。
|