• 新手入门
    • JSFiddle
    • 通过 npm 使用 React
    • 不用 npm 的快速开始
      • 分离文件
      • 离线转换
    • 下一步

    新手入门

    JSFiddle

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

    • React JSFiddle
    • React JSFiddle without JSX

    通过 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 的世界。