Frontend
Slots
Übersicht
Abschnitt betitelt „Übersicht“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.
Verwendung
Abschnitt betitelt „Verwendung“Über das <Rebase>-Prop
Abschnitt betitelt „Über das <Rebase>-Prop“<Rebase client={client} slots={[ { slot: "navigation.footer", Component: MyNavigationFooter, order: 10 }, { slot: "collection.actions", Component: BulkExportButton } ]}>Über ein Plugin
Abschnitt betitelt „Über ein Plugin“const myPlugin: RebasePlugin = { key: "my-plugin", slots: [ { slot: "home.cards", Component: AnalyticsCard, order: 20 } ]};Verfügbare Slots
Abschnitt betitelt „Verfügbare Slots“Startseite
Abschnitt betitelt „Startseite“| 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 |
Navigation
Abschnitt betitelt „Navigation“| 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 |
Sammlungsansicht
Abschnitt betitelt „Sammlungsansicht“| 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.
Entität / Formular
Abschnitt betitelt „Entität / Formular“| 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 |
Global / Shell
Abschnitt betitelt „Global / Shell“| 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 |
Referenz der Slot-Props
Abschnitt betitelt „Referenz der Slot-Props“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.
Verwandte Themen
Abschnitt betitelt „Verwandte Themen“- Komponenten-Overrides (Swizzling) – wenn ein Slot nicht ausreicht
- Rebase erweitern – der Rest der Erweiterungsoberfläche
- Plugins – Bereitstellen von Slot-Inhalten als Plugin