首页
所有分类
TAGS
文字工具 EMOJI BIBLE
编程 Python

Django ModelForm组件原理及用法详解

Posted in Python onOctober 12, 2020

这是一个神奇的组件，通过名字我们可以看出来，这个组件的功能就是把model和form组合起来。先来一个简单的例子来看一下这个东西怎么用：

比如我们的数据库中有这样一张学生表，字段有姓名，年龄，爱好，邮箱，电话，住址，注册时间等等一大堆信息，现在让你写一个创建学生的页面，你的后台应该怎么写呢？

首先我们会在前端一个一个罗列出这些字段，让用户去填写，然后我们从后天一个一个接收用户的输入，创建一个新的学生对象，保存起来。

其实，重点不是这些，而是合法性验证，我们需要在前端判断用户输入是否合法，比如姓名必须在多少字符以内，电话号码必须是多少位的数字，邮箱必须是邮箱的格式这些。当然可以一点一点手动写限制，各种判断，这毫无问题，不过比较麻烦。

我们现在有个更优雅（以后在Python相关的内容里，要多用“优雅”这个词，并且养成习惯）的方法：ModelForm

先来简单的，生硬的把它用上，再来加验证条件：

首先导入ModelForm

from django.forms import ModelForm

在视图函数中，定义一个类，比如就叫StudentList，这个类要继承ModelForm，在这个类中再写一个原类Meta（规定写法，并注意首字母是大写的）

在这个原类中，有以下属性（部分）：

class StudentList(ModelForm):
  class Meta:
    model = models.Student #对应的Model中的类
    fields = "__all__"   #字段，如果是__all__,就是表示列出所有的字段
    exclude = None     #排除的字段
    labels = None      #提示信息
    help_texts = None    #帮助提示信息
    widgets = None     #自定义插件
    error_messages = None  #自定义错误信息
#error_messages用法：
    error_messages = {
      'name':{'required':"用户名不能为空",},
      'age':{'required':"年龄不能为空",},
    }

#widgets用法,比如把输入用户名的input框给为Textarea
#首先得导入模块
    from django.forms import widgets as wid #因为重名，所以起个别名
    widgets = {
      "name":wid.Textarea(attrs={"class":"c1"}) #还可以自定义属性
    }
#labels，自定义在前端显示的名字


labels= {
      "name":"用户名"
    }

如果想增加一个字段，就在class Meta 之前写这个字段。然后在url对应的视图函数中实例化这个类，把这个对象传给前端。

def student(request):
  if request.method == 'GET':
    student_list = StudentList()
    return render(request,'student.html',{'student_list':student_list})

然后前端只需要 {{ student_list.as_p }} 一下，所有的字段就都出来了，可以用as_p显示全部，也可以通过for循环这student_list，拿到的是一个个input框，现在我们就不用as_p，手动把这些input框搞出来，as_p拿到的页面太丑。

首先 for循环这个student_list，拿到student对象，直接在前端打印这个student，是个input框；student.label ，拿到数据库中每个字段的verbose_name ，如果没有设置这个属性，拿到的默认就是字段名；还可以通过student.errors.0 拿到错误信息，还有student.field，是拿到每个字段，如果这个字段是多对多字段，还能stuent.field.queryset，拿到所有关联的字段，还能stuent.field.queryset.model，拿到所有关联的字段的类。有了这些，我们就可以通过bootstrap，自己拼出来想要的样式了

比如：

<body>
  <div class="container" >
    <h1>student</h1>
    <form method="POST" novalidate>
      {% csrf_token %}
{#      {{ student_list.as_p }}#}
      {% for student in student_list %}
        <div class="form-group col-md-6">
         {# 拿到数据字段的verbose_name,没有就默认显示字段名 #}
          <label class="col-md-3 control-label">{{ student.label }}</label>
          <div class="col-md-9" style="position: relative;">{{ student }}</div>
        </div>
      {% endfor %}

      <div class="col-md-2 col-md-offset-10">
        <input type="submit" value="提交" class="btn-primary">
      </div>
    </form>
  </div>
</body>

现在还缺一个input框的form-control样式，可以考虑在后台的widget里面添加。

比如这样：

from django.forms import widgets as wid #因为重名，所以起个别名
    widgets = {
      "name":wid.TextInput(attrs={'class':'form-control'}),
      "age":wid.NumberInput(attrs={'class':'form-control'}),
      "email":wid.EmailInput(attrs={'class':'form-control'})
    }

当然也可以在js中，找到所有的input框，加上这个样式，也行。

保存数据的时候，不用挨个取数据了，只需要save一下。

def student(request):

  if request.method == 'GET':
    student_list = StudentList()
    return render(request,'student.html',{'student_list':student_list})
  else:
    student_list = StudentList(request.POST)
    if student_list.is_valid():
      student_list.save()
    return redirect(request,'student_list.html',{'student_list':student_list})

编辑数据：

如果不用ModelForm，编辑的时候得显示之前的数据吧，还得挨个取一遍值，如果ModelForm，只需要加一个instance=obj（obj是要修改的数据库的一条数据的对象）就可以得到同样的效果。

保存的时候要注意，一定要注意有这个对象（instance=obj），否则不知道更新哪一个数据。

代码示例：

from django.shortcuts import render,HttpResponse,redirect
from django.forms import ModelForm
# Create your views here.
from app01 import models

def test(request):

  # model_form = models.Student
  model_form = models.Student.objects.all()
  return render(request,'test.html',{'model_form':model_form})


class StudentList(ModelForm):
  class Meta:
    model = models.Student #对应的Model中的类
    fields = "__all__"   #字段，如果是__all__,就是表示列出所有的字段
    exclude = None     #排除的字段
    labels = None      #提示信息
    help_texts = None    #帮助提示信息
    widgets = None     #自定义插件
    error_messages = None  #自定义错误信息
#error_messages用法：
    error_messages = {
      'name':{'required':"用户名不能为空",},
      'age':{'required':"年龄不能为空",},
    }

#widgets用法,比如把输入用户名的input框给为Textarea
#首先得导入模块
    from django.forms import widgets as wid #因为重名，所以起个别名
    widgets = {
      "name":wid.Textarea
    }
#labels，自定义在前端显示的名字
    labels= {
      "name":"用户名"
    }
def student(request):

  if request.method == 'GET':
    student_list = StudentList()
    return render(request,'student.html',{'student_list':student_list})
  else:
    student_list = StudentList(request.POST)
    if student_list.is_valid():
      student_list.save()
    return render(request,'student.html',{'student_list':student_list})

def student_edit(request,pk):
  obj = models.Student.objects.filter(pk=pk).first()
  if not obj:
    return redirect('test')
  if request.method == "GET":
    student_list = StudentList(instance=obj)
    return render(request,'student_edit.html',{'student_list':student_list})

  else:
    student_list = StudentList(request.POST,instance=obj)
    if student_list.is_valid():
      student_list.save()
    return render(request,'student_edit.html',{'student_list':student_list})

使用ModelForm编辑数据

对于验证规则，很多浏览器都比较智能，会自动帮我们做一些验证，可以在form表单上加 novalidate 属性就可以不让浏览器为我们做验证

ModelForm还支持所有form的功能，比如钩子，所以我们就可以通过钩子来自定义验证规则

写法和forms的写法一样：

class AuthorForm(forms.ModelForm):
  class Meta:
    model = Author
    fields = ('name', 'title')

  def clean_name(self):
    if ...
       return self.clean_data['name']
    else:
       raise ValidationError（‘sdgsadga'）
    ...

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持三水点靠木。

Django ModelForm组件原理及用法详解

- Author -

傻白甜++

声明：登载此文出于传递更多信息之目的，并不意味着赞同其观点或证实其描述。

Python 相关文章推荐
python实现从一组颜色中找出与给定颜色最接近颜色的方法
Mar 19 Python
Python检测QQ在线状态的方法
May 09 Python
python命令行解析之parse_known_args(）函数和parse_args()使用区别介绍
Jan 24 Python
详解python中的线程
Feb 10 Python
python中的内置函数max()和min()及mas()函数的高级用法
Mar 29 Python
TensorFlow Session使用的两种方法小结
Jul 30 Python
selenium+python 对输入框的输入处理方法
Oct 11 Python
对python字典过滤条件的实例详解
Jan 22 Python
Python 实现输入任意多个数,并计算其平均值的例子
Jul 16 Python
Tensorflow 自定义loss的情况下初始化部分变量方式
Jan 06 Python
python线程join方法原理解析
Feb 11 Python
python自动化调用百度api解决验证码
Apr 13 Python
Python ConfigParser模块的使用示例
Oct 12 #Python
python修改微信和支付宝步数的示例代码
Oct 12 #Python
教你如何用python操作摄像头以及对视频流的处理
Oct 12 #Python
Django限制API访问频率常用方法解析
Oct 12 #Python
Python confluent kafka客户端配置kerberos认证流程详解
Oct 12 #Python
Django如何使用asyncio协程和ThreadPoolExecutor多线程
Oct 12 #Python
使用Python中tkinter库简单gui界面制作及打包成exe的操作方法（二）
Oct 12 #Python
磁盘管理(1) Vmware(3) Hash(1) plus.io(1) 入门基础(1) 触发器(3) RabbitMQ(3) Geospatial(1) html5+(1) 虚拟机(3)
You might like
解析php框架codeigniter中如何使用框架的session
2013/06/24 PHP
fireworks菜单生成器mm_menu.js在 IE 7.0 显示问题的解决方法
2009/10/20 Javascript
jQuery数据缓存功能的实现思路及简单模拟
2013/05/27 Javascript
seaJs的模块定义和模块加载浅析
2014/06/06 Javascript
基于jQuery1.9版本如何判断浏览器版本类型
2016/01/12 Javascript
js添加绑定事件的方法
2016/05/15 Javascript
Listloading.js移动端上拉下拉刷新组件
2016/08/04 Javascript
对javascript继承的理解
2016/10/11 Javascript
简单三步实现报表页面集成天气
2016/12/15 Javascript
微信小程序实现拖拽 image 触摸事件监听的实例
2017/08/17 Javascript
利用JavaScript的%做隔行换色的实例
2017/11/25 Javascript
Vuepress 搭建带评论功能的静态博客的实现
2019/02/17 Javascript
微信小程序开发实现消息推送
2020/11/18 Javascript
jQuery实现简单弹幕效果
2019/11/28 jQuery
JS中类的静态方法，静态变量，实例方法，实例变量区别与用法实例分析
2020/03/14 Javascript
Python实现去除代码前行号的方法
2015/03/10 Python
使用Django Form解决表单数据无法动态刷新的两种方法
2017/07/14 Python
利用Python库Scapy解析pcap文件的方法
2019/07/23 Python
pygame实现烟雨蒙蒙下彩虹雨
2019/11/11 Python
keras K.function获取某层的输出操作
2020/06/29 Python
解决tensorflow/keras时出现数组维度不匹配问题
2020/06/29 Python
css3 按钮 利用css3实现超酷下载按钮
2013/03/18 HTML / CSS
Tech21美国/加拿大：英国NO.1防摔保护壳品牌
2018/01/20 全球购物
函数只定义了一次, 调用了一次, 但编译器提示非法重定义了-什么问题？
2014/10/03 面试题
What is view? why do we have view?
2012/06/22 面试题
护士自我评价
2014/02/01 职场文书
竞选大队委员演讲稿
2014/04/28 职场文书
信息与工商管理职业规划范文：为梦想而搏击
2014/09/11 职场文书
学生会感恩节活动方案
2014/10/11 职场文书
私用公车造成事故检讨书
2014/11/16 职场文书
2014年保洁工作总结
2014/11/24 职场文书
教师个人事迹材料
2014/12/17 职场文书
横店影视城导游词
2015/02/06 职场文书
python Polars库的使用简介
2021/04/21 Python
Python实战之用tkinter库做一个鼠标模拟点击器
2021/04/27 Python
laravel添加角色和模糊搜索功能的实现代码
2021/06/22 PHP