WHAT - React 两个重要的 Typescript 类型:ReactNode vs JSX.Element

文章目录

这两个类型 ReactNode 和 JSX.Element 在 React + TypeScript 中经常出现,但它们含义不同,适用场景也不同。

下面详细对比一下,并给出使用建议。

ReactNode 是什么?

它来自 @types/react,类型定义如下:

typescript 复制代码
type React.ReactNode = string | number | boolean | React.ReactElement<any, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal | null | undefined

ReactNode 代表所有可以渲染的内容,包括 JSX.Element、Fragment、字符串、数字、数组、null 等。

示例用途

typescript 复制代码
interface Props {
  children: React.ReactNode;
}

const MyBox = ({ children }: Props) => <div>{children}</div>;

可以传入:

typescript 复制代码
<MyBox>文本或<div>元素</div>都可以</MyBox>

JSX.Element 是什么?

这是 JSX 编译后 React 元素的类型,也就是 React.createElement(...) 的返回值的类型,表示一个具体的单个元素 。或者是 React.cloneElement(...) 接收的值。

示例用途

tsx 复制代码
const MyComponent = (): JSX.Element => {
  return <div>Hello</div>;
};

不允许返回字符串、数字、null 等,必须是单个且有效 React 元素。

ReactNode vs JSX.Element 对比

类型名 来源 含义 / 能接受的内容 常见用途
ReactNode React 表示一切可以渲染在页面上的内容 children、插槽、嵌套组件
JSX.Element JSX(全名:JSX.Element) React.createElement 的返回值(具体的 JSX 元素) 通常是组件返回值

使用建议

场景 建议类型 理由
组件 children React.ReactNode 更灵活,支持各种类型内容
单个 JSX 返回值 JSX.Element 明确指返回的是一个 React 元素
动态渲染插槽内容 / 插件 React.ReactNode 支持函数、组件、文字等
内部私用组件返回值类型 JSX.Element 限制更强,有助于类型检查

其他相关类型

类型 含义
ReactElement 是 JSX.Element 的父类型
ReactPortal Portal 节点的类型
ReactNode[] ReactNode 的数组

例子总结

tsx 复制代码
// ✅ ReactNode:适用于 children
type MyProps = {
  children: React.ReactNode;
  header?: React.ReactNode;
};

// ✅ JSX.Element:适用于组件返回值
const MyComponent = (): JSX.Element => {
  return <div>Hello</div>;
};
相关推荐
武昌库里写JAVA3 小时前
SpringBoot+Vue 项目介绍
java·javascript·git·sql·ai
Lanwarf-前端开发4 小时前
Vue3 + Canvas/WebGL 雷达扫描可视化实战:PPI、RHI、VOL、SVOL 四种模式原理与实现
前端·javascript·vue.js·webgl
YIAN7 小时前
从 LangChain 到 DeepAgents:手把手拆解 createAgent、Middleware 与复杂 Agent
javascript·langchain·deepseek
冬夜Zis8 小时前
顺着作用域链和 outer 指针,一次性看懂闭包底层逻辑
javascript
Ceelog8 小时前
Mac 上怎么找出并安全清理旧的 node_modules?(实测 304 个占 66.3 GB)
javascript
小码哥0689 小时前
智慧物业系统源码定制:公告发布范围与住户阅读记录设计
前端·javascript·vue.js·物业管理·物业系统·物业软件
Highcharts.js10 小时前
Highcharts直方图使用指南:如何根据派生数据创建直方图?
javascript·信息可视化·直方图·highcharts·图表开发·创建图表·派生数据
ZhengEnCi11 小时前
Express 企业级项目结构怎么组织:五层骨架、单向依赖和一份能跑的边界检查脚本
javascript·node.js·express
泯泷11 小时前
Cloudflare 出手抢 Astro:前端框架之战,底层逻辑变了
前端·javascript·前端框架
cc.ChenLy13 小时前
无法修改 el-dialog 样式原因及解决办法
javascript·vue.js·elementui