Zum Inhalt springen
tecminds

React-Native-Ladezustände: Formgetreue Skeletons, eine verzögerte Progress-Linie und warum wir den Vollbild-Spinner entfernt haben

Eine Mobile-App, die bei jedem Seitenwechsel einen Vollbild-Spinner zeigt, ist eine App, die ihren Nutzerinnen immer wieder den Kontext wegnimmt. Für das 3.0.1-Release unserer ZSOPilot-Companion-App haben wir «Loading» in drei Zustände zerlegt: formgetreue Platzhalterzeilen beim leeren Erst-Render, eine 2 pt starke Progress-Linie, die erst nach 400 ms erscheint, wenn sichtbare Inhalte nachgeladen werden, und gar nichts, wenn der Ladevorgang innerhalb der menschlichen Reaktionszeit fertig ist. Das ist die Aufzeichnung der Zustandsmaschine dahinter, des Einzeiler-Bugs, der uns gelehrt hat, dass «leer» nicht «geladen» ist, und der Accessibility-Regeln, die wir unterwegs mitgenommen haben.

TTobias LüscherCo‑Founder · TecMinds2026-11-09 · 11 Min Lesezeit

React-Native-Ladezustände: Formgetreue Skeletons, eine verzögerte Progress-Linie und warum wir den Vollbild-Spinner entfernt haben

Eine Mobile-App, die bei jedem Seitenwechsel einen Vollbild-Spinner zeigt, ist eine App, die ihren Nutzerinnen immer wieder den Kontext wegnimmt. Ein Tab-Wechsel — und der Screen, auf dem man eben war, ist weg. Pull-to-Refresh — wieder weg. Der Spinner macht seine Arbeit ehrlich: Er signalisiert, dass etwas passiert. Aber der Preis für diese Ehrlichkeit ist das Layout, die bereits sichtbaren Daten und das Gefühl, an einem Ort zu sein. Für das 3.0.1-Release von ZSOPilot, der Mobile-Companion-App, die wir für Schweizer Zivilschutzorganisationen auf Basis von Expo SDK 57 und React Native bauen, haben wir den Spinner herausgerissen und durch eine Zustandsmaschine ersetzt, die drei verschiedene Ausprägungen von «Laden» unterscheidet — und für jede eine andere Sache rendert. Manchmal nichts.

Das ist die Aufzeichnung dieser Zustandsmaschine, der Accessibility-Regeln, die wir unterwegs mitgenommen haben, und des Einzeiler-Bugs, den wir auf dem Weg dorthin ausgeliefert haben: Eine leere Liste, die auflöst, bevor ihr Elternblock es tut, überlistet jede naive «Geladen?»-Prüfung.

Die drei Zustände, die es wirklich gibt

Das Erste, was unser Denken aufgebrochen hat, war die Einsicht, dass der Komponentenbaum nicht einen Ladezustand hat. Er hat mindestens drei, und jeder davon will ein anderes Pixel-Budget.

Zustand eins ist der leere Erst-Render. Keine Daten, kein Layout als Ankerpunkt, die Nutzerin hat in dieser Session gerade erst auf diesen Screen navigiert. Das Richtige ist, die Form dessen zu zeigen, was gleich erscheint — denn gleich schaut die Nutzerin genau auf dieses Rechteck, und je weniger das Layout springt, wenn die echten Daten landen, desto besser. Ein Spinner ist hier aktiv feindselig: Er zentriert einen Punkt in einer Fläche, die gleich eine Liste wird.

Zustand zwei ist ein Refetch von bereits sichtbarem Inhalt. Die Nutzerin hat den Tab erneut angetippt, auf dem sie gerade war, oder nach unten gezogen zum Aktualisieren, oder die App ist aus dem Hintergrund zurückgekehrt und ein Stale-while-revalidate-Query ist gestartet. Das Richtige ist ein winziges, leises Signal, dass etwas passiert — kein Layoutwechsel, kein verdeckendes Overlay, kein Grund, die Zeile zu verlieren, die man gerade gelesen hat. Ein Spinner ist hier schlimmer als feindselig: Er löscht Kontext, der eine Sekunde vorher noch korrekt war.

Zustand drei ist ein Ladevorgang, der innerhalb der menschlichen Reaktionszeit endet — irgendwo unter 150 ms. Das Richtige ist, gar nichts zu zeigen. Ein Lade-Indikator, der 80 ms aufblitzt, ist pures visuelles Rauschen; die Nutzerin sieht ein Flackern und hat keine Ahnung, was es bedeutete. Ihn wegzulassen kostet die Nutzerin nichts und erspart allen die «Habe ich da gerade etwas gesehen?»-Mikroverwirrung.

Der Spinner, den wir geerbt hatten, kollabierte alle drei zu einem Zustand. Jede Navigation, jeder Refetch, jeder Sub-100-ms-Query bekam denselben zentrierten ActivityIndicator. Das Design, das wir in 3.0.1 ausgeliefert haben, gibt jedem der drei eine eigene Komponente und behandelt Übergänge zwischen ihnen als explizit, nicht als zufällig.

Zustand eins: Platzhalterzeilen in der Form der Liste

Für den Fall des leeren Erst-Renders rendern wir eine Placeholder-Komponente, deren Geometrie bewusst nahe an der echten Liste darunter liegt. Die ZSOPilot-Screens für Stundenplan, Lektionen und Material sind alle listenförmig: eine Zeitspalte links, Titel und Untertitel rechts gestapelt, eine 1-px-Trennlinie zwischen den Zeilen. Der Placeholder zeichnet dieselbe Form — eine 46 pt breite Zeitspalte mit zwei kurzen Balken, eine flex-grow Textspalte mit einem längeren und einem kürzeren Balken darunter, dieselbe borderBottomColor wie die echte Trennlinie — und animiert einen einzigen Opacity-Puls von 1.0 auf 0.45 und zurück über 1,4 Sekunden, synchron über jeden Balken der Seite.

Zwei Entscheidungen darin sind es wert, explizit genannt zu werden.

Die Breiten variieren. Wir rotieren durch sechs Breiten (72%, 54%, 81%, 63%, 47%, 69%), damit der Stapel als Liste gelesen wird und nicht als Strichcode. Gleich breite Platzhalter sind der mit Abstand häufigste Skeleton-Bug: Sie werden als visueller Fehler gelesen, nicht als Inhalt, weil echte Listeneinträge nie gleich breit sind. Variierende Breiten ohne sichtbares Muster — aber nicht zufällig, denn zufällig flackert beim Remount — sind ein billiger Weg, den Platzhalter wie etwas wirken zu lassen, das für echten Inhalt steht.

Der Platzhalter selbst ist verzögert. Die Komponente nutzt einen kleinen Hook, useDelayed, der seinen Boolean erst dann umschaltet, wenn der Lade-Zustand 150 ms gehalten hat:

export function useDelayed(active: boolean, delay: number) {
  const [shown, setShown] = useState(false);
  useEffect(() => {
    if (!active) return;
    const timer = setTimeout(() => setShown(true), delay);
    return () => {
      clearTimeout(timer);
      setShown(false);
    };
  }, [active, delay]);
  return active && shown;
}

In den ersten 150 ms reserviert der Placeholder vertikalen Raum in Höhe von rows * 61 pt, zeichnet aber nichts hinein. Wenn die echten Daten innerhalb dieses Fensters eintreffen — und bei warmem Cache tun sie das meistens — sieht die Nutzerin das Skeleton nie, nur die finale Liste. Wenn sie es nicht tun, blendet der Placeholder sanft ein, und die Nutzerin sieht etwas, das zumindest aussieht wie das, wonach sie gefragt hat. Der reservierte Platz verhindert in beiden Fällen den Layout-Sprung.

Zustand zwei: Eine dünne Linie, die nur dann erscheint, wenn es nötig ist

Für den Fall des Refetch von sichtbarem Inhalt rendern wir einen zwei Pixel starken Tintenstrich unter dem Header, ProgressLine genannt. Er belegt kein Layout (height: 0, overflow: visible), sodass sein Auftauchen nichts nach unten verschiebt, und er nutzt denselben Delayed-Boolean-Trick mit einer längeren Schwelle:

const visible = useDelayed(active, 400);

Vierhundert Millisekunden ist die Zahl, bei der wir ihn auf gecachten Refetches nicht mehr gesehen haben. Die meisten Pull-to-Refresh-Aufrufe bei gesunder Netzverbindung sind in 200-350 ms fertig; die Progress-Linie erscheint für sie nie. Bei langsamer Verbindung blendet sie nach 400 ms ein und animiert ein kurzes Segment — 28% der Trackbreite — das auf einer 1,1-s-Schleife unter dem Header hin- und hergleitet. Die Animation ist eine translateX-Interpolation auf einem Animated.Value mit useNativeDriver: true, läuft also auf dem UI-Thread und interagiert nicht mit dem Listen-Rendering darunter.

Visuell bedeutet das: Eine Nutzerin, die die App kennt und weiss, dass die Daten frisch sind, sieht den Indikator nie, und eine Nutzerin, die wartet, bemerkt nur eine dünne Tintenlinie unter der Titelleiste — kein Modal, kein Overlay, kein Spinner mitten in einer Seite, deren Inhalt sie bereits las. Die Liste darunter bleibt live und scrollbar; veraltete Daten bleiben auf dem Bildschirm, bis der Refetch auflöst, worauf sie an Ort und Stelle ersetzt werden.

Beide — der Placeholder und die Progress-Linie — respektieren eine Accessibility-Regel und eine Portion Accessibility-Metadaten.

Die Regel: AccessibilityInfo.isReduceMotionEnabled(). Wenn auf dem Gerät «Reduce Motion» aktiv ist, zeichnet die ProgressLine einen statischen, gedimmten Balken über die volle Breite statt eines gleitenden, und der Placeholder hört auf zu pulsieren. Der Hook, den wir nutzen, abonniert das reduceMotionChanged-Event, sodass das Umschalten der System-Einstellung die laufende App ohne Reload verändert. Der MDN-Einstieg zu prefers-reduced-motion ist derselbe Gedanke; React Native stellt ihn über AccessibilityInfo bereit.

Die Metadaten: accessibilityRole="progressbar" mit einem lokalisierten accessibilityLabel ("Daten werden geladen" für die Erstlast, "Wird aktualisiert" für die Refetch-Linie). Screenreader kündigen das Richtige an; VoiceOver liest nicht mehr «Bild», wo eine dekorative Animation lebt.

Zustand drei: Gar nichts

Der dritte Zustand ist der, den man am leichtesten vergisst, weil er über seine Abwesenheit definiert ist. Wenn der Ladevorgang innerhalb von 150 ms endet, wird der Placeholder nie gerendert, und wenn der Refetch innerhalb von 400 ms endet, erscheint die Progress-Linie nie. Die Nutzerin sieht die finalen Daten und nichts davor. Wir mussten keine Komponente für diesen Zustand schreiben — wir mussten einen Hook schreiben, der verhindert, dass eine Komponente rendert, bevor sie ihre Pixel verdient hat.

Hier haben wir die meiste Zeit damit verbracht, mit uns selbst zu diskutieren. Der Instinkt ist, bei jeder nicht-null Ladezeit irgendetwas zu zeigen, weil «dann weiss die Nutzerin, dass wir etwas tun». Die Realität ist, dass ein Spinner-Blitz bei 80 ms für die wahrgenommene Performance schlimmer ist als ein sauberer Sprung zum finalen Inhalt: Das Auge erfasst den Wechsel, das Gehirn verbringt einen Moment damit zu entscheiden, ob etwas kaputt ist, und einigt sich erst dann auf das echte Ergebnis. Delayed-Render-Hooks sind derselbe Instinkt wie der Serverless-Cold-Start-Warmup-Ping auf dem Backend — unterdrücke das Signal, auf das die Nutzerin nicht reagieren kann, und commite erst dann Pixel, wenn sie lange genug überleben, um gelesen zu werden. Dieselbe Logik räumt die Dashboard-Fetch-Muster auf, die wir in useQuery vs. useEffect für Next.js-Dashboards beschrieben haben.

Der Einzeiler-Bug: Leer ist nicht geladen

Die Zustandsmaschine ging live, und beim ersten Build, den wir unseren Pilot-Nutzerinnen gegeben haben, zeigte der Lektionen-Screen beim Kaltstart immer noch nur die dünne Progress-Linie, nie den Placeholder — selbst wenn die Daten sichtbar drei oder vier Sekunden brauchten, um bei schlechter Verbindung einzutreffen. Das Log, das die Nutzerin uns schickte, sagte, der Fetch sei schnell gewesen; der Screen blieb danach sekundenlang leer.

Die Ursache war ein Grenzfehler darin, wie wir entschieden haben, in welchem Zustand wir waren. Die Lektionenseite komponiert zwei Queries: einen für die Kursblöcke (die grossen Container) und einen für die Lektionen darin. Die naive «Wir sind geladen»-Prüfung, die wir geschrieben hatten, lautete lessons.length >= 0 && !lessons.isFetching — was wahr wird, sobald der Lessons-Query seinen initialen leeren Array zurückgibt, bevor der Kursblock-Query aufgelöst hat. Die Seite sah isFetching auf false kippen, folgerte, sie sei nicht mehr in Zustand eins, und fiel durch in Zustand zwei: ein leerer Screen mit einer dünnen Progress-Linie, was das richtige Rendering für «Wir refetchen Inhalt, der bereits auf dem Screen ist» und das falsche Rendering für «Wir haben den Elterncontainer noch nicht» ist.

Der Einzeiler-Fix war, die Zustand-eins-Prüfung daran zu koppeln, ob der Eltern-Block bereit war, nicht daran, ob die Blatt-Liste aufgelöst hatte. Die Code-Änderung waren zwei Zeichen in einem Conditional; die Lehre war, dass leer und geladen unterschiedliche Zustände sind, die auf der Datenebene zufällig identisch rendern, und eine Lade-Zustandsmaschine wissen muss, in welchem der beiden sie ist, bevor sie das richtige UI wählen kann. Wir sind seitdem auf dieselbe Form an anderen Stellen der Codebasis gestossen — das Default-Verhalten von React Query, data: undefined beim ersten Fetch und data: [] beim leeren Erfolg zurückzugeben, ist das richtige Primitiv, aber es ist leicht, beides in einer einzigen Truthy-Prüfung zusammenzuziehen und die Unterscheidung zu verlieren.

Das ist die Art kleiner Kategorienfehler, die sich schwer in Tests fangen lässt, weil das gerenderte Ergebnis von «noch am Laden» und «geladen, aber leer» oft bis zum nächsten Tick ununterscheidbar ist, und das Zeitfenster, in dem sie divergieren, genau das Fenster ist, das die Nutzerin bemerkt. Es ist auch die Art Sache, die viel leichter zu erkennen ist, sobald die Lade-Zustandsmaschine ein explizites Objekt mit benannten Zuständen ist und kein Ad-hoc-isLoading || !data-Ternary tief im JSX. Wir behandeln loading | refetching | empty | ready jetzt als Vier-Werte-Union in den Codeteilen, die pro Zustand unterschiedlich rendern, und der Compiler fängt, wenn ein Zweig einen vergisst.

Die Regel, mit der wir herausgegangen sind

Drei Ladezustände, nicht einer. Formgetreue Skeletons beim leeren Erst-Render, eine dünne verzögerte Linie beim Refetch von sichtbarem Inhalt, und gar nichts, wenn der Ladevorgang die menschliche Reaktionszeit unterbietet. Ein useDelayed-Hook auf jedem Lade-Indikator, damit die schnellsten 80% der Ladevorgänge gar keinen Indikator zeigen. Ein Reduce-Motion-Fallback für jede Animation. Ein Screenreader-Label für jede Progress-Komponente. Und — das ist der Teil, der leicht übersehen wird — ein expliziter, benannter Zustand in der Komponente für «der Elterncontainer löst noch auf», getrennt sowohl von «wir laden von null» als auch von «wir refetchen Daten, die wir schon haben».

Ein Vollbild-Spinner ist billig hinzuzufügen und teuer zu leben. Die Belohnung dafür, ihn in drei Zustände zu zerlegen, ist, dass die App aufhört, sich bei jedem Tap neu zu laden anzufühlen, und anfängt, sich wie eine Oberfläche anzufühlen, die stehen bleibt, während frische Daten darauf landen — und darum geht es bei einer Listenansicht auf dem Handy letztlich. Dieser Instinkt liegt auch dem Stale-Data-Tradeoff zugrunde, über den wir im Next.js-revalidateTag-Stale-Data-Cache-Beitrag geschrieben haben: Der richtige Default ist, der Nutzerin das zu zeigen, was sie hat, bis es einen Grund gibt, das zu ändern — nicht den Screen jedes Mal zu leeren, wenn ein Query läuft.

Wenn Sie eine Mobile-App auf React Native oder Expo bauen und die Erst-Nutzerinnen sagen, dass sie sich langsam anfühlt, obwohl Ihr P95 in Ordnung ist, lautet die Antwort oft nicht, die Queries schneller zu machen — sondern aufzuhören, der Nutzerin zu zeigen, dass Queries passiert sind. Buchen Sie einen kostenlosen 30-Minuten-Call, und wir gehen die Ladefläche Ihrer App gemeinsam durch.

Quellen: React Native — Animated · React Native — AccessibilityInfo · MDN — prefers-reduced-motion · Expo-Dokumentation

zsopilot · Ausbildungskontrolle für den Zivilschutz — gebaut für den Ernstfall.

Mobile‑first Plattform mit NFC‑Check‑in, Live‑Dashboards und rollenbasierter Steuerung. Entwickelt für den Einsatz vor Ort.

NÄCHSTER SCHRITTHat dich das interessiert?