原文:https://www.cnblogs.com/linxiyue/p/4074562.html
InlineModelAdmin
class InlineModelAdmin
class TabularInline
class StackedInline
举例,有两个Model:
1
2
3
4
5
6
7
8
|
from
django.db
import
models
class
Author(models.Model):
name
=
models.CharField(max_length
=
100
)
class
Book(models.Model):
author
=
models.ForeignKey(Author)
title
=
models.CharField(max_length
=
100
)
|
如果想在Author页面上编辑book:
1
2
3
4
5
6
7
8
9
|
from
django.contrib
import
admin
class
BookInline(admin.TabularInline):
model
=
Book
class
AuthorAdmin(admin.ModelAdmin):
inlines
=
[
BookInline,
]
|
Django提供了两个InlineModelAdmin的子类:
TabularInline
StackedInline
区别在于使用的模板。
InlineModelAdmin options选项
InlineModelAdmin和ModelAdmin共通的options有:
form
fieldsets
fields
formfield_overrides
exclude
filter_horizontal
filter_vertical
ordering
prepopulated_fields
get_queryset()
radio_fields
readonly_fields
raw_id_fields
formfield_for_choice_field()
formfield_for_foreignkey()
formfield_for_manytomany()
has_add_permission()
has_change_permission()
has_delete_permission()
额外增加的options有:
InlineModelAdmin.model
inline使用的model,必需。
InlineModelAdmin.fk_name
model的name,当有多个外键时使用。
InlineModelAdmin.formset
缺省BaseInlineFormSet。
InlineModelAdmin.form
缺省ModelForm。当创建formset时传递给inlineformset_factory()。
InlineModelAdmin.extra
inline的额外数目。
InlineModelAdmin.get_extra()也返回inline的额外数目。
InlineModelAdmin.max_num
可展示得最大数目。
InlineModelAdmin.get_max_num()也返回此数字。
InlineModelAdmin.min_num
可展示的最小数目。
InlineModelAdmin.get_min_num()也返回此数目。
InlineModelAdmin.raw_id_fields
同ModelAdmin。
1
2
3
|
class
BookInline(admin.TabularInline):
model
=
Book
raw_id_fields
=
(
"pages"
,)
|
InlineModelAdmin.template
使用的模板。
InlineModelAdmin.verbose_name
覆盖meta class中的verbose_name。
InlineModelAdmin.verbose_name_plural
同上
InlineModelAdmin.can_delete
默认为True。
InlineModelAdmin.get_formset(request, obj=None, **kwargs)
参考ModelAdmin.get_formsets_with_inlines.
InlineModelAdmin.get_extra(request, obj=None, **kwargs)
1
2
3
4
5
6
7
8
|
class
BinaryTreeAdmin(admin.TabularInline):
model
=
BinaryTree
def
get_extra(
self
, request, obj
=
None
,
*
*
kwargs):
extra
=
2
if
obj:
return
extra
-
obj.binarytree_set.count()
return
extra
|
InlineModelAdmin.get_max_num(request, obj=None, **kwargs)
1
2
3
4
5
6
7
8
|
class
BinaryTreeAdmin(admin.TabularInline):
model
=
BinaryTree
def
get_max_num(
self
, request, obj
=
None
,
*
*
kwargs):
max_num
=
10
if
obj.parent:
return
max_num
-
5
return
max_num
|
InlineModelAdmin.get_min_num(request, obj=None, **kwargs)
见上。
多个 ForeignKey链向同一个Model的情况
如果有多个foreign keys:
1
2
3
4
5
|
from
django.db
import
models
class
Friendship(models.Model):
to_person
=
models.ForeignKey(Person, related_name
=
"friends"
)
from_person
=
models.ForeignKey(Person, related_name
=
"from_friends"
)
|
展示其中一个:
1
2
3
4
5
6
7
8
9
10
11
|
from
django.contrib
import
admin
from
myapp.models
import
Friendship
class
FriendshipInline(admin.TabularInline):
model
=
Friendship
fk_name
=
"to_person"
class
PersonAdmin(admin.ModelAdmin):
inlines
=
[
FriendshipInline,
]
|
Working with many-to-many models
model例子:
1
2
3
4
5
6
7
8
|
from
django.db
import
models
class
Person(models.Model):
name
=
models.CharField(max_length
=
128
)
class
Group(models.Model):
name
=
models.CharField(max_length
=
128
)
members
=
models.ManyToManyField(Person, related_name
=
'groups'
)
|
inlines展示:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
from
django.contrib
import
admin
class
MembershipInline(admin.TabularInline):
model
=
Group.members.through
class
PersonAdmin(admin.ModelAdmin):
inlines
=
[
MembershipInline,
]
class
GroupAdmin(admin.ModelAdmin):
inlines
=
[
MembershipInline,
]
exclude
=
(
'members'
,)
|
Note:
第一 , the MembershipInline类指向Group.members.through. The through attribute指向管理the many-to-many关系的数据库.
第二,, the GroupAdmin 必须排除the members字段.
Working with many-to-many intermediary models
明确指出中间model的例子:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
from
django.db
import
models
class
Person(models.Model):
name
=
models.CharField(max_length
=
128
)
class
Group(models.Model):
name
=
models.CharField(max_length
=
128
)
members
=
models.ManyToManyField(Person, through
=
'Membership'
)
class
Membership(models.Model):
person
=
models.ForeignKey(Person)
group
=
models.ForeignKey(Group)
date_joined
=
models.DateField()
invite_reason
=
models.CharField(max_length
=
64
)
|
第一步:
1
2
3
|
class
MembershipInline(admin.TabularInline):
model
=
Membership
extra
=
1
|
第二步:
1
2
3
4
5
|
class
PersonAdmin(admin.ModelAdmin):
inlines
=
(MembershipInline,)
class
GroupAdmin(admin.ModelAdmin):
inlines
=
(MembershipInline,)
|
第三步:
1
2
|
admin.site.register(Person, PersonAdmin)
admin.site.register(Group, GroupAdmin)
|
Using generic relations as an inline
一个inline with generically related objects例子:
1
2
3
4
5
6
7
8
9
10
11
|
from
django.db
import
models
from
django.contrib.contenttypes.fields
import
GenericForeignKey
class
Image(models.Model):
image
=
models.ImageField(upload_to
=
"images"
)
content_type
=
models.ForeignKey(ContentType)
object_id
=
models.PositiveIntegerField()
content_object
=
GenericForeignKey(
"content_type"
,
"object_id"
)
class
Product(models.Model):
name
=
models.CharField(max_length
=
100
)
|
如果想在Product add/change页面上编辑Image实例,可以使用GenericTabularInline或GenericStackedInline:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
from
django.contrib
import
admin
from
django.contrib.contenttypes.admin
import
GenericTabularInline
from
myproject.myapp.models
import
Image, Product
class
ImageInline(GenericTabularInline):
model
=
Image
class
ProductAdmin(admin.ModelAdmin):
inlines
=
[
ImageInline,
]
admin.site.register(Product, ProductAdmin)
|