您好, 欢迎来到 !    登录 | 注册 | | 设为首页 | 收藏本站

React 列表 & Key

React 列表 & Key

首先,让我们看下在 Javascript 中如何转化列表。

如下,我们使用  让数组中的每一项变双倍,然后我们得到了新的列表 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 内构建元素集合。

下面,我们使用 Javascript 中的  来遍历 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 的项目符号列表。

基础列表组件

通常你需要在组件中渲染列表。

我们可以把前面的例子重构成组件,这个组件接收 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')
);

当我们运行这段,将会看到警告 a key should be provided for list items,意思是当你创建元素时,必须特殊的 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')
);

key

key 帮助 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) =>
  // Only do this if items have no stable IDs
  <li key={index}>
    {todo.text}
  </li>
);

如果列表项目的顺序可能会变化,我们不建议使用索引来用作 key 值,因为这样做会导致变差,还可能引起组件状态的问题。可以看看 Robin Pokorny 的这一篇。如果你选择不指定显式的 key 值,那么 React 将认使用索引用作为列表项目的 key 值。

要是你有兴趣了解更多的话,这里有一篇深入解析为什么 key 是必须的可以参考。

用 key 组件

元素的 key 只有放在就近的数组上下文中才有意义。

比方说,如果你出 ListItem 组件,你应该把 key 保留在数组中的这个 <ListItem />元素上,而不是放在 ListItem 组件中的 <li> 元素上。

例子:不正确的使用 key 的方式

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

例子:正确的使用 key 的方式

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

好的经验法则是:在 map() 中的元素需要设置 key 。

key 只是在兄弟节点之间必须唯一

数组元素中使用的 key 在其兄弟节点之间应该是独一无二的。然而,它们不需要是全局唯一的。当我们两个不同的数组时,我们可以使用相同的 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 ,但不会传递给你的组件。如果你的组件中需要使用 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() 返回的结果:

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

      )}
    </ul>
  );
}

这么做有时可以使你的更清晰,但有时这种风格也会被滥用。

就像在 JavaScript 中一样,何时需要为了可读性出变量,这完全取决于你。

但请记住,如果 map() 嵌套了太多层级,那可能就是你组件的好时机。


联系我
置顶