列表 & Key

首先，让我们看下在 Javascript 中如何转化列表。

如下代码，我们使用 map() 函数让数组中的每一项变双倍，然后我们得到了一个新的列表 doubled 并打印出来：

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

代码打印出 [2, 4, 6, 8, 10]。

在 React 中，把数组转化为元素列表的过程是相似的。

渲染多个组件

你可以通过使用 {} 在 JSX 内构建一个元素集合。

下面，我们使用 Javascript 中的 map() 方法来遍历 numbers 数组。将数组中的每个元素变成 <li> 标签，最后我们将得到的数组赋值给 listItems：

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

我们把整个 listItems 插入到 <ul> 元素中，然后渲染进 DOM：

  1. ReactDOM.render(
  2.   <ul>{listItems}</ul>,  document.getElementById('root')
  3. );

在 CodePen 上尝试

这段代码生成了一个 1 到 5 的项目符号列表。

基础列表组件

通常你需要在一个组件中渲染列表。

我们可以把前面的例子重构成一个组件，这个组件接收 numbers 数组作为参数并输出一个元素列表。

  1. function NumberList(props) {
  2.   const numbers = props.numbers;
  3.   const listItems = numbers.map((number) =>    <li>{number}</li>  );  return (
  4.     <ul>{listItems}</ul>  );
  5. }
  7. const numbers = [1, 2, 3, 4, 5];
  8. ReactDOM.render(
  9.   <NumberList numbers={numbers} />,  document.getElementById('root')
  10. );

当我们运行这段代码，将会看到一个警告 a key should be provided for list items，意思是当你创建一个元素时，必须包括一个特殊的 key 属性。我们将在下一节讨论这是为什么。

让我们来给每个列表元素分配一个 key 属性来解决上面的那个警告：

  1. function NumberList(props) {
  2.   const numbers = props.numbers;
  3.   const listItems = numbers.map((number) =>
  4.     <li key={number.toString()}>      {number}
  5.     </li>
  6.   );
  7.   return (
  8.     <ul>{listItems}</ul>
  9.   );
  10. }
  12. const numbers = [1, 2, 3, 4, 5];
  13. ReactDOM.render(
  14.   <NumberList numbers={numbers} />,
  15.   document.getElementById('root')
  16. );

在 CodePen 上尝试

key

key 帮助 React 识别哪些元素改变了，比如被添加或删除。因此你应当给数组中的每一个元素赋予一个确定的标识。

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

一个元素的 key 最好是这个元素在列表中拥有的一个独一无二的字符串。通常，我们使用数据中的 id 来作为元素的 key：

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

当元素没有确定 id 的时候，万不得已你可以使用元素索引 index 作为 key：

  1. const todoItems = todos.map((todo, index) =>
  2.   // Only do this if items have no stable IDs  <li key={index}>    {todo.text}
  3.   </li>
  4. );

如果列表项目的顺序可能会变化，我们不建议使用索引来用作 key 值，因为这样做会导致性能变差，还可能引起组件状态的问题。可以看看 Robin Pokorny 的深度解析使用索引作为 key 的负面影响这一篇文章。如果你选择不指定显式的 key 值，那么 React 将默认使用索引用作为列表项目的 key 值。

要是你有兴趣了解更多的话，这里有一篇文章深入解析为什么 key 是必须的可以参考。

用 key 提取组件

元素的 key 只有放在就近的数组上下文中才有意义。

比方说，如果你提取出一个 ListItem 组件，你应该把 key 保留在数组中的这个 <ListItem /> 元素上，而不是放在 ListItem 组件中的 <li> 元素上。

例子：不正确的使用 key 的方式

  1. function ListItem(props) {
  2.   const value = props.value;
  3.   return (
  4.     // 错误！你不需要在这里指定 key：    <li key={value.toString()}>      {value}
  5.     </li>
  6.   );
  7. }
  9. function NumberList(props) {
  10.   const numbers = props.numbers;
  11.   const listItems = numbers.map((number) =>
  12.     // 错误！元素的 key 应该在这里指定：    <ListItem value={number} />  );
  13.   return (
  14.     <ul>
  15.       {listItems}
  16.     </ul>
  17.   );
  18. }
  20. const numbers = [1, 2, 3, 4, 5];
  21. ReactDOM.render(
  22.   <NumberList numbers={numbers} />,
  23.   document.getElementById('root')
  24. );

例子：正确的使用 key 的方式

  1. function ListItem(props) {
  2.   // 正确！这里不需要指定 key：  return <li>{props.value}</li>;}
  4. function NumberList(props) {
  5.   const numbers = props.numbers;
  6.   const listItems = numbers.map((number) =>
  7.     // 正确！key 应该在数组的上下文中被指定    <ListItem key={number.toString()} value={number} />  );
  8.   return (
  9.     <ul>
  10.       {listItems}
  11.     </ul>
  12.   );
  13. }
  15. const numbers = [1, 2, 3, 4, 5];
  16. ReactDOM.render(
  17.   <NumberList numbers={numbers} />,
  18.   document.getElementById('root')
  19. );

在 CodePen 上尝试

一个好的经验法则是：在 map() 方法中的元素需要设置 key 属性。

key 值在兄弟节点之间必须唯一

数组元素中使用的 key 在其兄弟节点之间应该是独一无二的。然而，它们不需要是全局唯一的。当我们生成两个不同的数组时，我们可以使用相同的 key 值：

  1. function Blog(props) {
  2.   const sidebar = (    <ul>
  3.       {props.posts.map((post) =>
  4.         <li key={post.id}>          {post.title}
  5.         </li>
  6.       )}
  7.     </ul>
  8.   );
  9.   const content = props.posts.map((post) =>    <div key={post.id}>      <h3>{post.title}</h3>
  10.       <p>{post.content}</p>
  11.     </div>
  12.   );
  13.   return (
  14.     <div>
  15.       {sidebar}      <hr />
  16.       {content}    </div>
  17.   );
  18. }
  20. const posts = [
  21.   {id: 1, title: 'Hello World', content: 'Welcome to learning React!'},
  22.   {id: 2, title: 'Installation', content: 'You can install React from npm.'}
  23. ];
  24. ReactDOM.render(
  25.   <Blog posts={posts} />,
  26.   document.getElementById('root')
  27. );

在 CodePen 上尝试

key 会传递信息给 React ，但不会传递给你的组件。如果你的组件中需要使用 key 属性的值，请用其他属性名显式传递这个值：

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

上面例子中，Post 组件可以读出 props.id，但是不能读出 props.key。

在 JSX 中嵌入 map()

在上面的例子中，我们声明了一个单独的 listItems 变量并将其包含在 JSX 中：

  1. function NumberList(props) {
  2.   const numbers = props.numbers;
  3.   const listItems = numbers.map((number) =>    <ListItem key={number.toString()}              value={number} />  );  return (
  4.     <ul>
  5.       {listItems}
  6.     </ul>
  7.   );
  8. }

JSX 允许在大括号中嵌入任何表达式，所以我们可以内联 map() 返回的结果：

  1. function NumberList(props) {
  2.   const numbers = props.numbers;
  3.   return (
  4.     <ul>
  5.       {numbers.map((number) =>        <ListItem key={number.toString()}                  value={number} />      )}    </ul>
  6.   );
  7. }

在 CodePen 上尝试

这么做有时可以使你的代码更清晰，但有时这种风格也会被滥用。就像在 JavaScript 中一样，何时需要为了可读性提取出一个变量，这完全取决于你。但请记住，如果一个 map() 嵌套了太多层级，那可能就是你提取组件的一个好时机。