Changelist

Added in 1.0.1

The changelist is the ModelAdmin list page. Chassis keeps Django's result table and bulk actions, then rebuilds the chrome around them: breadcrumbs, toolbar, tabs, search, date hierarchy, and filters all sit in Chassis fieldsets.

Template: admin/chassis/change_list.html (extends admin/change_list.html). Stock {% block filters %}, {% block search %}, and {% block date_hierarchy %} are emptied so those controls are not rendered twice.

Every field below is documented in the Options catalog. This page explains how the page is assembled.

Page anatomy

┌─ breadcrumbs ─────────────────────────────────────────────┐
│  Dashboard  ›  Sidebar section  ›  Model verbose name     │
├─ toolbar (`page_actions` / `object-tools`) ───────────────┤
│  [list actions…]  [Import]  [Export]  [+ Add]             │
├─ controls stack (`chassis-changelist-controls`) ──────────┤
│  Tabs fieldset     FieldTabs / ForeignKeyTabs             │
│  Search fieldset   SearchOption                           │
│  Dates fieldset    DateHierarchyOption                    │
│  Filters fieldset  FiltersOption                          │
├─ results fieldset ────────────────────────────────────────┤
│  Django bulk actions (top)                                │
│  Result table: list_display + last-column row actions     │
│  Django bulk actions (bottom)                             │
│  Pagination                                               │
└───────────────────────────────────────────────────────────┘

Region	Driven by	Notes
Breadcrumbs	AdminSidebarService	Section label only if the model is in sidebar_items
List actions	ListActionsOption	Named URLs; may render disabled
Import / Export	ImportOption / ExportOption	Injected as list actions
Add	has_add_permission + Settings.allow_standard_add	Hidden when either is false
Choice tabs	FieldTabsOption	One row of buttons or a select
FK tabs	ForeignKeyTabsOption	One group per ForeignKeyTabGroupOption
Search	SearchOption	Collapsed via Settings.search_collapsed
Dates	DateHierarchyOption	Collapsed via Settings.date_hierarchy_collapsed
Filters	FiltersOption	Collapsed via Settings.filters_collapsed
Table columns	Django list_display	Badge / decimal / JSON fields are rewritten
Last column	RowActionsOption	Default: view icon

chassis_link_first_column = False (mixin default) means the first column is plain text. The intended entry point is a row action.

How options are applied

On ChassisAdminMixin.__init__:

1. SearchOption.fields is written to instance search_fields.
2. DateHierarchyOption.field is written to instance date_hierarchy.
3. Badge, pretty-JSON, and decimal display methods are generated.
4. List-action condition_method names are validated as @classmethod.

On changelist_view:

1. Tabs and FK tab groups become context (tabs, tab_groups, field_tab_display).
2. Search / filters / date hierarchy titles and collapsed flags go into context.
3. _get_chassis_list_actions merges ListActionsOption with import/export buttons.

Query-string parameters of tabs, search, and filters are preserved when you follow Add or a row action.

Search

from django_chassis.options import SearchOption

SearchOption(fields=['title', 'isbn'], fieldset_title='Search', placeholder='Title or ISBN')

Parameter	Type	Default
fields	list[str]	required — becomes search_fields
fieldset_title	localized string	Search / Поиск
placeholder	localized string	''

Lookups are Django's: default icontains, ^ prefix, = exact, @ full text.

Filters

from django_chassis.options import FiltersOption

FiltersOption(fields=['status', 'author'], fieldset_title='Filters')

fields accepts the same values as Django list_filter (field names, related lookups, SimpleListFilter subclasses). The stock right-hand filter sidebar is not used.

Date hierarchy

from django_chassis.options import DateHierarchyOption

DateHierarchyOption(field='published_at')

Parameter	Type	Default
field	model date/datetime field	required
fieldset_title	localized string	Dates / Даты

Field tabs

Choice-based tabs (or a select) that filter the changelist.

from django_chassis.enums import TabDisplay
from django_chassis.options import FieldTabsOption

FieldTabsOption(field='status', choices=Book.Status.choices, display=TabDisplay.BUTTONS, all_label='All')

Parameter	Type	Default
field	model field name	required
choices	list of (value, label)	required
display	TabDisplay.BUTTONS or SELECT	BUTTONS
all_label	localized string	All / Все
fieldset_title	localized string	Tabs

Each tab is a GET link. "All" drops the query parameter.

Foreign-key tabs

One or more FK-based tab groups. Attach one ForeignKeyTabsOption and put every group in groups.

from django_chassis.options import ForeignKeyTabGroupOption, ForeignKeyTabsOption

ForeignKeyTabsOption(groups=[ForeignKeyTabGroupOption(field='author', model=Author, label='Authors')])

ForeignKeyTabsOption also accepts a single-group shortcut via field and model instead of groups. Full field tables: Options catalog.

Collapsed fieldsets

Settings.search_collapsed, filters_collapsed, and date_hierarchy_collapsed control the initial state. See ModelAdmin and Options catalog.

See also

• Options catalog
• Presentation
• Row and list actions
• Related entities