React Academy · Lektion

Dynamische Felder mit useFieldArray

Fügen Sie dynamische Formularfelder mit dem useFieldArray-Hook hinzu, entfernen und sortieren Sie sie neu.

Dynamische Felder mit useFieldArray ist eine kostenlose React Academy-Lektion auf CoddyKit. Dies ist Lektion 4 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 verwenden Sie den useFieldArray-Hook von React Hook Form, um Formulare mit dynamischen Feldlisten zu erstellen – beispielsweise zum Hinzufügen, Entfernen und Neuordnen von Elementen.

Was ist useFieldArray?

useFieldArray verwaltet ein Array von Feldern innerhalb eines React-Hook-Formulars. Es stellt die Methoden append, prepend, remove, swap, move und insert bereit, mit denen Sie die Feldliste bearbeiten können.

import { useFieldArray } from 'react-hook-form';

const { fields, append, remove } = useFieldArray({
  control,
  name: 'phoneNumbers',
});

Einrichtung: control aus useForm

useFieldArray benötigt das `control`-Objekt aus useForm. Entnehmen Sie es gemeinsam mit register und handleSubmit per Destrukturierung.

const { register, control, handleSubmit } = useForm({
  defaultValues: { phoneNumbers: [{ value: '' }] },
});

Felder rendern

Durchlaufen Sie `fields` mit map(), um jedes Element zu rendern. Verwenden Sie die `id` des Feldes als React-Key, nicht den Index. Registrieren Sie jedes Feld mit der Syntax für Array-Pfade.

return fields.map((field, index) => (
  <div key={field.id}>
    <input
      {...register(`phoneNumbers.${index}.value`)}
    />
    <button onClick={() => remove(index)}>Remove</button>
  </div>
));

Neue Felder anhängen

Rufen Sie append() mit einem Objekt aus Standardwerten auf, um am Ende der Liste ein neues Feld hinzuzufügen. Das Formular registriert es automatisch.

<button onClick={() => append({ value: '' })}>
  Add Phone Number
</button>

Felder entfernen

Rufen Sie remove(index) auf, um ein Feld an einer bestimmten Position zu löschen. Alle nachfolgenden Felder rücken auf und ihre Registrierungen werden automatisch aktualisiert.

<button onClick={() => remove(index)}>Delete</button>

Validierung der Mindestanzahl von Feldern

Sie können die Länge des Arrays in einem Zod-Schema mit .min() validieren, um sicherzustellen, dass mindestens ein Feld vorhanden ist.

const schema = z.object({
  emails: z.array(z.object({ value: z.string().email() }))
           .min(1, 'At least one email required'),
});

Felder tauschen und verschieben

Verwenden Sie `swap(indexA, indexB)`, um zwei Felder zu tauschen, oder `move(from, to)`, um ein Feld an eine andere Position zu verschieben. Damit lassen sich sortierbare Feldlisten per Drag-and-drop erstellen.

swap(0, 2); // swap first and third items
move(3, 0); // move item at index 3 to the top

Verschachteltes useFieldArray

Sie können useFieldArray innerhalb eines anderen useFieldArray verschachteln, um mehrstufige dynamische Formulare zu erstellen, beispielsweise eine Rechnung mit Positionen, die jeweils Unterpositionen enthalten.

Array-Daten übermitteln

Beim Absenden übergibt handleSubmit das vollständige Array als Teil des Datenobjekts. Sie greifen unter data.phoneNumbers darauf zu – einem Array von Objekten, die der Feldstruktur entsprechen.

const onSubmit = (data) => {
  console.log(data.phoneNumbers);
  // [{ value: '555-1234' }, { value: '555-5678' }]
};

Kurzer Check

Warum sollten Sie beim Rendern von useFieldArray-Feldern field.id und nicht den Array-Index als React-Key verwenden?

Zusammenfassung

useFieldArray stellt Ihnen ein fields-Array sowie die Methoden append, remove, swap und move bereit. Verwenden Sie field.id als React-Key, registrieren Sie Felder mit der Syntax 'fieldName.index.subfield' und validieren Sie Arrays mit Zod min/max.

Kurs abgeschlossen

Herzlichen Glückwunsch! Sie haben **Formulare mit React Hook Form verwalten** abgeschlossen. Sie können jetzt performante Formulare mit RHF erstellen, eine Zod-Schema-Validierung anwenden und dynamische Feld-Arrays erstellen.

Häufig gestellte Fragen

Ist die Lektion „Dynamische Felder mit useFieldArray“ kostenlos?

Ja — der vollständige Text von „Dynamische Felder mit useFieldArray“ 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 „Dynamische Felder mit useFieldArray“?

Fügen Sie dynamische Formularfelder mit dem useFieldArray-Hook hinzu, entfernen und sortieren Sie sie neu. 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 4 von 4.

Wie lange dauert die Lektion „Dynamische Felder mit useFieldArray“?

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

← Zurück zu React Academy