NavTree
Navigationsbaum wie das Ordnermenü von Outlook: Gruppen (NavTreeGroup) mit Kopfzeile aus Farbpunkt, Titel, Status und Aktionen,
darunter Einträge (NavTreeNode) mit Einrückung, Pfeil zum Auf- und Zuklappen, Symbol, Zähler und „…“-Menü. Einträge können
Ziel beim Ziehen sein (OnDrop); der Klapp-Zustand bleibt mit StorageKey im Browser. Der Baum ist mit der Tastatur
bedienbar, klappt zum aktiven Eintrag auf, lädt Kinder auf Wunsch erst beim Aufklappen (LazyChildren, OnLoadChildren)
und lässt sich über Vorlagen und CSS-Variablen anpassen. Für Ordner mit Dokumenten gibt es OrdnerBaum.
Ordner mehrerer Postfächer
Ordnermenü wie in Outlook: Sammelansichten oben, darunter je Postfach die Ordner mit Unterordnern und Zähler. Den Zettel auf einen Ordner ziehen, um ihn abzulegen; „…“ oder ein Rechtsklick auf einen Büro-Ordner öffnet das Menü.
Tastatur, Vorlagen und Nachladen
Projektbaum mit Tastatur: In den Baum tabben, dann Pfeiltasten, Pos1/Ende und Anfangsbuchstaben; F2 und Entf melden OnNodeKeyDown,
Umschalt+F10 öffnet das Menü. „Archiv“ lädt seine Kinder erst beim Aufklappen, „Gesperrt“ ist nicht wählbar. Eigene Darstellung über
NodeTemplate und NodeEndContent, engere Einrückung und andere Hervorhebung über CSS-Variablen.
SKILL.md – Navtree
--- name: NavTree description: Onesown Blazor Komponente NavTree (Navigation). Verwende diesen Skill wenn du die NavTree-Komponente verwenden, konfigurieren oder debuggen moechtest. --- # NavTree **Namespace:** `Onesown.Blazor.Components` **Kategorie:** Navigation **Basisklasse:** `OoComponentBase` Navigationsbaum wie das Ordnermenü von Outlook: Gruppen mit Kopfzeile (Farbpunkt, Titel, Status, Aktionen) und darunter Einträge mit Einrückung, Pfeil zum Auf- und Zuklappen, Symbol, Zähler und „…“-Menü. Einträge können Ziel beim Ziehen sein (OnDrop); der Klapp-Zustand bleibt auf Wunsch im Browser gespeichert. Bedienbar mit der Tastatur, Kinder lassen sich erst beim Aufklappen laden. **Live-Demo:** https://components.schini.com/demo/navtree ## Parameter | Parameter | Typ | Standard | Beschreibung | |---|---|---|---| | ``ChildContent`` | ``RenderFragment`` | | Die Gruppen des Baums (NavTreeGroup), darüber oder dazwischen auch eigener Inhalt. | | ``Label`` | ``string`` | ``"Navigation"`` | Zugänglicher Name des Baums (aria-label). Standard: "Navigation". | | ``ActiveKey`` | ``string`` | | Key des hervorgehobenen Eintrags, etwa des geöffneten Ordners. Ohne Angabe ist keiner hervorgehoben. | | ``ExpandToActive`` | ``bool`` | ``true`` | Ob übergeordnete Einträge und die Gruppe des aktiven Eintrags aufklappen, sobald ActiveKey wechselt. Standard: true. | | ``StorageKey`` | ``string`` | | Schlüssel, unter dem der Klapp-Zustand von Gruppen und Einträgen im Browser gespeichert wird (localStorage). Ohne Angabe wird nichts gespeichert. | | ``OnNodeClick`` | ``EventCallback<NavTreeNode>`` | | Wird bei jedem Klick auf einen Eintrag ausgelöst (mit Href nach dem Start der Navigation). | | ``OnNodeToggle`` | ``EventCallback<NavTreeToggleEventArgs>`` | | Wird ausgelöst, wenn ein Eintrag auf- oder zugeklappt wurde. | | ``OnLoadChildren`` | ``EventCallback<NavTreeNode>`` | | Lädt die Kinder eines Eintrags mit LazyChildren beim ersten Aufklappen: Children des übergebenen Eintrags füllen. Bleibt Children leer, bleibt der Eintrag zu. Ohne Angabe lassen sich solche Einträge nicht aufklappen. | | ``OnNodeKeyDown`` | ``EventCallback<NavTreeKeyEventArgs>`` | | Wird ausgelöst, wenn auf einem Eintrag mit Tastaturfokus F2, Entf oder Einfg gedrückt wird, etwa für Umbenennen, Löschen und Neu. | | ``OnDrop`` | ``EventCallback<NavTreeNode>`` | | Wird ausgelöst, wenn etwas auf einem Eintrag abgelegt wird (HTML5 Drag & Drop). Ohne Angabe ist kein Eintrag Ziel beim Ziehen. | | ``MutedCount`` | ``bool`` | | Zähler gedämpft grau statt in der Primärfarbe, etwa wenn die Zahl keine ungelesenen Einträge meint. Standard: false. | ## Geerbte Parameter (OoComponentBase) Alle nicht deklarierten HTML-Attribute (``class``, ``style``, ``data-*``, ``aria-*``, ...) werden an das Root-Element weitergereicht. | Parameter | Typ | Standard | Beschreibung | |---|---|---|---| | ``Size`` | ``string`` | | Größe der Komponente. Mögliche Werte: OoSize.Xs, OoSize.Sm, OoSize.Md, OoSize.Lg, OoSize.Xl. Wird als CSS-Klasse am Root-Element gesetzt. | ## Hinweise - Natives HTML-Attribut class wird automatisch an das Root-Element weitergegeben - Natives HTML-Attribut style wird automatisch an das Root-Element weitergegeben - Alle weiteren nicht deklarierten Attribute (data-*, aria-*, id, tabindex, …) werden ebenfalls weitergereicht - Größe der Komponente via Size mit OoSize-Konstanten steuern (OoSize.Xs bis OoSize.Xl) - Aufbau: <NavTree ActiveKey="@_aktiv"><NavTreeGroup Nodes="_sammel" /><NavTreeGroup Key="pf-1" Title="Büro" Color="#0078d4" Nodes="_ordner" /></NavTree> - Einträge als NavTreeNode mit Key, Text, Icon (oder Color für einen Farbpunkt), Href, Count und Children (beliebig tief); Projektdaten in Data - Gruppe ohne Title: nur die Einträge, etwa Sammelansichten über allen Gruppen - Aktiver Eintrag über ActiveKey (Key des Eintrags); liegt er in einem zugeklappten Eintrag oder einer zugeklappten Gruppe, klappen diese auf (ExpandToActive="false" schaltet das ab) - Klick auf einen Eintrag mit Href navigiert, OnNodeClick meldet jeden Klick - „…“-Menü je Eintrag: <NavTreeGroup><NodeMenu><ContextMenuItem Text="Umbenennen" OnClick="@(() => Umbenennen(context))" /></NodeMenu>; context ist der NavTreeNode; - Rechtsklick auf einen Eintrag öffnet dasselbe Menü an der Mausposition (abschaltbar mit RightClickMenu="false" an der Gruppe) - Eigene Darstellung je Eintrag: NodeTemplate (statt des Texts) und NodeEndContent (vor dem Zähler) an der NavTreeGroup - Knöpfe in der Kopfzeile (Actions) und das „…“-Menü erscheinen mit Maus erst beim Überfahren, am Touch-Gerät immer - Tastatur (wie ein Baum im Explorer): Pfeil auf/ab wechselt den Eintrag, rechts klappt auf bzw. springt zum ersten Kind, links klappt zu bzw. - springt zum übergeordneten Eintrag, Pos1/Ende, Enter öffnet, Umschalt+F10 oder die Menütaste öffnet das Menü; F2, Entf und Einfg meldet OnNodeKeyDown - Ablegen beim Ziehen (HTML5 Drag & Drop, etwa Zeilen einer DataList): OnDrop setzen; Einträge mit AllowDrop sind dann Ziel und beim Darüberziehen hervorgehoben - Klapp-Zustand im Browser merken: StorageKey="post-ordner" (localStorage); ohne Angabe gilt er nur bis zum Neuladen. Startzustand über Collapsed an Gruppe bzw. Eintrag - Auf- und Zuklappen eines Eintrags meldet OnNodeToggle - Kinder erst beim Aufklappen laden: LazyChildren="true" am Eintrag und OnLoadChildren, das Children füllt; bis dahin dreht sich ein Ladesymbol - Gesperrter Eintrag: Disabled am NavTreeNode - Zähler: Count > 0 erscheint rechts als CounterLabel, getönt in der Primärfarbe; MutedCount="true" für gedämpftes Grau - Aussehen über CSS-Variablen am NavTree (style oder class): --oo-nav-tree-indent (Einrückung je Ebene), --oo-nav-tree-row-padding (Innenabstand der Zeile), - --oo-nav-tree-font-size, --oo-nav-tree-icon-size, --oo-nav-tree-group-gap, --oo-nav-tree-hover-bg, --oo-nav-tree-active-bg, --oo-nav-tree-active-color, --oo-nav-tree-drop-bg