Lists and Keys

首先，让我们回顾一下如何在 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 中，将数组转换为元素列表几乎完全相同。

渲染多个组件

您可以构建元素集合，并使用大括号将其包含在 JSX 中{}。

下面，我们numbers使用 JavaScript map()函数遍历数组。我们<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')
);

在 CodePen 上试用它。

此代码显示1到5之间的数字的项目符号列表。

基本列表组件

通常你会在组件内渲染列表。

我们可以将前面的例子重构为一个组件，该组件接受一个数组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')
);

当你运行这段代码时，会给你一个警告，即应该为列表项提供一个密钥。“键”是在创建元素列表时需要包含的特殊字符串属性。我们将在下一节讨论为什么它很重要。

让我们将内容分配key给我们的列表项numbers.map()并修复缺失的关键问题。

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')
);

在 CodePen 上试用它。

按键

键可帮助 React 识别哪些项目已更改，添加或删除。键应该赋予数组内的元素以给元素一个稳定的标识：

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

选择密钥的最佳方法是使用一个字符串，它唯一标识其兄弟中的列表项。大多数情况下，您会使用数据中的 ID 作为关键字：

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

如果您没有渲染项目的稳定 ID，则可以使用项目索引作为最后的手段：

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

如果这些项目可以重新排序，我们不建议使用索引，因为这会很慢。如果您有兴趣，您可以阅读深入的解释，说明为什么密钥是必需的。

用键提取组件

键仅在周围阵列的情况下才有意义。

例如，如果你提取一个ListItem组件，你应该保留<ListItem />数组中元素的关键，而不是它本身的根<li>元素ListItem。

示例：不正确的密钥用法

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')
);

在 CodePen 上试用它。

一个好的经验法则是map()调用中的元素需要键。

钥匙必须在兄弟姐妹中独一无二

在阵列中使用的键在他们的兄弟姐妹中应该是唯一的。但是，他们不需要全球独一无二。当我们生成两个不同的数组时，我们可以使用相同的键：

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')
);

在 CodePen 上试用它。

Keys 可以作为 React 的提示，但不会传递给组件。如果您的组件中需要相同的值，请将其明确传递为具有不同名称的道具：

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()结果：

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

在 CodePen 上试用它。

有时候会导致代码更加清晰，但这种风格也可能被滥用。就像在 JavaScript 中一样，由您决定是否值得提取变量以提高可读性。请记住，如果map()主体太嵌套，则可能是提取组件的好时机。