【玩转全栈】----基于ModelForm完成用户管理页面
目录
大致效果
添加用户代码
引入ModelForm
ModelForm 与一般表单的区别:
ModelForm 与传统 Form 的区别:
使用ModelForm制作用户管理
新建用户
编辑用户:
删除数据
完整代码
在学完前面的部门管理案例后,自己独立写出个用户管理应该不难,基本逻辑和大致代码都和前面一样,大家可以自己试试。
大致效果
基于ModelForm用户管理 系统
添加用户代码
但是,按照之前的方式写的话,在表单方面还是会有些繁琐,这里指的是后端代码和前端html。因为用户表涉及到的字段有很多,这就导致视图函数中要写很多行接收用户提交数据,而且添加用户的前端页面也会非常长。像之前那些写的话,用户添加相关文件就会是这样的:
user_list.html:
{% extends 'layout.html' %}
{% block content %}
<div class="container-fluid">
<div class="my-div">
<div style="margin-bottom: 10px">
<a class="btn btn-primary" href="/user/add/">
{# target="_blank"使得跳转打开新页面#}
<span class="glyphicon glyphicon-plus" aria-hidden="true"></span>
新建用户</a>
</div>
<div>
<div class="panel-heading">
<span class="glyphicon glyphicon-eye-open" aria-hidden="true"></span>
用户列表</div>
<div class="bs-example" data-example-id="contextual-table">
<table class="table">
<thead>
<tr>
<th>ID</th>
<th>姓名</th>
<th>密码</th>
<th>年龄</th>
<th>账户余额</th>
<th>入职时间</th>
<th>性别</th>
<th>部门</th>
<th>操作</th>
</tr>
</thead>
<tbody>
{% for obj in queryset %}
<tr>
<th scope="row">{
{ obj.id }}</th>
<td>{
{ obj.name }}</td>
<td>{
{ obj.password }}</td>
<td>{
{ obj.age }}</td>
<td>{
{ obj.account }}</td>
<td>{
{ obj.create_time|date:"Y-m-d H:i:s" }}</td>
{# creat_time也是,Django内部自带的一种写法,相当于在内部建立一个date函数,将匹配模板和create_time作为参数传递进去,也不允许加百分号#}
{# <td>{
{ obj.depart_id }}</td>#}
{# 在模板语法中不允许自己加(),如果是要括号的,模板会自动帮你加#}
<td>{
{ obj.get_gender_display }}</td>
# Django内部提供了一种方法,对应models.py中带有choices属性的字段,要是想要获取对应元组的内容,只需要使用 get_内容_display
<td>{
{ obj.depart.title }}</td>
<td>
<a class="btn btn-primary btn-xs" href="">编辑</a>
<a class="btn btn-danger btn-xs" href="">删除</a>
</td>
</tr>
{% endfor %}
</table>
</div>
</div>
</div>
</div>
{% endblock %}
user_add.html:
{% extends 'layout.html' %}
{% block content %}
<div class="container-fluid" style="margin-top: 10px">
<div class="my-div">
<div class="container">
<div class="panel panel-default" style="width: 750px;margin-top: 10px">
<!-- Default panel contents -->
<div class="panel-heading" style="margin-top: 0">新建 用户</div>
<div class="panel-body">
<form class="form-horizontal" method="POST">
{% csrf_token %}
<!-- 姓名输入框 -->
<div class="form-group">
<label for="inputDepartmentName" class="col-sm-2 control-label">姓名</label>
<div class="col-sm-5">
<input type="text" class="form-control" id="inputDepartmentName" placeholder="请输入姓名" name="name">
</div>
</div>
<div class="form-group">
<label for="inputDepartmentName" class="col-sm-2 control-label">密码</label>
<div class="col-sm-5">
<input type="text" class="form-control" id="inputDepartmentName" placeholder="请输入密码" name="pwd">
</div>
</div>
<div class="form-group">
<label for="inputDepartmentName" class="col-sm-2 control-label">年龄</label>
<div class="col-sm-5">
<input type="text" class="form-control" id="inputDepartmentName" placeholder="请输入年龄" name="age">
</div>
</div>
<div class="form-group">
<label for="inputDepartmentName" class="col-sm-2 control-label">余额</label>
<div class="col-sm-5">
<input type="text" class="form-control" id="inputDepartmentName" placeholder="请输入账户余额" name="account">
</div>
</div>
<div class="form-group">
<label for="inputDepartmentName" class="col-sm-2 control-label">入职时间</label>
<div class="col-sm-5">
<input type="text" class="form-control" id="inputDepartmentName" placeholder="请输入入职时间" name="ctime">
</div>
</div>
<div class="form-group">
<label for="inputDepartmentName" class="col-sm-2 control-label">性别</label>
<div class="col-sm-5">
<label>
<select class="form-control" name="gender">
{% for item in gender_choices %}
<option value={
{ item.0 }}>{
{ item.1 }}</option>
{% endfor %}
</select>
</label>
</div>
</div>
<div class="form-group">
<label for="inputDepartmentName" class="col-sm-2 control-label">部门</label>
<div class="col-sm-5">
<label>
<select class="form-control" name="depart">
{% for item in queryset %}
<option value="{
{ item.id }}">{
{ item.title }}</option>
{% endfor %}
</select>
</label>
</div>
</div>
<!-- 管理员密码输入框 -->
<div class="form-group">
<label for="inputPassword3" class="col-sm-2 control-label">管理员密码</label>
<div class="col-sm-10">
<input type="password" class="form-control" id="inputPassword3" placeholder="请输入管理员密码" name="pwd">
</div>
</div>
<!-- 提交按钮 -->
<div class="form-group">
<div class="col-sm-offset-2 col-sm-10">
<button type="submit" class="btn btn-primary">提 交</button>
</div>
</div>
</form>
</div>
</div>
</div>
</div>
</div>
{% 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文件中运用:
<form class="form-horizontal" method="POST">
{% csrf_token %}
<!-- 输入框 -->
{% for items in form %}
{
{ items.label }} : {
{ items }}
{% endfor %}
<!-- 提交按钮 -->
<div class="form-group">
<div class="col-sm-offset-2 col-sm-10">
<button type="submit" class="btn btn-primary">提 交</button>
</div>
</div>
</form>
这样的话,页面显示的就是前面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/<int:nid>/edit/", views.user_edit),
path("user/<int:nid>/delete/", views.user_delete),
views.py:
def user_list(request):
# 获取用户列表
queryset = UserInfo.objects.all()
for obj in queryset:
# Django内部提供了一种方法,对应models.py中带有choices属性的字段,要是想要获取对应元组的内容,只需要使用 get_内容_display()函数,
# 就是自动获取到元素对应元组中的内容,在html中不是函数,在视图函数中是函数
# print(obj.get_gender_display())
# print(obj.create_time.strftime("%Y-%m-%d"))
# ids = Department.objects.filter(id=obj.depart_id).first()
# print(ids.title)
# 像这样按照id去部门表中查找title值当然是可以的,但Django内部提供了一种更加便捷的方式,用于多表间的关联
# 帮助跨表,获取数据很容易
var = obj.depart.title
print(var)
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示例"""
from django import forms
class UserForm(forms.ModelForm):
class Meta:
model = UserInfo
fields = ['name','password','age','account','create_time','depart','gender']
# 1、还是比较繁琐
# widgets = {
# 'name': forms.TextInput(attrs={'class':'form-control'}),
# 'password': forms.PasswordInput(attrs={'class':'form-control'}),
# }
# 2、循环到所有的插件再赋予form-control样式
def __init__(self,*args,**kwargs):
super(UserForm,self).__init__(*args,**kwargs)
# 循环找到所有的插件
for name,field in self.fields.items():
field.widget.attrs = {'class':'form-control'}
def user_m_form_add(request):
"""添加用户,ModelForm版本"""
if request.method == "GET":
form = UserForm()
return render(request, "user_MForm_add.html",{"form":form})
# 用户提交POST请求,校验数据
form = UserForm(data=request.POST)
# 注意!要是数据填写错误,表单数据就传不过来
print(request.POST)
if form.is_valid():
print(form.cleaned_data)
# 自动帮我们保存到ModelForm定义的数据库中
form.save()
return redirect("/user/list")
else:
print(form.errors)
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})
def user_delete(request,nid):
UserInfo.objects.filter(id=nid).delete()
return redirect("/user/list/")
user_list.html:
{% extends 'layout.html' %}
{% block content %}
<div class="container-fluid">
<div class="my-div">
{# <div style="margin-bottom: 10px">#}
{# <a class="btn btn-primary" href="/user/add/">#}
{# target="_blank"使得跳转打开新页面#}
{# <span class="glyphicon glyphicon-plus" aria-hidden="true"></span>#}
{# 新建用户</a>#}
{# </div>#}
<div style="margin-bottom: 10px">
<a class="btn btn-primary" href="/user/MForm_add/">
{# target="_blank"使得跳转打开新页面#}
<span class="glyphicon glyphicon-plus" aria-hidden="true"></span>
新建用户</a>
</div>
<div>
<div class="panel-heading">
<span class="glyphicon glyphicon-eye-open" aria-hidden="true"></span>
用户列表</div>
<div class="bs-example" data-example-id="contextual-table">
<table class="table">
<thead>
<tr>
<th>ID</th>
<th>姓名</th>
<th>密码</th>
<th>年龄</th>
<th>账户余额</th>
<th>入职时间</th>
<th>性别</th>
<th>部门</th>
<th>操作</th>
</tr>
</thead>
<tbody>
{% for obj in queryset %}
<tr>
<th scope="row">{
{ obj.id }}</th>
<td>{
{ obj.name }}</td>
<td>{
{ obj.password }}</td>
<td>{
{ obj.age }}</td>
<td>{
{ obj.account }}</td>
<td>{
{ obj.create_time|date:"Y-m-d" }}</td>
{# creat_time也是,Django内部自带的一种写法,相当于在内部建立一个date函数,将匹配模板和create_time作为参数传递进去,也不允许加百分号#}
{# <td>{
{ obj.depart_id }}</td>#}
{# 在模板语法中不允许自己加(),如果是要括号的,模板会自动帮你加#}
<td>{
{ obj.get_gender_display }}</td>
<td>{
{ obj.depart.title }}</td>
<td>
<a class="btn btn-primary btn-xs" href="/user/{
{ obj.id }}/edit/">编辑</a>
<a class="btn btn-danger btn-xs" href="/user/{
{ obj.id }}/delete/">删除</a>
</td>
</tr>
{% endfor %}
</table>
</div>
</div>
</div>
</div>
{% endblock %}
user_add.html:
{% extends 'layout.html' %}
{% block content %}
<div class="container-fluid" style="margin-top: 10px">
<div class="my-div">
<div class="container">
<div class="panel panel-default" style="width: 750px;margin-top: 10px">
<!-- Default panel contents -->
<div class="panel-heading" style="margin-top: 0">新建 用户</div>
<div class="panel-body">
<form class="form-horizontal" method="POST">
{% csrf_token %}
<!-- 姓名输入框 -->
<div class="form-group">
<label for="inputDepartmentName" class="col-sm-2 control-label">姓名</label>
<div class="col-sm-5">
<input type="text" class="form-control" id="inputDepartmentName" placeholder="请输入姓名" name="name">
</div>
</div>
<div class="form-group">
<label for="inputDepartmentName" class="col-sm-2 control-label">密码</label>
<div class="col-sm-5">
<input type="text" class="form-control" id="inputDepartmentName" placeholder="请输入密码" name="pwd">
</div>
</div>
<div class="form-group">
<label for="inputDepartmentName" class="col-sm-2 control-label">年龄</label>
<div class="col-sm-5">
<input type="text" class="form-control" id="inputDepartmentName" placeholder="请输入年龄" name="age">
</div>
</div>
<div class="form-group">
<label for="inputDepartmentName" class="col-sm-2 control-label">余额</label>
<div class="col-sm-5">
<input type="text" class="form-control" id="inputDepartmentName" placeholder="请输入账户余额" name="account">
</div>
</div>
<div class="form-group">
<label for="inputDepartmentName" class="col-sm-2 control-label">入职时间</label>
<div class="col-sm-5">
<input type="text" class="form-control" id="inputDepartmentName" placeholder="请输入入职时间" name="ctime">
</div>
</div>
<div class="form-group">
<label for="inputDepartmentName" class="col-sm-2 control-label">性别</label>
<div class="col-sm-5">
<label>
<select class="form-control" name="gender">
{% for item in gender_choices %}
<option value={
{ item.0 }}>{
{ item.1 }}</option>
{% endfor %}
</select>
</label>
</div>
</div>
<div class="form-group">
<label for="inputDepartmentName" class="col-sm-2 control-label">部门</label>
<div class="col-sm-5">
<label>
<select class="form-control" name="depart">
{% for item in queryset %}
<option value="{
{ item.id }}">{
{ item.title }}</option>
{% endfor %}
</select>
</label>
</div>
</div>
<!-- 管理员密码输入框 -->
<div class="form-group">
<label for="inputPassword3" class="col-sm-2 control-label">管理员密码</label>
<div class="col-sm-10">
<input type="password" class="form-control" id="inputPassword3" placeholder="请输入管理员密码" name="pwd">
</div>
</div>
<!-- 提交按钮 -->
<div class="form-group">
<div class="col-sm-offset-2 col-sm-10">
<button type="submit" class="btn btn-primary">提 交</button>
</div>
</div>
</form>
</div>
</div>
</div>
</div>
</div>
{% endblock %}
user_MForm_add.html:
{% extends 'layout.html' %}
{% block content %}
<div class="container-fluid" style="margin-top: 10px">
<div class="my-div">
<div class="container">
<div class="panel panel-default" style="width: 750px;margin-top: 10px">
<!-- Default panel contents -->
<div class="panel-heading" style="margin-top: 0">新建 用户</div>
<div class="panel-body">
<form class="form-horizontal" method="POST" action="/user/MForm_add/">
{% csrf_token %}
<!-- 输入框 -->
{% for items in form %}
<div class="form-group">
<label for="inputDepartmentName" class="col-sm-2 control-label">{
{ items.label }}</label>
<div class="col-sm-5">
{# <input type="text" class="form-control" id="inputDepartmentName" placeholder="" name="{
{ items.label }}">#}
{
{ items }}
{# 要是有错误信息,会显示#}
<span style="color: red">{
{ items.errors.0 }}</span>
{# 直接手写{
{ items }},因为他会自动帮我们生成html标签#}
</div>
</div>
{# {
{ items.label }} : {
{ items }}#}
{% endfor %}
<!-- 提交按钮 -->
<div class="form-group">
<div class="col-sm-offset-2 col-sm-10">
<button type="submit" class="btn btn-primary">提 交</button>
</div>
</div>
</form>
</div>
</div>
</div>
</div>
</div>
{% endblock %}
user_edit.html:
{% extends 'layout.html' %}
{% block content %}
<div class="container">
<div class="panel panel-default" style="width: 750px;margin-top: 10px">
<div class="panel-heading" style="margin-top: 0">编辑 用户</div>
<div class="panel-body">
<form class="form-horizontal" method="POST" action="/user/MForm_add/">
{% csrf_token %}
<!-- 输入框 -->
{% for items in form %}
<div class="form-group">
<label for="inputDepartmentName" class="col-sm-2 control-label">{
{ items.label }}</label>
<div class="col-sm-5">
{
{ items }}
<span style="color: red">{
{ items.errors.0 }}</span>
</div>
</div>
{% endfor %}
<!-- 提交按钮 -->
<div class="form-group">
<div class="col-sm-offset-2 col-sm-10">
<button type="submit" class="btn btn-primary">提 交</button>
</div>
</div>
</form>
</div>
</div>
</div>
{% endblock %}
感谢您的三连!!!