class InlineModelAdmin
class TabularInline
class StackedInline
舉例，有兩個Model：
from django.db import modelsclass 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：
from django.contrib import adminclass BookInline(admin.TabularInline): model = Bookclass AuthorAdmin(admin.ModelAdmin): inlines = [ BookInline, ]
Django提供了兩個InlineModelAdmin的子類:
TabularInline
StackedInline
區別在于使用的模板。
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。
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)
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)
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)
見上。
如果有多個foreign keys：
from django.db import modelsclass Friendship(models.Model): to_person = models.ForeignKey(Person, related_name="friends") from_person = models.ForeignKey(Person, related_name="from_friends")
展示其中一個：
from django.contrib import adminfrom myapp.models import Friendshipclass FriendshipInline(admin.TabularInline): model = Friendship fk_name = "to_person"class PersonAdmin(admin.ModelAdmin): inlines = [ FriendshipInline, ]
model例子：
from django.db import modelsclass 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展示：
from django.contrib import adminclass MembershipInline(admin.TabularInline): model = Group.members.throughclass 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字段.
明確指出中間model的例子：
from django.db import modelsclass 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)
第一步：
class MembershipInline(admin.TabularInline): model = Membership extra = 1
第二步：
class PersonAdmin(admin.ModelAdmin): inlines = (MembershipInline,)class GroupAdmin(admin.ModelAdmin): inlines = (MembershipInline,)
第三步：
admin.site.register(Person, PersonAdmin)admin.site.register(Group, GroupAdmin)
一個inline with generically related objects例子：
from django.db import modelsfrom django.contrib.contenttypes.fields import GenericForeignKeyclass 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：
from django.contrib import adminfrom django.contrib.contenttypes.admin import GenericTabularInlinefrom myproject.myapp.models import Image, Productclass ImageInline(GenericTabularInline): model = Imageclass ProductAdmin(admin.ModelAdmin): inlines = [ ImageInline, ]admin.site.register(Product, ProductAdmin)
新聞熱點
疑難解答
