[5.1.x] Fixed #35464 -- Updated docs to note fieldsets have limited impact on TabularInlines.

Backport of b5f4d76bc4 from main.
This commit is contained in:
Maryam Yusuf 2024-06-24 00:38:02 +01:00 committed by Sarah Boyce
parent ebcbf73153
commit bdfcda8c26
1 changed files with 12 additions and 3 deletions

View File

@ -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