前言

注：文章后面的目录列表链接有对每个目录文档的中文说明介绍

如果你觉得有必要的话，可以对项目进行star，或者watch，以便你更方便知道我的更新动态！

注：这个文档并不是简单地把react官网文档直接按字面意思翻译过来这么简单，必要的地方，我会以汉语的思维重新组织原官网的原句，这样我相信更能让你理解其含义！

前一段时间了解了一下react，后来就不知不觉的喜欢上了react，喜欢它的这种构建用户界面的思想。无论是一个全新的app还是一个已经存在的app，react都能很方便的适用！用了react之后，你就会有一种莫名的高大上的感觉，因为你的整个用户界面都是采用“js”的逻辑构思出来的，而不是像以前那样，页面某个地方差个东西，就在对应的地方加个div，然后直接修改html文件，最后查看页面效果等。这点还有别于其它框架，如angular和vue，这些基于mvc的框架，让你写页面时有点像是在写模板的感觉，你更多的还是在写数据层的部分，而react则让你在开发的过程中，html和css和js三个部分同时联系起来了，用react开发，它的Components和elements的思想，就好像你在盖一栋房子，然后你构造这栋房子的每一部分，最后把它组合成整一栋房子。react使得你的开发逻辑性更强，让你更主动，对你的整个页面构造更具有控制能力！此外，react发达的社区环境、以及jsx语法和es6都会让你感觉整个开发体验非常的“爽、干净、流畅”。

当然了，对于react，我也还是在学得状态中，怎么学习react呢？可以的办法就是搞个react项目上上手就非常不错，但是这只能让你粗糙地了解一个框架的如何的使用，但是它真正的原理恐怕你是不理解的。怎么办呢？我觉得你在知道一个框架怎么使用了以后，那么你就应该回归简单，从基础的知识点去理解它，那么什么地方可以让你这么做呢？当然去它的官网呀，因为这里是它的孕育地，所有的基础api都在这里，你可以看见和学习到，必要的时候你可以去社区跟你的同行讨论相关问题，我相信这也是一个不错的方法。

所以，于是我坚持去浏览的react的官网，并把其中的一部分内容翻译了过来，必要的时候加上自己的理解，于是有了现在的这个文档！

因为工作关系，大部分文档的工作还在更新中，我会坚持更新完的，因为有两点原因促使我坚持下去：1、我利用业余时间做这项工作，能帮助我加深对react基础api的理解，何乐而不为？2、进一步增强我对英语文档的阅读能力以及文档组织能力。

这篇文档是建立在我为了加深对react的原理理解而做笔记的基础上建立起来的！所以一些特别地方的一些说明仅仅代表我当时自己对react的理解，请仁者见仁！

请注意，这篇文档是建立在react官网Doc部分再加上我学习过程中自己的理解翻译过来的，所以你有困惑的时候，不妨再去看一下react官网或者react社区去寻求答案！

最后，感谢你的阅读！

目录

License

[MIT license]

来源(书栈小编注)

https://github.com/woai30231/react-doc