# Dynamische Webentwicklung mit Django und HTMX vereinfachen (Teil 4): Wie werden Payloads gesendet?

Im Gegensatz zu herkömmlichen Ajax-Anfragen mit `fetch` in JavaScript, bei denen man für POST-Anfragen den Payload oft direkt mit `JSON.stringify()` zusammenstellt, wie zum Beispiel:

```JavaScript
fetch("/api/todos/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-CSRFToken": csrftoken
  },
  body: JSON.stringify({
    title: "장보기",
    done: false,
    priority: 3
  })
})
```

Wie handhabt das **HTMX**? Wie genau sendet `hx-post` Daten an den Server? Da viele Beispiele nur sehr einfache Funktionen zeigen, ist es überraschend schwer, praktische Beispiele für die Übertragung komplexer Payloads zu finden.

Dieser Beitrag wird die Datenübertragungsarten in HTMX und deren Verarbeitung auf dem Server vollständig erläutern.


![Flowchart des HTMX-Datenflusses in DJANGO](/media/whitedec/blog_img/fbe9c41ba8ea4eabb78e760e1f768482.webp)

------

## HTMX-Datenübertragungsarten {#sec-1f930b1a0dad}

**Der Ansatz für den Payload bei `fetch` und die Datenübertragungsart von `hx-post` unterscheiden sich erheblich.**

Bei `fetch` erstellt der Entwickler direkt ein Objekt und wandelt es in JSON um, das dann in den Body gelegt wird. **HTMX hingegen sammelt grundsätzlich Werte aus dem DOM und sendet diese.**

Die Denkweise von HTMX ist nicht, „JS-Objekte direkt zusammenzustellen“, sondern **„Werte aus HTML-Elementen zu sammeln, um Anfrageparameter zu erstellen“**. Dafür werden üblicherweise die folgenden drei Methoden verwendet:

### 1) Werte über Formulare sammeln und senden {#sec-f5086851ac19}

Dies ist die HTML-konformste Methode und passt gut zu Django.

```html
<form hx-post="/todos/create/" hx-target="#todo-list">
    <input type="text" name="title" placeholder="제목">
    <input type="number" name="priority" value="3">
    <input type="hidden" name="done" value="false">
    <button type="submit">등록</button>
</form>
```

In diesem Fall sammelt HTMX die Eingabewerte innerhalb des Formulars und sendet sie in der Anfrage. Die Standardkodierung ist **URL-encoded form data**, genau wie bei einer normalen Formularübermittlung.

In einer Django-View kann man sie wie gewohnt empfangen:

```Python
def create_todo(request):
    title = request.POST.get("title")
    priority = request.POST.get("priority")
    done = request.POST.get("done")
```

### 2) Werte anderer Elemente ohne Formular einbeziehen: `hx-include` {#sec-a2c0e1f9e1ca}

Dies wird verwendet, wenn man `hx-post` an einen einzelnen Button anfügt und nur bestimmte, weiter entfernte Eingabewerte mitsenden möchte.

```HTML
<input type="text" id="title" name="title" placeholder="제목">
<input type="number" id="priority" name="priority" value="3">

<button hx-post="/todos/create/"
        hx-include="#title, #priority"
        hx-target="#todo-list">
    등록
</button>
```

`hx-include` fügt die Werte der angegebenen Elemente der Anfrage hinzu. Man muss nicht das gesamte Element in `<form>` einschließen, um ein ähnliches Ergebnis wie einen Payload zu erzielen, was bei wenigen Eingabefeldern sehr nützlich ist.

### 3) Versteckte oder berechnete Werte hinzufügen: `hx-vals` {#sec-f3e44212771a}

Dies ist die Funktion, die dem Konzept am nächsten kommt, einen Teil des Payload-Objekts direkt in `fetch` zu erstellen.

```HTML
<button hx-post="/todos/create/"
        hx-vals='{"title": "장보기", "done": false, "priority": 3}'
        hx-target="#todo-list">
    빠른 등록
</button>
```

`hx-vals` fügt der Anfrage zusätzliche Parameter hinzu. Standardmäßig wird die obige JSON-Syntax verwendet, aber mit dem Präfix `js:` können auch dynamische JavaScript-berechnete Werte gesendet werden.

```HTML
<input type="text" id="title" placeholder="제목">

<button hx-post="/todos/create/"
        hx-vals='js:{title: document.querySelector("#title").value, done: false, priority: 3}'
        hx-target="#todo-list">
    등록
</button>
```

Auch in diesem Fall liest Django die Werte über `request.POST`. Denn `hx-vals` **definiert Werte in einer JSON-ähnlichen Syntax**, macht aber den Anfragetext selbst nicht zu JSON.

------

## Wichtiger Hinweis: `hx-vals` ist kein "JSON Payload" {#sec-c31077e0c2ea}

Dies ist der verwirrendste Punkt, wenn man HTMX zum ersten Mal begegnet.

```HTML
<button hx-post="/my-url/" hx-vals='{"a":1, "b":2}'>
```

Dieser Code bedeutet nicht, dass ein „JSON-Objekt als Body gesendet wird“, sondern eher, dass **`a=1&b=2` zu den Anfrageparametern hinzugefügt wird**. Das bedeutet, der Server muss die Daten immer noch wie Formulardaten verarbeiten.

### Was, wenn man wirklich einen JSON-Body senden möchte? {#sec-ea728484bd6f}

Wenn man unbedingt das `application/json`-Format wie bei `fetch(... JSON.stringify(payload))` verwenden muss, benötigt man die **`json-enc`-Erweiterung** von HTMX.

Man konfiguriert sie gemäß der offiziellen Dokumentation wie folgt:

```HTML
<script src="https://unpkg.com/htmx.org@1.9.12/dist/ext/json-enc.js"></script>

<button hx-post="/api/todos/"
        hx-ext="json-enc"
        hx-vals='{"title": "장보기", "done": false, "priority": 3}'
        hx-target="#result">
    JSON로 전송
</button>
```

Jetzt erst wird es zu unserer bekannten JSON-Payload-Methode. In diesem Fall ist `request.POST` in der Django-View leer, daher muss man `request.body` direkt lesen.

```Python
import json

def create_todo_api(request):
    data = json.loads(request.body)
    title = data.get("title")
    # ... 로직 처리 ...
    return JsonResponse({"ok": True})
```

------

## HTMX und DRF: Unterschiedliche Philosophien, aber keine Notwendigkeit zur Verschmelzung {#sec-aff378931c81}

Obwohl man JSON mithilfe der Erweiterung senden kann, bleibt die Frage, ob dies der HTMX-eigenen Art entspricht. Dies liegt daran, dass hier zwei Philosophien kollidieren: die **„datenorientierte“ (DRF)** und die **„hypermedienorientierte“ (HTMX)**.

Wenn man sich entscheidet, HTMX richtig einzusetzen, muss man sich vielleicht vorübergehend von der datenorientierten Denkweise lösen. Werte über `<form>`, `hx-include` und `hx-vals` zu senden, und der Server empfängt diese über `request.POST` und **gibt HTML-Snippets anstelle von JSON zurück** – genau hier glänzt HTMX am meisten.

### Was, wenn man auf DRF-Serialisierer nicht verzichten möchte? {#sec-2a26aeec3b61}

Die Serialisierer von DRF sind wirklich mächtig. Sollte man dieses praktische Validierungstool aufgeben und sich mit dem mühsamen `request.POST.get()` zufriedengeben, nur weil man HTMX verwendet?

Glücklicherweise validieren DRF-Serialisierer nicht nur JSON, sondern auch Formulardaten hervorragend. Da dieser Teil den Rahmen sprengen würde, werden wir im nächsten Beitrag ausführlich die **„Koexistenz von HTMX und DRF-Serialisierern“** behandeln.

------

## Fazit {#sec-ab81cf195815}

Die heutigen Inhalte lassen sich wie folgt zusammenfassen:

1.  **HTMX sammelt Werte grundsätzlich aus dem DOM.** Dies unterscheidet sich vom Ansatz von `fetch`, bei dem das Payload-Objekt direkt zusammengestellt wird.
2.  **3 Übertragungsarten:** `<form>` zum Senden des Ganzen, `hx-include` zum gezielten Einbeziehen von Werten, `hx-vals` zum Hinzufügen von Werten.
3.  **Standardmäßig sind es Formulardaten.** Vorsicht: Auch wenn `hx-vals` JSON-Syntax verwendet, wird kein tatsächlicher JSON-Body gesendet.
4.  **Wenn JSON unbedingt erforderlich ist, verwenden Sie die `json-enc`-Erweiterung.** Es ist jedoch gut zu wissen, dass der eigentliche Charme von HTMX im Austausch von HTML-Fragmenten liegt.

Im nächsten Teil kommen wir mit Methoden zurück, um die Bequemlichkeit von DRF in HTMX zu integrieren!


**Weitere Beiträge lesen**

- [Dynamische Webentwicklung mit Django und HTMX vereinfachen (Teil 1)](/ko/whitedec/2025/1/27/django-htmx-dynamic-web-simplification/)  
- [Dynamische Webentwicklung mit Django und HTMX vereinfachen - Ajax (Teil 2)](/ko/whitedec/2025/1/27/django-htmx-dynamic-web-simplification-2/)  
- [Dynamische Webentwicklung mit Django und HTMX vereinfachen (Teil 3): Django-Integration](/de/whitedec/2025/1/27/django-htmx-dynamic-web-simplification-3/)
- [Dynamische Webentwicklung mit Django und HTMX vereinfachen (Teil 4): Payload-Übertragungsarten](/de/whitedec/2025/1/27/django-htmx-csrf-token-integration/)
- [Dynamische Webentwicklung vereinfachen mit Django und HTMX: Einsatz von Form und Serializer](/de/whitedec/2026/4/22/django-htmx-forms-serializer-usage/)
- [Dynamische Webentwicklung mit Django und HTMX vereinfachen: Trigger im Einsatz](/de/whitedec/2026/4/23/django-htmx-dynamic-web-development-trigger/)