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 | Öffnen | Schließen |
|---|---|---|
| Maus | Hover, nach mmmTooltipShowDelay | Verlassen von Trigger und Sprechblase, nach mmmTooltipHideDelay |
| Tastatur | Fokus auf dem Trigger | Fokus verlässt den Trigger, oder Escape |
| Klick / Tap | pinnt den Tooltip | zweiter 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.
Escapeschließ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“ | position | Sprechblase … |
|---|---|---|
| Top | bottom | unter dem Trigger |
| Bottom | top | über dem Trigger |
| Left | right | rechts neben dem Trigger |
| Right | left | links neben dem Trigger |
Die Spalten der Figma-Property werden zu align:
| Figma | align | Pfeilmitte sitzt … |
|---|---|---|
| Left/Top | start | 24px von der linken bzw. oberen Ecke entfernt |
| Center | center | mittig auf der Kante |
| Right/Bottom | end | 24px 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
| Figma | Umsetzung |
|---|---|
| Max width | maxWidth – höchstens 15rem (240px) statt 20rem (320px) breit |
| Show Arrow | arrow – [arrow]="false" blendet den Pfeil aus |
| Show Title | headline – 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"
Arrow position „Bottom“ → position="top"
Arrow position „Left“ → position="right"
Arrow position „Right“ → position="left"
Weitere Properties
<!--
Nur für diese Übersicht: mmm-tooltip wird per CSS eingeblendet
(mmm-tooltip { display: block }), statt von einem Trigger geöffnet zu werden.
-->
<!-- Arrow position: 4 Seiten × 3 Ausrichtungen -->
@for (position of positions; track position) {
<div class="group">
<p>Arrow position „{{ arrowEdge[position] }}“ → position="{{ position }}"</p>
<div class="row">
@for (align of aligns; track align) {
<figure>
<figcaption>align="{{ align }}"</figcaption>
<mmm-tooltip
headline="Lorem ipsum dolor"
[position]="position"
[align]="align"
>
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam.
</mmm-tooltip>
</figure>
}
</div>
</div>
}
<!-- Max width, Show Arrow, Show Title -->
<div class="group">
<p>Weitere Properties</p>
<div class="row">
<figure>
<figcaption>maxWidth</figcaption>
<mmm-tooltip headline="Lorem ipsum dolor" position="right" align="start" maxWidth>
Lorem ipsum dolor sit amet, consetetur sadipscing elitr sed diam.
</mmm-tooltip>
</figure>
<figure>
<figcaption>[arrow]="false"</figcaption>
<mmm-tooltip headline="Lorem ipsum dolor" [arrow]="false">
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam.
</mmm-tooltip>
</figure>
<figure>
<figcaption>ohne headline</figcaption>
<mmm-tooltip position="right" align="start">
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam.
</mmm-tooltip>
</figure>
</div>
</div>
Inputs
mmm-tooltip
| Input | Typ | Default | Beschreibung |
|---|---|---|---|
headline | string | '' | 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 |
arrow | boolean | true | Zeigt den Pfeil |
maxWidth | boolean | false | Schmale Maximalbreite (--mmm-tooltip-max-width-narrow) |
[mmmTooltipTrigger]
| Input | Typ | Default | Beschreibung |
|---|---|---|---|
mmmTooltipTrigger | Tooltip | – (Pflicht) | Template-Referenz auf das mmm-tooltip |
mmmTooltipDisabled | boolean | false | Hält den Tooltip geschlossen bzw. schließt ihn |
mmmTooltipShowDelay | number | 100 | Millisekunden vom Hover bis zum Öffnen |
mmmTooltipHideDelay | number | 100 | Millisekunden 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(eindrop-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-labelbei einem reinen Icon). Nicht aufmmm-buttonodermmm-compact-buttonsetzen – beide rendern ihren eigenen<button>im Inneren,aria-describedbylandete 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-grey2mit Fokusring. - Accessibility: Die Sprechblase hat
role="tooltip", der Trigger bekommt ihre ID in seinaria-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.
startundendrichten die Kante der Sprechblase dann an der Kante des Triggers aus. - Overlay: Die Sprechblase liegt als Popover im Top Layer. Kein
overflow: hiddenund keinz-indexum 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-marginauf 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 / startbottom / centerbottom / endtop / starttop / centertop / endright / startright / centerright / endleft / startleft / centerleft / end<!-- Info-Icon an einem Label: Hover oder Tastaturfokus öffnet, Klick/Tap pinnt -->
<p class="label">
Sollzinsbindung
<button
type="button"
class="info-trigger"
[mmmTooltipTrigger]="sollzins"
aria-label="Was ist die Sollzinsbindung?"
>
<mmm-icon>infozeichen_24</mmm-icon>
</button>
</p>
<mmm-tooltip #sollzins headline="Sollzinsbindung" position="right" align="start">
Der Zeitraum, für den der Sollzins fest vereinbart ist – unabhängig davon,
wie sich die Zinsen am Markt entwickeln.
</mmm-tooltip>
<!-- Alle Positionen: position = Seite des Triggers, align = Lage des Pfeils -->
<div class="placements">
@for (placement of placements; track $index) {
<div class="placement">
<button
type="button"
class="info-trigger"
[mmmTooltipTrigger]="tip"
[attr.aria-label]="placement.position + ' / ' + placement.align"
>
<mmm-icon>infozeichen_24</mmm-icon>
</button>
<code>{{ placement.position }} / {{ placement.align }}</code>
<mmm-tooltip
#tip
headline="Lorem ipsum dolor"
[position]="placement.position"
[align]="placement.align"
>
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
eirmod tempor invidunt ut labore et dolore magna aliquyam erat.
</mmm-tooltip>
</div>
}
</div>
<!-- Ohne Headline, ohne Pfeil, schmale Maximalbreite -->
<div class="variants">
<button
type="button"
class="info-trigger"
[mmmTooltipTrigger]="ohneHeadline"
aria-label="Ohne Headline"
>
<mmm-icon>infozeichen_24</mmm-icon>
</button>
<mmm-tooltip #ohneHeadline>
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam.
</mmm-tooltip>
<button
type="button"
class="info-trigger"
[mmmTooltipTrigger]="ohnePfeil"
aria-label="Ohne Pfeil"
>
<mmm-icon>infozeichen_24</mmm-icon>
</button>
<mmm-tooltip #ohnePfeil headline="Lorem ipsum dolor" [arrow]="false" align="start">
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam.
</mmm-tooltip>
<button
type="button"
class="info-trigger"
[mmmTooltipTrigger]="schmal"
aria-label="Schmale Maximalbreite"
>
<mmm-icon>infozeichen_24</mmm-icon>
</button>
<mmm-tooltip #schmal headline="Lorem ipsum dolor" maxWidth>
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam.
</mmm-tooltip>
</div>