CommandBar
Befehlsleiste wie das vereinfachte Menüband von Outlook (role="toolbar"): Buttons, SmartLinks und ContextMenus nebeneinander,
getrennt durch CommandBarSeparator, rechts optional EndContent. Die Leiste misst, ob ihre Befehle samt Beschriftung
noch in die Zeile passen. Erst wenn nicht, fallen die Beschriftungen stufenweise weg: zuerst die der Befehle in CommandBarItem Priority="Low", dann alle außer
Priority="High". Die Beschriftung bleibt als Tooltip und für Screenreader erhalten.
Beschriftungen nach Platz
Befehlsleiste wie in Outlook. Die Breite unten verkleinern: Sobald nicht mehr alles in die Zeile passt, fallen zuerst die Beschriftungen der Zusatzbefehle weg, dann alle außer „Neue E-Mail“.
Zuletzt: –
SKILL.md – Commandbar
--- name: CommandBar description: Onesown Blazor Komponente CommandBar (Common). Verwende diesen Skill wenn du die CommandBar-Komponente verwenden, konfigurieren oder debuggen moechtest. --- # CommandBar **Namespace:** `Onesown.Blazor.Components` **Kategorie:** Common **Basisklasse:** `OoComponentBase` Befehlsleiste wie das vereinfachte Menüband von Outlook (role="toolbar"): Buttons, SmartLinks, ContextMenus und ToggleButtonGroups nebeneinander, getrennt durch CommandBarSeparator, rechts optional weitere Befehle. Passen die Befehle nicht mehr in die Zeile, fallen die Beschriftungen stufenweise weg – zuerst die der Zusatzbefehle, dann alle – und es bleiben Symbole mit Tooltip. **Live-Demo:** https://components.schini.com/demo/commandbar ## Parameter | Parameter | Typ | Standard | Beschreibung | |---|---|---|---| | ``ChildContent`` | ``RenderFragment`` | | Die Befehle von links: Button, SmartLink (AsButton="true"), ContextMenu, ToggleButtonGroup, CommandBarItem und CommandBarSeparator, auch ein Titel. | | ``EndContent`` | ``RenderFragment`` | | Befehle am rechten Ende der Leiste, etwa Ansicht wechseln oder Aktualisieren. Ohne Angabe bleibt rechts nichts. | | ``Label`` | ``string`` | ``"Befehle"`` | Zugänglicher Name der Leiste (aria-label). Standard: "Befehle". | | ``CompactBreakpoint`` | ``string`` | | Feste Grenze: Bis zu dieser Breite der Leiste zeigen Befehle mit Priority="OoCommandBarPriority.Low" nur ihr Symbol, auch wenn die Beschriftung noch passen würde. CSS-Länge in rem, em oder px. Standard: keine Grenze, nur die Messung entscheidet. | | ``IconOnlyBreakpoint`` | ``string`` | | Feste Grenze: Bis zu dieser Breite der Leiste zeigen alle Befehle außer Priority="OoCommandBarPriority.High" nur ihr Symbol, auch wenn die Beschriftungen noch passen würden. CSS-Länge in rem, em oder px. Standard: keine Grenze, nur die Messung entscheidet. | | ``CollapseLabels`` | ``bool`` | ``true`` | Ob Beschriftungen bei wenig Platz wegfallen. false: Alle Befehle behalten ihren Text. Standard: true. | | ``Plain`` | ``bool`` | | Ohne weiße Fläche, runde Ecken und Schatten – etwa in einer Kopfzeile, die schon eine Fläche hat. 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: <CommandBar><Button Text="Neu" Icon="add" /><CommandBarSeparator /><Button Text="Löschen" Icon="delete" ButtonStyle="OoColorPalette.Neutral.Ghost" /></CommandBar> - Rechtsbündige Befehle (Ansicht, Aktualisieren, Umschalter) in EndContent - Die Leiste misst selbst, ob ihre Befehle samt Beschriftung in die Zeile passen (Breite der Leiste, nicht des Fensters): Erst wenn nicht, verlieren Befehle in <CommandBarItem Priority="OoCommandBarPriority.Low"> ihre Beschriftung, reicht das nicht, alle außer Priority="OoCommandBarPriority.High". Wird sie wieder breiter, kommen die Beschriftungen zurück - Feste Grenzen zusätzlich zur Messung: CompactBreakpoint="50rem" bzw. IconOnlyBreakpoint="35rem" – bis zu dieser Breite gilt die Stufe auch dann, wenn die Beschriftungen noch passen würden - Die Beschriftung bleibt für Screenreader erhalten; Button und SmartLink zeigen sie in der Leiste zusätzlich als Tooltip, solange kein eigener Title gesetzt ist - ToggleButtonGroup behält ihre Beschriftungen; für knappe Leisten deren Items mit IconOnly bauen oder mit CommandBarItem MaxBarWidth/MinBarWidth zwischen zwei Varianten wechseln - Nur in bestimmten Breiten zeigen: <CommandBarItem MinBarWidth="50rem"> (erst ab dieser Breite) bzw. MaxBarWidth="50rem" (nur bis dahin) - Die Leiste nimmt die volle Breite ihres Containers ein und schneidet Befehle ab, die auch ohne Beschriftung nicht mehr passen; Menüs und Tooltips liegen darüber - Aussehen: weiße Fläche mit runden Ecken und leichtem Schatten; Plain="true" ohne Fläche und Schatten. Anpassbar über --oo-command-bar-background, --oo-command-bar-radius und --oo-command-bar-shadow - Im MasterDetailLayout gehört sie in den Header