Button
Reiner Klick-Button mit fluent Farbsystem (OoColor).
Semantikfarben – Base / Outline / Ghost
Base (Solid)
Outline
Ghost
Soft
Shade-Navigation – Lighter → Darker → beyond
Primary alle Stufen
Primary alle Stufen – Soft
Danger alle Stufen
Danger alle Stufen – Soft
.Next über Darker hinaus
Verhalten
Klick-Event
Klicks: 0
Disabled
Navigationseintrag (FullWidth, JustifyContent, StartContent)
FullWidth streckt den Button über die Breite und kürzt langen Text mit „…“, JustifyContent richtet den Inhalt aus, StartContent setzt Markup vor Icon und Text.
Seitenleiste (14rem)
FullWidth zentriert
Loading-State (IsBusy)
IsBusy
IsBusy: False
Shadow
Solid + Shadow
Outline + Shadow
Ghost + Shadow
Soft + Shadow
Icons
Nur Icon
Icon + Text
Quadratisch (IconOnly)
Aktiver Eintrag (Active)
Border-Radius
Stufen
Size
Standard-Größe ist
OoSize.Xs. Hier kombiniert mit einer TextBox zum direkten Größenvergleich.
Alle Größen (nur Button)
Xs (Standard)
Sm
Md
Lg
Xl
Shades – Neutral
Base
Outline
Ghost
Shades – Black
Base
Outline
Ghost
Shades – Primary
Base
Outline
Ghost
Shades – Secondary
Base
Outline
Ghost
Shades – Danger
Base
Outline
Ghost
Shades – Success
Base
Outline
Ghost
Shades – Warning
Base
Outline
Ghost
Shades – Info
Base
Outline
Ghost
Custom-Farben via FromHex()
Lila #9333ea – Shades
Lila #9333ea – Outline / Ghost / Soft
Magenta #e91e8c – Shades
Magenta #e91e8c – Outline / Ghost / Soft
Teal #0d9488 – Shades
Teal #0d9488 – Outline / Ghost / Soft
Orange #d97706 – Shades
Orange #d97706 – Outline / Ghost / Soft
Varianten-Wechsel .Outline / .Ghost / .Soft
.Next über Darker hinaus
Icon hinter dem Text (EndIcon)
EndIcon steht ganz rechts, etwa der Pfeil eines Buttons, der ein Menü öffnet; ein Zähler davor als CounterLabel im ChildContent.
class & style
class
style
SKILL.md – Button
--- name: Button description: Onesown Blazor Komponente Button (Common). Verwende diesen Skill wenn du die Button-Komponente verwenden, konfigurieren oder debuggen moechtest. --- # Button **Namespace:** `Onesown.Blazor.Components` **Kategorie:** Common **Basisklasse:** `FormControlBase` Vielseitiger Button mit Text, Icon, Lade-Spinner, Farbpalette und konfigurierbarem Radius. Kann rein per Text, per Icon, als Text+Icon-Kombination oder mit beliebigem ChildContent belegt werden. Farbe und Form werden über OoColorPalette-Token gesteuert; appweite Defaults lassen sich mit einem DefaultsBereich im Root-Layout oder für eine Seite vorgeben. **Live-Demo:** https://components.schini.com/demo/button ## Parameter | Parameter | Typ | Standard | Beschreibung | |---|---|---|---| | ``IsFloatingLabel`` | ``bool`` | ``false`` | Kein Label: true gibt dem Button die Höhe eines Eingabefelds mit Floating Label (gleiche Zeilenhöhe daneben). Standard: false; OoDefaults.Input.IsFloatingLabel gilt hier nicht. | | ``Text`` | ``string`` | | Beschriftungstext des Buttons. Wird links vom Icon angezeigt, wenn beide gesetzt sind. | | ``Icon`` | ``string`` | | Name des Material-Symbols (z. B. "save", "delete", "edit"). Wird als Icon neben oder statt Text angezeigt. | | ``OnClick`` | ``EventCallback<MouseEventArgs>`` | | Wird ausgelöst wenn der Nutzer auf den Button klickt. Bei Disabled=true oder IsBusy=true wird kein Event gefeuert. | | ``Disabled`` | ``bool`` | | Deaktiviert den Button: kein Klick, ausgegraut, ARIA-Attribut disabled gesetzt. Standard: false. | | ``IsBusy`` | ``bool`` | | Zeigt einen Lade-Spinner und sperrt den Button für weitere Klicks, solange true. Geeignet für asynchrone Aktionen. | | ``Type`` | ``string`` | ``"button"`` | HTML-Button-Typ. Mögliche Werte: "button" (Standard), "submit" (Formular absenden), "reset" (Formular zurücksetzen). | | ``Title`` | ``string`` | | HTML-Title-Attribut – erscheint als nativer Browser-Tooltip beim Hover. In einer CommandBar ohne Angabe der Text, weil er dort bei wenig Platz wegfällt. | | ``ButtonStyle`` | ``OoButtonStyle`` | | Farb- und Stil-Token für den Button. Wert aus OoColorPalette (z. B. OoColorPalette.Primary, OoColorPalette.Danger.Light.Outline). Standard: OoColorPalette.Neutral (wenn kein Defaults gesetzt). | | ``Radius`` | ``string`` | | Border-Radius des Buttons. OoRadius-Konstanten (OoRadius.Sm, OoRadius.Lg, OoRadius.Full) oder beliebiger CSS-Wert (z. B. "8px"). Standard: OoRadius.Sm. | | ``ChildContent`` | ``RenderFragment`` | | Beliebiges Markup als Button-Inhalt – ersetzt Text und Icon, wenn gesetzt. | | ``Shadow`` | ``bool?`` | | Simuliert durch einen Inset-Box-Shadow einen dauerhaft gedrückten Zustand. Nützlich für Toggle-Szenarien. | | ``StartContent`` | ``RenderFragment`` | | Markup vor Icon und Text, etwa ein Statuspunkt in einem Navigationseintrag. Anders als ChildContent (nach dem Text) bleibt der Text dabei in seinem Element und wird bei Überlänge gekürzt. | | ``FullWidth`` | ``bool`` | | Button über die ganze Breite des Containers; ein zu langer Text wird mit „…“ gekürzt. Standard: false. Zusammen mit JustifyContent="OoJustifyContent.Start" für Navigationseinträge, etwa in einer Seitenleiste. | | ``JustifyContent`` | ``OoJustifyContent`` | ``OoJustifyContent.Normal`` | Horizontale Ausrichtung von Icon und Text im Button (CSS justify-content). Standard: Normal (zentriert). Start richtet den Inhalt linksbündig aus, sinnvoll mit FullWidth. | | ``IconOnly`` | ``bool`` | | Quadratischer Button nur mit Icon: ohne seitlichen Innenabstand, so breit wie hoch (Höhe aus Size). Mit Radius="OoRadius.Full" rund. Title für die Bedeutung setzen, weil kein Text dasteht. Eine Höhe zwischen zwei Größen über das Token der Größe, etwa --oo-size-min-height-sm an einem umgebenden Element. Standard: false. | | ``Active`` | ``bool`` | | Hebt den Button als aktiven Eintrag hervor, etwa die geöffnete Seite in einer Navigation aus Ghost-Buttons: dauerhaft hinterlegt wie beim Überfahren. Standard: false. | | ``EndIcon`` | ``string`` | | Material-Symbol ganz rechts im Button, hinter Text und ChildContent – etwa "arrow_drop_down" für einen Button, der ein Menü öffnet, oder "arrow_forward" für „Weiter“. Bleibt auch bei IsBusy stehen. Standard: null. | ## Geerbte Parameter (FormControlBase) | Parameter | Typ | Standard | Beschreibung | |---|---|---|---| | ``Size`` | ``string`` | ``OoSize.Md`` | 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. | | ``Id`` | ``string`` | ``Generator.GenerateRandomHtmlTagID()`` | Eindeutige HTML-ID des Input-Elements. Wird automatisch generiert und kann überschrieben werden (z. B. für Labels mit for-Attribut). | | ``ShowLabel`` | ``bool`` | ``true`` | Blendet das Label über dem Eingabefeld ein oder aus. Standard: true. | | ``Label`` | ``string`` | | Beschriftung des Eingabefelds. Wird auch als Accessible-Name für Screenreader verwendet. | | ``Placeholder`` | ``string`` | ``" "`` | Platzhaltertext im leeren Eingabefeld. Standard: Leerzeichen (verhindert Floating-Label-Sprung in Chrome). | | ``AutoSaveCallback`` | ``EventCallback`` | | Wird nach jeder Wertänderung ausgelöst und signalisiert der Seite, dass gespeichert werden soll. Kombinierbar mit TriggerAutoSaveCallbackOnlyIfValid. | | ``TriggerAutoSaveCallbackOnlyIfValid`` | ``bool`` | ``true`` | Steuert ob AutoSaveCallback nur bei gültigem Wert ausgelöst wird. Standard: true. | | ``AfterValueChanged`` | ``EventCallback`` | | Wird nach jeder Wertänderung ausgelöst, unabhängig von der Gültigkeit des Werts. Geeignet für Live-Vorschau oder Seiteneffekte. | | ``ShowValidationTooltip`` | ``bool`` | ``false`` | Zeigt Validierungsmeldungen als Tooltip neben dem Feld statt als Text darunter. Standard: false. | ## Hinweise - Immer @bind-Value für Two-Way-Binding verwenden - Für Formular-Validierung ValueExpression="() => _model.Property" setzen - Komponente muss innerhalb eines <Form>- oder <EditForm>-Containers liegen, damit der EditContext greift - AutoSaveCallback wird nach jeder gültigen Änderung ausgelöst, wenn TriggerAutoSaveCallbackOnlyIfValid=true (Standard) - AfterValueChanged wird nach jeder Änderung ausgelöst, unabhängig von der Gültigkeit - ShowValidationTooltip=true zeigt Validierungsmeldungen als Tooltip statt unter dem Feld - Eingabefelder (nicht Button/ToggleButton): Defaults für IsFloatingLabel und Size über DefaultsBereich (Input, ersatzweise Size), appweit im Root-Layout; ein Parameter an der Instanz hat Vorrang - Ändert sich nur ein Cascading-Wert, werden die direkten Parameter nicht erneut gesetzt: Ein Eingabefeld rendert beim Tippen nie den vorigen Wert; inhaltlich gleiche OoDefaults lösen kein Rendern aus - Für einfache Aktionen: Text="Speichern" ButtonStyle="OoColorPalette.Primary" - Für Icons: Icon="delete" \u2013 zeigt das Material-Symbol ohne Text - Text + Icon kombinierbar: Text="Löschen" Icon="delete" - Lade-Zustand: IsBusy="true" zeigt Spinner und sperrt den Button - Submit-Buttons: Type="submit" innerhalb eines Form-Containers verwenden - Eigenes Markup: ChildContent statt Text/Icon für komplexen Button-Inhalt - Shadow="true" simuliert einen dauerhaft gedrückten Zustand (z. B. aktiver Toggle) - Navigationseintrag: FullWidth="true" JustifyContent="OoJustifyContent.Start", langer Text wird mit „…“ gekürzt - Aktiver Navigationseintrag (geöffnete Seite): Active="true" hinterlegt ihn wie beim Überfahren - Statuspunkt o. Ä. vor dem Text: StartContent - Icon hinter dem Text: EndIcon="arrow_drop_down", etwa als Trigger eines ContextMenu („Label ▾“); ein Zähler dazwischen als ChildContent: <Button Text="Label" EndIcon="arrow_drop_down"><CounterLabel Count="2" HideZero="true" /></Button> - Quadratisch nur mit Icon: IconOnly="true" Icon="arrow_upward" Title="Zum Anfang", rund mit Radius="OoRadius.Full"