SidebarLayout

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=b

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=b

Als reiner Link – Text, Icon, Text + Icon

Kein AsButton. Icon und Text sollen vertikal zentriert sein.

Reiner Link – verschiedene Icons

Reiner Link – NoColor (Farbe erben)

NoColor="true" erbt die Farbe vom Elternelement – nützlich in farbigen Containern.

AsButton – Semantikfarben

Der Link rendert ein echtes <a href> – verhält sich im Browser wie ein Link, sieht aus wie ein Button.

AsButton – Outline & Ghost

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.494 (ändert sich bei ForceLoad=true oder beim erneuten Ausführen des Beispiels)

ChildContent (Custom Markup)

Icon + Text – Zentrierung in allen Größen

Icon links vom Text. Prüfe ob Icon und Text in jeder Größe vertikal zentriert sind.

Nur Icon (kein Text) – alle Größen

Quadratische Icon-Buttons. Prüfe ob das Icon in jeder Größe mittig sitzt.

Icon + Text – Solid / Outline / Ghost

Gleiches Icon in allen drei Varianten, Größe XS und MD zum Vergleich.

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

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
NavLink (Blazor) (Inactive)
Setzt „active"-Klasse nicht, kein href-Fallback für Rechtsklick-Ziel
NavLink (Blazor) (Active)
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(/&#124;$)" |
| ``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


Die Verbindung zum Server ist unterbrochen. Verbinde neu …

Neu verbinden hat nicht geklappt. Nächster Versuch in Sekunden.

Keine Verbindung zum Server. Bitte erneut versuchen oder die Seite neu laden.

Der Server hat die Sitzung angehalten.

Die Sitzung ließ sich nicht fortsetzen. Bitte erneut versuchen oder die Seite neu laden.