HTMX: Moderne Webanwendungen ohne JavaScript-Framework bauen

Eine Anleitung von der Einbindung bis zur Inline-Bearbeitung, mit Serverseite, Sicherheitsfragen und dem Stand von HTMX 4
Aktualisiert:
Abstract
- #HTMX
- #Webentwicklung
- #JavaScript-Frameworks
- #Moderne Webanwendungen
- #Frontend-Entwicklung
- #Server-seitiges Rendering
- #Dynamische Websites
- #Web-Performance
- #Web-Design
- #Web-Technologien
Wie weit kommt eine Geschäftsanwendung mit HTML vom Server und ein paar Attributen?
Angenommen, die Vertriebsabteilung eines Maschinenbauers wünscht sich eine kleine Kontaktverwaltung im Intranet: eine Liste, ein Formular für neue Einträge, Namen direkt in der Liste korrigieren, Einträge löschen. Im Jahr 2026 landet so ein Auftrag oft reflexhaft bei React oder Vue, samt Build-Werkzeug, JSON-Schnittstelle, Zustandsverwaltung im Browser und einem Paket, das bei jeder Abhängigkeit mitwächst. Für ein paar Formulare und eine Tabelle ist das viel Maschinerie.
HTMX geht den umgekehrten Weg. Die kleine JavaScript-Bibliothek erweitert HTML um Attribute, mit denen Schaltflächen, Formulare und andere Elemente Anfragen an den Server schicken und einen Teil der Seite durch die Antwort ersetzen. Der Server liefert fertiges HTML, keine Daten zum Weiterverarbeiten. Die folgende Anleitung baut die Kontaktverwaltung Schritt für Schritt auf, zeigt die Gegenseite auf dem Server und ordnet ein, wo der Ansatz trägt, wo nicht und was die im Sommer 2026 erschienene Version 4 ändert.
Warum viele Anwendungen kein SPA-Framework brauchen
Eine Single-Page-Application (SPA) erzeugt die Oberfläche komplett im Browser. Der Server stellt nur noch Daten bereit, meist als JSON. Das ist für bestimmte Anwendungen genau richtig: Ein Grafikeditor, eine Tabellenkalkulation im Browser oder ein Planungswerkzeug mit Drag-and-drop halten viel Zustand lokal und müssen ohne Umweg über den Server reagieren.
Ein großer Teil der Geschäftsanwendungen sieht aber anders aus. Kundenportale, Ticketsysteme, Verwaltungsoberflächen und interne Werkzeuge bestehen im Kern aus Listen, Detailansichten und Formularen. Die eigentliche Logik, also Berechtigungen, Validierung und Geschäftsregeln, liegt ohnehin auf dem Server. Eine SPA dupliziert davon einen Teil im Browser und fügt eine Schicht hinzu, die gepflegt, getestet und aktualisiert werden will: Build-Konfiguration, Routing im Browser, Datenabgleich mit dem Server, Fehlerbehandlung an zwei Stellen.
HTMX lässt diese Schicht weg. Die Oberfläche entsteht weiter auf dem Server, etwa mit Django, Laravel, Spring, ASP.NET Core oder Express. Nur dort, wo sich ein Seitenteil ändern soll, kommt ein Attribut dazu. Der Grundgedanke dahinter heißt Hypermedia: Das HTML vom Server enthält nicht nur Inhalte, sondern auch die nächsten möglichen Aktionen. Wie das Konzept im Detail funktioniert und woher HTMX kommt, beschreibt unser Beitrag Moderne Webanwendungen mit HTMX. Hier geht es um die Umsetzung.
Das Prinzip in einem Satz: Anfrage, Antwort, Austausch
Jede HTMX-Interaktion folgt demselben Muster. Ein Element löst bei einem Ereignis eine HTTP-Anfrage aus, der Server antwortet mit einem HTML-Schnipsel, und HTMX setzt diesen Schnipsel an einer bestimmten Stelle der Seite ein. Vier Fragen bestimmen das Verhalten, und für jede gibt es ein Attribut:
- Welche Anfrage an welche Adresse?
hx-get,hx-post,hx-put,hx-patchoderhx-delete. - Wann?
hx-trigger, etwa bei Klick, Eingabe, Absenden oder sobald ein Element sichtbar wird. Ohne Angabe gilt ein sinnvoller Standard: Klick bei Schaltflächen, Absenden bei Formularen, Änderung bei Eingabefeldern. - Wohin mit der Antwort?
hx-targetmit einem CSS-Selektor. - Wie einsetzen?
hx-swap, zum BeispielinnerHTML(Inhalt ersetzen),outerHTML(ganzes Element ersetzen) oderbeforeend(anhängen).
Wer diese vier Fragen beantworten kann, beherrscht den größten Teil dessen, was HTMX im Alltag ausmacht.
Schritt für Schritt: eine Kontaktverwaltung mit HTMX
Das Beispiel kommt mit einer einzigen HTML-Seite und einer Handvoll Server-Endpunkten aus. Eigenes JavaScript ist dafür nicht nötig.
HTMX einbinden
Für erste Versuche genügt ein Skript-Tag mit fest angegebener Version:
<head>
<meta charset="utf-8" />
<title>Kontakte</title>
<script src="https://cdn.jsdelivr.net/npm/htmx.org@2.0.11/dist/htmx.min.js"></script>
</head>
Im Produktivbetrieb gehört die Datei auf den eigenen Server oder kommt über den Paketmanager npm ins Projekt. Das macht die Anwendung unabhängig von einem fremden Dienst, und es fließen keine IP-Adressen der Nutzer an ein CDN, wofür nach der DSGVO eine Rechtsgrundlage nötig wäre. Ein Build-Schritt ist in beiden Fällen nicht erforderlich.
Inhalte nachladen
Die Kontaktliste soll erst auf Knopfdruck erscheinen:
<button hx-get="/kontakte" hx-target="#kontakt-liste">Kontakte laden</button>
<ul id="kontakt-liste">
<!-- hier setzt HTMX die Antwort des Servers ein -->
</ul>
Ein Klick schickt eine GET-Anfrage an /kontakte. Der Server antwortet nicht mit einer ganzen Seite, sondern nur mit den Listeneinträgen:
<li id="kontakt-1">Max Mustermann – max@beispiel.de</li>
<li id="kontakt-2">Erika Musterfrau – erika@beispiel.de</li>
Da innerHTML die Standardeinstellung ist, landen die Einträge im leeren ul. Soll die Liste gleich beim Laden der Seite erscheinen, genügt hx-trigger="load" am ul selbst.
Formulare ohne Neuladen absenden
Ein neuer Kontakt wird über ein normales Formular angelegt. Das Attribut hx-post sorgt dafür, dass HTMX die Felder abschickt und nur einen Bereich aktualisiert:
<form
hx-post="/kontakte"
hx-target="#kontakt-liste"
hx-swap="beforeend"
hx-on::after-request="if(event.detail.successful) this.reset()"
>
<input type="text" name="name" placeholder="Name" required />
<input type="email" name="email" placeholder="E-Mail" required />
<button type="submit">Speichern</button>
</form>
Der Server legt den Kontakt an und gibt genau einen neuen Listeneintrag zurück, den beforeend ans Ende der Liste hängt. Das Attribut hx-on leert das Formular nach erfolgreichem Absenden. Es ist eine der wenigen Stellen, an denen ein Ausdruck in JavaScript auftaucht; wer das vermeiden will, lässt den Server stattdessen ein frisches, leeres Formular mitschicken.
Die Browser-Validierung über required und type="email" bleibt erhalten, weil HTMX das native Absenden des Formulars abfängt und nicht ersetzt. Die serverseitige Prüfung ersetzt sie natürlich nicht.
Ladeanzeige einblenden
Bei langsamen Antworten sollten Nutzer sehen, dass etwas passiert. HTMX blendet Elemente mit der Klasse htmx-indicator während einer Anfrage ein:
<button hx-get="/kontakte" hx-target="#kontakt-liste" hx-indicator="#laedt">
Kontakte laden
</button>
<span id="laedt" class="htmx-indicator">Wird geladen …</span>
Die nötigen Standardstile bringt HTMX selbst mit: Das Element ist unsichtbar und wird während der Anfrage eingeblendet. Wer eigene Stile verwenden möchte, kann das über die Klasse htmx-request steuern, die HTMX während der Anfrage setzt.
Einträge direkt in der Liste bearbeiten
Inline-Bearbeitung zeigt gut, wie der Server die Oberfläche steuert. Jeder Listeneintrag erhält einen Bearbeiten-Knopf:
<li id="kontakt-1">
Max Mustermann – max@beispiel.de
<button
hx-get="/kontakte/1/bearbeiten"
hx-target="closest li"
hx-swap="outerHTML"
>
Bearbeiten
</button>
</li>
Der Ausdruck closest li ist eine HTMX-Erweiterung der Selektor-Syntax und meint den nächsten umschließenden Listeneintrag. Der Server antwortet mit einem Formular, das den ganzen Eintrag ersetzt:
<li id="kontakt-1">
<form hx-put="/kontakte/1" hx-target="closest li" hx-swap="outerHTML">
<input type="text" name="name" value="Max Mustermann" />
<input type="email" name="email" value="max@beispiel.de" />
<button type="submit">Speichern</button>
<button
type="button"
hx-get="/kontakte/1"
hx-target="closest li"
hx-swap="outerHTML"
>
Abbrechen
</button>
</form>
</li>
Nach dem Speichern liefert der Server wieder die normale Zeile aus. Ob ein Nutzer einen Eintrag überhaupt bearbeiten darf, entscheidet allein der Server, indem er den Knopf ausgibt oder weglässt. Im Browser muss diese Regel niemand nachbauen.
Löschen mit Rückfrage
Zum Abschluss ein Löschknopf mit Sicherheitsabfrage:
<button
hx-delete="/kontakte/1"
hx-target="closest li"
hx-swap="outerHTML"
hx-confirm="Diesen Kontakt wirklich löschen?"
>
Löschen
</button>
hx-confirm zeigt den Bestätigungsdialog des Browsers. Antwortet der Server mit Status 200 und leerem Inhalt, ersetzt HTMX den Eintrag durch nichts, er verschwindet also aus der Liste.
Die Gegenseite: was der Server liefern muss
HTMX ist an kein Backend gebunden. Der Server muss nur HTML-Schnipsel ausgeben können. Das folgende Beispiel nutzt Node.js mit Express und hält die Daten der Einfachheit halber im Speicher:
import express from 'express';
const app = express();
app.use(express.urlencoded({ extended: false }));
const kontakte = [
{ id: 1, name: 'Max Mustermann', email: 'max@beispiel.de' },
{ id: 2, name: 'Erika Musterfrau', email: 'erika@beispiel.de' },
];
let naechsteId = 3;
// Benutzereingaben maskieren, damit kein fremdes HTML in die Seite gelangt
const ERSATZ = {
'&': '&',
'<': '<',
'>': '>',
'"': '"',
"'": ''',
};
const maskieren = (text) => String(text).replace(/[&<>"']/g, (z) => ERSATZ[z]);
const zeile = (k) => `
<li id="kontakt-${k.id}">
${maskieren(k.name)} – ${maskieren(k.email)}
<button hx-get="/kontakte/${k.id}/bearbeiten" hx-target="closest li" hx-swap="outerHTML">Bearbeiten</button>
<button hx-delete="/kontakte/${k.id}" hx-target="closest li" hx-swap="outerHTML"
hx-confirm="Diesen Kontakt wirklich löschen?">Löschen</button>
</li>`;
app.get('/kontakte', (req, res) => {
const liste = kontakte.map(zeile).join('');
// Caches mitteilen, dass die Antwort vom HX-Request-Header abhängt
res.set('Vary', 'HX-Request');
if (req.get('HX-Request')) {
res.send(liste); // nur das Fragment für HTMX
} else {
res.send(
`<!doctype html><html lang="de"><body><ul>${liste}</ul></body></html>`,
);
}
});
app.post('/kontakte', (req, res) => {
const name = (req.body.name ?? '').trim();
const email = (req.body.email ?? '').trim();
if (!name || !email) {
return res.status(422).send('<p>Bitte Name und E-Mail angeben.</p>');
}
const kontakt = { id: naechsteId++, name, email };
kontakte.push(kontakt);
res.send(zeile(kontakt));
});
app.delete('/kontakte/:id', (req, res) => {
const index = kontakte.findIndex((k) => k.id === Number(req.params.id));
if (index !== -1) kontakte.splice(index, 1);
res.send(''); // leere Antwort entfernt den Eintrag
});
app.listen(3000);
Die Endpunkte zum Bearbeiten und Speichern folgen demselben Muster und sind hier weggelassen. In einem echten Projekt übernimmt eine Template-Engine wie Jinja, Blade, Thymeleaf oder Razor die Zeilen, und dieselbe Vorlage dient sowohl für die ganze Seite als auch für das einzelne Fragment.
Vier Punkte verdienen besondere Aufmerksamkeit:
- Ganze Seite oder Fragment: HTMX schickt bei seinen Anfragen den Header
HX-Requestmit. So kann derselbe Endpunkt beim direkten Aufruf eine vollständige Seite liefern und bei einer HTMX-Anfrage nur den Ausschnitt. DerVary-Header verhindert, dass ein Zwischenspeicher die falsche Variante ausliefert. - Fehlerantworten: HTMX 2 setzt Antworten mit Statuscodes ab 400 standardmäßig nicht in die Seite ein. Die Fehlermeldung aus dem Beispiel bleibt also unsichtbar, solange das Verhalten nicht über die Konfiguration
responseHandlingangepasst wird oder der Server Validierungsfehler mit Status 200 als Formular mit Hinweisen zurückgibt. Viele Teams wählen den zweiten Weg. - Maskierung: Weil HTMX Server-HTML direkt in die Seite einsetzt, ist sauberes Maskieren von Benutzereingaben Pflicht. Template-Engines erledigen das in der Regel automatisch, handgebaute Zeichenketten wie im Beispiel nicht.
- CSRF-Schutz: Formulare, die Daten ändern, brauchen wie in jeder Serveranwendung ein Token gegen Cross-Site Request Forgery, also gegen untergeschobene Anfragen von fremden Seiten. Mit
hx-headersambody-Element lässt sich das Token an alle Anfragen anhängen.
Wo HTMX an Grenzen stößt
Die Kontaktverwaltung zeigt die Stärken: wenig Code, eine einzige Stelle für die Logik, keine Toolchain im Browser. Die Grenzen zeigen sich, sobald eine Oberfläche viel lokalen Zustand braucht. Ein Kalender mit Drag-and-drop, ein Diagrammeditor oder ein Formular, das bei jeder Eingabe zehn abhängige Felder neu berechnet, lassen sich zwar mit HTMX bauen, fühlen sich aber schnell zäh an, weil jede Änderung einen Weg über das Netz braucht. Auch Anwendungen, die offline funktionieren sollen, passen nicht zum Modell.
Ein zweiter Punkt ist die Latenz. Eine SPA kann sofort reagieren und im Hintergrund speichern. Bei HTMX hängt die gefühlte Geschwindigkeit direkt davon ab, wie schnell der Server antwortet. Ein langsames Backend lässt sich nicht hinter einer optimistischen Anzeige verstecken. Umgekehrt profitieren die Ladezeiten, weil der Browser kein großes Anwendungspaket herunterladen und ausführen muss.
Für kleine Interaktionen ohne Serverbezug, etwa ein aufklappendes Menü oder einen Tab-Wechsel, kombinieren viele Teams HTMX mit Alpine.js oder ein paar Zeilen eigenem JavaScript. Wer dagegen eine Oberfläche mit vielen voneinander abhängigen Komponenten plant, ist mit einem Framework besser bedient. Welches dann passt, vergleicht unser Beitrag Frontend-Frameworks im Unternehmenseinsatz: Angular, React, Vue und Svelte.
HTMX steht dabei nicht allein. Hotwire mit Turbo aus dem Umfeld von Ruby on Rails, Livewire für Laravel und Phoenix LiveView verfolgen eine ähnliche Idee, sind aber stärker auf ein Backend-Framework zugeschnitten: Livewire und LiveView setzen Laravel bzw. Phoenix voraus, Turbo funktioniert zwar auch ohne Rails, hat dort aber seine Referenzintegration. HTMX ist die backendneutrale Variante: Es funktioniert mit jeder Sprache, die HTML ausgeben kann.
HTMX 4: was sich ändert und wann sich der Umstieg lohnt
Ende August 2026 erschien HTMX 4.0. Eine Version 3 gibt es nicht; das Projekt hat sie bewusst übersprungen. Für den Alltag wichtiger ist eine zweite Entscheidung: Als Standardversion beim Paketmanager bleibt vorerst Version 2, und das Projekt hat angekündigt, Version 2 unbefristet weiter zu unterstützen. Bestehende Anwendungen geraten also nicht unter Zeitdruck.
Technisch ist Version 4 ein größerer Umbau. Die wichtigsten Änderungen nach Angaben des Projekts:
- fetch statt XMLHttpRequest: HTMX nutzt intern die moderne
fetch()-Schnittstelle des Browsers. Für Antworten, die in Teilen eintreffen (Streaming), und für Server-Sent Events, mit denen der Server laufend Aktualisierungen schickt, liefert das Projekt eigene Erweiterungen mit. - Explizite Vererbung: In Version 2 erben Kindelemente Attribute wie
hx-targetautomatisch von übergeordneten Elementen, ähnlich wie bei CSS. Das war praktisch, führte in größeren Seiten aber zu schwer nachvollziehbarem Verhalten. In Version 4 muss Vererbung ausdrücklich gekennzeichnet werden, etwa mithx-target:inherited. - Einfachere Browser-Historie: Statt Momentaufnahmen der Seite im lokalen Speicher des Browsers abzulegen, lädt HTMX 4 beim Zurück-Navigieren die Seite neu vom Server.
- Morphing im Kern: Der Idiomorph-Algorithmus, der neue und alte Seitenteile abgleicht, statt sie komplett auszutauschen, war bisher eine Erweiterung und gehört nun zum Kern. Dadurch bleiben etwa Fokus und Eingaben in Formularen beim Aktualisieren besser erhalten.
- Neue Ereignisnamen und Fehlerbehandlung: Die Namen der HTMX-Ereignisse folgen einem neuen Schema, und auch Fehlerantworten werden standardmäßig anders behandelt als in Version 2.
Unsere Einschätzung: Für neue Projekte, die erst in einigen Monaten produktiv gehen, lohnt ein Blick auf Version 4, vor allem wegen der expliziten Vererbung, die größere Seiten leichter wartbar macht. Wer heute eine Anwendung mit Version 2 betreibt, hat keinen Grund zur Eile. Die Grundkonzepte, also Attribute für Anfrage, Ziel und Austausch, bleiben gleich. Vor einem Wechsel sollten Teams den Migrationsleitfaden des Projekts lesen und vor allem eigene Ereignisbehandlung und vererbte Attribute prüfen.
Was das für Ihr Team bedeutet
HTMX ist kein Ersatz für React, Vue oder Angular, sondern ein anderes Werkzeug für eine andere Art von Anwendung. Überschätzt wird oft das Schlagwort „ohne JavaScript“: Die Bibliothek ist selbst JavaScript, und anspruchsvolle Oberflächen brauchen weiterhin Code im Browser. Unterschätzt wird dagegen, wie viel Aufwand bei formularlastigen Geschäftsanwendungen entfällt, wenn es keine zweite Anwendung im Browser gibt, die mit dem Server synchron gehalten werden muss.
Besonders profitieren Teams, die ohnehin stark im Backend arbeiten, etwa mit Java, .NET, PHP oder Python. Sie können Oberflächen mit den Werkzeugen bauen, die sie kennen, und brauchen keine eigene Frontend-Spezialisierung. Auch bestehende serverseitige Anwendungen lassen sich mit HTMX Seite für Seite modernisieren, ohne die Architektur umzubauen.
Unsere Empfehlung: Bevor für eine neue interne Anwendung ein SPA-Framework gesetzt wird, lohnt sich ein kleiner Prototyp mit HTMX, etwa eine einzelne Liste mit Bearbeitungsfunktion. Nach wenigen Tagen zeigt sich, ob die Latenz akzeptabel ist und ob das Team mit dem Modell zurechtkommt. Fällt der Test positiv aus, spart das Projekt eine ganze Schicht an Code und Abstimmung.
Wenn Sie abwägen möchten, welcher Frontend-Ansatz zu Ihrem Vorhaben passt, oder Ihr Team in HTMX und anderen Webtechnologien schulen wollen, finden Sie Beratung und Seminare auf unserer Themenseite Web- und Frontend-Technologien. Bei der Umsetzung kompletter Anwendungen unterstützt unsere Web- und App-Entwicklung.
Häufige Fragen zu HTMX in der Praxis
Wie testet man eine HTMX-Anwendung?
Der größte Teil der Logik steckt in Server-Endpunkten, die HTML zurückgeben. Diese lassen sich mit den üblichen Werkzeugen des jeweiligen Backends testen, etwa indem ein Test prüft, ob die Antwort die erwartete Zeile enthält. Für das Zusammenspiel im Browser eignen sich End-to-End-Tests mit Werkzeugen wie Playwright oder Cypress.
Funktioniert die Anwendung auch ohne JavaScript im Browser?
Nur, wenn sie darauf ausgelegt ist. Formulare und Links mit regulären action- und href-Angaben funktionieren auch ohne HTMX, wenn der Server jeweils eine vollständige Seite liefert. Das Attribut hx-boost nutzt genau diesen Weg und rüstet normale Links und Formulare nach. Rein über hx-get an einer Schaltfläche ausgelöste Aktionen funktionieren ohne JavaScript dagegen nicht.
Lohnt sich der Umstieg auf HTMX 4 sofort?
Für laufende Anwendungen in der Regel nicht. Version 2 wird weiter gepflegt, und die Umstellung betrifft vor allem Ereignisnamen, vererbte Attribute und die Fehlerbehandlung. Neue Projekte können mit Version 4 starten, wenn das Team bereit ist, mit einer noch jungen Hauptversion zu arbeiten, für die es weniger Beispiele und Erfahrungsberichte gibt.
Wie groß ist HTMX?
Laut Projekt ist die Bibliothek komprimiert etwa 16 Kilobyte groß und hat keine Abhängigkeiten. Im Vergleich zu einer typischen SPA mit Framework, Routing und Zustandsverwaltung ist das wenig. Für die Ladezeit entscheidend bleibt aber, wie schnell der Server die HTML-Fragmente erzeugt.
Kategorien