We want to hear from you!Take our 2021 Community Survey!
This site is no longer updated.Go to react.dev

Listen und Keys

These docs are old and won’t be updated. Go to react.dev for the new React docs.

These new documentation pages teach modern React and include live examples:

Lass uns zuerst schauen, wie wir Listen in JavaScript transformieren können.

In dem untenstehenden Code verwenden wir die map()-Funktion um die Werte eines Nummern-Arrays zu verdoppeln. Wir weisen das von map() neu zurückgegebene Array der Variable double zu und loggen es:

const numbers = [1, 2, 3, 4, 5];
const doubled = numbers.map((number) => number * 2);console.log(doubled);

Dieser Code schreibt [2, 4, 6, 8, 10] in die Konsole.

In React ist das Transformieren von Arrays in Element-Listen nahezu identisch.

Rendern mehrerer Komponenten

Du kannst Sammlungen von Elementen erstellen und diese mit geschweiften Klammern {} in JSX einbinden.

Nachfolgend wird ein Nummern-Array mit Hilfe der JavaScript map()-Funktion durchlaufen. Wir geben für jeden Eintrag im Array ein <li> Element zurück. Schließlich weisen wir das Array der Variable listItems zu:

const numbers = [1, 2, 3, 4, 5];
const listItems = numbers.map((number) =>  <li>{number}</li>);

Dann können wir das gesamte listItems-Array in ein <ul>-Element schreiben:

<ul>{listItems}</ul>

Auf CodePen ausprobieren

Dieser Code stellt eine Liste von Aufzählungen von 1 bis 5 dar.

Grundlegende Listen-Komponente

Normalerweise würdest du Listen innerhalb einer Komponente rendern.

Wir können das vorherige Beispiel in eine Komponente überführen. Diese akzeptiert ein Nummern-Array und gibt dieses als Liste von Elementen aus.

function NumberList(props) {
  const numbers = props.numbers;
  const listItems = numbers.map((number) =>    <li>{number}</li>  );  return (
    <ul>{listItems}</ul>  );
}

const numbers = [1, 2, 3, 4, 5];
const root = ReactDOM.createRoot(document.getElementById('root'));
root.render(<NumberList numbers={numbers} />);

Wenn du diesen Code ausführst, dann wird dir eine Warnung angezeigt, die dir sagt, dass ein Key für jedes Element der Liste bereitgestellt werden soll. Ein key ist ein spezielles String-Attribut, das bei der Erstellung von Elementlisten berücksichtigt werden muss. Wir werden im nächsten Abschnitt sehen, warum es wichtig ist.

Weisen wir nun innerhalb von numbers.map() das key-Attribut hinzu, um die Warnung des fehlenden Schlüssels zu beheben.

function NumberList(props) {
  const numbers = props.numbers;
  const listItems = numbers.map((number) =>
    <li key={number.toString()}>      {number}
    </li>
  );
  return (
    <ul>{listItems}</ul>
  );
}

Auf CodePen ausprobieren

Schlüssel (Keys)

Schlüssel (im Weiteren Keys genannt) helfen React zu erkennen, welche Elemente geändert, hinzugefügt oder gelöscht wurden. Keys sollten Elementen in einem Array zugewiesen werden, um diesen eine beständige Identität zu geben:

const numbers = [1, 2, 3, 4, 5];
const listItems = numbers.map((number) =>
  <li key={number.toString()}>    {number}
  </li>
);

Der beste Weg einen Key zu definieren, ist die Verwendung eines Strings, der das Listenelement eindeutig von seinen Geschwisterelementen unterscheiden lässt. Meistens würdest du IDs aus deinen Daten als Keys verwenden:

const todoItems = todos.map((todo) =>
  <li key={todo.id}>    {todo.text}
  </li>
);

Wenn du keine IDs für die gerenderten Elemente hast, kannst du als letzte Maßnahme auch den Listenindex benutzen:

const todoItems = todos.map((todo, index) =>
  // Mache dies nur, wenn dir keine IDs zur Verfügung stehen  <li key={index}>    {todo.text}
  </li>
);

Wir empfehlen dir nicht die Indizes für die Keys zu verwenden, da sich die Reihenfolge der Listeneinträge verändern kann. Dies kann sich negativ auf die Performance auswirken und zu Problemen mit dem Komponenten-State führen. Im Artikel von Robin Pokorny kannst du eine ausführlichere Erklärung über die negativen Auswirkungen beim Verwenden des Index als Key finden. Wenn du Listenelementen keinen expliziten Key zuweist, verwendet React standardmäßig die Indizes als Key.

Wenn du dich dafür interessiert mehr zu lernen, ist hier eine ausführliche Erklärung, warum Keys nötig sind.

Extrahieren von Komponenten mit Keys

Keys ergeben nur im Zusammenhang mit einem umgebenden Array Sinn.

Wenn du beispielsweise eine ListItem-Komponente auslagerst, solltest du den Key auf das <ListItem />-Element im Array setzen und nicht auf das <li>-Element im ListItem selbst.

Beispiel: Falsche Verwendung von Keys

function ListItem(props) {
  const value = props.value;
  return (
    // Falsch! Die Angabe des Keys ist hier nicht erforderlich:    <li key={value.toString()}>      {value}
    </li>
  );
}

function NumberList(props) {
  const numbers = props.numbers;
  const listItems = numbers.map((number) =>
    // Falsch! Der Key sollte hier angegeben werden:    <ListItem value={number} />  );
  return (
    <ul>
      {listItems}
    </ul>
  );
}

Beispiel: Richtige Verwendung von Keys

function ListItem(props) {
  // Richtig! Die Angabe des Keys ist hier nicht erforderlich:  return <li>{props.value}</li>;}

function NumberList(props) {
  const numbers = props.numbers;
  const listItems = numbers.map((number) =>
    // Richtig! Der Key sollte innerhalb eines Arrays angegeben werden.    <ListItem key={number.toString()} value={number} />  );
  return (
    <ul>
      {listItems}
    </ul>
  );
}

Auf CodePen ausprobieren

Eine gute Faustregel ist, dass Elemente innerhalb von map() einen Key benötigen.

Keys müssen nur bei Geschwistern eindeutig sein

Keys, die in einem Array verwendet werden, sollten untereinander eindeutig sein. Global müssen sie es jedoch nicht. Man kann somit die gleichen Keys in zwei verschiedenen Arrays verwenden:

function Blog(props) {
  const sidebar = (    <ul>
      {props.posts.map((post) =>
        <li key={post.id}>          {post.title}
        </li>
      )}
    </ul>
  );
  const content = props.posts.map((post) =>    <div key={post.id}>      <h3>{post.title}</h3>
      <p>{post.content}</p>
    </div>
  );
  return (
    <div>
      {sidebar}      <hr />
      {content}    </div>
  );
}

const posts = [
  {id: 1, title: 'Hallo Welt', content: 'Willkommen beim Lernen von React!'},
  {id: 2, title: 'Installation', content: 'Du kannst React via npm installieren.'}
];

const root = ReactDOM.createRoot(document.getElementById('root'));
root.render(<Blog posts={posts} />);

Auf CodePen ausprobieren

Keys dienen React als Hinweise, werden aber nicht an die Komponente weitergegeben. Wenn du den gleichen Wert in deiner Komponente benötigst, dann übergib ihn explizit als Prop mit einem anderen Namen:

const content = posts.map((post) =>
  <Post
    key={post.id}    id={post.id}    title={post.title} />
);

In dem obigen Beispiel kann die Post-Komponente props.id lesen, aber nicht props.key.

Einbetten von map() in JSX

Im folgenden Beispiel deklarieren wir eine listItems-Variable und betten sie in JSX ein:

function NumberList(props) {
  const numbers = props.numbers;
  const listItems = numbers.map((number) =>    <ListItem key={number.toString()}              value={number} />  );  return (
    <ul>
      {listItems}
    </ul>
  );
}

JSX erlaubt es, jeden Ausdruck, der in geschweifte Klammern gesetzt wird, einzubetten. Somit können wir map() inline setzen:

function NumberList(props) {
  const numbers = props.numbers;
  return (
    <ul>
      {numbers.map((number) =>        <ListItem key={number.toString()}                  value={number} />      )}    </ul>
  );
}

Auf CodePen ausprobieren

Manchmal führt dies zu klarerem Code, aber dieser Stil kann ebenso missbraucht werden. Wie in JavaScript liegt es an dir zu entscheiden, ob es sich lohnt, eine Variable zur besseren Lesbarkeit zu benutzen. Behalte im Hinterkopf, dass wenn map() zu verschachtelt ist, es wahrscheinlich eine guter Zeitpunkt ist, diesen Code in eine Komponente auszulagern.

Ist diese Seite hilfreich?Bearbeite diese Seite