Skip to content

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

VarianteGrößeBogenFarbe
size="lg" (Default)48pxØ 32px, 3px Strichstärke--mmm-main-colors-primary
size="sm"24pxØ 16px, 2px Strichstärke--mmm-main-colors-primary
backdrop48pxwie 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

InputTypDefaultBeschreibung
size'sm' | 'lg''lg'24px oder 48px
backdropbooleanfalseBlockiert die ganze Seite mit einer Abdunklung
activebooleantrueBlendet den Spinner ein oder aus; mit backdrop sperrt bzw. entsperrt es die Seite
textstring''Text unter dem Spinner; wird nur mit backdrop angezeigt
ariaLabelstring'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, bei size="sm" 24px. Der Bogen skaliert mit, samt Strichstärke.
  • --mmm-loading-spinner-color: Farbe des Bogens; Primary, mit backdrop weiß.
  • --mmm-loading-spinner-duration: Dauer eines Zyklus (Halbkreis → Punkt → Halbkreis, eine volle Umdrehung); 1.4s.
  • --mmm-loading-spinner-fade-duration: Dauer des Einblendens, mit backdrop samt Abdunklung; 200ms. 0s schaltet 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, mit backdrop also 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) und aria-label. Den Bereich, der lädt, zusätzlich mit aria-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 was z-index, overflow oder transform der Eltern tun. Die Seite darunter ist inert: keine Klicks, kein Tastaturfokus, für Screenreader nicht erreichbar. Escape schließt die Abdunklung nicht.
  • Screenreader kündigen beim Öffnen einen Dialog an. Sein Name ist der text, ohne text das ariaLabel. 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 backdrop wird text nicht angezeigt. Inline den Text selbst neben den Spinner setzen (siehe Beispiel).
  • Pro Seite sollte nur ein Spinner mit backdrop aktiv 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 backdrop samt Abdunklung und Text. Ausgeblendet wird er sofort.
  • Bei prefers-reduced-motion: reduce bleibt 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-color setzen, z.B. var(--mmm-whites-white) oder currentColor.
  • Die Komponente bringt keine eigenen Außenabstände mit.

Beispiel

Angebote werden geladen …

Ihre Daten werden gespeichert …