如何在 ReactJS 18 的类组件中访问 props.children

花韻仙語

花韻仙語

2025-09-26

466人浏览

原创

如何在 reactjs 18 的类组件中访问 props.children

本文针对 ReactJS 18 中类组件访问 props.children 时可能遇到的 TypeScript 类型问题,提供了清晰的解决方案。通过正确定义组件的 Props 类型,显式声明 children 属性,可以避免类型检查错误,并确保在类组件中正常使用 props.children。文章还对比了 React 17 和 React 18 中关于 children 属性的类型定义差异,帮助开发者更好地理解问题根源。

在 ReactJS 中,props.children 是一个非常重要的属性,它允许我们将组件嵌套在其他组件内部,并将嵌套的内容作为 children 传递给父组件。 虽然 React 18 并没有移除 props.children,但在使用 TypeScript 的类组件中,如果不正确地定义 Props 类型,可能会遇到类型错误。

问题分析

当你在 React 18 中使用 TypeScript 类组件时,可能会遇到类似 "Property 'children' does not exist on type 'Readonly'.ts(2339)" 的错误。 这是因为在 React 18 的类型定义中,React.Component 的 Props 类型不再默认包含 children 属性。 这意味着,如果你没有在 Props 类型中显式声明 children 属性,TypeScript 编译器会认为该属性不存在。

解决方案

解决这个问题的方法是在定义类组件的 Props 类型时,显式声明 children 属性。 以下是示例代码:

import React from 'react';

interface SystemStatusContainerProps {
  children: React.ReactNode;
  // 其他 Props 属性...
}

interface SystemStatusContainerState {
  status: systemStatuses;
  pollStatus: boolean;
}

enum systemStatuses {
  online = 'online',
  offline = 'offline',
  update = 'update'
}

class SystemStatusContainer extends React.Component {
  state: SystemStatusContainerState = {
    status: systemStatuses.online,
    pollStatus: true,
  };

  timer: NodeJS.Timeout | undefined;

  componentDidMount() {
    this.timer = setTimeout(() => {
      this.setState({ status: systemStatuses.offline });
    }, 2000);
  }

  componentWillUnmount() {
    if (this.timer) {
      clearTimeout(this.timer);
    }
  }

  render() {
    const { status } = this.state;

    if (status === systemStatuses.offline) {
      return <div>System Unavailable Modal</div>; // Replace with your actual component
    } else if (status === systemStatuses.update) {
      return <div>System Status Modal</div>; // Replace with your actual component
    } else {
      return {this.props.children}>;
    }
  }
}

export default SystemStatusContainer;

代码解释:

  1. 定义 Props 类型: 我们创建了一个名为 SystemStatusContainerProps 的接口,并在其中定义了 children 属性,类型为 React.ReactNode。 React.ReactNode 可以表示任何可以作为 React 组件子元素的类型,包括字符串、数字、React 元素等。
  2. 类型声明: 在 SystemStatusContainer 类组件的定义中,我们将 SystemStatusContainerProps 作为第一个类型参数传递给 React.Component。 这样,TypeScript 编译器就知道 this.props 具有 children 属性。
  3. 使用 props.children: 在 render 方法中,我们可以像以前一样使用 this.props.children 来访问子元素。

使用示例

import SystemStatusContainer from './SystemStatusContainer';

function App() {
  return (
    <systemstatuscontainer><p>This is a child element.</p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/gongju/2500" title="度加AI"><img
														src="https://img.php.cn/upload/manual/000/969/633/6a61700fe297c535.jpg" alt="度加AI" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/gongju/2500" title="度加AI" class="overflowclass">度加AI</a>
													<p class="overflowclass">度加AI官网入口,百度官方 AIGC 创作平台,支持 AI 成片、AI 生文、数字人、声音克隆、配音字幕与智能剪辑等在线创作能力。</p>
												</div>
												<a rel="nofollow" href="/xiazai/gongju/2500" title="度加AI" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div>
      <button>Click me</button>
    </systemstatuscontainer>
  );
}

export default App;

在这个示例中,

React 17 和 React 18 的类型差异

在 React 17 中,React.Component 的 Props 类型默认包含了 children 属性,这意味着即使你没有显式声明 children 属性,也可以直接使用 this.props.children。

// React 17 的类型定义 (简化)
class Component<p> {
  readonly props: Readonly</p><p> & Readonly;
}</p>

而在 React 18 中,React.Component 的 Props 类型不再默认包含 children 属性。

// React 18 的类型定义 (简化)
class Component<p> {
  readonly props: Readonly</p><p>;
}</p>

这个变化导致了在 React 18 中使用 TypeScript 类组件时,需要显式声明 children 属性。

总结

通过显式声明 children 属性,可以解决在 React 18 的 TypeScript 类组件中访问 props.children 时遇到的类型问题。 理解 React 17 和 React 18 在类型定义上的差异,可以帮助开发者更好地适应 React 的版本升级。 记住,在 TypeScript 中,显式地定义类型可以提高代码的可读性和可维护性,并减少潜在的错误。

相关专题

更多
TypeScript工程化开发与Vite构建优化实践
TypeScript工程化开发与Vite构建优化实践

本专题面向前端开发者,深入讲解 TypeScript 类型系统与大型项目结构设计方法,并结合 Vite 构建工具优化前端工程化流程。内容包括模块化设计、类型声明管理、代码分割、热更新原理以及构建性能调优。通过完整项目示例,帮助开发者提升代码可维护性与开发效率。

2026.02.13

125

17

TypeScript全栈项目架构与接口规范设计
TypeScript全栈项目架构与接口规范设计

本专题面向全栈开发者,系统讲解基于 TypeScript 构建前后端统一技术栈的工程化实践。内容涵盖项目分层设计、接口协议规范、类型共享机制、错误码体系设计、接口自动化生成与文档维护方案。通过完整项目示例,帮助开发者构建结构清晰、类型安全、易维护的现代全栈应用架构。

2026.02.25

355

17

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

2026.03.13

208

19

TypeScript 全栈开发进阶指南
TypeScript 全栈开发进阶指南

面向有 JavaScript 基础的开发者,深入讲解 TypeScript 的类型系统与全栈开发实践。

2026.06.03

98

29

TypeScript Node.js 全栈工程化与Monorepo架构实践
TypeScript Node.js 全栈工程化与Monorepo架构实践

本专题围绕 TypeScript 在 Node.js 全栈开发中的工程化实践展开,系统讲解 Monorepo 架构设计、包管理策略、模块复用机制以及服务端与前端统一类型系统的构建方法。通过真实项目案例,帮助开发者提升大型全栈项目的可维护性与协作效率。

2026.06.16

88

8

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.03

1154

5

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

1234

5

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

2023.10.24

3266

49

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

2023.11.24

2189

6

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 11.1万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1.3万人学习