React 列表 & Keys

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

React 實例

使用 map() 方法遍歷數組生成了一個 1 到 5 的數字列表:

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

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

React 實例

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

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的正確使用方式

React 實例

function ListItem(props) { // 對啦！這裏不需要指定key: return <li>{props.value}</li>; } function NumberList(props) { const numbers = props.numbers; const listItems = numbers.map((number) => // 又對啦！key應該在數組的上下文中被指定 <ListItem key={number.toString()} value={number} /> ); return ( <ul> {listItems} </ul> ); } const numbers = [1, 2, 3, 4, 5]; ReactDOM.render( <NumberList numbers={numbers} />, document.getElementById('example') );

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

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

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

React 實例

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

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

React 實例

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

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