Loading Spinner
Überblick
mmm-loading-spinner ist der „Circular Loading Indikator“: ein Kreisbogen, der
im Uhrzeigersinn läuft und dabei vom Halbkreis zum Punkt schrumpft und wieder
wächst. Er zeigt an, dass Inhalte geladen werden oder eine Aktion verarbeitet
wird.
Die Komponente funktioniert auf zwei Arten:
- Inline (Default): Der Spinner steht im Layout, z.B. anstelle eines Bereichs, der noch lädt.
- Mit Backdrop (
backdrop): Der Spinner blockiert die ganze Seite. Er liegt weiß und zentriert auf einer Abdunklung, optional mit einem Text darunter, und die Seite darunter ist nicht bedienbar, solange er aktiv ist.
<!-- inline --><mmm-loading-spinner /><mmm-loading-spinner size="sm" />
<!-- blockiert die ganze Seite, solange saving() true ist --><mmm-loading-spinner backdrop [active]="saving()" />
<!-- mit Text unter dem Spinner --><mmm-loading-spinner backdrop [active]="saving()" text="Ihre Daten werden gespeichert …"/>Varianten
| Variante | Größe | Bogen | Farbe |
|---|---|---|---|
size="lg" (Default) | 48px | Ø 32px, 3px Strichstärke | --mmm-main-colors-primary |
size="sm" | 24px | Ø 16px, 2px Strichstärke | --mmm-main-colors-primary |
backdrop | 48px | wie lg | --mmm-whites-white auf --mmm-greyscale-grey3 |
backdrop ist die Variante „Auf Abdunklung“ und lässt sich mit beiden Größen
kombinieren. Mit text steht darunter ein zentrierter Text (Body 1 bold, in der
Farbe des Bogens), Spinner und Text sind dann gemeinsam zentriert.
Inputs
| Input | Typ | Default | Beschreibung |
|---|---|---|---|
size | 'sm' | 'lg' | 'lg' | 24px oder 48px |
backdrop | boolean | false | Blockiert die ganze Seite mit einer Abdunklung |
active | boolean | true | Blendet den Spinner ein oder aus; mit backdrop sperrt bzw. entsperrt es die Seite |
text | string | '' | Text unter dem Spinner; wird nur mit backdrop angezeigt |
ariaLabel | string | 'Wird geladen' | Accessible Name für Screenreader; wird nicht angezeigt, text ersetzt ihn |
Outputs
Die Komponente hat keine eigenen Outputs.
SCSS-Variablen
Alle --mmm-loading-spinner-* Properties werden auf dem Host deklariert und
können direkt am Element überschrieben werden, z.B. per style-Attribut:
--mmm-loading-spinner-size: Kantenlänge;48px, beisize="sm"24px. Der Bogen skaliert mit, samt Strichstärke.--mmm-loading-spinner-color: Farbe des Bogens; Primary, mitbackdropweiß.--mmm-loading-spinner-duration: Dauer eines Zyklus (Halbkreis → Punkt → Halbkreis, eine volle Umdrehung);1.4s.--mmm-loading-spinner-fade-duration: Dauer des Einblendens, mitbackdropsamt Abdunklung;200ms.0sschaltet es ab.--mmm-loading-spinner-backdrop-color: Farbe der Abdunklung;--mmm-greyscale-grey3.--mmm-loading-spinner-text-color: Farbe des Texts; folgt--mmm-loading-spinner-color, mitbackdropalso weiß.--mmm-loading-spinner-text-size: Schriftgröße des Texts;1rem.--mmm-loading-spinner-text-line-height: Zeilenhöhe des Texts;1.5rem.--mmm-loading-spinner-text-weight: Schriftstärke des Texts;700.--mmm-loading-spinner-text-gap: Abstand zwischen Spinner und Text;--mmm-space-16.--mmm-loading-spinner-text-max-width: Maximale Breite des Texts, bevor er umbricht;24rem.
Hinweise
- Accessibility inline: Der Host rendert mit
role="progressbar"(ohne Wert, also unbestimmt) undaria-label. Den Bereich, der lädt, zusätzlich mitaria-busy="true"auszeichnen. - Steht neben dem Spinner schon ein sichtbarer Text wie „Wird geladen …“, kann der Spinner mit
aria-hidden="true"ausgeblendet werden, damit Screenreader nicht doppelt vorlesen. - Backdrop: Die Abdunklung ist ein natives modales
<dialog>. Es liegt im Top Layer über allem, egal wo das Element im DOM steht und wasz-index,overflowodertransformder Eltern tun. Die Seite darunter ist inert: keine Klicks, kein Tastaturfokus, für Screenreader nicht erreichbar.Escapeschließt die Abdunklung nicht. - Screenreader kündigen beim Öffnen einen Dialog an. Sein Name ist der
text, ohnetextdasariaLabel. Wird die Seite freigegeben, springt der Fokus dorthin zurück, wo er vorher war, z.B. auf den auslösenden Button. Das gilt für[active]="false"ebenso wie für das Entfernen per@if. - Ändert sich der
text, während die Seite gesperrt ist, kündigen Screenreader das nicht zuverlässig an. - Ohne
backdropwirdtextnicht angezeigt. Inline den Text selbst neben den Spinner setzen (siehe Beispiel). - Pro Seite sollte nur ein Spinner mit
backdropaktiv sein, am besten zentral (z.B. in der App-Shell) und an einen gemeinsamen Ladezustand gebunden. Mehrere gleichzeitig legen ihre Abdunklungen übereinander. - Die Seite hinter der Abdunklung bleibt scrollbar. Bedienen lässt sie sich trotzdem nicht.
- Wenn der Spinner erscheint, blendet er sanft ein, mit
backdropsamt Abdunklung und Text. Ausgeblendet wird er sofort. - Bei
prefers-reduced-motion: reducebleibt der Bogen ein Halbkreis und dreht sich nur langsam. Das Einblenden bleibt, es ändert nur die Deckkraft. - Auf dunklem Grund oder in einem Button die Farbe über
--mmm-loading-spinner-colorsetzen, z.B.var(--mmm-whites-white)odercurrentColor. - Die Komponente bringt keine eigenen Außenabstände mit.
Beispiel
Angebote werden geladen …
<!-- Groessen: 48px (Default) und 24px -->
<div class="loading-spinner-example__row">
<mmm-loading-spinner />
<mmm-loading-spinner size="sm" />
</div>
<!-- Neben sichtbarem Text: der Text benennt den Zustand, der Spinner ist nur Deko -->
<p class="loading-spinner-example__row">
<mmm-loading-spinner size="sm" aria-hidden="true" />
Angebote werden geladen …
</p>
<!-- Auf dunklem Grund: Farbe ueber die CSS-Variable -->
<div class="loading-spinner-example__dark">
<mmm-loading-spinner
style="--mmm-loading-spinner-color: var(--mmm-whites-white)"
/>
</div>
<!-- Blockiert die ganze Seite, solange `blocking` true ist, mit Text darunter -->
<div>
<mmm-button (click)="blockPage()">Seite 3 Sekunden blockieren</mmm-button>
</div>
<mmm-loading-spinner
backdrop
[active]="blocking()"
text="Ihre Daten werden gespeichert …"
/>