Anwendungsaufbau im Browser

Was ist eine Single-Page-Application?

SPA, Einseitenanwendung

Eine Single-Page-Application (SPA) ist eine Webanwendung, die ein einziges HTML-Dokument lädt und danach alle Ansichtswechsel im Browser selbst erledigt. Statt bei jedem Klick eine neue Seite vom Server zu holen, lädt sie nur noch Daten über Schnittstellen nach und baut die Oberfläche per JavaScript um.

Ein mehrstufiges Formular, das Zwischenstände behalten soll, ohne bei jedem Schritt neu zu laden, ist der typische Fall für diesen Aufbau.

KI-generiertDieses Bild wurde mit KI erzeugt · Yves Hoppe / KI / cmt
Lädt
Ein HTML-Dokument, danach nur noch Daten
Übernimmt selbst
Routing, Verlauf und Fehlerseiten
Braucht
Server-Fallback auf das eine Dokument
Verwechselt mit
Progressive Web App

Was beim Klick wirklich passiert

Bei einer klassischen Website fordert jeder Klick eine neue Seite an, der Browser wirft die alte weg und baut alles neu auf. In einer SPA fängt ein Router im JavaScript den Klick ab, ändert über die History-API die Adresszeile und tauscht nur den Teil der Oberfläche aus, der sich unterscheidet.

Deshalb bleibt der Zustand erhalten: eine halb ausgefüllte Eingabe, die Scrollposition einer Liste, eine offene Seitenleiste. Und deshalb wirkt der Wechsel sofort, denn statt eines vollständigen Dokuments wird oft nur eine kleine JSON-Antwort geholt, manchmal gar nichts, weil die Daten schon im Speicher liegen.

Wie das HTML einer SPA aussieht

Wer bei einer reinen SPA den Quelltext öffnet, sieht fast nichts: ein leeres Element als Einhängepunkt und ein Skript. Den gesamten sichtbaren Inhalt erzeugt erst das JavaScript, nachdem es geladen und ausgeführt wurde.

<!doctype html>
<html lang="de">
  <head>
    <title>Ticketsystem</title>
    <script type="module" src="/assets/app.js"></script>
  </head>
  <body>
    <div id="app"></div>
  </body>
</html>

Das erklärt beide typischen Eigenschaften auf einmal: Der erste Aufruf dauert länger, weil erst das Skript laden muss, bevor etwas zu sehen ist. Danach geht jeder Wechsel schnell, weil das Dokument bleibt und nur Daten fließen.

Warum der Server jede Adresse auf dasselbe Dokument lenken muss

Die Adressen einer SPA wie /tickets/4711 gibt es auf dem Server gar nicht als Datei, der Router im Browser erfindet sie. Solange du innerhalb der Anwendung klickst, fällt das nicht auf. Lädt jemand die Seite neu oder öffnet einen Link aus einer E-Mail, fragt der Browser den Server nach genau dieser Adresse und bekommt ohne Vorkehrung einen Fehler 404.

Deshalb braucht jede SPA einen Server-Fallback: Alle Anfragen, zu denen keine echte Datei existiert, bekommen das eine HTML-Dokument zurück, und der Router entscheidet dann, welche Ansicht er zeigt. In nginx sieht das so aus:

location / {
    try_files $uri $uri/ /index.html;
}

Mit dieser Regel liefert der Server allerdings auch für Tippfehler in der Adresse den Status 200. Eine echte „Seite nicht gefunden“-Meldung muss die Anwendung selbst anzeigen.

Frameworks und typische Beispiele

Eine SPA lässt sich ohne Hilfsmittel bauen, im Alltag übernimmt aber fast immer ein Framework Routing, Darstellung und Datenbindung. Die verbreitetsten sind:

  • React

    Eine Bibliothek für Oberflächen von Meta, die mit einem Router wie React Router zur SPA wird. Next.js baut darauf auf und mischt Server- und Browser-Rendering.

  • Angular

    Ein vollständiges Framework von Google mit eigenem Router, Formularen und HTTP-Client, verbreitet in großen Unternehmensanwendungen.

  • Vue

    Ein Framework mit offiziellem Router und der Zustandsbibliothek Pinia, Nuxt ergänzt serverseitiges Rendering.

  • Svelte

    Übersetzt Komponenten beim Bauen in schlankes JavaScript, SvelteKit liefert Routing und Server-Rendering dazu.

Bekannte Beispiele für das Prinzip sind Webmailer wie Gmail oder Outlook im Web, Kartendienste und Projektboards: Du arbeitest stundenlang in derselben Oberfläche, ohne dass die Seite ein einziges Mal komplett neu lädt.

Vor- und Nachteile im Vergleich

Ob eine SPA die richtige Wahl ist, hängt davon ab, was die Anwendung leisten muss. Der Vergleich mit einer klassischen Website, bei der der Server jede Seite einzeln liefert, zeigt die Unterschiede:

AspektSingle-Page-ApplicationKlassische Website
Erster AufrufLangsamer, JavaScript muss erst ladenSchnell, fertiges HTML
Wechsel danachSehr schnell, nur DatenNeues Dokument je Klick
ZustandBleibt im Speicher erhaltenGeht beim Seitenwechsel verloren
SuchmaschinenNur mit Server-Rendering verlässlichProblemlos indexierbar
AufwandRouting, Fehler, Fokus selbst bauenBringt der Browser mit
BackendLiefert eine API, oft für App und WebLiefert fertige Seiten

Wann eine SPA passt und wann nicht

Für Anwendungen mit vielen Interaktionen hinter einer Anmeldung ist das Modell stark: ein Planungswerkzeug, ein Ticketsystem, eine Verwaltungsoberfläche. Dort zählt, dass Zustand bestehen bleibt und Wechsel ohne Neuaufbau laufen, und Suchmaschinen spielen keine Rolle.

Für inhaltsgetriebene Seiten ist sie oft zu viel. Ein Fachtext oder ein Katalog braucht schnelle erste Anzeige und indexierbares HTML, beides bekommst du serverseitig einfacher. Die Frameworks haben darauf reagiert und mischen heute: Der Rahmen kommt vom Server, einzelne Bereiche verhalten sich wie eine SPA.

KI-generiertDieses Bild wurde mit KI erzeugt · Yves Hoppe / KI / cmt
Nicht verwechseln

Single-Page-Application und was oft damit gleichgesetzt wird

Single-Page-Application gegen Multi-Page-Application

Dort liefert der Server pro Klick ein neues Dokument. Das ist einfacher zu bauen und zu betreiben, und mit Techniken wie Turbo oder htmx fühlt es sich sehr ähnlich an, ohne dass du Routing und Zustand selbst verwaltest.

Single-Page-Application gegen Onepager

Ein Onepager ist eine Website, deren gesamter Inhalt auf einer langen Seite steht, Menüpunkte springen per Anker nach unten. Das ist eine Gestaltungsform für Inhalte, keine Anwendung, und braucht weder Router noch Datenschnittstelle.

Single-Page-Application gegen Progressive Web App

Eine PWA ist über einen Service Worker installierbar und offlinefähig. Das lässt sich mit einer SPA kombinieren, ist aber unabhängig davon: Auch eine klassische Seite kann eine PWA sein.

Single-Page-Application gegen Server-Side Rendering

SSR beschreibt, wo das HTML entsteht, SPA beschreibt, wer die Navigation übernimmt. Eine Anwendung kann serverseitig gerendert werden und sich danach trotzdem wie eine SPA verhalten.

KI-generiertDieses Bild wurde mit KI erzeugt · Yves Hoppe / KI / cmt
In der Praxis

Alles, was der Browser bisher geschenkt hat, baust du nach

Beim Klick auf einen Link wechselt keine Seite, sondern die Anwendung tauscht Inhalte aus und schreibt die neue Adresse in den Verlauf. Damit liegt der Zurück-Button in deiner Verantwortung, ebenso die Scrollposition beim Zurückspringen. Auch der Ladezustand braucht eine sichtbare Rückmeldung, weil der Browser keinen Fortschritt mehr anzeigt, und schlägt das Nachladen fehl, gibt es keine Fehlerseite des Servers, die einspringt.

Weniger offensichtlich ist die Bedienung ohne Maus. Nach einem Ansichtswechsel bleibt der Tastaturfokus dort, wo er vorher war, und wer mit einer Sprachausgabe arbeitet, bekommt nicht mit, dass sich überhaupt etwas geändert hat. Seitentitel und Fokus müssen nach jedem Wechsel gesetzt werden, üblich ist der Fokus auf die neue Überschrift und eine Ansage über einen Live-Bereich. Sonst ist die Anwendung für einen Teil der Belegschaft unbrauchbar.

Der dritte Punkt ist das Gewicht. Alles, was die Anwendung jemals braucht, kommt zunächst in einem Paket, und das wächst mit jedem neuen Bildschirm. Ohne Aufteilung nach Route lädt jemand, der nur ein Formular ausfüllen will, die Auswertungen gleich mit herunter. Lazy Loading pro Route ist deshalb kein Feinschliff, sondern gehört von Anfang an dazu.

Single-Page-Application lernen

Routing, Zustand und das Nachladen von Daten hängen enger zusammen, als es zunächst aussieht, und genau daran arbeiten die JavaScript-Trainings für Entwicklerteams.

Wenn du das Modell mit serverseitig erzeugten Seiten vergleichen willst, hilft der Überblick in den Kursen rund um Frontend-Architektur.

Häufige Fragen

Sind SPAs schlecht für die Sichtbarkeit in Suchmaschinen?
Sie machen es schwerer. Wenn die Inhalte erst durch JavaScript entstehen, hängt die Indexierung davon ab, dass der Crawler das ausführt, was Zeit kostet und nicht garantiert ist. Für Inhalte, die gefunden werden sollen, lieferst du besser fertiges HTML aus, etwa über Server-Side Rendering oder statisch erzeugte Seiten.
Ist jede React-Anwendung eine SPA?
Nein. React selbst legt nur fest, wie Komponenten dargestellt werden. Mit einem clientseitigen Router entsteht eine SPA, mit Next.js oder einem anderen Server-Framework kann dieselbe Oberfläche auch serverseitig gerendert und als normale Seiten ausgeliefert werden.
Brauche ich für eine SPA eine Zustandsbibliothek?
Erst wenn Daten an mehreren, weit auseinanderliegenden Stellen gebraucht werden. Vieles, was früher in einen globalen Speicher wanderte, ist in Wahrheit zwischengespeicherte Serverantwort und gehört in eine Datenbibliothek, nicht in den Anwendungszustand.
Wie halte ich die Anmeldung sicher?
Ein Token im Local Storage ist über eingeschleustes JavaScript auslesbar. Robuster ist ein Cookie mit HttpOnly und SameSite, das der Browser automatisch mitschickt und das JavaScript gar nicht erst sieht.

Passt thematisch dazu

Ob React, Angular, Vue oder Svelte zu deinem Team passt, entscheiden die sechs Kriterien für die Wahl eines Frontend-Frameworks.

Wenn deine SPA zusätzlich gefunden werden soll, hilft der Prüfstein, ob ein Projekt Next.js wirklich braucht.

Persönlich für dich da

Deine Ansprechpartner

Du willst das Thema nicht nur nachschlagen, sondern anwenden können? Wir beraten dich persönlich und kostenlos.

Yves Hoppe

Yves Hoppe

Weiterbildung & Beratung

Ordnet mit dir ein, welcher Kurs zu deinem Vorwissen passt.

Norbert Jansen

Norbert Jansen

Beratung & Inhouse

Plant Inhouse-Trainings, die an euren eigenen Daten und Abläufen ansetzen.

Single-Page-Application im Kurs statt im Lexikon

Nachschlagen bringt dich bis zum Verstehen. Anwenden lernst du an echten Aufgaben.