enhancement
major
minor
major
minor
major
#29523
<sidebar> zeigt zwei der fünf Arten von Sidebar-Elementen an, die ReactSidebarControl rendert, und keines der Badges
Betrifft 8.0.0-alpha8. Wurde beim Neuaufbau der Navigationsleiste einer Anwendung in der React-View-Benutzeroberfläche festgestellt.
tl-layout-react rendert fünf Arten von Seitenleistenelementen und jeweils ein Badge. Mit tl-layout-view kann ein View-Autor zwei der fünf Elemente und keines der Badges deklarieren.
| tl-layout-react | vom Client gerendert? | @TagName in tl-layout-view |
| NavigationItem | ja | nav-item |
| SeparatorItem | ja | Trennzeichen |
| GroupItem — Beschriftung, Symbol, untergeordnete Elemente, anfänglich erweitert | ja | keine |
| HeaderItem — eine Gruppenüberschrift | ja | keine |
| CommandItem – ein Element, das einen Befehl ausführt | ja | keine |
Das Client-Bundle enthält alle fünf – c.type === „command“ ? … : c.type === "group" && … in script/tl-react-controls.js – und ReactSidebarControl liefert bereits die Gruppenmechanismen: TOGGLE_GROUP_COMMAND, _groupStates, die pro Gruppen-ID persistent gespeichert werden.
Bei NavigationItem selbst lassen sich zwei weitere Eigenschaften nicht konfigurieren:
- badge / setBadge – der Client rendert tlSidebar__badge und tlSidebar__badge--collapsed. NavItemConfig verfügt nur über label, icon, route und children.
- withHidden(boolean) – ein Element kann ausgeblendet werden; es gibt keine Deklaration dafür.
withRoute wird als „route“ bereitgestellt und funktioniert.
Die Sidebar hat keine Kopf- oder Fußzeile
Der Konstruktorvon `ReactSidebarControl` nimmt vier Inhaltsangaben für die Leiste selbst entgegen — `headerContent`, `headerCollapsedContent`, `footerContent`, `footerCollapsedContent`. `SidebarElement.createControl` übergibt für alle vier den Wert `null`:
149: aconst_null 150: aconst_null 151: aconst_null 152: aconst_null 153: invokespecial // ReactSidebarControl."<init>":(…;ReactControl;ReactControl;ReactControl;ReactControl;)V
SidebarElement.Config verfügt über „items“, „active-item“, „collapsed“ und „drawer-open-slot-name“ – für die vier gibt es nichts. Eine Rail kann also weder eine Kopfzeile über ihren Elementen noch eine Fußzeile darunter anzeigen, obwohl die Komponente, über die sie gerendert wird, beides unterstützt, einschließlich der zusammengeklappten Varianten.
Beachten Sie, dass <nav-item><children> nicht die Leiste ist: NavigationItem verwendet die untergeordneten Elemente als seine _contentFactory, d. h. als Inhaltsbereich des Elements im Arbeitsbereich. Es gibt keinen Pfad vom View-XML in das eigene Chrome der Leiste.
Warum das wichtig ist
Die betreffende Leiste enthält von oben nach unten: eine Beschriftung, einen Bereichsumschalter, eine Gruppe mit einer Beschriftung und je einem Eintrag pro Projekt, die jeweils ihre Dokumentanzahl anzeigen, eine zweite Gruppe mit Beschriftung sowie eine Fußzeile mit einer Schaltfläche und einer Notiz. Davon kann tl-layout-view die Beschriftungen, Symbole und Routen der Einträge darstellen. Die Beschriftungen, die Anzahlen, der Umschalter und die Fußzeile werden alle von „ReactSidebarControl“ unterstützt und sind von einer Ansicht aus nicht erreichbar.
Keine Lücke, sondern der Ausweg – es lohnt sich, dies zu dokumentieren
„SidebarElement.SidebarItemConfig“ ist eine „PolymorphicConfiguration<SidebarItemElement>“, und „SidebarItemElement“ ist eine Schnittstelle mit einer einzigen Methode:
SidebarItem createSidebarItem(ViewContext context);
So kann eine Anwendung ihr eigenes Element registrieren und eine beliebige Unterklasse von `SidebarItem` zurückgeben – einschließlich eines `GroupItem`, dessen untergeordnete Elemente sie zum Zeitpunkt des Aufrufs von `createSidebarItem` aus einer Modellabfrage aufbaut, wobei jedes mit einem Badge versehen ist. Auf diese Weise erhält die oben genannte Anwendung ihre dynamische Projektgruppe: ein Konfigurationselement, ausschließlich serverseitig, ohne React-Komponente und ohne clientseitige Erstellung.
Dies ist eine gute Nahtstelle. Sie ist nirgendwo dokumentiert und der einzige Grund, warum die oben genannten Lücken überbrückbar sind. Was sie jedoch nicht löst, sind die Kopf- und Fußzeile, da diese keine Elemente sind.
Vorgeschlagene Lösung
- Registriere @TagName`s für `GroupItem, HeaderItem und CommandItem, analog zu nav-item.
- Füge „badge“ und „hidden“ zu ` NavItemConfig` hinzu.
- Füge „header“, „header-collapsed“, „footer“ und „footer-collapsed“ zu `SidebarElement.Config` als `PolymorphicConfiguration<UIElement> ` (oder als Slot-Namen, wie bei ` drawer-open-slot-name`) hinzu und übergebe sie anstelle von `null`.
- Dokumentieren Sie ` SidebarItemElement ` als Erweiterungspunkt für berechnete Elemente.
Die Punkte 1 und 2 betreffen Konfigurationsanpassungen an bereits vorhandenem Code; Punkt 3 umfasst vier Konstruktorargumente.