Django中内置了Form和Model两个类,有时候页面的表单form类与Model类是一一对应,因此分别定义Form类和Model类会比较麻烦,最简单的方式就是通过Model来生成一个Form类,Django内置的ModelForm就是为此而生的.下面以一个简单的例子来说明它的简单用法.
基本需求
收集用户的日本报名信息
其中JLPT的日语等级分为N1,N2,N3,N4,N5;所以需要一个选择器.
用户需要手动输入姓名,因此需要一个输入框.
在Project中新建一个app
$ python manager startapp jlpt
文件目录结构如下所示
jlpt1/ ├── admin.py ├── __init__.py ├── models.py ├── tests.py └── views.py 0 directories, 5 files
添加URL规则
url(r‘^jlpt/‘, include(‘jlpt.urls‘)),
在jlpt目录下新建一个urls.py文件
from django.conf.urls import patterns, include, url urlpatterns = patterns(‘‘, url(r‘^$‘, ‘jlpt.views.home‘, name=‘home‘), )
如此一来,当用户在浏览器中输入http://yourdomain.com/jlpt
时,会导向到名叫home的view.下面我们来定义home这个view.
定义view
from django.shortcuts import render from django.http import HttpResponse from jlpt.forms import ExamInfoForm # Create your views here. def home(request): if request.method == ‘POST‘: form = ExamInfoForm(request.POST) if form.is_valid(): exam_info = form.save() exam_info.save() return HttpResponse(‘Thank you‘) else: form = ExamInfoForm() return render(request, ‘jlpt/index.html‘, {‘form_info‘: form})
当用户post表单时,利用POST数据新建一个ExamInfoForm,把Form中的内容保存成一个instance,然后将instance保存到数据库中.
当用户get表单时,新建一个空的ExamInfoForm.
ExamInfoForm这个类就是我们接下来要创建的ModelForm
创建ModelForm类
在jlpt目录下新建一个forms.py文件
from django.forms import ModelForm from jlpt.models import ExamInfo class ExamInfoForm(ModelForm): class Meta: model = ExamInfo fields = ‘__all__‘
ExamInfoForm继承自ModelForm,新建了一个Meta类,model的值为ExamInfo,这个ExamInfo就是一个Model类.
定义Model类
from django.db import models # Create your models here. LEVEL_CHOICES = ( (‘N1‘, ‘N1‘), (‘N2‘, ‘N2‘), (‘N3‘, ‘N3‘), (‘N4‘, ‘N4‘), (‘N5‘, ‘N5‘), (‘NO‘, ‘NO‘), ) class ExamInfo(models.Model): name = models.CharField(max_length=10) level = models.CharField(max_length=2, choices=LEVEL_CHOICES)
这样只需要定义一个Model类,就可以依此创建一个新的Form,当然Form是可以定制的,比如选择需要显示的字段.
添加template文件
<!DOCTYPE html> </html> <head> <title>报名情况统计</title> </head> <body> <p style="text-align:center;font-size:1.5em;">少年よ、大志を抱け!</p> <form action="/jlpt/" method="post"> {% csrf_token %} <fieldset> <legend>你要参加2014年7月JLPT的哪个等级考试?</legend> {{ form_info.as_p }} <input type="submit" value="submit" /> </fieldset> </form> </body> </html>
views.home中的return render(request, ‘jlpt/index.html‘, {‘form_info‘: form})
通过传递form
(这个html文件中为form_info
)来渲染这个页面.
添加后台管理
在jlpt目录下新建一个admin.py文件,代码如下
from django.contrib import admin from jlpt.models import ExamInfo # Register your models here. class ExamInfoAdmin(admin.ModelAdmin): list_display = [‘name‘, ‘level‘] admin.site.register(ExamInfo, ExamInfoAdmin)
通过http://www.yourdomain.com/admin登陆到后台管理系统时,可以看到数据分为name
和level
两列.
安装jlpt.
在project的settings.py文件中,为INSTALLED_APPS添加一个新的item.
# Application definition INSTALLED_APPS = ( ‘django.contrib.admin‘, ‘django.contrib.auth‘, ‘django.contrib.contenttypes‘, ‘django.contrib.sessions‘, ‘django.contrib.messages‘, ‘django.contrib.staticfiles‘, ‘your project name‘, ‘jlpt‘, )
完成,访问一下
Django的ModelForm简单用法