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 = https://www.itread01.com/react/props.value;
  return (
    // 錯啦！你不需要在這裡指定key:
    
  • 
      {value}
    
    • 
  );
}

function NumberList(props) {
  const numbers = props.numbers;
  const listItems = numbers.map((number) =>
    //錯啦！元素的key應該在這裡指定：
    
  );
  return (
    
      
      {listItems}
    
    
  );
}

const numbers = [1, 2, 3, 4, 5];
ReactDOM.render(
  ,
  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=https://www.itread01.com/react/{number} />

  );
  return (
    
      
      {listItems}
    
    
  );
}

    JSX 允許在大括號中嵌入任何表示式，所以我們可以在 map() 中這樣使用：

    React 例項

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

    嘗試一下 ?

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