React リスト & Keys

私たちは使用できますJavaScript の map() メソッドリストを作成します。

React サンプル

map()メソッドを使用して配列を走査し、1から5までの数字のリストを生成しました:

const numbers = [1, 2, 3, 4, 5]; const listItems = numbers.map((numbers) => <li>{numbers}</li> ); const root = ReactDOM.createRoot(document.getElementById("root")); root.render( <ul>{listItems}</ul> );

試してみる »

上記の例を、配列パラメータを受け取るコンポーネントに再構築できます。各リスト要素にkeyを割り当てないと警告が表示されますa key should be provided for list items、つまりkeyを含める必要があるということです:

React サンプル

function NumberList(props) { const numbers = props.numbers; const listItems = numbers.map((number) => <li key={number.toString()}> {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} /> );

試してみる »

Keys

Keysは、DOM内の一部の要素が追加または削除されたときに、Reactがどの要素が変更されたかを識別するのに役立ちます。したがって、配列内の各要素に明確な識別子を割り当てる必要があります。

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

要素のkeyは、その要素がリスト内で持つ一意の文字列であることが最適です。通常、データからのidを要素のkeyとして使用します:

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

要素に明確なidがない場合は、そのシーケンス番号インデックスをkeyとして使用できます:

const todoItems = todos.map((todo, index) =>
  // 只有在没有确定的 id 时使用
  <li key={index}>
    {todo.text}
  </li>
);

リストを並べ替える可能性がある場合、インデックスをkeyとして使用することはお勧めしません。これによりレンダリングが非常に遅くなる可能性があります。


keysを使用してコンポーネントを抽出する

要素のkeyは、その兄弟ノードと比較した場合にのみ意味を持ちます。

例えば、ListItemコンポーネントを抽出する場合、keyは配列内のこの<ListItem />要素上に置くべきであり、ListItemコンポーネント内部の <li>要素上に置くべきではありません。

誤った例

function ListItem(props) {
  const value = props.value;
  return (
    // 错啦!你不需要在这里指定key:
    <li key={value.toString()}>
      {value}
    </li>
  );
}

function NumberList(props) {
  const numbers = props.numbers;
  const listItems = numbers.map((number) =>
    //错啦!元素的key应该在这里指定:
    <ListItem value={number} />
  );
  return (
    <ul>
      {listItems}
    </ul>
  );
}

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

keyの正しい使い方

React サンプル

function ListItem(props) { //そうです!ここではkeyを指定する必要はありません: return <li>{props.value}</li>; } function NumberList(props) { const numbers = props.numbers; const listItems = numbers.map((number) => //それも正しい!keyは配列のコンテキスト内で指定されるべきです <ListItem key={number.toString()} value={number} /> ); return ( <ul> {listItems} </ul> ); } const numbers = [1, 2, 3, 4, 5]; const root = ReactDOM.createRoot(document.getElementById("root")); root.render( <NumberList numbers={numbers} /> );

試してみる »

map()メソッド内で要素を呼び出すときは、常に各要素に一意のkeyを追加することを忘れないでください。


要素のkeyは兄弟要素間で一意である必要があります

配列要素で使用されるkeyは、その兄弟間で一意である必要があります。ただし、グローバルに一意である必要はありません。2つの異なる配列を生成する場合、同じキーを使用できます。

React サンプル

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: 'Hello World', content: 'Welcome to learning React!'}, {id: 2, title: 'Installation', content: 'You can install React from npm.'} ]; const root = ReactDOM.createRoot(document.getElementById("root")); root.render( <Blog posts={posts} /> );

試してみる »

keyはReactへのヒントとして扱われますが、コンポーネントには渡されません。コンポーネント内でkeyと同じ値を使用する必要がある場合は、それをプロパティとして渡してください:

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

上記の例では、Postコンポーネントはprops.idを読み取ることができますが、props.keyは読み取ることができません。


JSXでmap()を埋め込む

上記の例では、個別のlistItems変数を宣言し、それをJSXに含めました:

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

  );
  return (
    <ul>
      {listItems}
    </ul>
  );
}

JSXでは波括弧内に任意の式を埋め込むことができるため、map()内で次のように使用できます:

React サンプル

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

試してみる »

これによりコードがより明確になることもありますが、このスタイルが乱用されることもあります。JavaScriptと同様に、可読性のために変数を抽出する必要があるかどうかは完全にあなた次第です。ただし、map()がネストしすぎている場合は、コンポーネントを抽出できることを覚えておいてください。

その他の拡張