7.Lists and Keys（列表和键）

React版本：15.4.2
**翻译：xiyoki **

首先，让我们回顾一下如何在Javascript中转换列表。
在下面的代码中，我们使用map()函数来操作numbers数组，并使数组元素的值增大一倍。我们将通过map()函数返回的新数组赋给变量doubled，并在控制台输出：

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

这段代码在控制台打印输出：[2, 4, 6, 8, 10]
在React中，将arrays转换为lists元素几乎与上述的操作一样。

Rendering Multiple Components（渲染多个组件）

我们可以构建元素集合，并使用花括号{}将该集合include到JSX中。
下面，我们将使用Javascript中的map()函数来循环numbers数组。我们为数组中的每一项返回一个<li>元素。最后，我们将值为元素的结果数组赋值给listItems:

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

我们将整个listItems数组包含在一个<ul>元素中，并将其渲染到DOM:

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

这段代码显示了以1-5为值的无序列表。

Basic List Component（基本列表组件）

通常你会在一个组件中渲染lists。我们可以将前面的例子进行重构，接受numbers数组，并输出无序列表元素。

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];
ReactDOM.render(
  <NumberList numbers={numbers} />,
  document.getElementById('root')
);

当你运行此代码时，将会收到一个警告，指出应为列表项提供一个keys属性。”key”是你在创建列表项元素时需要包括进去的特殊的字符串属性。我们将在下个小节中讨论为什么它很重要。
让我们在numbers.map()方法中将key属性指定给我们的列表项，并修复因缺少key而出现的问题。

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];
ReactDOM.render(
  <NumberList numbers={numbers} />,
  document.getElementById('root')
);

Keys（键）

键帮助React区分哪些列表项已更改，已添加或已删除。键应该赋予数组中的元素，给这些元素一个稳定的身份：

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

选用的key最好是一个字符串，该字符串能在其兄弟元素间唯一标识一个列表项。通常你会使用数据中的ID作为键：

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

当对于已渲染的列表项，若没有稳定的IDs时，你可以使用最后的手段，即是将项目索引引用作为关键字：

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

如果列表项可以重新排序，我们不建议将索引当做键使用，因为这将很慢。如果你感兴趣你可以阅读 in-depth explanation about why keys are necessary。

Extracting Components with Keys （使用键提取组件）

键仅在包含带key属性的元素的数组的上下文中有意义。
例如，你提取一个ListItem组件，你应当将key赋在数组里的<ListItem />元素上，而不是在ListItem自身返回的根<li>元素上。
示例：键不正确的用法

function ListItem(props) {
  const value = props.value;
  return (
    // Wrong! There is no need to specify the key here:
    <li key={value.toString()}>
      {value}
    </li>
  );
}

function NumberList(props) {
  const numbers = props.numbers;
  const listItems = numbers.map((number) =>
    // Wrong! The key should have been specified here:
    <ListItem value={number} />
  );
  return (
    <ul>
      {listItems}
    </ul>
  );
}

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

示例：键正确的用法

function ListItem(props) {
  // Correct! There is no need to specify the key here:
  return <li>{props.value}</li>;
}

function NumberList(props) {
  const numbers = props.numbers;
  const listItems = numbers.map((number) =>
    // Correct! Key should be specified inside the array.
    <ListItem key={number.toString()}
              value={number} />
  );
  return (
    <ul>
      {listItems}
    </ul>
  );
}

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

一个好的经验法则是，在map()方法内调用的元素需要key。

Keys Must Only Be Unique Among Siblings（在兄弟列表项中，任意一个列表项的key必须是唯一的）

数组中使用的键在其兄弟之间应该是唯一的。但是，它们并不需要是全局唯一的。当我们生成两个不同的数组时，我们可以使用相同的键：

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.'}
];
ReactDOM.render(
  <Blog posts={posts} />,
  document.getElementById('root')
);

Key在React中起着提示的作用，但它们不会被传递给组件。如果你需要在组件中使用相同的值，则使用不同的名称显式地将该值作为props传递：

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

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

Embedding map() in JSX（在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()的结果：

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

有时，这会使得代码更加清晰，但这种风格也可以被滥用。就像在Javascript中，是否应该为了可读性而提取一个变量这完全由你决定。请记住，如果map()的身体过于嵌套，那么这就是提取组件的好时机。