使用 Django 中的 Form 表单的功能 - 文章教程

使用 Django 中的 Form 表单的功能

发布于 2021-03-29 字数 5853 浏览 976 评论 0

Form 表单的功能

  1. 自动生成 HTML 表单元素
  2. 检查表单数据的合法性
  3. 如果验证错误,重新显示表单(数据不会重置)
  4. 数据类型转换(字符类型的数据转换成相应的 Python 类型)

Form 相关的对象包括

Widget:用来渲染成HTML元素的工具,如:forms.Textarea对应HTML中的<textarea>标签
Field:Form对象中的一个字段,如:EmailField表示email字段,如果这个字段不是有效的email格式,就会产生错误。
Form:一系列Field对象的集合,负责验证和显示HTML元素
Form Media:用来渲染表单的CSS和JavaScript资源。

Form Objects

Form 对象封装了一系列 Field 和验证规则,Form 类都必须直接或间接继承自 django.forms.Form,定义 Form 有两种方式:

方法一:直接继承 Form

from django import forms
class ContactForm(forms.Form):
    subject = forms.CharField(max_length=100,label='主题')
    message = form.CharField(widget=forms.TextArea)
    sender = form.EmailField()
    cc_myself = forms.BooleanField(required=False)

方法二:结合 Model,继承 django.forms.ModelForm

#models.py
class Contact(models.Model):
    title = models.CharField(max_length=30)
    content = models.CharField(max_length=20)

#form.py
class ConotactForm(ModelForm):
    class Meta:
    model = Contact
    field = ('title','content')  #只显示model中指定的字段

在视图(view)中使用 form

在view函数中使用form的一般情景是:

view.py:

form django.shortcuts import render
form django.http import HttpResponseRedirect

def contact(request):
    if request.method=="POST":
        form = ContactForm(request.POST)
        if form.is_valid():  #所有验证都通过
            #do something处理业务
            return HttpResponseRedirect('/')
    else:
        form = ContactForm()
    return render(request,'contact.html',{'form':form})

contact.html:

<form action='/contact/' method='POST'>
    { % for field in form % }
        <div class = 'fieldWrapper'>
            { {field.label_tag} }:{ {field} }
            { {field.errors} }
        </div>
    { % endfor % }
    <div class='fieldWrapper'> <p><input type='submit' value='留言'></p></div>
</form>

处理表单数据

form.is_valid()返回true后,表单数据都被存储在form.cleaned_data对象中(字典类型,意为经过清洗的数据),而且数据会被自动转换为Python对象,如:在form中定义了DateTimeField,那么该字段将被转换为datetime类型,还有诸如:IntegerField、FloatField

if form.is_valid():
    subject = form.cleaned_data['subject']
    message = form.cleaned_data['message']
    sender = form.cleaned_data['sender']
    cc_myself = form.cleaned_data['cc_myself']

    recipients = ['info@example.com']
    if cc_myself:
        recipients.append(sender)

    from django.core.mail import send_mail
    send_mail(subject, message, sender, recipients)
    return HttpResponseRedirect('/thanks/') # Redirect after POST

Form 的简单使用方法就这些。

在模版中显示表单的几种方式

显示form找template中的方法多种多样,也可以自定义:

<form action="/contact/" method="post">{ % csrf_token % }
{ { form.as_p } }
<input type="submit" value="Submit" />
</form>

还可以使用form.as_table、form.as_ul,分别表示用<p>标签,<table>标签和<ul>表示显示表单。如果要自定义,你只要获取到每个元素的值就行:

<form action="/contact/" method="post">
    { { form.non_field_errors } }
    <div class="fieldWrapper">
        { { form.subject.errors } }
        <label for="id_subject">Email subject:</label>
        { { form.subject } }
    </div>
    <div class="fieldWrapper">
        { { form.message.errors } }
        <label for="id_message">Your message:</label>
        { { form.message } }
    </div>
    <div class="fieldWrapper">
        { { form.sender.errors } }
        <label for="id_sender">Your email address:</label>
        { { form.sender } }
    </div>
    <div class="fieldWrapper">
        { { form.cc_myself.errors } }
        <label for="id_cc_myself">CC yourself?</label>
        { { form.cc_myself } }
    </div>
    <p><input type="submit" value="Send message" /></p>
</form>

每个form字段都可以使用 { {form.name_of_field} }得到。

也可以通过迭代form,每个迭代元素对应的是form里面的field

<form action="/contact/" method="post">
    { % for field in form % }
        <div class="fieldWrapper">
            { { field.errors } }
            { { field.label_tag } }: { { field } }
        </div>
    { % endfor % }
    <p><input type="submit" value="Send message" /></p>
</form>

{ {field} }有如下属性:

{ {field.lable} },如:Email address
{ {field.label_tag} },如: <label for=id_email>Email address</label>
{ {field.value} } 如:someone.@gmail.com
{ {field.errors} }

参考

如果你对这篇文章有疑问,欢迎到本站 社区 发帖提问或使用手Q扫描下方二维码加群参与讨论,获取更多帮助。

扫码加入群聊

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

目前还没有任何评论,快来抢沙发吧!

关于作者

JSmiles

生命进入颠沛而奔忙的本质状态,并将以不断告别和相遇的陈旧方式继续下去。

2583 文章
29 评论
84935 人气
更多

推荐作者

清欢

文章 1 评论 0

贱贱哒

文章 3 评论 0

悸初

文章 2 评论 0

西瓜杏

文章 0 评论 0

各自安好

文章 0 评论 0