安装 React
React 可以被灵活地运用在各种项目中。你可以用它创建新的应用程序,也可以逐渐地将其添加到现有的代码库中,而无需重写。
尝试 React
如果你只是想简单尝试下 React,可以使用 CodePen. 首先试试这个 Hello World 示例代码。你不需要安装任何东西,还能简单修改下代码使其生效。
如果你喜欢使用自己的文本编辑器,你还可以 <a href="/react/downloads/single-file-example.html" download="hello.html">下载此 HTML 文件</a> 进行编辑, 然后在本地浏览器中打开。它会执行缓慢的运行时代码转换,所以不要在生产环境中使用。
如果你想在一个完整的项目中使用 React,一般有两种方式:创建 React 应用或添加 React 到现有应用。
创建新应用
Create React App 是开始构建新的 React 单页面应用的最佳途径。 它可以帮你配置开发环境,以便你可以使用最新的 JavaScript 特性,还能提供很棒的开发体验,并为生产环境优化你的应用
npm install -g create-react-app
create-react-app my-app
cd my-app
npm start
Create React App 并不处理后端逻辑和数据库,它只会创建一个前端的构建管道,所以可以和任何后端搭配使用。它可以使用 Babel 和 Webpack 这样的配置工具,也可以零配置使用。
当你准备好将其部署到生产环境中时,运行 npm run build
将会在 build
文件夹中创建一个优化好的应用。你可以从 README 和 用户指南 中了解更多信息。
添加 React 到现有应用
你不需要为了使用 React 重写你的应用。
我们建议你将 React 添加到应用的一小部分中,比如单个小部件,以便你看它是否适用于你的情况。
虽然 React 可以在没有构建管道的情况下使用 ,但是为了更高效我是还建议你使用它,现代的构建管道通常包括:
- 包管理器,比如 Yarn 或 npm。它可以让你使用庞大的第三方软件包生态系统,还能很方便的安装或升级。
- 构建器,比如 webpack 或 Browserify。它允许你编写模块化代码并且压缩文件以优化加载时间。
- 编译器 比如 Babel。它可以让包含新特性的代码运行在旧版浏览器上。
安装
Note:
一旦安装 React,我们强烈建议你将它配置为生产构建程序 ,以确保你在生产环境中使用最新版本的 React。
我们建议使用 Yarn 或 npm 来管理前端的依赖关系, 如果你还未使用过包管理器,阅读 Yarn 文档 以快速入门。
使用 Yarn 安装 React:
yarn init
yarn add react react-dom
使用 npm 安装 React:
npm init
npm install --save react react-dom
Yarn 和 npm 都会从 npm 仓库 下载软件包。
使用 ES6 和 JSX
我们推荐使用 Babel 以便你在 JavaScript 中使用 ES6 和 JSX,ES6 拥有一系列 JavaScript 新特性的标准,能使你的开发更简单。JSX 是与 React 搭配使用的 JavaScript 语言的扩展。
Babel 安装说明 说明了如何在多种不同的环境中配置 Babel,确保你已经安装了babel-preset-react
和 babel-preset-es2015
并且在 .babelrc
configuration 配置文件中启用它们, 到这里就准备就绪了。
在 Hello Wrorld 中使用 ES6 的 JSX
我们建议你使用像 webpack 或 Browserify 这样的构建工具,以便于编写模块代码并将其压缩,优化加载时间。
下面是最基本的 React 示例:
import React from 'react';
import ReactDOM from 'react-dom';
ReactDOM.render(
<h1>Hello, world!</h1>,
document.getElementById('root')
);
这段代码会将其渲染入一个 ID 为 root
的 DOM 元素,所以在你的 HTML 文件中需要有 <div id="root"></div>
。
类似以上,你可以在任何由其他 JavaScript UI 库编辑的现有应用中,将 React 渲染进一个 DOM 元素。
开发和生产版本
默认情况下,React 会包含很多有用的警告,这些警告在开发中非常有用。
然而,这些警告使开发版本的 React 体积过大并且运行过慢,所以你应该在部署应用时使用生产版本
了解如何判断你的网页是否运行了合适的 React 版本, 以及如何有效的配置生产构建程序:
- 使用 Create React App 构建应用
- 使用独立文件构建应用
- 使用 Brunch 构建应用
- 使用 Browserify 构建应用
- 使用 Rollup 构建应用
- 使用 Webpack 构建应用
使用 CDN
如果你不想使用 npm 来管理软件包,'react' 和 'react-dom' npm 软件包同样提供了托管在 CDN 上的独立文件。
<script src="https://unpkg.com/react@15/dist/react.js"></script>
<script src="https://unpkg.com/react-dom@15/dist/react-dom.js"></script>
以上版本仅用于开发,不适合生产。压缩优化的生产版本如下:
<script src="https://unpkg.com/react@15/dist/react.min.js"></script>
<script src="https://unpkg.com/react-dom@15/dist/react-dom.min.js"></script>
如果想要加载指定版本的 react
和 react-dom
,用版本号替换 15。
如果你在使用 Bower,可以通过 react
包来使用 React。
Hello World
尝试 React 最简单的方法是使用 CodePen上的Hello World例子。如果你不想安装任何东西,可以在浏览器中打开它,然后跟着尝试我们接下来的例子。如果你更愿意使用本地开发环境,可以查看完整代码示例 。
一个最简单的React例子如下:
ReactDOM.render(
<h1>Hello, world!</h1>,
document.getElementById('root')
);
它渲染了一个 "Hello, world!" 的标题。