Edward-tan

【玩转全栈】----基于ModelForm完成用户管理页面

目录

大致效果

添加用户代码

引入ModelForm

ModelForm 与一般表单的区别：

ModelForm 与传统 Form 的区别：

使用ModelForm制作用户管理

新建用户

编辑用户：

删除数据

完整代码

在学完前面的部门管理案例后，自己独立写出个用户管理应该不难，基本逻辑和大致代码都和前面一样，大家可以自己试试。

大致效果

基于ModelForm用户管理系统

添加用户代码

但是，按照之前的方式写的话，在表单方面还是会有些繁琐，这里指的是后端代码和前端html。因为用户表涉及到的字段有很多，这就导致视图函数中要写很多行接收用户提交数据，而且添加用户的前端页面也会非常长。像之前那些写的话，用户添加相关文件就会是这样的：

user_list.html:

{% extends 'layout.html' %}
{% block content %}
    
        
            
                
        {#            target="_blank"使得跳转打开新页面#}
                    
                    新建用户
            

            
                
                    
                    用户列表
                
                
                    {% for obj in queryset %}
                    
{#                        creat_time也是,Django内部自带的一种写法,相当于在内部建立一个date函数,将匹配模板和create_time作为参数传递进去,也不允许加百分号#}
{#                      #}
{#                        在模板语法中不允许自己加(),如果是要括号的,模板会自动帮你加#}
                      
                      # Django内部提供了一种方法,对应models.py中带有choices属性的字段,要是想要获取对应元组的内容,只需要使用  get_内容_display
                      
                    {% endfor %}
                
                  
                    
                      ID
                      姓名
                      密码
                      年龄
                      账户余额
                      入职时间
                      性别
                      部门
                      操作
                    
                  
                  
                      {
  
  { obj.id }}
                      {
  
  { obj.name }}
                      {
  
  { obj.password }}
                      {
  
  { obj.age }}
                      {
  
  { obj.account }}
                      {
  
  { obj.create_time|date:"Y-m-d H:i:s" }} {
  
  { obj.depart_id }} {
  
  { obj.get_gender_display }} {
  
  { obj.depart.title }}
                      
                          编辑
                          删除
                      
                    
              
            
        
    
{% endblock %}

ID	姓名	密码	年龄	账户余额	入职时间	性别	部门	操作
{ { obj.id }}	{ { obj.name }}	{ { obj.password }}	{ { obj.age }}	{ { obj.account }}	{ { obj.create_time\|date:"Y-m-d H:i:s" }}	{ { obj.depart_id }}	{ { obj.get_gender_display }}	{ { obj.depart.title }}	编辑删除

user_add.html:

{% extends 'layout.html' %}
{% block content %}
    
     
        
            
              
              新建 用户
              
                
                    {% csrf_token %}
                  
                  
                    姓名
                    
                      
                    
                  

                    
                    密码
                    
                      
                    
                  

                    
                    年龄
                    
                      
                    
                  

                    
                    余额
                    
                      
                    
                  

                
                    入职时间
                    
                      
                    
                  

                    
                    性别
                        
                            
                                
                            
                        
                    

                    
                    部门
                    
                      
                            
                        
                    
                  

                  
                  
                    管理员密码
                    
                      
                    
                  

                  
                  
                    
                      
                    
                  
                
              
            
        
    

{% endblock %}

views.py:

def user_list(request):
    # 获取用户列表
    queryset = UserInfo.objects.all()
    return render(request, "user_list.html",{"queryset":queryset})

def user_add(request):
    Department.objects.all()
    context = {
        'gender_choices': UserInfo.gender_choices,
        'queryset': Department.objects.all()
    }
    if request.method == "GET":
        return render(request, "user_add.html",context)
    name = request.POST.get("name")
    pwd = request.POST.get("pwd")
    age = request.POST.get("age")
    account = request.POST.get("account")
    ctype = request.POST.get("ctime")
    gender = request.POST.get("gender")
    depart_id = request.POST.get("depart")
    UserInfo.objects.create(name=name,password=pwd, age=age, account=account, create_time=ctype, depart_id =depart_id, gender=gender)
    return redirect("/user/list")

引入ModelForm

下面介绍一种更加便捷的表单方法——ModelForm

在Django开发中，ModelForm 是 Django 提供的一个用于简化表单处理的工具，它能通过模型（Model）自动生成表单，而不需要手动定义每个字段。ModelForm 是 Django 中的一个强大功能，能够帮助开发者减少重复的代码，特别是在需要处理与模型关联的表单时。

`ModelForm` 与一般表单的区别：

特性	`ModelForm`	一般表单
自动与数据库字段绑定	自动与模型字段绑定	不会自动绑定，字段需要手动定义
字段映射	字段通过模型自动映射到表单字段	需要手动创建字段并定义属性
验证机制	自动应用模型中的验证规则	需要手动编写字段的验证逻辑
数据保存	自动保存到数据库	需要手动处理数据保存逻辑
创建表单字段	自动生成字段	需要手动定义表单字段

ModelForm 是由传统Form更新而来，继承了Form，但会更加便捷一点

`ModelForm` 与传统 `Form` 的区别：

特性	`ModelForm`	传统 `Form`
关联模型	自动与模型字段关联	不关联模型，需要手动定义字段
字段定义	通过模型字段自动生成	需要手动定义所有字段
验证机制	自动继承模型的验证规则	需要手动为每个字段定义验证规则
数据保存	自动将表单数据保存到模型实例	需要手动提取数据并保存到数据库
生成表单字段	自动生成HTML表单字段	需要手动创建表单字段

ModelForm 主要用于那些与模型直接关联的表单，简化了表单字段的定义和数据的保存过程。与传统的 Form 相比，ModelForm 自动从模型中获取字段和验证规则，因此减少了开发工作量。缺点是对于那些没有直接模型支持的表单，或者需要更复杂逻辑的表单，ModelForm 可能不如手动定义的传统 Form 灵活。

使用ModelForm制作用户管理

新建用户

"""ModelForm示例"""
# 引入forms
from django import forms
class UserForm(forms.ModelForm):
    # 继承ModelForm
    class Meta:
        # model等于表名
        model = UserInfo
        # 具体要用到的列名
        fields = ['name','password','age','account','create_time','depart','gender']

def user_m_form_add(request):
    """添加用户,ModelForm版本"""
    # 实例化前面的ModelForm
    form = UserForm()
    return render(request, "user_MForm_add.html",{"form":form})

简单得在html文件中运用：


        {% csrf_token %}
        
        {% for items in form %}
            {
  
  { items.label }} : {
  
  { items }}
        {% endfor %}

这样的话，页面显示的就是前面ModelForm中创建的fields中的列:

这样的话，数字数据输入框会自动加一个加减箭头，性别会自动加男女选项下拉框，部门也会自动加关联部门表中的id下拉框。但我们想要的效果是部门处要是具体的部门，而不是对应的id，因为ModelForm在循环取值过程中，取到的是一个一个的对象，若直接print这个对象，就会是这样的效果:

可以在部门表后面加上_ _str_ _方法，作用是使得外部有地方直接打印对象时，会打印_ _str_ _函数中返回的内容，这里是部门id所对应的title名称。

def __str__(self):
    return self.title

这里的 { { items.label }}，取的是标签，即字段的另一个名称，在models文件中的verbose_name参数即是友好的中文名称，{ { items.label }}可以使得遍历每个字段并创建输入框时在前面加字段的另一名称。

 name = models.CharField(verbose_name="姓名",max_length=32)

但是这样生成的页面和原来手写的页面还是有点不一样

这是因为虽然ModelForm能简化我们的步骤，但是他是统一自动生成的html标签，样式格式是不会变的，怎么解决呢？

可以在UserForm中添加widgets插件

有两种方式添加:

1、在Meta中添加

添加widgets插件：

widgets = {
            'name': forms.TextInput(attrs={'class':'form-control'}),
            'password': forms.PasswordInput(attrs={'class':'form-control'}),
        }

但是这样，如果字段足够多的情况下，还是得一行一行写，也比较繁琐。

2、重写init方法

    def __init__(self,*args,**kwargs):
        super(UserForm,self).__init__(*args,**kwargs)
        # 循环找到所有的插件
        for name,field in self.fields.items():
            field.widget.attrs = {'class':'form-control'}

这段代码通过循环找到所有的字段名，再赋予样式。

编辑用户：

编辑用户和部门表的编辑一样，只需要将用户点击编辑行数据展示出来，然后用户修改，自动更新，并跳转到显示页面上。

当然这是一般的方法，使用ModelForm的话会更加便捷。

还是使用前面新建数据创建的ModelForm，只需创建实例即可使用。将用户点击编辑行的id传给视图函数，创建实例传参instance=根据id获取到的数据对象，这样即可在输入框中显示原始数据；用UserForm接收用户提交的数据，使用ModelForm的form.save()函数进行更新，这比直接写更新语句要便捷得多，但是这样会导致一个问题，即程序并不知道要更新的是哪行数据，所有程序会自动将用户添加数据作为一个新数据添加到数据库中，并且原来的数据不变，这并不是我们想要的结果，解决方法也很简单，只需要再次获取到ID对应数据对象，在UserForm中添加参数instance=数据对象，再更新，即可实现便捷。

def user_edit(request,nid):
    row_object = UserInfo.objects.filter(id=nid).first()
    if request.method == "GET":
        # 根据ID去数据库获取要编辑的那一行数据(对象)
        # 加上instance=row_object会默认将对应ID的数据显示到页面输入框中,这就比之前的部门管理要方便很多
        form = UserForm(instance=row_object)
        return render(request,"user_edit.html",{"form":form})
    # 如果不加下面这行代码,并且UserForm中加instance,那么数据库中就不是更新数据,因为程序不知道要更新哪一行数据,所有程序会自动新添加一行数据,原来数据保持不变
    form = UserForm(data=request.POST,instance=row_object)
    if form.is_valid():
        form.save()
        return redirect("/user/list/")
    return render(request,"user_edit.html",{"form":form})

删除数据

由于删除数据本身就比较简洁了，不必追求花样，用部门管理中的删除逻辑就行：

view.py

def user_delete(request,nid):
    UserInfo.objects.filter(id=nid).delete()
    return redirect("/user/list/")

完整代码

urls.py:

# 用户管理
    path("user/list/", views.user_list),
    path("user/add/", views.user_add),
    path("user/MForm_add/", views.user_m_form_add),
    path("user//edit/", views.user_edit),
    path("user//delete/", views.user_delete),