Zum Inhalt springen

Frontend

Slots

Slots sind benannte UI-Erweiterungspunkte, an denen Sie benutzerdefinierte React-Komponenten einfügen können. Jeder Slot verfügt über typisierte Props, die für seine Position in der UI spezifisch sind. Rebase wird mit 27 integrierten Slots ausgeliefert, die die Startseite, die Navigation, Sammlungsansichten, Entitätsformulare, die App-Leiste und mehr abdecken.

Jeder Slot in der folgenden Tabelle wird gerendert. Wenn Sie eine Komponente für einen Slot registrieren und nichts sehen, liegt der Fehler in Ihrer Komponente oder deren Props, nicht im Slot – UNRENDERED_SLOTS in @rebasepro/cms-types ist leer, und ein Test leitet diese Liste durch das Scannen nach Render-Stellen ab, sodass ein Slot hier nicht ohne eine solche deklariert werden kann.

<Rebase
client={client}
slots={[
{
slot: "navigation.footer",
Component: MyNavigationFooter,
order: 10
},
{
slot: "collection.actions",
Component: BulkExportButton
}
]}
>
const myPlugin: RebasePlugin = {
key: "my-plugin",
slots: [
{
slot: "home.cards",
Component: AnalyticsCard,
order: 20
}
]
};
Slot Props-Typ Beschreibung
home.actions PluginGenericProps Aktionen im Header der Startseite
home.cards PluginHomePageAdditionalCardsProps Zusätzliche Karten auf der Startseite
home.children.start PluginGenericProps Inhalt am Anfang der Startseite
home.children.end PluginGenericProps Inhalt am Ende der Startseite
home.card.widget HomeCardWidgetSlotProps Kompaktes Widget innerhalb einer Sammlungskarte auf der Startseite
home.collection.actions PluginHomePageActionsProps Aktionen auf Sammlungskarten der Startseite
Slot Props-Typ Beschreibung
navigation.header NavigationSlotProps Unter dem Logo im Sidebar-Drawer
navigation.footer NavigationSlotProps Über dem Collapse-Umschalter am unteren Rand des Drawers
Slot Props-Typ Beschreibung
collection.actions CollectionActionsProps Toolbar-Aktionen am Ende (nach den Sammlungs-Actions)
collection.actions.start CollectionActionsProps Toolbar-Aktionen am Anfang (neben den Filtern)
collection.header.action CollectionHeaderActionProps Aktionsschaltflächen in Spaltenüberschriften
collection.add-column CollectionAddColumnProps „Spalte hinzufügen“-Bereich im Tabellen-Header
collection.error CollectionErrorProps Fehlerstatusanzeige für eine Sammlung
collection.toolbar CollectionToolbarProps Zusätzliche Widgets innerhalb der Sammlungs-Toolbar-Zeile
collection.empty-state CollectionEmptyStateProps Benutzerdefinierter Empty-State, wenn die Sammlung keine Daten enthält
collection.widgets CollectionWidgetsSlotProps Widgets oberhalb der Sammlungstabelle

Wenn einem Sammlungs-Slot der tableController oder selectionController der Ansicht übergeben wird, übermitteln diese Zeilen so, wie der Server sie sendet: tableController.rows (mit ihren IDs an denselben Positionen in tableController.ids, loading, error sowie Filter, Suche und Sortierung der Toolbar) und eine Auswahl nach ID – selection ist { type: "rows", ids, rows } oder { type: "query", query, excludedIds, count }, und isSelected(id) fragt eine einzelne Zeile ab.

Slot Props-Typ Beschreibung
form.actions PluginFormActionProps Aktionen in der Aktionsleiste des Entitätsformulars. Übergibt die id des Datensatzes (fehlt, solange er neu ist), path, status, collection und formContext
form.actions.top PluginFormActionProps Aktionen oberhalb der Formular-Aktionsleiste
form.before PluginFormActionProps Inhalt vor dem Formulartitel/der Feldliste
form.after PluginFormActionProps Inhalt nach der Formularfeldliste
entity.row.actions EntityRowActionsProps Zeilenbasierte Aktionen in Sammlungstabellen, neben den integrierten Zeilentools. Übergibt die Zeile, wie der Server sie sendet (row), deren id, path, collection, den selectionController der Tabelle und context
entity.field.before EntityFieldSlotProps Vor einem einzelnen Formularfeld eingefügte UI. Übergibt propertyKey und property des Felds sowie path und id des Datensatzes (fehlt, solange er neu ist)
entity.field.after EntityFieldSlotProps Nach einem einzelnen Formularfeld eingefügte UI
Slot Props-Typ Beschreibung
global.search GlobalSearchProps Sammlungsübergreifende Suche in der App-Leiste neben den Breadcrumbs
shell.toolbar ShellToolbarProps Aktionen auf oberster Ebene am Ende der App-Leiste
Slot Props-Typ Beschreibung
kanban.setup KanbanSetupProps Setup-UI für das Kanban-Board
kanban.add-column KanbanAddColumnProps „Spalte hinzufügen“ in der Kanban-Ansicht

Alle Slot-Prop-Typen werden aus @rebasepro/cms-types exportiert und können für typsichere Slot-Komponenten importiert werden:

import type { CollectionActionsProps, NavigationSlotProps } from "@rebasepro/cms-types";

Jeder Props-Typ bietet Zugriff auf den Kontext, der für die Position des Slots relevant ist – Sammlungsmetadaten, Entitätsdaten, Navigationsstatus und mehr. Die vollständigen Property-Details entnehmen Sie bitte den einzelnen Typdefinitionen.