0Pricing
React Academy · Lektion

React Actions und useActionState

Definieren Sie Server- und Client-Actions, verarbeiten Sie Formularübermittlungen und verfolgen Sie ausstehende Zustände.

React Actions und useActionState ist eine kostenlose React Academy-Lektion auf CoddyKit. Dies ist Lektion 3 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des React Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der React Academy-Kurs umfasst insgesamt 4 Lektionen.

Willkommen

In dieser Lektion definieren Sie React 19 Actions, verwenden useActionState zur Verwaltung des Status einer Formulareinsendung und behandeln ausstehende Vorgänge sowie Fehler übersichtlich.

Was sind React Actions?

Actions sind asynchrone Funktionen, die Sie an die `action`-Prop eines Formulars (oder an `formAction` eines Buttons) übergeben. React 19 behandelt sie speziell: Es verfolgt den Status ausstehender Vorgänge, behandelt Fehler und integriert sie automatisch in Transitions.

Server Actions in Next.js

Fügen Sie in Next.js mit dem App Router am Anfang einer Funktion 'use server' ein, um sie zu einer Server Action zu machen. React ruft sie beim Absenden eines Formulars auf dem Server auf — eine API-Route ist nicht erforderlich.
'use server';

export async function createPost(formData) {
  const title = formData.get('title');
  await db.insert(posts).values({ title });
  revalidatePath('/posts');
}

Eine Action in einem Formular verwenden

Übergeben Sie die Server- oder Client-Action direkt an die `action`-Prop des Formulars. React ruft sie beim Absenden des Formulars mit den FormData auf.
import { createPost } from './actions';

export default function NewPostForm() {
  return (
    <form action={createPost}>
      <input name="title" />
      <button type="submit">Create</button>
    </form>
  );
}

useActionState

useActionState umschließt eine Action und liefert Ihnen den aktuellen Status (das Ergebnis der letzten Action) sowie einen booleschen Wert für ausstehende Vorgänge. Die umschlossene Funktion wird an die Formular-Action übergeben.
'use client';
import { useActionState } from 'react';
import { createPost } from './actions';

function NewPostForm() {
  const [state, action, isPending] = useActionState(createPost, null);
  return (
    <form action={action}>
      {state?.error && <p>{state.error}</p>}
      <input name="title" />
      <button disabled={isPending}>Create</button>
    </form>
  );
}

Eine Action, die einen Status zurückgibt

Die Server Action erhält bei der Verwendung mit useActionState `(prevState, formData)`. Geben Sie ein Objekt mit Informationen zu Erfolg oder Fehler zurück — dieses wird zum neuen Status.
'use server';

export async function createPost(prevState, formData) {
  const title = formData.get('title')?.toString();
  if (!title) return { error: 'Title is required' };
  await db.insert(posts).values({ title });
  return { success: true };
}

isPending für einen deaktivierten Absende-Button

Verwenden Sie den Wert isPending aus useActionState, um den Absende-Button zu deaktivieren und während der Ausführung der Action einen Ladeindikator anzuzeigen.
<button type="submit" disabled={isPending}>
  {isPending ? 'Saving...' : 'Save'}
</button>

Client Actions

Actions müssen nicht auf dem Server ausgeführt werden. Eine Client Action ist eine reguläre asynchrone Funktion ohne 'use server'. Sie erhält durch useActionState trotzdem die Verwaltung von Status und ausstehenden Vorgängen.
async function clientAction(prevState, formData) {
  const res = await fetch('/api/post', {
    method: 'POST', body: formData,
  });
  if (!res.ok) return { error: 'Failed' };
  return { success: true };
}

useFormStatus für untergeordnete Komponenten

Verwenden Sie in einem tief verschachtelten Absende-Button `useFormStatus()`, um den Status des übergeordneten Formulars zu ausstehenden Vorgängen auszulesen, ohne Props weiterreichen zu müssen.
'use client';
import { useFormStatus } from 'react-dom';

function SubmitButton() {
  const { pending } = useFormStatus();
  return <button disabled={pending}>Submit</button>;
}

Progressive Verbesserung

React Actions mit Server Actions funktionieren auch ohne JavaScript (progressive Verbesserung). Der Browser sendet eine native Formular-POST-Anfrage an den Next.js-Handler, sodass die Funktion bereits funktioniert, bevor JavaScript geladen ist.

Schnelltest

Was gibt useActionState zurück, mit dem Sie während der Ausführung einer Formular-Action einen Ladezustand anzeigen können?

Zusammenfassung

React Actions sind asynchrone Funktionen, die an die Formular-Action übergeben werden. useActionState umschließt eine Action und liefert den Status, eine umschlossene Action-Funktion und isPending. Server Actions enthalten 'use server' und werden auf dem Server ausgeführt.

Als Nächstes

Nächste Lektion: **useOptimistic für sofortiges Feedback** — Sie zeigen optimistische UI-Aktualisierungen an, während eine Server-Mutation ausgeführt wird.

Häufig gestellte Fragen

Ist die Lektion „React Actions und useActionState“ kostenlos?

Ja — der vollständige Text von „React Actions und useActionState“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des React Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der React Academy-Kurs umfasst insgesamt 4 Lektionen.

Was lerne ich in „React Actions und useActionState“?

Definieren Sie Server- und Client-Actions, verarbeiten Sie Formularübermittlungen und verfolgen Sie ausstehende Zustände. Du übst React Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.

Brauche ich Erfahrung, um React Academy zu starten?

Keine Vorkenntnisse erforderlich. React Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 3 von 4.

Wie lange dauert die Lektion „React Actions und useActionState“?

Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.

Kann ich in dieser React Academy-Lektion Code schreiben und ausführen?

Ja. Jede React Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.

Alle Lektionen in diesem Kurs

  1. React Server Components erklärt
  2. Der use()-Hook für asynchrone Ressourcen
  3. React Actions und useActionState
  4. useOptimistic für sofortiges Feedback
← Zurück zu React Academy