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()的身體過于嵌套，那么這就是提取組件的好時機。