Python的Django框架中forms表单类的使用方法详解 - 哈喽比特

872次阅读 | 发布于5年以前

Form表单的功能

自动生成HTML表单元素
检查表单数据的合法性
如果验证错误，重新显示表单（数据不会重置）
数据类型转换（字符类型的数据转换成相应的Python类型）

Form相关的对象包括

Widget：用来渲染成HTML元素的工具，如：forms.Textarea对应HTML中的标签</li> <li>Field：Form对象中的一个字段，如：EmailField表示email字段，如果这个字段不是有效的email格式，就会产生错误。</li> <li>Form：一系列Field对象的集合，负责验证和显示HTML元素</li> <li>Form Media：用来渲染表单的CSS和JavaScript资源。</li> </ul> <p><strong>Form Objects</strong></p> <p>Form对象封装了一系列Field和验证规则，Form类都必须直接或间接继承自django.forms.Form，定义Form有两种方式:</p> <p>方法一：直接继承Form</p> <pre><code> 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) </code></pre> <p>方法二：结合Model，继承django.forms.ModelForm</p> <pre><code> #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中指定的字段 </code></pre> <p><strong>在视图（view）中使用form</strong></p> <p>在view函数中使用form的一般情景是：</p> <p>view.py:</p> <pre><code> 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}) </code></pre> <p>contact.html:</p> <pre><code> <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> </code></pre> <p><strong>处理表单数据</strong></p> <p>form.is_valid()返回true后，表单数据都被存储在form.cleaned_data对象中（字典类型，意为经过清洗的数据），而且数据会被自动转换为Python对象，如：在form中定义了DateTimeField，那么该字段将被转换为datetime类型，还有诸如：IntegerField、FloatField</p> <pre><code> 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 </code></pre> <p>Form的简单使用方法就这些。另：</p> <p>在模版中显示表单的几种方式：</p> <p>显示form找template中的方法多种多样，也可以自定义：</p> <pre><code> <form action="/contact/" method="post">{% csrf_token %} {{ form.as_p }} <input type="submit" value="Submit" /> </form> </code></pre> <p>还可以使用form.as_table、form.as_ul，分别表示用<p>标签，<table>标签和<ul>表示显示表单。如果要自定义，你只要获取到每个元素的值就行：</p> <pre><code> <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> </code></pre> <p>每个form字段都可以使用 {{form.name_of_field}}得到。</p> <p>也可以通过迭代form，每个迭代元素对应的是form里面的field</p> <pre><code> <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> </code></pre> <p>{{field}}有如下属性：</p> <pre><code> {{field.lable}}，如：Email address {{field.label_tag}}，如： <label for=id_email>Email address</label> {{field.value}} 如：someone.@gmail.com {{field.errors}} </code></pre> <p><strong>实例：构建表单<br /> </strong>第一步:首先在models.py中定义一个表单模型</p> <pre><code> class RemarkForm(forms.Form): subject = forms.CharField(max_length=100 ,label='留言标题') mail = forms.EmailField(label='电子邮件') topic = forms.ChoiceField(choices=TOPIC_CHOICES,label='选择评分') message = forms.CharField(label='留言内容',widget=forms.Textarea) cc_myself = forms.BooleanField(required=False ,label='订阅该贴') </code></pre> <p>那个topic中的choices需要在models.py中定义一个数组. </p> <pre><code> TOPIC_CHOICES = ( ('leve1', '差评'), ('leve2', '中评'), ('leve3', '好评'), ) </code></pre> <p>这样，之后在html显示的表单就采用这个模型的数据了。</p> <p>另外还有一种定义表单模型的方式，那就是直接继承另一个models。如果我们在models里设计数据库时，已经设计好了一个类(就是数据库的表)之后想复用这个类的信息来作为表单的模型，那么很简单，同样是在models中的一个类 </p> <pre><code> class Advertisement(models.Model): #订单编号 OrderID = models.ForeignKey(OrderInfo) #//广告标题# Title = models.CharField(max_length = 36) #//广告内容# Content = models.CharField(max_length = 600) </code></pre> <p>注意，他的类型是models.Model，是做数据库ORM用的。</p> <p>然后怎么关联呢?<br /> 需要导入一个新的类 (ModelForm) </p> <pre><code> from django.forms import ModelForm class ContactForm(ModelForm): class Meta: model = Advertisement fields = ('Title', 'CustomerID') </code></pre> <p>这里的Advertisement就是之前那个ORM的模型。<br /> 第二步：OK，继续我们的表单，下一步需要做什么呢？开始在views.py里写对表单的调用吧.<br /> def remark(request):</p> <pre><code> if request.method == 'POST': # 如果表单被提交 form = ContactForm(request.POST) # 获取Post表单数据 if form.is_valid(): # 验证表单 return HttpResponseRedirect('/') # 跳转 else: form = ContactForm() #获得表单对象 return render_to_response('message.html', { 'form': form, }) </code></pre> <p>整个代码很简单，我就不过多的解释了。</p> <p>第三步：我们知道django里任何访问都是通过urls.py来管理的。所以下面我们需要配置一个路径。</p> <pre><code> (r'^message', 'iring.views.remark'),</code></pre> <p>第四步：最后应该是建立一个模板的时候了，因为我们最终是输出到html上的.注意views的remark函数最后一行 </p> <pre><code> return render_to_response('message.html', { 'form': form, }) </code></pre> <p>就是讲当前的表单对象输出到message.html里，自动生成一个表单。<br /> 所以，先构建一个html.<br /> 这个html模板很简单，除去不必要的CSS，我只给出核心部分好啦。 </p> <pre><code> <form action="/message/" 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> </code></pre> <pre><code> {% for field in form %} {% endfor %} </code></pre> <p>用于对表单对象里的元素进行遍历，然后通过 </p> <pre><code> {{ field.label_tag }} {{ field }} {{ field.errors }} </code></pre> <p>这三个标签来输出，注意{{ field.errors }}默认情况下是不会输出的，只有当验证表单正确性时才会输出内容。</p> <p>最终我们通过:<br /> http://youdjangourl/message来访问这个例子</p> <p><img src="https://codingsky.oss-cn-hangzhou.aliyuncs.com/cdn/codingsky/upload/img/blog/40c0ebef9a3acf0cb9347bd1391849f0.jpg" alt="2016621145313568.jpg $463×521$" /></p> <p><img src="https://codingsky.oss-cn-hangzhou.aliyuncs.com/cdn/codingsky/upload/img/blog/c66c2045b4e8770fd625290ba3d37656.jpg" alt="2016621145344436.jpg $433×383$" /></p> <p><img src="https://codingsky.oss-cn-hangzhou.aliyuncs.com/cdn/codingsky/upload/img/blog/028c89642b2352b85e961beb54595855.jpg" alt="2016621145405787.jpg $434×350$" /></p> </div> </div> <div class="blockgap"></div> </div> <div class="blockgap"></div> <script> let url = window.location.href; function onWxReadyForShareArticle(){ let obj = { title: decodeURI(articleTitle), desc: decodeURI(articleSummary), link: window.location.href, imgUrl: "https://oss-cn-hangzhou.aliyuncs.com/codingsky/cdn/img/2024-02-01/89778da8387748299364fa73ad54f9a9", // 分享图标 success: function () { //console.log("update share success"); } }; wx.updateAppMessageShareData(obj); } function wechatShareArticle(){ //let data = {url:"https://hellobit.com.cn/doc/2024/1/29/1039.html"}; let data = { url : window.location.href }; postJsonV2(getUserToken(),"/api/tbs/v1/wxsdk/jssdk", data, function(code, data){ if(code != 200){ //console.log("get sign error,", code, data); return; } if(data.code != 0){ //console.log("get sign error, biz error ", data); return; } let appid = data.data.appid; let noncestr = data.data.noncestr; let timestamp = data.data.timestamp; let signature = data.data.signature; // get nonceStr, signature wx.config({ debug: false, // 开启调试模式,调用的所有api的返回值会在客户端alert出来，若要查看传入的参数，可以在pc端打开，参数信息会通过log打出，仅在pc端时才会打印。 appId: appid, // 必填，公众号的唯一标识 timestamp: timestamp, // 必填，生成签名的时间戳 nonceStr: noncestr, // 必填，生成签名的随机串 signature: signature,// 必填，签名 jsApiList: ['updateAppMessageShareData'] // 必填，需要使用的JS接口列表 }); wx.ready(function(){ onWxReadyForShareArticle(); }); wx.error(function(res){ if(console.error){ //console.error(res); } }); }); } </script>  <div class="mcontainer" style="margin-top: 10px;margin-bottom:0px;padding-top:10px;padding-bottom:10px;background-color:rgb(48, 60, 66);color:#fff;"> <div class="row" style="text-align:center;"> <p style="margin:0px;padding:0px;" class="mfont_1">Copyright© 2013-2020</p> <p style="margin:0px;padding:0px;" class="mfont_1">All Rights Reserved <a href="https://beian.miit.gov.cn">京ICP备2023019179号-8</a></p> </div> </div> <script> window.onload = function(){ hljs.highlightAll(); if(typeof wechatShareArticle === "function"){ wechatShareArticle(); } }; document.addEventListener('DOMContentLoaded', () => { // Get all "navbar-burger" elements const $navbarBurgers = Array.prototype.slice.call(document.querySelectorAll('.navbar-burger'), 0); // Add a click event on each of them $navbarBurgers.forEach( el => { el.addEventListener('click', () => { // Get the target from the "data-target" attribute const target = el.dataset.target; const $target = document.getElementById(target); // Toggle the "is-active" class on both the "navbar-burger" and the "navbar-menu" el.classList.toggle('is-active'); $target.classList.toggle('is-active'); }); }); }); </script>  <script type="text/javascript" src="//cpro.baidustatic.com/cpro/ui/c.js" async="async" defer="defer" ></script>  <script> var _hmt = _hmt || []; (function() { var hm = document.createElement("script"); hm.src = "https://hm.baidu.com/hm.js?713c92a31aa12d55b910e2065c7cda9d"; var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(hm, s); })(); </script> <script> /*var _hmt = _hmt || []; (function() { var hm = document.createElement("script"); hm.src = "https://hm.baidu.com/hm.js?e066867ae5a323a82641e57db7e7c914"; var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(hm, s); })();*/ </script> <script> (function(){ var bp = document.createElement('script'); var curProtocol = window.location.protocol.split(':')[0]; if (curProtocol === 'https') { bp.src = 'https://zz.bdstatic.com/linksubmit/push.js'; } else { bp.src = 'http://push.zhanzhang.baidu.com/push.js'; } var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(bp, s); })(); </script>   <script async src="https://www.googletagmanager.com/gtag/js?id=G-2VE3RBLF6N"></script> <script> window.dataLayer = window.dataLayer || []; function gtag(){dataLayer.push(arguments);} gtag('js', new Date()); gtag('config', 'G-2VE3RBLF6N'); </script> </body> </html>