快速开始-React入门指南

JSFiddle

开始学习 React 最简单的方式是使用如下JSFiddle的 Hello World例子：

初学者教程包 (Starter Kit)

开始先下载初学者教程包。

在初学者教程包的根目录，创建一个包含以下内容的 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">
      React.render(
        <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 文件，内容如下：

React.render(
  <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 文件会自动生成。

React.render(
  React.createElement("h1", null, "Hello, world!"),
  document.getElementById("example")
);

对照以下内容更新你的 HTML 代码

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

想要遵循 CommonJS 规范?

如果你想在使用 React 时，遵循 browserify，webpack 或者或其它兼容CommonJS的模块系统，只要使用 react npm包即可。而且，jsx 转换工具可以很轻松的地集成到大部分打包系统里（不仅仅是 CommonJS）。

下一步

接着学习更多入门教程和初学者教程包 examples 目录下的其它例子。

我们还有一个社区开发者共同建设的 Wiki：workflows, UI-components, routing, data management etc.

祝你好运，欢迎来到 React 的世界。