新手入门

JSFiddle

开始学习 React 的最简单的方法是用下面 JSFiddle 的 Hello World：

通过 npm 使用 React

我们建议在 React 中使用 CommonJS 模块系统，比如 browserify 或 webpack。使用 react 和 react-dom npm 包。

  1. // main.js
  2. var React = require('react');
  3. var ReactDOM = require('react-dom');
  5. ReactDOM.render(
  6.   <h1>Hello, world!</h1>,
  7.   document.getElementById('example')
  8. );

要用 browserify 安装 React DOM 和构建你的包。

  1. $ npm install --save react react-dom babelify babel-preset-react
  2. $ browserify -t [ babelify --presets [ react ] ] main.js -o bundle.js

要用 webpack 安装 React DOM 和构建你的包： 

  1. $ npm install --save react react-dom babel-preset-react
  2. $ webpack

注意:

如果你正在使用 ES2015，你将要使用 babel-preset-es2015 包。

不用 npm 的快速开始

如果你现在还没准备要使用 npm，你可以下载这个已经包含了预构建的 React 和 React DOM 拷贝的入门套件。

下载入门套件 0.14.7

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

  1. <!DOCTYPE html>
  2. <html>
  3.   <head>
  4.     <meta charset="UTF-8" />
  5.     <title>Hello React!</title>
  6.     <script src="build/react.js"></script>
  7.     <script src="build/react-dom.js"></script>
  8.     <script src="https://cdnjs.cloudflare.com/ajax/libs/babel-core/5.8.23/browser.min.js"></script>
  9.   </head>
  10.   <body>
  11.     <div id="example"></div>
  12.     <script type="text/babel">
  13.       ReactDOM.render(
  14.         <h1>Hello, world!</h1>,
  15.         document.getElementById('example')
  16.       );
  17.     </script>
  18.   </body>
  19. </html>

在 JavaScript 代码里写着 XML 格式的代码称为 JSX；可以去 JSX 语法里学习更多 JSX 相关的知识。为了把 JSX 转成标准的 JavaScript，我们用 <script type="text/babel"> 标签，并引入 Babel 来完成在浏览器里的代码转换。

分离文件

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

  1. ReactDOM.render(
  2.   <h1>Hello, world!</h1>,
  3.   document.getElementById('example')
  4. );

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

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

注意一些浏览器（比如 Chrome）会在使用 HTTP 以外的协议加载文件时失败。

离线转换

先安装 Babel 命令行工具（需要 npm）：

  1. npm install --global babel-cli
  2. npm install babel-preset-react

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

  1. babel --presets react src --watch --out-dir build

注意:

如果你正在使用 ES2015, 你将需要使用 babel-preset-es2015 包。

build/helloworld.js 会在你对文件进行修改时自动生成。阅读 Babel CLI 文档 了解高级用法。

  1. ReactDOM.render(
  2.   React.createElement('h1', null, 'Hello, world!'),
  3.   document.getElementById('example')
  4. );

对照下面更新你的 HTML 代码

  1. <!DOCTYPE html>
  2. <html>
  3.   <head>
  4.     <meta charset="UTF-8" />
  5.     <title>Hello React!</title>
  6.     <script src="build/react.js"></script>
  7.     <script src="build/react-dom.js"></script>
  8.     <!-- 不需要 Babel! -->
  9.   </head>
  10.   <body>
  11.     <div id="example"></div>
  12.     <script src="build/helloworld.js"></script>
  13.   </body>
  14. </html>

下一步

去看看入门教程和入门教程包 examples 目录下的其它例子学习更多。

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

恭喜你，欢迎来到 React 的世界。