React 列表 & Keys

我们可以使用 JavaScript 的 map() 方法来创建列表。

React 实例

使用 map() 方法遍历数组生成了一个 1 到 5 的数字列表:

  1. const numbers = [1, 2, 3, 4, 5];
  2. const listItems = numbers.map((numbers) =>
  3.   <li>{numbers}</li>
  4. );
  6. ReactDOM.render(
  7.   <ul>{listItems}</ul>,
  8.   document.getElementById('example')
  9. );

我们可以将以上实例重构成一个组件，组件接收数组参数，每个列表元素分配一个 key，不然会出现警告 a key should be provided for list items，意思就是需要包含 key：

React 实例

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

Keys

Keys 可以在 DOM 中的某些元素被增加或删除的时候帮助 React 识别哪些元素发生了变化。因此你应当给数组中的每一个元素赋予一个确定的标识。

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

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

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

当元素没有确定的 id 时，你可以使用他的序列号索引 index 作为 key：

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

如果列表可以重新排序，我们不建议使用索引来进行排序，因为这会导致渲染变得很慢。

用keys提取组件

元素的 key 只有在它和它的兄弟节点对比时才有意义。

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

错误的示范

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

key的正确使用方式

React 实例

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

当你在 map() 方法的内部调用元素时，你最好随时记得为每一个元素加上一个独一无二的 key。

元素的 key 在他的兄弟元素之间应该唯一

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

React 实例

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

key 会作为给 React 的提示，但不会传递给你的组件。如果您的组件中需要使用和 key 相同的值，请将其作为属性传递：

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

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

在 jsx 中嵌入 map()

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

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

JSX 允许在大括号中嵌入任何表达式，所以我们可以在 map() 中这样使用：

React 实例

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

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