react.dev

3.3 KiB

Raw Blame History

id	title	layout	next
getting-started-zh-CN	入门教程	docs	tutorial.html

JSFiddle

开始 Hack React 的最简单的方法是用下面 JSFiddle 的Hello Worlds

入门教程包 (Starter Kit)

开始先下载入门教程包

下载入门教程 {{site.react_version}}

在入门教程包的根目录，创建一个含有下面代码的 helloworld.html

<!DOCTYPE html>
<html>
  <head>
    <script src="build/react.js"></script>
    <script src="build/JSXTransformer.js"></script>
  </head>
  <body>
    <div id="example"></div>
    <script type="text/jsx">
      /** @jsx React.DOM */
      React.renderComponent(
        <h1>Hello, world!</h1>,
        document.getElementById('example')
      );
    </script>
  </body>
</html>

在 JavaScript 代码里写着 XML 格式的代码称为 JSX；可以去 JSX 语法里学习更多 JSX 相关的知识。为了把 JSX 转成标准的 JavaScript，我们用 <script type="text/jsx"> 标签包裹着含有 JSX 的代码，然后引入 JSXTransformer.js 库来实现在浏览器里的代码转换。

分离文件

你的 React JSX 代码文件可以写在另外的文件里。新建下面的 src/helloworld.js。

/** @jsx React.DOM */
React.renderComponent(
  <h1>Hello, world!</h1>,
  document.getElementById('example')
);

然后在 helloworld.html 引用该文件：

<script type="text/jsx" src="src/helloworld.js"></script>

离线转换

先安装命令行工具（依赖 npm）：

npm install -g react-tools

然后把你的 src/helloworld.js 文件转成标准的 JavaScript:

jsx --watch src/ build/

只要你修改了， build/helloworld.js 文件会自动生成。

/** @jsx React.DOM */
React.renderComponent(
  React.DOM.h1(null, 'Hello, world!'),
  document.getElementById('example')
);

注意:

目前注释解析器还是非常严格；为了让它能够找出 @jsx 修饰符，有两个限制是必须的。@jsx 注释块必须是代码文件第一个注释。注释必须以 /** (/* 和 // 不起作用) 开头。如果解析器找不到 @jsx 注释，它就不会转换代码，直接原样输出到文件。

对照下面更新你的 HTML 代码

<!DOCTYPE html>
<html>
  <head>
    <title>Hello React!</title>
    <script src="build/react.js"></script>
    <!-- No need for JSXTransformer! -->
  </head>
  <body>
    <div id="example"></div>
    <script src="build/helloworld.js"></script>
  </body>
</html>

想用 CommonJS？

如果你想在一个模块系统里使用 React，fork 我们的代码， npm install 然后运行 grunt。一个漂亮的 CommonJS 模块集将会被生成。我们的 jsx 转换工具可以很轻松的集成到大部分打包系统里（不仅仅是 CommonJS）。

下一步

去看看入门教程，然后学习其他在 /examples 目录里的示例代码。祝你好运，欢迎来到 React 的世界。

3.3 KiB Raw Blame History