个人学习心得项目地址
- 托管在 gitee 上的项目链接 ：https://gitee.com/uncleAndyChen/react-full-stack-learning
- 托管在 github 上的项目链接：https://github.com/uncleAndyChen/react-full-stack-learning
前言
针对《深入浅出React和Redux》一书中，某一个被挑选的例子，完成之后，会创建一个相应的分支。
- 《深入浅出React和Redux》原书例子代码，传送门
-
在原书代码的基础上，把相关依赖升级到当前最新版（截止 2018-11-06）。
- react v16.6.0
- redux v4.0.1
- react-redux v5.1.0
- 第一章代码位于 chapter-01，第二章的代码位于 chapter-02，依次类推。
- 子目录名即为分支名，如第四章代码目录下的子目录：
todo_controlled_component，会有一个对应分支也叫todo_controlled_component。
PropTypes 依赖变化
react 的类型检查 PropTypes 自 React v15.5 起已弃用，请使用 prop-types。
《深入浅出React和Redux》一书示例代码使用的 react 是 15.4.1 版本，需要调整 PropTypes 的引用：
// 书中的代码是
import { PropTypes } from 'react';
// 要改为：
import PropTypes from 'prop-types';
扩展阅读：使用 PropTypes 进行类型检查
第二章，分支 controlpanel
# 切换至该分支
git checkout controlpanel
git pull
知识点
- 组件。
- 组件的 state、props。
- 父组件通过 props 向子组件传递数据。
第二章，分支 controlpanel_with_summary
# 切换至该分支
git checkout controlpanel_with_summary
git pull
知识点
- 组件的 props，父组件向子组件传递数据，包括传递函数。
- 子组件通过调用父组件的函数，来达到向父组件传递数据的目的。
第三章，分支 react-redux
# 切换至该分支
git checkout react-redux
git pull
到项目根目录，添加 redux 和 react-redux 依赖。
以下操作会添加最新版的 redux（截止 2018-11-06，版本为：4.0.1） 和 react-redux（截止 2018-11-06，版本为：5.1.0）
cnpm i redux --save
cnpm i react-redux --save
如果不事先添加 redux 依赖而直接添加 react-redux 依赖，会有警告：
peerDependencies WARNING react-redux@* requires a peer of redux@^2.0.0 || ^3.0.0 || ^4.0.0-0 but none was installed
知识点
- UI 组件（presentational component）（傻瓜组件）
- 容器组件（container component）
- 应用 redux 的三大原则
- redux 库：const store = createStore(reducer, initValues)
- React-Redux 库
- connect(mapStateToProps, mapDispatchToProps)(componentName)
- mapStateToProps
- mapDispatchToProps
相关知识点，已经总结到文档：redux 知识点、参考链接
第四章，分支 todo_controlled_component
# 切换至该分支
git checkout todo_controlled_component
git pull
知识点
代码文件组织结构，以及确定模块的边界。
参考《深入浅出React和Redux》P75-81。
- 推荐目录组织方式：按照功能组织。
- 把一个目录看做一个模块，那么我们要做的是明确这个模块对外的接口，而这个接口应该实现把内部封装起来。
- 目录下人 index.js 文件，就是我们的模块接口。
- 各个模块之间只能假设其他模块包含 index.js 文件，要引用模块只能导入 index.js，不能够直接去导人其他文件。
- 导人一个目录的时候，默认导人的就是这个目录下的 index.js 文件， index.js 文件中导出的内容，就是这个模块想要公开出来的接口。
- 推荐使用 export（命名式）的方式导出模块，而不是用 export default（默认）的方式，因为 export default 在导入时，会增加代码量。
状态树的设计
参考《深入浅出React和Redux》P81-83。
- 一个模块控制一个状态节点。
- 避免冗余数据。
- 树形结构扁平。
- 只能通过 reducer 纯函数修改 state，不能直接修改 state。
- 所以，push 和 unshift 会改变原来那个数组，是不能直接作用于 state 的。
- 利用扩展操作符。
combineReducers
利用 combineReducers 可以把多个只针对局部状态的“小的”reducer 合并为一个操纵整个状态树的“大的“ reducer。
更妙的是，没有两个”小的“ reducer 会发生冲突，因为无论怎么组合，状态树上一个子状态都只会被一个 reducer 处理，Redux 就是用这种方法隔绝了各个模块。
很明显，无论我们有多少“小的” reducer，也无论如何组合，都不用在乎它们被因为调用的顺序，因为调用顺序和结果没有关系。
随着应用变得复杂，需要对 reducer 函数进行拆分，拆分后的每一块独立负责管理 state 的一部分。
combineReducers 辅助函数的作用是，把一个由多个不同 reducer 函数作为 value 的 object，合并成一个最终的 reducer 函数，然后就可以对这个 reducer 调用 createStore。
合并后的 reducer 可以调用各个子 reducer，并把它们的结果合并成一个 state 对象。state 对象的结构由传入的多个 reducer 的 key 决定。
-
最终，state 对象的结构会是这样的：
{ todos: ... filter: ... } 通过为传入对象的 reducer 命名不同来控制 state key 的命名。例如，你可以调用 combineReducers({ todos: todoReducer, filter: filterReducer }) 将 state 结构变为 { todos, counter }。
个人认为，更好的做法是直接用 reducer 名作为 state 的 key，使用 ES6 的简写方法：combineReducers({ todos, filter })。这与 combineReducers({ todos: todoReducer, filter: filterReducer }) 产生的 state 结果是一样的。
关于 state key 的使用，实际开发过程中还需要注意些什么呢？看笔者总结的踩坑经验：<a href="./redux.md#stateKey">state 的 key</a>
bindActionCreators
把原来笨重的函数调用过程封装起来，使最终的业务代码更加优雅。
代码修改及完善
添加新的依赖
cnpm i --save react-addons-perf
...
peerDependencies WARNING react-addons-perf@* requires a peer of react-dom@^15.4.2 but react-dom@16.6.0 was installed
意思是，需要 react v15.4.2 支持，所以，将 Store.js 修改如下：
// 以下代码删除
import Perf from 'react-addons-perf'
win.Perf = Perf;
const middlewares = [];
if (process.env.NODE_ENV !== 'production') {
middlewares.push(require('redux-immutable-state-invariant')());
}
const storeEnhancers = compose(
applyMiddleware(...middlewares),
(win && win.devToolsExtension) ? win.devToolsExtension() : (f) => f,
);
export default createStore(reducer, {}, storeEnhancers);
// 上一行代码改为
export default createStore(reducer, {}, window.__REDUX_DEVTOOLS_EXTENSION__ && window.__REDUX_DEVTOOLS_EXTENSION__());
createStore 第三个参数：window.__REDUX_DEVTOOLS_EXTENSION__ && window.__REDUX_DEVTOOLS_EXTENSION__()，是为了支持 Redux DevTools 插件。
警告 Warning: A component is changing an uncontrolled input of type checkbox to be controlled...
完整的警告如下：
Warning: A component is changing an uncontrolled input of type checkbox to be controlled.
Input elements should not switch from uncontrolled to controlled (or vice versa).
Decide between using a controlled or uncontrolled input element for the lifetime of the component.
More info: https://fb.me/react-controlled-components
in input (at todoItem.js:13)
in li (at todoItem.js:7)
in TodoItem (at todoList.js:14)
in ul (at todoList.js:11)
in TodoList (created by Connect(TodoList))
in Connect(TodoList) (at todos.js:11)
in div (at todos.js:9)
in Unknown (at TodoApp.js:8)
in div (at TodoApp.js:7)
in TodoApp (at src/index.js:10)
in Provider (at src/index.js:9)
这是因为 todoItem.js:13 代码中的 checkbox 的 checked 属性没有用 state 来记录，所以会警告，但这并不影响该示例的正常运行。
关于页面控件是否受控，以及相关问题，请看官方文档：Controlled Components
解决
为了消除以上警告，同时，为了更方便理解 state 变化会引起页面的重新渲染，作如下修改：
- 将 checkbox 的 onClick 事件删除，这样，点击 checkbox 控件不会有任何反应（checkbox 设置了只读属性）。
- 将设置待办事项状态的点击事件放到 label 上，添加了 a 标签。
不过，a 标签的 href 属性只是
#会引发另外的警告，这个下面再解决。 - 同时将 checkbox 的 checked 属性添加上去，其值就是待办事项的数据：currentState.completed，这是一个 bool 变量。
- 将变量
checkedProp定义行const checkedProp = completed ? {checked: true} : {};删除。
最后，关键代码如下：
<input className="toggle" type="checkbox" checked={completed} readOnly/>
<label className="text"><a href="#" onClick={onToggle}>{text}</a></label>
a 标签的 href 属性只是 # 会引发的警告
./src/todos/views/todoItem.js
Line 13: The href attribute requires a valid value to be accessible.
Provide a valid, navigable address as the href value.
If you cannot provide a valid href, but still need the element to resemble a link,
use a button and change it with appropriate styles.
Learn more: https://github.com/evcohen/eslint-plugin-jsx-a11y/blob/master/docs/rules/anchor-is-valid.md
jsx-a11y/anchor-is-valid
项目中用到的 Link 组件 ./src/filter/views/link.js 也有同样的警告，一起修改。
./src/filter/views/link.js
Line 11: The href attribute requires a valid value to be accessible.
...
解决
参照文章anchor-is-valid，作如下调整：
将 a 标签 <a href="#" onClick={onToggle}>{text}</a> 换成 button 控件，同时增加 button 相关的 style.css 文件放到 src 根目录下。
<button
type="button"
className="link-button"
onClick={onToggle}>
{text}
</button>
将 link.js 组件中的 a 标签也换成 button，这里就不贴代码了，直接看代码文件吧。
最后还有一个警告，在点击【添加】按钮的时候触发的，不过 chrome 浏览器才有该警告，QQ 浏览器没有，没再深入研究。
[Deprecation] Using unescaped '#' characters in a data URI body is deprecated and will be removed in M71, around December 2018.
Please use '%23' instead. See https://www.chromestatus.com/features/5656049583390720 for more details.
