first do it, then do it right, then do it better.

此文章是翻译Test Utilities这篇React（版本v15.4.0）官方文档。

Test Utilities

Importing

1
2
3

import ReactTestUtils from 'react-addons-test-utils' // ES6
var ReactTestUtils = require('react-addons-test-utils') // ES5 with npm
var ReactTestUtils = React.addons.TestUtils // ES5 with react-with-addons.js

Overview

ReactTestUtils 便于在你选择的测试框架中测试React components。在Facebook，我们使用Jest 进行轻松的JavaScript测试。同Jest 网站的React 使用说明 进行Jest 入门学习。

此文章是翻译Add-Ons这篇React（版本v15.4.0）官方文档。

Add-Ons

React add-ons 是用于构建React 应用的有用的使用模块集合。这些应该被认为是实验性的 而且往往比核心更容易发生改变。

• TransitionGroup 和CSSTransitionGroup，用于处理不容易实现的动画和转换，例如在component 移除之前。
• createFragment 创建一套额外帧的子节点。

下面这些add-ons 尽在React 开发版本中（没有缩小）：

• Perl 寻找优化机会的新能分析器。
• ReactTestUtils编写测试用例的简单助手。

前言

个人博客自从2016年10月21日搭建以来，迄今为止已经有49 篇日志了。虽然不是很多篇文章，但是搜索站内的内容已经力不从心了。

搜索了网上很多关于“Hexo 站内搜索”的内容，发现大部分都是使用Swiftype，但是发现Swiftype 搜索只有15 天的免费，之后就需要开始收费了。

因为只是为自己的个人博客 使用站内搜索，所以希望找一个类似与Swiftype 的，但是免费的站内搜索。最后找了Algolia 这个免费版本替代。

下面简单说下搭建过程：

此文章是翻译SyntheticEvent这篇React（版本v15.4.0）官方文档。

SyntheticEvent

SynthecticEvent 入门参考文档包括React 时间系统中的表单部分。参考Handling Event 获取更多信息。

Overview

你的事件句柄将会传入一个SyntheticEvent 实例，一个跨浏览器的包装器包装着浏览器原生事件。它有着和浏览器原生事件相同的接口，包括stopPropagation() 和preventDefault() ,除了事件同一工作跨所有浏览器。

此文章是翻译DOM Elements这篇React（版本v15.4.0）官方文档。

DOM Elements

React 为了性能和跨浏览器兼容实现了一个独立的DOM 系统。我们有机会去除一些粗糙的浏览器实现。

在React 中，所有的DOM 属性（properties）和特性（attributes）（包括事件句柄）都应该是camelCased。例如，HTML 特性tabindex 对于React 特性tabIndex。特例是aria-* 和data-* 特性应该是lowercased。

此文章是翻译Installation这篇React（版本v15.4.0）官方文档。

Installation

React 是灵活的并且可以在各种各样的项目中使用。你也可以使用它创建一个项目，但是你也可以逐渐引入它到一个已存在的代码库中而不需要进行重写。

Trying Out React

如果你只是感兴趣尝试一下React，你可以使用CodePen。从this Hello World example code 开始。你不用按照安装任何东西；你可以只修改代码就可以查看如果它工作。

如果你更喜欢使用你自己的文本编辑器，你也可以download this HTML file，编辑它，并且在你的浏览器中从本地文件系统打开它。它做一个慢的运行时代码转换，所以不在生产环境使用它。

本文是React 官网Docs 相关文章的翻译目录，版本为v15.4.0。

QUICK START

Installation ------ 中文翻译文档
Hello World ------ 中文翻译文档
Introducing JSX ------ 中文翻译文档
Rendering Elements ------ 中文翻译文档
Components and Props ------ 中文翻译文档
State and Lifecycle ------ 中文翻译文档
Handling Events ------ 中文翻译文档
Conditional Rendering ------ 中文翻译文档
Lists and Keys ------ 中文翻译文档
Forms ------ 中文翻译文档
Lifting State Up ------ 中文翻译文档
Composition vs Inheritance ------ 中文翻译文档
Thinking In React ------ 中文翻译文档

此文章是翻译ReactDOMServer这篇React（版本v15.4.0）官方文档。

ReactDOMServer

如果你用script 标签来使用React，这些顶级APIs 将会在全局ReactDOMServer 上有用。如果你在npm 中使用ES6，你可以写import ReactDOMServer from 'react-dom/server'。如果你在npm 中使用ES5，你可以写var ReactDOMServer = require('react-dom/server')。

此文章是翻译ReactDOM这篇React（版本v15.4.0）官方文档。

ReactDOM

如果你用script 标签来使用React，这些顶级APIs 将会在全局ReactDOM 上有用。如果你在npm 中使用ES6，你可以写import ReactDOM from 'react-dom'。如果你在npm 中使用ES5，你可以写var ReactDOM = require('react-dom')。

此文章是翻译React.Component这篇React（版本v15.4.0）官方文档。

React.Component

Components让你将UI 分成独立的、可复用的块，并且独立的思考每一块。React.Component 是由React提供。