Django ModelForm and Form

Django的ModelForm组件,djangomodelform

 

django表单系统中,所有的表单类都作为django.forms.Form的子类创建,包括ModelForm

Django中ModelForm的应用

1.设计思路

根据每页显示数据量对数据进行切片显示。根据/index.html?p=4用GET方法获取页码

 1 def index(request):
 2     per_page_count=10 
 3     current_page=request.GET.get('p')
 4     current_page=int(current_page)
 5     start=(current_page-1)*per_page_count
 6     end=current_page*per_page_count
 7     data=USER_LIST[start:end]
 8 
 9     if current_page<=1:
10         prev_page=1
11         next_page = current_page + 1
12     else:
13         prev_page=current_page-1
14         next_page=current_page+1
15     return render(request,"index.html",{'user_list':data,'prev_page':prev_page,'next_page':next_page})

1 <body>
2 <ul>
3     {% for row in user_list %}
4         <li>{{ row.name }}-{{ row.age }}</li>
5     {% endfor %}
6 </ul>
7 <a href="/index.html?p={{%20prev_page%20}}">上一页</a>
8 <a href="/index.html?p={{%20next_page%20}}">下一页</a>
9 </body>

创建类

from django.forms import ModelForm
from django.forms import widgets as wd
from app01 import models

class 类名(ModelForm):
    class Meta:
         model = models.表名         #models中的表名
         fields="__all__",                     # 字段
         exclude=None,                  # 排除字段
         widgets=None,                   # 自定义插件
         error_messages=None,       # 自定义错误信息(整体错误信息from django.core.exceptions import NON_FIELD_ERRORS)


    def clean_字段名         #自定义钩子函数

?

关于django的表单系统,主要分两种

在传统中Form提交的POST的数据在服务器端获取时将不得不一一获取并验证数据的可靠性,但是使用django提供的Form时可简化该过程并提供相应的验证,同时Django还提供了Form与Model的结合即formModel,该模型可以直接获取表单的数据后直接保存到数据库中,同时有表单验证功能。

威尼斯官方网站,2.Django原生分页组件

Django封装的两个对象Paginator和page对象,通过输入的参数对数据进行处理得到各种属性,且两个对象互相包含。

Paginator对象 参数有全部数据的数组,以及每页显示条目数量,函数内部封装了对象的各项属性
# 全部数据:USER_LIST,=》得出共有多少条数据
# per_page: 每页显示条目数量
# count:    数据总个数
# num_pages:总页数
# page_range:总页数的索引范围,如: (1,10),(1,200)
# page:     page对象(是否具有下一页;是否有上一页;)

Page对象 参数为当前的页码
# has_next              是否有下一页
# next_page_number      下一页页码
# has_previous          是否有上一页
# previous_page_number  上一页页码
# object_list           分页之后的数据列表,已经切片好的数据
# number                当前页
# paginator             paginator对象

from django.core.paginator import Paginator,EmptyPage,PageNotAnInteger

 1 def index1(request):
 2     current_page=request.GET.get('p')
 3     paginator=Paginator(USER_LIST, 10)
 4     try:
 5         posts=paginator.page(current_page)   
 6     except PageNotAnInteger:
 7         posts=paginator.page(1)
 8     except EmptyPage:
 9         posts=paginator.page(paginator.num_pages)
10     return render(request,"index1.html",{"posts":posts})

 1 <ul>
 2     {% for row in posts.object_list %}
 3         <li>{{ row.name }}-{{ row.age }}</li>
 4     {% endfor %}
 5 </ul>
 6 {% if posts.has_previous %}
 7 <a href="/index1.html?p={{%20posts.previous_page_number%20}}">上一页</a>
 8 {% else %}
 9 <a href="#">上一页</a>
10 {% endif %}
11 {% for i in posts.paginator.pager_num_range %}
12     {% if i == posts.number  %}
13         <a style="font-size: 30px;" href="/index1.html?p={{%20i%20}}">{{ i }}</a>
14     {% else %}
15         <a href="/index1.html?p={{%20i%20}}">{{ i }}</a>
16     {% endif %}
17 {% endfor %}
18 {% if posts.has_next %}
19 <a href="/index1.html?p={{%20posts.next_page_number%20}}">下一页</a>
20 {% endif %}
21 
22     {{ posts.number }}/{{ posts.paginator.num_pages }}
23 

可做出类似  上一页 下一页 1/100 
的分页效果

实例化对象

form = 类名(instance=obj,data=request.POST)

instance传的是已有的对象(在页面中显示默认值)
data传的是从页面返回过来的值(用户输入的值 ,用来验证)

form.is_valid() #威尼斯人线上娱乐,验证

form.save  
#将数据保存至数据库中(如果有instance参数就修改数据库中的记录,如果没有instance参数就在数据库中添加新的一条记录)

 

创建类
from django.forms import ModelForm from django.forms import widgets as
wd from app01 import models class 类名(ModelForm): cla…

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
ModelForm
    a.  class Meta:
            model,                           # 对应Model的
            fields=None,                     # 字段
            exclude=None,                    # 排除字段
            labels=None,                     # 提示信息
            help_texts=None,                 # 帮助提示信息
            widgets=None,                    # 自定义插件
            error_messages=None,             # 自定义错误信息(整体错误信息from django.core.exceptions import NON_FIELD_ERRORS)
            field_classes=None               # 自定义字段类 (也可以自定义字段)
            localized_fields=('birth_date',) # 本地化,如:根据不同时区显示数据
            如:
                数据库中
                    2016-12-27 04:10:57
                setting中的配置
                    TIME_ZONE = 'Asia/Shanghai'
                    USE_TZ = True
                则显示:
                    2016-12-27 12:10:57
    b. 验证执行过程
        is_valid -> full_clean -> 钩子 -> 整体错误
 
    c. 字典字段验证
        def clean_字段名(self):
            # 可以抛出异常
            # from django.core.exceptions import ValidationError
            return "新值"
    d. 用于验证
        model_form_obj = XXOOModelForm()
        model_form_obj.is_valid()
        model_form_obj.errors.as_json()
        model_form_obj.clean()
        model_form_obj.cleaned_data
    e. 用于创建
        model_form_obj = XXOOModelForm(request.POST)
        #### 页面显示,并提交 #####
        # 默认保存多对多
            obj = form.save(commit=True)
        # 不做任何操作,内部定义 save_m2m(用于保存多对多)
            obj = form.save(commit=False)
            obj.save()      # 保存单表信息
            obj.save_m2m()  # 保存关联多对多信息
 
    f. 用于更新和初始化
        obj = model.tb.objects.get(id=1)
        model_form_obj = XXOOModelForm(request.POST,instance=obj)
        ...
 
        PS: 单纯初始化
            model_form_obj = XXOOModelForm(initial={...})
  • 基于django.forms.Form
  • 基于django.forms.ModelForm

 

3.自定义分页组件

通过继承原生分页组件自定制分页功能

 1 class CustomPaginator(Paginator):
 2     def __init__(self,current_page, per_pager_num,*args,**kwargs):
 3         # 当前页
 4         self.current_page = int(current_page)
 5         # 最多显示的页码数量 11
 6         self.per_pager_num = int(per_pager_num)
 7         super(CustomPaginator,self).__init__(*args,**kwargs)
 8     def pager_num_range(self):
 9         # 当前页
10         #self.current_page
11         # 最多显示的页码数量 11
12         #self.per_pager_num
13         # 总页数
14         # self.num_pages
15         if self.num_pages < self.per_pager_num:
16             return range(1,self.num_pages+1)
17         # 总页数特别多 5
18         part = int(self.per_pager_num/2)
19         if self.current_page <= part:
20             return range(1,self.per_pager_num+1)
21         if (self.current_page + part) > self.num_pages:
22             return range(self.num_pages-self.per_pager_num+1,self.num_pages+1)
23         return range(self.current_page-part,self.current_page+part+1)

效果如下:
上一页 1 2 3 4 5 6 7 8 9 10 11 下一页 6/100

  

表单API

表单有两种状态,绑定,未绑定 Form.is_bound()
Form.is_valid()
验证表单数据是否合法,返回True或者False

Form.errors 错误字典

Form.has_error(field,code=None)

Form.initial 在表单未绑定的情况下,为表单字段设置初始值,

>>> f=ContactForm(initial={'subject':'Hi there'})

Form.has_changed() 检查表单数据是否变化

From.cleaned_data
表单通过验证后,可以使用cleaned_data属性来访问‘清洁’的数据

Form.as_p() 将表单渲染成< p >标签
From.as_ul() 将表单渲染成< ul >标签
From.as_table() 将表单渲染成< table > 标签
但是这些都得自己添加<table ></table>;< ul >< /ul
>标签

Form.py

4.bootstrap自定制样式

 1 {#bootstrap自定制样式#}
 2 <nav aria-label="Page navigation">
 3   <ul class="pagination">
 4     <li>
 5       {% if posts.has_previous %}
 6       <a href="/index1.html?p={{%20posts.previous_page_number%20}}" aria-label="Previous">
 7         &laquo;
 8       </a>
 9        {% else %}
10         <a href="#" aria-label="Previous">
11         &laquo;
12       </a>
13         {% endif %}
14     </li>
15     {% for i in posts.paginator.pager_num_range %}
16     {% if i == posts.number  %}
17         <li class="active"><a  href="/index1.html?p={{%20i%20}}">{{ i }}</a></li>
18     {% else %}
19         <li><a href="/index1.html?p={{%20i%20}}">{{ i }}</a></li>
20     {% endif %}
21     {% endfor %}
22     <li>
23       <a href="/index1.html?p={{%20posts.next_page_number%20}}" aria-label="Next">
24         &raquo;
25       </a>
26     </li>
27   </ul>
28 </nav>
设置表单必填行与错误行的样式

Form.error_css_class
Form.required_css_class

from django import forms
class ContactForm(Form):
    error_css_class = 'error'      #错误行样式在HTML中表示class='error'
    required_css_class = 'required' #必填样式在Html中表示clss=‘required’

然后在css文件中定义error与required类就行了

#encoding:utf-8
from django import forms
from django.forms import ModelForm
from models import Supplier, sysType

class SupplierForm(forms.ModelForm):
    #ModelForm生成downlist下拉框
    def __init__(self,*args,**kwargs):
        super(SupplierForm,self).__init__(*args,**kwargs)
        self.fields['systemType'].widget.choices = sysType.objects.all().values_list('id','sysDesc')
    class Meta:
        model=Supplier
        exclude={'id',}

models.py

class Supplier(models.Model):
    name=models.CharField("供应商名称",max_length=100,null=False)
    sales=models.CharField("销售人员",max_length=10,null=False)
    sales_phone=models.CharField("销售电话号码",max_length=20,null=True)
    engineer=models.CharField("技术人员",max_length=10,null=True)
    engineer_phone=models.CharField("技术人员电话号码",max_length=20,null=True)
    systemType=models.ForeignKey('sysType',verbose_name='系统类型')
    createDate=models.DateTimeField("创建日期",auto_now_add=True)
    updateDate=models.DateTimeField("更新日期",auto_now=True)
views.py

form_p=SupplierForm(request.POST)
if SupplierForm.is_valid:
    form_p.save()
    page_id=str(uuid.uuid4())
    return render_to_response(urlconfig.index,{'form':SupplierForm()})
前端页面

{{ form.as_p }}

 

 

 

 5.完全脱离Django内置模块的自写分页组件

 1 class Pagination(object):
 2     def __init__(self,totalCount,currentPage,perPageItemNum=10,maxPageNum=7):
 3         # 数据总个数
 4         self.total_count = totalCount
 5         # 当前页
 6         try:
 7             v = int(currentPage)
 8             if v <= 0:
 9                v = 1
10             self.current_page = v
11         except Exception as e:
12             self.current_page = 1
13         # 每页显示的行数
14         self.per_page_item_num = perPageItemNum
15         # 最多显示页面
16         self.max_page_num = maxPageNum
17 
18     def start(self):
19         return (self.current_page-1) * self.per_page_item_num
20 
21     def end(self):
22         return self.current_page * self.per_page_item_num
23     @property
24     def num_pages(self):
25         """
26         总页数
27         :return:
28         """
29         # 666
30         # 10
31         a,b = divmod(self.total_count,self.per_page_item_num)
32         if b == 0:
33             return a
34         return a+1
35 
36     def pager_num_range(self):
37         # self.num_pages()
38         # self.num_pages
39         # 当前页
40         #self.current_page
41         # 最多显示的页码数量 11
42         #self.per_pager_num
43         # 总页数
44         # self.num_pages
45         if self.num_pages < self.max_page_num:
46             return range(1,self.num_pages+1)
47         # 总页数特别多 5
48         part = int(self.max_page_num/2)
49         if self.current_page <= part:
50             return range(1,self.max_page_num+1)
51         if (self.current_page + part) > self.num_pages:
52             return range(self.num_pages-self.max_page_num+1,self.num_pages+1)
53         return range(self.current_page-part,self.current_page+part+1)
54 
55     def page_str(self):
56         page_list = []
57 
58         first = "<li><a href='/index2.html?p=1'>首页</a></li>"
59         page_list.append(first)
60 
61         if self.current_page == 1:
62             prev = "<li><a href='#'>上一页</a></li>"
63         else:
64             prev = "<li><a href='/index2.html?p=%s'>上一页</a></li>" %(self.current_page-1,)
65         page_list.append(prev)
66         for i in self.pager_num_range():
67             if i == self.current_page:
68                 temp = "<li class='active'><a href='/index2.html?p=%s'>%s</a></li>" %(i,i)
69             else:
70                 temp = "<li><a href='/index2.html?p=%s'>%s</a></li>" % (i, i)
71             page_list.append(temp)
72 
73         if self.current_page == self.num_pages:
74             nex = "<li><a href='#'>下一页</a></li>"
75         else:
76             nex = "<li><a href='/index2.html?p=%s'>下一页</a></li>" % (self.current_page + 1,)
77         page_list.append(nex)
78 
79         last = "<li><a href='/index2.html?p=%s'>尾页</a></li>" %(self.num_pages,)
80         page_list.append(last)
81 
82         return ''.join(page_list)

适用于各种框架

 

配置表单元素的HTML id属性,< label >标签

Form.auto_id

>>> f = ContactForm(auto_id=False) #这样在html中表单不包含< label >标签
>>> f = ContactForm(auto_id=True) #在html中表单<label>标签将为每个表单的id
>>> f = ContactForm(auto_id='id_for_%s') #在html中表单<label>标签为id_for_字段id

From.prefix 可以为Django表单添加一个命名空间
>>> mother = PersonForm(prefix=’mother’)
>>> father = PersonForm(prefix=’father’)

Field.required 表示该字段为必填 缺省为必填项,如需要指定不为必须

>>> f=forms.CharField(required=True)

Field.label 表示友好的label,表单在页面显示时用到它

name=from.CharField(label="Your name")

Field.help_text 显示字段描述文本

Field.error_message 覆盖默认的错误信息

name = forms.CharField(error_messages={'required':'Please enter your name'}) #覆盖required的默认错误信息
widget

widget 负责渲染网页上的HTML表单

设置weidget实例样式 利用widget.attrs

class CommentForm(forms.Form):
    name=forms.CharField(widget=forms.TextInput(attrs={'class':'special'}))
    comment = forms.CharField(widget= forms.TextInput(attrs={'size':'40'}))

自定义了name字段的输入样式为类 special
comment更改的大小为40

内建的weidget

TextInput
NumberInput
EmailInput
URLInput
PasswprdInput
HiddenInput
DateInput 日期
DateTimeInput 日期/时间
TimeInput 时间
Textarea
CheckboxInput
Select
NullBooleanSelect 渲染成 unknown,yes,no三个选项
SelectMultiple
RadioSelect
CheckboxSelectMultiple 复选框列表
FileInput 文件上传
SelectDateWidget

ModelForm表单

from django.forms import ModelForm
from myapp.models import Article
class ArticleForm(ModelForm):
    class Meta:
        model = Article  #表单对应的model
        fields = ['pub_date', 'headline', 'content', 'reporter']  #表单中显示的字段,对应models.py中对应的字段

使用的时候可以如下:

>>>form =  ArticleForm()
>>>article = Article.objects.get(pk=1)
>>>form = ArticleForm(instance = article)  #赋值instance可以使form表单是可以接受对象的数据   

save()方法

每一个ModelForm都有一个save()方法,这个方法可以更具绑定的form表单创建并且保存一个数据库对象,ModelForm的子类可以接受一个model的子类作为instance的参数,如果存在那么save()方法会更新这个实例,否则会创建一个新的实例

save(commit=False)

save()方法接受一个commit的参数,其值为True或者False。默认为True。
如果你声明
save(commit=False),那么它就会返回一个还未保存至数据库的对象,这样的话
你可以用这个对象添加一些额外的数据,然后在用save()保存到数据库

def edit(request,sid):
    edit_obj = get_object_or_404(PointRule,id=sid)
    if request.method == 'POST':
        form = PointRuleForm(request.POST.copy(),instance=edit_obj)
        if form.is_valid():
            point = form.save(commit=False)
            point.update_user = request.user  #在form.save(commit=False时,添加一些表单中未有的数据)
            point.save()
            return redirect('point:index')
        else:
            messages.error(request, u'数据验证错误')
    else:
        form = PointRuleForm(instance=edit_obj)
        return render(request,'point/edit.html',locals())

save_m2m()方法

在save(commit=False)的时候,如果你的model中含有many-to-many的数据模型,那么你将无法使用save()方法去保存数据,只能使用save_m2m()方法来保存
在为声明ave(commit=False),则不用如此保存,用save()就好了..

Selecting the fields to use

1.选择model中所有字段为表单中的字段

__all__

例子

from django.forms import ModelForm
class AuthorForm(ModelForm)
    class Meta:
         model = Author
         fields='__all__'

2.剔除指定字段的所有数据 exclude

class PartialAuhorForm(ModelForm):
    class Meta:
        model = Author
        exclude = ['title'] #添加Author model中出了titile字段的所有字段至PartialAuhorForm表单

覆盖字段的默认值

form django.forms import ModelForm, Textarea
form myapp.models import Author
    class AuthorForm(ModelForm):
        class Meta:
            model=Author
            fields=('name','title','birth_date')
            widgets={'name':Textarea(attrs={'cols':80,'rows':20})}

 from django.utils.translation import ugettext_lazy as _
 class AuthorForm(ModelForm):
      class Meta:
          model=Author
          fields=('name','title','birth_date')
          labels = { 'name':_('Writer'), }
          help_texts = {'name':_('some useful help text.'),}
          error_messages={ 'name':{'max_length':_("this writer name is too long")} }

相关文章