SidebarLayout

Tooltip

Tooltip-Overlay mit konfigurierbarer Position – einsetzbar auf Buttons, Icons und beliebigen Elementen.

Positionen

Rechts
Links
Oben
Unten

Auf Icon-Buttons

Info
Löschen
Speichern

Längerer Tooltip-Text

Mehrzeilig
Warnung

Text, Icons und Formatierung

Content kann beliebiger Inhalt sein, TooltipContent beliebiges Markup.

Die Abkürzung

UID
steht im Fließtext, ebenso ein
Icon.

Ein- und Ausschalten

ShowTooltip="false" rendert nur den Content ohne Tooltip-Hülle.

Wert: True

Inhalt erst beim Hover laden

ShowTooltip="false" ShowTooltipOnHover="true" rendert TooltipContent erst beim ersten Hover oder Fokus; bis dahin steht LadeText im Tooltip.

Tastatur und Bildschirmrand

Mit Tab fokussieren zeigt den Tooltip, Escape blendet ihn aus. Am Bildschirmrand (etwa am Handy) bleibt der Tooltip im Fenster: oben/unten wird er seitlich verschoben, links/rechts schmaler, oder er weicht nach unten aus.

In Containern mit overflow

Der Tooltip liegt über allem (Top Layer): Container mit overflow, etwa Kanban-Spalten, Cards oder Dialoge, schneiden ihn nicht ab.

Spaltenbeschreibung mit langem Hinweis

class & style

class
style
SKILL.md – Tooltip
---
name: Tooltip
description: Onesown Blazor Komponente Tooltip (Common). Verwende diesen Skill wenn du die Tooltip-Komponente verwenden, konfigurieren oder debuggen moechtest.
---

# Tooltip

**Namespace:** `Onesown.Blazor.Components`  
**Kategorie:** Common  
**Basisklasse:** `OoComponentBase`  

Hinweis-Overlay, das beim Überfahren mit der Maus, beim Antippen oder bei Tastaturfokus über, unter, links oder rechts von beliebigem Inhalt (Button, Icon, Text) erscheint. tooltip.js öffnet ihn ohne SignalR-Roundtrip als Popover im Top Layer, sodass ihn kein Container mit overflow abschneidet, hält ihn im Fenster und blendet ihn mit Escape aus.

**Live-Demo:** https://components.schini.com/demo/tooltip  

## Parameter

| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Content`` | ``RenderFragment`` |  | Inhalt, an dem der Tooltip hängt, etwa ein Button, ein Icon oder Text. Wird immer gerendert. |
| ``TooltipContent`` | ``RenderFragment`` |  | Hinweistext des Tooltips, beliebiges Markup. Ohne TooltipContent wird nur Content ohne Tooltip-Hülle gerendert. |
| ``TooltipPosition`` | ``string`` | ``"top"`` | Lage des Tooltips relativ zum Content. Mögliche Werte: "top" (Standard), "bottom", "left", "right"; Groß-/Kleinschreibung egal, unbekannte Werte ergeben "top". |
| ``ShowTooltip`` | ``bool`` | ``true`` | Zeigt den Tooltip beim Hover/Fokus an und rendert TooltipContent sofort. Standard: true. Mit false und ShowTooltipOnHover="false" wird nur Content gerendert. |
| ``ShowTooltipOnHover`` | ``bool`` |  | Lädt TooltipContent erst beim ersten Hover oder Fokus (nur wirksam mit ShowTooltip="false"); bis dahin steht LadeText im Tooltip. Für teuer zu berechnende Hinweise. Standard: false. |
| ``LadeText`` | ``string`` | ``"Berechne ..."`` | Platzhaltertext im Tooltip, solange TooltipContent bei ShowTooltipOnHover="true" noch nicht geladen ist. Standard: "Berechne ...". |

## 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: Content enthält das Element, an dem der Tooltip hängt, TooltipContent den Hinweistext (beliebiges Markup)
- Position über TooltipPosition: "top" (Standard), "bottom", "left" oder "right"; unbekannte Werte fallen auf "top" zurück
- Liegt über allem (Top Layer): Kanban-Spalten, Cards, Dialoge und andere Container mit overflow oder z-index schneiden ihn nicht ab
- Am Fensterrand verschiebt tooltip.js oben/unten stehende Tooltips seitlich ins Fenster; links/rechts stehende werden schmaler oder weichen nach unten bzw. oben aus, ebenso oben/unten bei fehlendem Platz
- Teurer Inhalt: ShowTooltip="false" ShowTooltipOnHover="true" rendert TooltipContent erst beim ersten Hover oder Fokus und zeigt bis dahin LadeText
- Ohne Tooltip: ShowTooltip="false" (und ShowTooltipOnHover="false") oder TooltipContent=null rendert nur Content, ohne Hülle
- Barrierefreiheit: Der Text trägt role="tooltip"; tooltip.js verknüpft ihn beim Fokus per aria-describedby mit dem fokussierten Element; Escape blendet ihn aus
- Der Tooltip selbst ist nicht bedienbar (pointer-events: none) – keine Links oder Buttons in TooltipContent legen


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.