React / 系统课时
创建函数组件
创建函数组件
函数组件是 React 中最常用的界面构建单元。本课将从一个可运行示例出发,掌握组件的命名、返回 JSX 的规则,以及组件被 React 正确识别和渲染所需的基本条件。
学习目标
- 能够使用 TypeScript 定义并导出函数组件
- 理解组件名称、返回值和 JSX 根节点规则
- 能够在另一个组件中引用并渲染函数组件
函数组件的基本形式
函数组件本质上是一个返回 React 元素的 JavaScript 或 TypeScript 函数。组件名称必须以大写字母开头,因为 JSX 会把小写标签当作原生 HTML 元素处理,把大写标签当作自定义组件处理。
组件可以使用普通函数声明,也可以使用箭头函数。初学阶段建议优先使用函数声明,名称清晰,错误堆栈也更容易阅读。
创建并渲染组件
在一个已创建好的 React 与 TypeScript 项目中,将 src/App.tsx 替换为下面的内容。示例定义了 Welcome 组件,再由 App 组件负责调用它。
function Welcome() {
// 组件必须返回可被 React 渲染的 JSX
return (
<section>
<h2>欢迎学习 React</h2>
<p>这是我的第一个函数组件。</p>
</section>
);
}
export default function App() {
return (
<main>
<h1>课程首页</h1>
<Welcome />
</main>
);
}预期结果
页面依次显示:
课程首页
欢迎学习 React
这是我的第一个函数组件。<Welcome /> 看起来像 HTML 标签,但它实际会调用 Welcome 函数,并把函数返回的 JSX 放到当前位置。组件通常只描述界面,不应在渲染过程中直接修改外部变量或执行不可预测的副作用。
返回值与根节点
组件可以返回一个 JSX 元素,也可以返回由 Fragment 包裹的多个同级元素。不能直接返回两个没有共同父节点的 JSX 标签,否则编译器无法确定它们属于哪个返回值。
当组件暂时不需要显示内容时,可以返回 null。返回普通对象、未定义变量或不受支持的值,则会造成类型错误或运行错误。
提示:JSX 中的
return后如果要换行,应立即写左括号,避免 JavaScript 自动分号插入导致函数提前返回。
常见错误
组件名写成 welcome 时,<welcome /> 会被当作未知的原生标签,而不是调用函数。另一个常见问题是定义了组件却没有在任何已渲染组件中引用,此时页面不会出现对应内容。
还要注意,组件函数应返回 JSX,而不是返回 JSX 字符串。例如返回 "<h2>标题</h2>" 只会显示普通文本,不会生成标题元素。