Reactjs入门官方文档(七)【lists-and-keys】

译自reactjs官方文档
我们首先看下在Javascript中如何对一个list进行修改. 下面的例子中我们使用map()方法将一个list中的每个值加倍, 并在最后打印结果:

const numbers = [1, 2, 3, 4, 5];
const doubled = numbers.map((number) => number * 2);
console.log(doubled);

将会在控制台上打印[2, 4, 6, 8, 10].
在React中将list转换成elments几乎完全一样.

渲染重复对象

你可以构建一个element集, 然后在JSF中使用{}引用它.
下面我们使用map()遍历一个数组, 生成一个<li>集合并赋值给变量listItems:

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

基本的List对象

通常的做法是将list渲染到一个对象中.
我们将上面的例子重构到一个对象中, 这个对象接受一个数组作为属性, 然后输出一个无序列表.

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

这段代码在运行时会抛出一个警告提示应该为生成的list提供一个key. 这个Key是当创建element列表时需要包含的一个特殊的字符串, 稍后将讨论为什么这个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

Keys帮助React判断哪一条被修改/被添加或被删除. 数组中的每个element应该被赋予一个key作为这个element的唯一标识.
添加key的最好的方式是选择一个能在list中唯一确认一个条目的字符串, 通常可以用数据的id:

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

万不得已的时候(没有data id或其他唯一的字符串)使用数组下标:

const todoItems = todos.map((todo, index) =>
  // Only do this if items have no stable IDs
  <li key={index}>
    {todo.text}
  </li>
);

如果数组中的对象可能要重新排序, 不建议使用下标作为key, 因为这样会很慢. 感兴趣可以阅读深度解释为什么key是必要的

提取出带有key的对象

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.

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的提示而存在, 但它不会被作为属性传递到component内部. 如果你的component需要同一个值, 显式的用一个不同的名字传递:

const content = posts.map((post) =>
  <Post
    key={post.id}
    id={post.id}
    title={post.title} />
);

上面的例子中, Post对象中可以得到props.id, 但拿不到props.key.

在JSX中嵌入map()

JSX允许在{}间嵌入任意表达式:

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

有时候这会使得代码更清晰, 有时则显得更让人困惑. 为了可读性提取到一个变量是否值得将由你来决定. 如果map()方法中嵌套太复杂, 你该意识到是时候将这些提取到一个component了.