大网数据广告活动
React 前端开发

React 中文参考:createElement

· 52CE 我爱测

通常你会在你组件的最后返回这个元素,或者把它作为另一个元素的子元素。虽然你可以读取元素的属性,但你最好把创建的元素作为黑盒,只用于渲染。

createElement 允许你创建一个 React 元素。它可以作为 JSX 的替代方案。

const element = createElement(type, props, ...children)

参考 {/reference/}

createElement(type, props, ...children) {/createelement/}

调用 createElement 来创建一个 React 元素,它有 type、props 和 children 三个参数。


function Greeting({ name }) {
  return createElement(
    'h1',
    { className: 'greeting' },
    '你好'
  );
}

查看更多例子。

参数 {/parameters/}

  • type:type 参数必须是一个有效的 React 组件类型,例如一个字符串标签名(如 'div' 或 'span'),或一个 React 组件(一个函数式组件、一个类式组件,或者是一个特殊的组件如 Fragment)。

  • props:props 参数必须是一个对象或 null。如果你传入 null,它会被当作一个空对象。创建的 React 元素的 props 与这个参数相同。注意,props 对象中的 ref 和 key 比较特殊,它们 不会 作为 element.props.ref 和 element.props.key 出现在创建的元素 element 上,而是作为 element.ref 和 element.key 出现。

  • 可选 ...children:零个或多个子节点。它们可以是任何 React 节点,包括 React 元素、字符串、数字、portal、空节点(null、undefined、true 和 false),以及 React 节点数组。

返回值 {/returns/}

createElement 返回一个 React 元素,它有这些属性:

  • type:你传入的 type。
  • props:你传入的 props,不包括 ref 和 key。
  • ref:你传入的 ref。如果缺失则为 null。
  • key:你传入的 key,会被强制转换为字符串。如果缺失则为 null。

通常你会在你组件的最后返回这个元素,或者把它作为另一个元素的子元素。虽然你可以读取元素的属性,但你最好把创建的元素作为黑盒,只用于渲染。

注意事项 {/caveats/}

  • 你必须 把 React 元素和它们的 props 视为 不可变的,在创建后永远不要改变它们的内容。在开发环境中,React 会浅层 冻结 返回的元素及其 props 属性,以确保如此。

  • 当你使用 JSX 时,你必须以大写字母开头来渲染你的自定义组件。换句话说,<Something /> 等价于 createElement(Something),但 <something />(小写)等价于 createElement('something')(注意它是一个字符串,它会被当作内置的 HTML 标签)。

  • 你应该仅 在所有子元素都是静态可知的情况下,才将它们依次传递给 createElement 的可选参数,比如 createElement('h1', {}, child1, child2, child3)。如果你的子元素不固定,则把它们放到数组中作为第三个参数传递,例如 createElement('ul', {}, listItems),以此确保 React 可以在动态列表的场景下 警告你缺少 key。静态列表的场景不需要这么做,因为它们不会重新排序。


用法 {/usage/}

不使用 JSX 创建元素 {/creating-an-element-without-jsx/}

如果你不喜欢 JSX 或者无法在你的项目中使用它,你可以使用 createElement 作为替代方案。

要想不使用 JSX 创建一个元素,你可以调用 createElement 并传入 type、props 和 children:


function Greeting({ name }) {
  return createElement(
    'h1',
    { className: 'greeting' },
    '你好',
    createElement('i', null, name),
    '。欢迎!'
  );
}

children 是可选的,你可以传入任意数量的子元素(上面的例子中有三个)。这段代码会显示一个带有问候语的 <h1> 标题。为了对比,这是使用 JSX 的版本:

function Greeting({ name }) {
  return (
    <h1 className="greeting">
      你好<i>{name}</i>,欢迎!
    </h1>
  );
}

要想渲染你自己的 React 组件,则传入一个函数(比如 Greeting)作为 type ,而不是一个字符串(比如 'h1'):

  return createElement(Greeting, { name: '泰勒' });
}

如果使用 JSX,它看起来像这样:

  return <Greeting name="泰勒" />;
}

这里是一个完整的使用 createElement 的示例:


function Greeting({ name }) {
  return createElement(
    'h1',
    { className: 'greeting' },
    '你好',
    createElement('i', null, name),
    ',欢迎!'
  );
}
  return createElement(
    Greeting,
    { name: '泰勒' }
  );
}
.greeting {
  color: darkgreen;
  font-family: Georgia;
}

这里是相同的示例,但使用的是 JSX:

function Greeting({ name }) {
  return (
    <h1 className="greeting">
      你好<i>{name}</i>,欢迎!
    </h1>
  );
}
  return <Greeting name="泰勒" />;
}
.greeting {
  color: darkgreen;
  font-family: Georgia;
}

两种编码风格都没问题,你可以在项目中使用任何一个你喜欢的风格。相比于 createElement,使用 JSX 的主要好处是很容易看出哪个闭合标签对应哪个开放标签。

React 元素究竟是什么? {/what-is-a-react-element-exactly/}

元素是用来描述一部分用户界面的轻量级结构。比如,<Greeting name="泰勒" /> 和 createElement(Greeting, { name: '泰勒' }) 都会生成一个这样的对象:

// 极度简化的样子
{
  type: Greeting,
  props: {
    name: '泰勒'
  },
  key: null,
  ref: null,
}

注意,创建这个对象并不会渲染 Greeting 组件或者创建任何 DOM 元素。

React 元素更像是一个描述或指令,它告诉 React 之后该如何渲染 Greeting 组件。你从 App 组件中返回了这个对象,就是告诉了 React 接下来该做什么。

创建元素非常高效,因此你不需要试图优化或者避免它。

本文来自 React 文档中文译者及贡献者,按 CC BY 4.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
React 文档中文译者及贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。