React 中 JSX expressions must have one parent element 错误
当组件返回多个元素时,出现 React.js 错误“JSX 表达式必须有一个父元素”。 要解决该错误,请将元素包装在父 div
元素中或使用片段,例如 <><h2>One</h2><h2>Two</h2></>
。
下面是一个产生上述错误的示例
export default function App() {
// ⛔️ JSX expressions must have one parent element.
return (
<h2>One</h2>
<h2>Two</h2>
);
}
上面示例中的问题是 App 组件返回多个元素。
一个组件不能返回多个元素,就像一个函数不能返回多个值一样(除非它们被包装在一个数组中,这是一个单一的值)。
解决错误的一种方法是使用 react 片段。
export default function App() {
return (
<>
<h2>One</h2>
<h2>Two</h2>
</>
);
}
当我们需要在不向 DOM 添加额外节点的情况下对子列表进行分组时,会使用片段。
我们可能还会看到使用了更冗长的片段语法。
import React from 'react';
export default function App() {
return (
<React.Fragment>
<h2>One</h2>
<h2>Two</h2>
</React.Fragment>
);
}
上面的两个示例实现了相同的结果——它们对子元素列表进行分组,而不向 DOM 添加额外的节点。
现在大多数代码编辑器都支持更简洁的语法。
另一种解决方案是将我们的子元素包装在另一个 DOM 元素中,例如 一个 div
。
export default function App() {
return (
<div>
<h2>One</h2>
<h2>Two</h2>
</div>
);
}
这解决了错误,因为我们现在返回一个包含多个子元素的单个 div
元素,而不是返回多个元素。
这种方法仅在添加额外的
div
不会破坏我们的布局时有效,否则使用片段,因为片段不会向 DOM 添加任何额外标记。
如果其中一个代码路径返回同一级别的多个元素,我们可能还会看到错误发生在条件语句中。
export default function App() {
return (
<div>
{/* ⛔️ JSX expressions must have one parent element.ts(2657) */}
{true ? (
<h2>One</h2>
<h2>Two</h2>
) : null}
</div>
);
}
三元运算符的truthy路径返回2个同级元素,导致错误。 我们可以通过用片段包装这两个元素来解决这个问题。
export default function App() {
return (
<div>
{true ? (
<>
<h2>One</h2>
<h2>Two</h2>
</>
) : null}
</div>
);
}
现在三元的每个代码路径都返回一个值。
“JSX 表达式必须有一个父元素”错误的原因是从函数返回多个值的语法无效。
React 组件只是函数,所以当我们在同一层级返回多个元素时,实际上是在一个函数的同一层级使用多个 return
语句。
function render() {
return React.createElement('h2', null, 'One');
return React.createElement('h2', null, 'Two');
}
第二个 return
语句不可访问,这是无效语法。
另一方面,当我们用片段或另一个元素包装元素时,该函数只返回一个值,这解决了错误。
我们可能会看到的另一种方法是将元素分组到一个数组中。
export default function App() {
return [<h2 key={0}>One</h2>, <h2 key={1}>Two</h2>];
}
该数组是单个值,因此错误已解决,但是我们需要将唯一的 key prop 传递给每个数组元素。
这是不必要的,应该避免,因为片段语法更具可读性和直观性。
export default function App() {
return (
<>
<h2>One</h2>
<h2>Two</h2>
</>
);
}