SmartLink
Ein echtes <a href>-Tag das optional wie ein Button aussieht – mit automatischer Active-Klasse,
Enhanced Navigation Control und vollem Browser-Verhalten (Mittelklick, Ctrl+Klick, Rechtsklick).
Active-Match Varianten bei SmartLink
Zeigt welche Strategie wann greift. Aktive Links bekommen die Klasse
active (fett) und aria-current="page".
Die zweite Zeile nutzt ActiveClass="oo-btn--shadow", damit der aktive Zustand als gedrückter Button sichtbar wird.
Aktuelle URL: /demo/smartlink?ansicht=a
Query-String & Fragment bei der Active-Prüfung
Alle Links nutzen
ActiveMatch="Exact". Standard: Query-String zählt mit (IgnoreQueryString="false"),
Fragment wird ignoriert (IgnoreFragment="true"). Klick auf die Links ändert nur die URL dieser Seite.
Aktuelle URL: /demo/smartlink?ansicht=a
Als reiner Link – Text, Icon, Text + Icon
Kein
AsButton. Icon und Text sollen vertikal zentriert sein.
Reiner Link – verschiedene Icons
Prüfe ob Icon-Baseline mit Textbaseline übereinstimmt.
Reiner Link – NoColor (Farbe erben)
NoColor="true" erbt die Farbe vom Elternelement – nützlich in farbigen Containern.
AsButton – Semantikfarben
AsButton – Outline & Ghost
Mit Icon
Größen & Radius (AsButton)
Standard-Größe ist
OoSize.Xs (wie Button). Ohne Size-Parameter wird XS verwendet.
Shadow (gedrückter Zustand)
Navigationseintrag (FullWidth, JustifyContent, Active)
Seitenleiste aus Ghost-Links:
FullWidth="true" und JustifyContent="OoJustifyContent.Start".
Der Eintrag der geöffneten Seite wird automatisch hinterlegt (wie Button Active="true"), langer Text wird mit „…“ gekürzt.
Strg-/Mittelklick öffnen einen neuen Tab. Active übersteuert die Erkennung über die URL.
ForceLoad – echter Browser-Reload
ForceLoad="true" setzt onclick="window.location.assign(this.href)" und umgeht damit
Blazors SignalR-Interception. Linksklick = echter Reload. Mittelklick / Ctrl+Click behalten das native Browser-Verhalten für einen neuen Tab.
Beispiel initialisiert um: 04:19:57.584
(ändert sich bei ForceLoad=true oder beim erneuten Ausführen des Beispiels)
ChildContent (Custom Markup)
Icon + Text – Zentrierung in allen Größen
Nur Icon (kein Text) – alle Größen
Icon + Text – Solid / Outline / Ghost
Icon rechts (via ChildContent)
Der Icon-Parameter setzt das Icon immer links. Für Icon rechts ChildContent verwenden.
Enhance – Enhanced Navigation bei Static SSR
Enhance="false" setzt data-enhance-nav="false". Bei Static SSR erzwingt das einen vollständigen Seitenaufruf;
im Interactive Server Modus (wie hier) bleibt das Verhalten unverändert – dafür ForceLoad verwenden.
Cascading-Defaults (OoDefaults)
Mit
AsButton="true" übernimmt SmartLink ButtonStyle, Radius und Size aus
Button eines umgebenden DefaultsBereich, sofern am Link nichts gesetzt ist. Eigene Parameter haben Vorrang.
Externe Links & durchgereichte Attribute
Externe URLs gelten nie als aktiv. Weitere HTML-Attribute wie
target, rel, aria-label oder data-*
werden an das <a> durchgereicht; title kommt über den Parameter Title.
Lange Texte in schmalen Containern
Reine Links brechen lange Texte und URLs ohne Leerzeichen um, statt die Seite zu verbreitern.
Vergleich: Plain <a> vs. NavLink vs. SmartLink
Alle drei Links zeigen auf
/demo/smartlink (aktuelle Seite) – nur SmartLink und NavLink setzen die Active-Klasse automatisch.
Plain <a>
Kein Active, kein Enhanced Nav
Kein Active, kein Enhanced Nav
NavLink (Blazor) (Inactive)
Setzt „active"-Klasse nicht, kein href-Fallback für Rechtsklick-Ziel
Setzt „active"-Klasse nicht, kein href-Fallback für Rechtsklick-Ziel
NavLink (Blazor) (Active)
Setzt „active"-Klasse, kein href-Fallback für Rechtsklick-Ziel
Setzt „active"-Klasse, kein href-Fallback für Rechtsklick-Ziel
SKILL.md – Smartlink
--- name: SmartLink description: Onesown Blazor Komponente SmartLink (Common). Verwende diesen Skill wenn du die SmartLink-Komponente verwenden, konfigurieren oder debuggen moechtest. --- # SmartLink **Namespace:** `Onesown.Blazor.Components` **Kategorie:** Common **Basisklasse:** `IDisposable` Intelligenter Link mit automatischer Active-CSS-Klasse, optionalem Button-Styling, ForceLoad-Unterstützung und konfigurierbarer Active-Matching-Strategie (Prefix, Exact, Regex). **Live-Demo:** https://components.schini.com/demo/smartlink ## Parameter | Parameter | Typ | Standard | Beschreibung | |---|---|---|---| | ``Href`` | ``string`` | **Pflicht** | Ziel-URL des Links. | | ``Text`` | ``string`` | | Text-Label des Links. | | ``Icon`` | ``string`` | | Material Symbols Icon-Name (z.B. "open_in_new", "arrow_forward"). | | ``Title`` | ``string`` | | HTML Title-Attribut für Tooltip on Hover. In einer CommandBar mit AsButton="true" ohne Angabe der Text, weil er dort bei wenig Platz wegfällt. | | ``ChildContent`` | ``RenderFragment`` | | Child-Content (z.B. für Custom-Markup). | | ``AsButton`` | ``bool`` | ``false`` | Rendert den Link mit Button-Styling (oo-btn). | | ``ButtonStyle`` | ``OoButtonStyle`` | | Farbpalette / Variante – nur relevant wenn AsButton="true". | | ``Radius`` | ``string`` | | Border-Radius – Preset via OoRadius oder Custom-CSS-Wert. Standard: OoRadius.Sm. | | ``Shadow`` | ``bool?`` | | Zeigt einen Inset-Box-Shadow (gedrückter Zustand) – nur relevant wenn AsButton="true". | | ``FullWidth`` | ``bool`` | | Link über die ganze Breite des Containers; ein zu langer Text wird mit „…“ gekürzt – nur relevant wenn AsButton="true". 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 (CSS justify-content) – nur relevant wenn AsButton="true". Standard: Normal (zentriert). Start richtet den Inhalt linksbündig aus, sinnvoll mit FullWidth. | | ``NoColor`` | ``bool`` | ``false`` | Unterdrückt die primäre Link-Farbe – der Link erbt die Farbe vom Elternelement. | | ``Enhance`` | ``bool`` | ``true`` | false = data-enhance-nav="false" wird gesetzt (erzwingt Full Reload bei Static SSR). | | ``ForceLoad`` | ``bool`` | ``false`` | true = Linksklick löst immer einen echten Browser-Reload aus (window.location.assign). Funktioniert auch im Interactive Server Modus. Mittelklick und Ctrl+Click öffnen weiterhin einen neuen Tab. | | ``UseActive`` | ``bool`` | ``true`` | Ob die Active-Klasse gesetzt werden soll. | | ``Active`` | ``bool?`` | | Übersteuert die Erkennung über die URL: true = immer aktiv, false = nie aktiv. Standard: null (aus der URL laut ActiveMatch). Mit AsButton="true" wird der aktive Link wie Button Active="true" dauerhaft hinterlegt. | | ``ActiveClass`` | ``string`` | ``"active"`` | CSS-Klasse die gesetzt wird wenn der Link aktiv ist. | | ``ActiveMatch`` | ``SmartLinkActiveMatch`` | ``SmartLinkActiveMatch.SegmentPrefix`` | Matching-Strategie für die Active-Klasse. | | ``ActivePattern`` | ``string`` | | Regex-Pattern – nur verwendet wenn ActiveMatch = Regex. Beispiel: "^kunden(/|$)" | | ``IgnoreQueryString`` | ``bool`` | ``false`` | Query-String bei Active-Prüfung ignorieren. | | ``IgnoreFragment`` | ``bool`` | ``true`` | Fragment (#anker) bei Active-Prüfung ignorieren. | ## Hinweise - Einfacher Link: Href="/kunden" Text="Kundenliste" - Als Button: AsButton="true" ButtonStyle="OoColorPalette.Primary" - Icon-Link: Icon="open_in_new" Text="Extern" für Links mit Material-Symbol - ForceLoad: ForceLoad="true" erzwingt echten Browser-Reload auch im Interactive Server Modus - Active-Klasse: UseActive="false" deaktiviert, ActiveMatch="SmartLinkActiveMatch.Exact" für exaktes Matching - Regex-Matching: ActiveMatch="SmartLinkActiveMatch.Regex" + ActivePattern="^kunden(/|$)" - Navigationseintrag: AsButton="true" ButtonStyle="OoColorPalette.Neutral.Ghost" FullWidth="true" JustifyContent="OoJustifyContent.Start" – - ein echter Link, Strg-/Mittelklick öffnen einen neuen Tab; ist die Seite geöffnet, wird er wie Button Active="true" hinterlegt - Active="true"/"false" übersteuert die Erkennung über die URL, etwa wenn mehrere Routen zum selben Eintrag gehören - NoColor="true" unterdrückt die primäre Link-Farbe (erbt Farbe vom Elternelement) - ChildContent statt Text/Icon für beliebiges Markup innerhalb des Links - Ein aktiver Link erhält zusätzlich aria-current="page" (ein eigenes aria-current-Attribut hat Vorrang) - Externe URLs (andere Domain, anderer Port, mailto:, javascript:) und ungültige Regex-Patterns gelten nie als aktiv - Enhance="false" setzt data-enhance-nav="false" für Static SSR