React 列表 & Keys

我們可以使用 JavaScript 的 map() 方法來創建列表。

我們可以將以上實例重構成一個組件，組件接收數組參數，每個列表元素分配一個 key，不然會出現警告 a key should be provided for list items，意思就是需要包含 key：

Keys

Keys 可以在 DOM 中的某些元素被增加或刪除的時候幫助 React 識別哪些元素發生了變化。因此你應當給數組中的每一個元素賦予一個確定的標識。

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

一個元素的 key 最好是這個元素在列表中擁有的一個獨一無二的字符串。通常，我們使用來自數據的 id 作為元素的 key:

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

當元素沒有確定的 id 時，你可以使用他的序列號索引 index 作為 key：

const todoItems = todos.map((todo, index) =>
  // 只有在沒有確定的 id 時使用
  <li key={index}>
    {todo.text}
  </li>
);

如果列表可以重新排序，我們不建議使用索引來進行排序，因為這會導致渲染變得很慢。

用keys提取組件

元素的 key 只有在它和它的兄弟節點對比時才有意義。

比方說，如果你提取出一個 ListItem 組件，你應該把 key 保存在數組中的這個 <ListItem /> 元素上，而不是放在 ListItem 組件中的 <li> 元素上。

錯誤的示範

function ListItem(props) {
  const value = props.value;
  return (
    // 錯啦！你不需要在這里指定key:
    <li key={value.toString()}>
      {value}
    </li>
  );
}
function NumberList(props) {
  const numbers = props.numbers;
  const listItems = numbers.map((number) =>
    //錯啦！元素的key應該在這里指定：
    <ListItem value={number} />
  );
  return (
    <ul>
      {listItems}
    </ul>
  );
}
const numbers = [1, 2, 3, 4, 5];
ReactDOM.render(
  <NumberList numbers={numbers} />,
  document.getElementById('example')
);

key的正確使用方式

當你在 map() 方法的內部調用元素時，你最好隨時記得為每一個元素加上一個獨一無二的 key。

元素的 key 在他的兄弟元素之間應該唯一

數組元素中使用的 key 在其兄弟之間應該是獨一無二的。然而，它們不需要是全局唯一的。當我們生成兩個不同的數組時，我們可以使用相同的鍵。

key 會作為給 React 的提示，但不會傳遞給你的組件。如果您的組件中需要使用和 key 相同的值，請將其作為屬性傳遞：

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() 中這樣使用：

這么做有時可以使你的代碼更清晰，但有時這種風格也會被濫用。就像在 JavaScript 中一樣，何時需要為了可讀性提取出一個變量，這完全取決於你。但請記住，如果一個 map() 嵌套了太多層級，那你就可以提取出組件。