首先,我们来看下如何在JavaScript中转换列表。
下面给出的代码里,我们使用map()
函数获取一组数,然后加倍他们。我们将map()
返回的新数组赋值给变量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中,你可以将元素放入花括号{}
,来构建元素集合。
下面,我们使用JavaScriptmap()
来遍历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')
);
在CodePen中试一试
此代码显示从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')
);
当你运行这份代码时,你将得到一个应该提供键给列表项的警告。当你创建元素列表时,你需要加入一个特殊的字符串属性作为“键”。我们会在下一节论述他的重要性。
让我们在numbers.map()
中给列表项赋予一个键
,来修复丢失键的问题。
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')
);
键
键帮助React标识出哪些项发生了变化,哪些被添加或删除。在数组中应该为元素指定键,来给元素一个固定的标识:
const numbers = [1, 2, 3, 4, 5];
const listItems = numbers.map((number) =>
<li key={number.toString()}>
{number}
</li>
);
选择键最好的方法是使用一个字符串来唯一表示一个列表项,使其与其他兄弟项不同。通常你可以将你数据中的ID作为键:
const todoItems = todos.map((todo) =>
<li key={todo.id}>
{todo.text}
</li>
);
当你的渲染项没有固定的ID时,有一个最后的手段:你可以使用项的索引作为键:
const todoItems = todos.map((todo, index) =>
// Only do this if items have no stable IDs
<li key={index}>
{todo.text}
</li>
);
如果项可以重新排序,我们不建议使用索引作为键。如果你感兴趣的话,可以读下深入解释为什么需要键。
根据键抽取组件
键只有在数组直接的上下文中才有意义。
举例来说,如果你抽取了一个ListItem
组件,你应该将键放在数组元素<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')
);
在CodePen上试一试
一个很好的经验法则:在map()
中的元素需要键。
键在其兄弟中必须唯一
数组中使用的键,在其兄弟之间必须唯一。然而,他们不必全局唯一。当我们生成两个不同的数组时,可以使用相同的键:
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')
);
在CodePen上试一试
键作为一个提示传给React,但不会将他们传给你的组件。如果你的组件需要一个相同的值,用个不同的名字显示的作为一个prop将它传入。
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>
);
}
在CodePen上试一试
有时这可以带来更清晰的代码,但这种风格也可能被滥用。正如在JavaScript中,是否值得为了可读性去提取一个变量,这取决于你。记住,如果map()
的内容中嵌套太多,也许这就意味着该去提取组件了。