Skip to content

Tooltip

Überblick

Ein Tooltip ist eine kleine Sprechblase mit optionaler Headline und Fließtext, deren Pfeil auf das auslösende Element zeigt – typischerweise ein Info-Icon neben einem Label. Er besteht aus zwei Teilen:

  • mmm-tooltip – die Sprechblase. Ihre Inputs entsprechen den Figma-Properties, der Text wird projiziert.
  • [mmmTooltipTrigger] – die Direktive auf dem auslösenden Element. Sie öffnet die Sprechblase in einem CDK-Overlay.
<button
type="button"
[mmmTooltipTrigger]="info"
aria-label="Mehr Informationen"
>
<mmm-icon>infozeichen_24</mmm-icon>
</button>
<mmm-tooltip #info headline="Lorem ipsum dolor">
Lorem ipsum dolor sit amet, consetetur sadipscing elitr.
</mmm-tooltip>

mmm-tooltip selbst rendert an seiner Stelle nichts. Wo es im Template steht, ist also egal – sinnvoll ist direkt neben dem Trigger.

Verhalten

EingabeÖffnenSchließen
MausHover, nach mmmTooltipShowDelayVerlassen von Trigger und Sprechblase, nach mmmTooltipHideDelay
TastaturFokus auf dem TriggerFokus verlässt den Trigger, oder Escape
Klick / Tappinnt den Tooltipzweiter Klick auf den Trigger, Tap/Klick außerhalb, oder Escape
  • Der Mauszeiger kann vom Trigger in die Sprechblase wandern, ohne dass sie schließt – der Text lässt sich lesen und markieren.
  • Klick/Tap ist der Weg auf Touch-Geräten, dort gibt es kein Hover.
  • Escape schließt in jedem Fall, ohne dass Maus oder Fokus bewegt werden müssen (WCAG 1.4.13).

Varianten

Position

In Figma heißt die Property Arrow position und benennt die Kante, an der der Pfeil sitzt. Im Code beschreibt position stattdessen, auf welcher Seite des Triggers die Sprechblase erscheint – der Pfeil sitzt dann an der gegenüberliegenden Kante:

Figma „Arrow position“positionSprechblase …
Topbottomunter dem Trigger
Bottomtopüber dem Trigger
Leftrightrechts neben dem Trigger
Rightleftlinks neben dem Trigger

Die Spalten der Figma-Property werden zu align:

FigmaalignPfeilmitte sitzt …
Left/Topstart24px von der linken bzw. oberen Ecke entfernt
Centercentermittig auf der Kante
Right/Bottomend24px von der rechten bzw. unteren Ecke entfernt

Der Pfeil zeigt immer auf die Mitte des Triggers; bei start und end ragt die Sprechblase entsprechend zur anderen Seite hinaus.

Weitere Properties

FigmaUmsetzung
Max widthmaxWidth – höchstens 15rem (240px) statt 20rem (320px) breit
Show Arrowarrow – [arrow]="false" blendet den Pfeil aus
Show Titleheadline – ohne Wert gibt es keine Headline
Space (4px)--mmm-tooltip-offset – Abstand vom Trigger bis zur Pfeilspitze

In beiden Breiten passt sich eine kurze Sprechblase ihrem Text an; erst längerer Text bricht an der Maximalbreite um.

Arrow position „Top“ → position="bottom"

align="start"
align="center"
align="end"

Arrow position „Bottom“ → position="top"

align="start"
align="center"
align="end"

Arrow position „Left“ → position="right"

align="start"
align="center"
align="end"

Arrow position „Right“ → position="left"

align="start"
align="center"
align="end"

Weitere Properties

maxWidth
[arrow]="false"
ohne headline

Inputs

mmm-tooltip

InputTypDefaultBeschreibung
headlinestring''Optionale fette erste Zeile
position'top' | 'bottom' | 'left' | 'right''bottom'Seite des Triggers, auf der die Sprechblase erscheint
align'start' | 'center' | 'end''center'Lage des Pfeils auf der zugewandten Kante
arrowbooleantrueZeigt den Pfeil
maxWidthbooleanfalseSchmale Maximalbreite (--mmm-tooltip-max-width-narrow)

[mmmTooltipTrigger]

InputTypDefaultBeschreibung
mmmTooltipTriggerTooltip– (Pflicht)Template-Referenz auf das mmm-tooltip
mmmTooltipDisabledbooleanfalseHält den Tooltip geschlossen bzw. schließt ihn
mmmTooltipShowDelaynumber100Millisekunden vom Hover bis zum Öffnen
mmmTooltipHideDelaynumber100Millisekunden vom Verlassen bis zum Schließen

Über #trigger="mmmTooltipTrigger" lässt sich der Tooltip auch aus dem Code steuern: show(), hide() und toggle(); das Signal open gibt an, ob er gerade offen ist.

Outputs

Keiner der beiden Teile definiert Outputs.

SCSS-Variablen

Alle --mmm-tooltip-* Properties werden auf der Sprechblase (.mmm-tooltip) deklariert, nicht auf dem mmm-tooltip-Element: Zum Anzeigen wird die Sprechblase in ein Overlay am Ende des <body> verschoben und erbt dort nichts mehr von Wrappern. Überschrieben werden sie deshalb auf .mmm-tooltip:

  • --mmm-tooltip-background
  • --mmm-tooltip-border-color
  • --mmm-tooltip-headline-color
  • --mmm-tooltip-text-color
  • --mmm-tooltip-shadow (ein drop-shadow()-Filter, damit auch der Pfeil Schatten wirft)
  • --mmm-tooltip-max-width
  • --mmm-tooltip-max-width-narrow
  • --mmm-tooltip-padding
  • --mmm-tooltip-gap
  • --mmm-tooltip-border-width
  • --mmm-tooltip-border-radius
  • --mmm-tooltip-offset
  • --mmm-tooltip-arrow-height
  • --mmm-tooltip-arrow-inset
  • --mmm-tooltip-viewport-margin
  • --mmm-tooltip-headline-size
  • --mmm-tooltip-headline-line-height
  • --mmm-tooltip-headline-weight
  • --mmm-tooltip-body-size
  • --mmm-tooltip-body-line-height

--mmm-tooltip-offset, --mmm-tooltip-arrow-height, --mmm-tooltip-arrow-inset und --mmm-tooltip-viewport-margin liest der Trigger beim Öffnen aus und positioniert das Overlay danach. Ein Override verschiebt Sprechblase und Pfeil also gemeinsam.

Hinweise

  • Trigger: Die Direktive gehört auf das fokussierbare Element selbst, also einen nativen <button> oder <a>, und dieses braucht einen eigenen Accessible Name (z.B. aria-label bei einem reinen Icon). Nicht auf mmm-button oder mmm-compact-button setzen – beide rendern ihren eigenen <button> im Inneren, aria-describedby landete dann am falschen Element.
  • Aussehen des Triggers: Das ist Sache des Konsumenten; die Komponente bringt nur die Sprechblase mit. Das Beispiel unten stylt einen Icon-Button in --mmm-greyscale-grey2 mit Fokusring.
  • Accessibility: Die Sprechblase hat role="tooltip", der Trigger bekommt ihre ID in sein aria-describedby (ein bereits vorhandenes bleibt erhalten). Die Sprechblase ist auch geschlossen im DOM, nur versteckt – Screenreader lesen die Beschreibung deshalb schon beim Fokussieren vor.
  • Inhalt: nur Text, keine Links oder Buttons. Der Tooltip beschreibt den Trigger; der Fokus geht nie in die Sprechblase.
  • Ohne Pfeil zeigt nichts auf die Mitte des Triggers. start und end richten die Kante der Sprechblase dann an der Kante des Triggers aus.
  • Overlay: Die Sprechblase liegt als Popover im Top Layer. Kein overflow: hidden und kein z-index um den Trigger herum kann sie abschneiden oder verdecken. Beim Scrollen läuft sie mit.
  • Schmale Viewports: Die Maximalbreite ist zusätzlich auf die Viewportbreite abzüglich --mmm-tooltip-viewport-margin auf beiden Seiten begrenzt. Passt die Sprechblase trotzdem nirgends in voller Breite, wird sie auf den Platz neben dem Trigger verschmälert statt abgeschnitten. Sie landet dann auf der Platzierung mit dem meisten Platz, nicht unbedingt auf der nächsten in der oben beschriebenen Reihenfolge.

Beispiel

Sollzinsbindung

bottom / start
bottom / center
bottom / end
top / start
top / center
top / end
right / start
right / center
right / end
left / start
left / center
left / end