React

Quick Start

Community Resources

Guides

Reference

Flux

Tips

Getting Started Edit on GitHub

JSFiddle #

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

通过 npm 使用 React #

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

// main.js
var React = require('react');
var ReactDOM = require('react-dom');

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

在安装 browserify 之后安装 React DOM 和构建你的应用包。

$ npm install --save react react-dom
$ browserify -t babelify main.js -o bundle.js

不使用 npm 快速开始 #

If you're not ready to use npm yet, you can download the starter kit which includes prebuilt copies of React and React DOM. 如果你没有做好使用 npm 的准备，你可以下载包含了 React 和 ReactDOM 预生成包的入门教程包。

下载入门教程 0.14.3

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

<!DOCTYPE html>
<html>
  <head>
    <meta charset="UTF-8" />
    <title>Hello React!</title>
    <script src="build/react.js"></script>
    <script src="build/react-dom.js"></script>
    <script src="https://cdnjs.cloudflare.com/ajax/libs/babel-core/5.8.23/browser.min.js"></script>
  </head>
  <body>
    <div id="example"></div>
    <script type="text/babel">
      ReactDOM.render(
        <h1>Hello, world!</h1>,
        document.getElementById('example')
      );
    </script>
  </body>
</html>

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

分离文件 #

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

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

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

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

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

离线转换 #

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

npm install --global babel

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

babel src --watch --out-dir build

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

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

对照下面更新你的 HTML 代码

<!DOCTYPE html>
<html>
  <head>
    <meta charset="UTF-8" />
    <title>Hello React!</title>
    <script src="build/react.js"></script>
    <!-- 不需要 Babel！ -->
  </head>
  <body>
    <div id="example"></div>
    <script src="build/helloworld.js"></script>
  </body>
</html>

下一步 #

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

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

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

Next →