From b5f4d76bc400b9f2017da0a52ee4ff0d7c09be15 Mon Sep 17 00:00:00 2001 From: Maryam Yusuf Date: Mon, 24 Jun 2024 00:38:02 +0100 Subject: [PATCH] Fixed #35464 -- Updated docs to note fieldsets have limited impact on TabularInlines. --- docs/ref/contrib/admin/index.txt | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/docs/ref/contrib/admin/index.txt b/docs/ref/contrib/admin/index.txt index 504ab62368c..6af21407177 100644 --- a/docs/ref/contrib/admin/index.txt +++ b/docs/ref/contrib/admin/index.txt @@ -437,9 +437,7 @@ subclass:: * ``description`` A string of optional extra text to be displayed at the top of each - fieldset, under the heading of the fieldset. This string is not - rendered for :class:`~django.contrib.admin.TabularInline` due to its - layout. + fieldset, under the heading of the fieldset. Note that this value is *not* HTML-escaped when it's displayed in the admin interface. This lets you include HTML if you so desire. @@ -447,6 +445,17 @@ subclass:: :func:`django.utils.html.escape` to escape any HTML special characters. + .. admonition:: :class:`~django.contrib.admin.TabularInline` has limited + support for ``fieldsets`` + + Using ``fieldsets`` with :class:`~django.contrib.admin.TabularInline` + has limited functionality. You can specify which fields will be + displayed and their order within the ``TabularInline`` layout by + defining ``fields`` in the ``field_options`` dictionary. + + All other features are not supported. This includes the use of ``name`` + to define a title for a group of fields. + .. attribute:: ModelAdmin.filter_horizontal By default, a :class:`~django.db.models.ManyToManyField` is displayed in