摘要:今天我们就来解读一下的源码。比较有意思,将定时器以方式提供出来,并且提供了方法。实现方式是,在组件内部维护一个定时器,实现了组件更新销毁时的计时器更新销毁操作,可以认为这种定时器的生命周期绑定了组件的生命周期,不用担心销毁和更新的问题。
1. 引言
React PowerPlug 是利用 render props 进行更好状态管理的工具库。
React 项目中,一般一个文件就是一个类,状态最细粒度就是文件的粒度。然而文件粒度并非状态管理最合适的粒度,所以有了 Redux 之类的全局状态库。
同样,文件粒度也并非状态管理的最细粒度,更细的粒度或许更合适,因此有了 React PowerPlug。
比如你会在项目中看到这种眼花缭乱的 state:
class App extends React.PureComponent { state = { name = 1 isLoading = false isFetchUser = false data = {} disableInput = false validate = false monacoInputValue = "" value = "" } render () { /**/ } }
其实真正 App 级别的状态并没有那么多,很多 诸如受控组件 onChange 临时保存的无意义 Value 找不到合适的地方存储。
这时候可以用 Value 管理局部状态:
{({ value, set, reset }) => ( <> > )}
可以看到,这个问题本质上应该拆成新的 React 类解决,但这也许会导致项目结构更混乱,因此 RenderProps 还是必不可少的。
今天我们就来解读一下 React PowerPlug 的源码。
2. 精读 2.1. Value这是一个值操作的工具,功能与 Hooks 中 useState 类似,不过多了一个 reset 功能(Hooks 其实也未尝不能有,但 Hooks 确实没有 Reset)。
用法源码{({ value, set, reset }) => ( <> > )}
源码地址
原料:无
State 只存储一个属性 value,并赋初始值为 initial:
export default { state = { value: this.props.initial }; }
方法有 set reset。
set 回调函数触发后调用 setState 更新 value。
reset 就是调用 set 并传入 this.props.initial 即可。
2.2. ToggleToggle 是最直接利用 Value 即可实现的功能,因此放在 Value 之后说。Toggle 值是 boolean 类型,特别适合配合 Switch 等组件。
既然 Toggle 功能弱于 Value,为什么不用 Value 替代 Toggle 呢?这是个好问题,如果你不担心自己代码可读性的话,的确可以永远不用 Toggle。用法
源码{({ on, toggle }) => }
源码地址
原料:Value
核心就是利用 Value 组件,value 重命名为 on,增加了 toggle 方法,继承 set reset 方法:
export default { toggle: () => set(on => !on); }
理所因当,将 value 值限定在 boolean 范围内。
2.3. Counter与 Toggle 类似,这也是继承了 Value 就可以实现的功能,计数器。
用法源码{({ count, inc, dec }) => ( )}
源码地址
原料:Value
依然利用 Value 组件,value 重命名为 count,增加了 inc dec incBy decBy 方法,继承 set reset 方法。
与 Toggle 类似,Counter 将 value 限定在了数字,那么比如 inc 就会这么实现:
export default { inc: () => set(value => value + 1); }
这里用到了 Value 组件 set 函数的多态用法。一般 set 的参数是一个值,但也可以是一个函数,回调是当前的值,这里返回一个 +1 的新值。
2.4. List操作数组。
用法源码{({ list, pull, push }) => (
)}{list.map({ tag }) => ( pull(value => value === tag)}> {tag} )}
源码地址
原料:Value
依然利用 Value 组件,value 重命名为 list,增加了 first last push pull sort 方法,继承 set reset 方法。
export default { list: value, first: () => value[0], last: () => value[Math.max(0, value.length - 1)], set: list => set(list), push: (...values) => set(list => [...list, ...values]), pull: predicate => set(list => list.filter(complement(predicate))), sort: compareFn => set(list => [...list].sort(compareFn)), reset };
为了利用 React Immutable 更新的特性,因此将 sort 函数由 Mutable 修正为 Immutable,push pull 同理。
2.5. Set存储数组对象,可以添加和删除元素。类似 ES6 Set。和 List 相比少了许多功能函数,因此只承担添加、删除元素的简单功能。
用法需要注意的是,initial 是数组,而不是 Set 对象。
源码{({ values, remove, add }) => ( )} {values.map(tag => ( remove(tag)}>{tag} ))}
源码地址
原料:Value
依然利用 Value 组件,value 重命名为 values 且初始值为 [],增加了 add remove clear has 方法,保留 reset 方法。
实现依然很简单,add remove clear 都利用 Value 提供的 set 进行赋值,只要实现几个操作数组方法即可:
const unique = arr => arr.filter((d, i) => arr.indexOf(d) === i); const hasItem = (arr, item) => arr.indexOf(item) !== -1; const removeItem = (arr, item) => hasItem(arr, item) ? arr.filter(d => d !== item) : arr; const addUnique = (arr, item) => (hasItem(arr, item) ? arr : [...arr, item]);
has 方法则直接复用 hasItem。核心还是利用 Value 的 set 函数一招通吃,将操作目标锁定为数组类型罢了。
2.6. mapMap 的实现与 Set 很像,类似 ES6 的 Map。
用法与 Set 不同,Map 允许设置 Key 名。需要注意的是,initial 是对象,而不是 Map 对象。
源码源码地址
原料:Value
依然利用 Value 组件,value 重命名为 values 且初始值为 {},增加了 set get clear has delete 方法,保留 reset 方法。
由于使用对象存储数据结构,操作起来比数组方便太多,已经不需要再解释了。
值得吐槽的是,作者使用了 != 判断 has:
export default { has: key => values[key] != null; }
这种代码并不值得提倡,首先是不应该使用二元运算符,其次比较推荐写成 values[key] !== undefined,毕竟 set("null", null) 也应该算有值。
2.7. stateState 纯粹为了替代 React setState 概念,其本质就是换了名字的 Value 组件。
用法值得注意的是,setState 支持函数和值作为参数,是 Value 组件本身支持的,State 组件额外适配了 setState 的另一个特性:合并对象。
{({ state, setState }) => { const onStart = data => setState({ loading: true }); const onFinish = data => setState({ data, loading: false }); return ( ); }}
源码地址
原料:Value
依然利用 Value 组件,value 重命名为 state 且初始值为 {},增加了 setState 方法,保留 reset 方法。
setState 实现了合并对象的功能,也就是传入一个对象,并不会覆盖原始值,而是与原始值做 Merge:
export default { setState: (updater, cb) => set( prev => ({ ...prev, ...(typeof updater === "function" ? updater(prev) : updater) }), cb ); }2.8. Active
这是一个内置鼠标交互监听的容器,监听了 onMouseUp 与 onMouseDown,并依此判断 active 状态。
用法源码{({ active, bind }) => ( You are {active ? "clicking" : "not clicking"} this div.)}
源码地址
原料:Value
依然利用 Value 组件,value 重命名为 active 且初始值为 false,增加了 bind 方法。
bind 方法也巧妙利用了 Value 提供的 set 更新状态:
export default { bind: { onMouseDown: () => set(true), onMouseUp: () => set(false) } };2.9. Focus
与 Active 类似,Focus 是当 focus 时才触发状态变化。
用法源码{({ focused, bind }) => ( )}You are {focused ? "focusing" : "not focusing"} the input.
源码地址
原料:Value
依然利用 Value 组件,value 重命名为 focused 且初始值为 false,增加了 bind 方法。
bind 方法与 Active 如出一辙,仅是监听时机变成了 onFocus 和 onBlur。
2.10. FocusManager不知道出于什么考虑,FocusManager 的官方文档是空的,而且 Help wanted。。
正如名字描述的,这是一个 Focus 控制器,你可以直接调用 blur 来取消焦点。
用法笔者给了一个例子,在 5 秒后自动失去焦点:
源码{({ focused, blur, bind }) => ( { setTimeout(() => { blur(); }, 5000); }} />)}You are {focused ? "focusing" : "not focusing"} the input.
源码地址
原料:Value
依然利用 Value 组件,value 重命名为 focused 且初始值为 false,增加了 bind blur 方法。
blur 方法直接调用 document.activeElement.blur() 来触发其 bind 监听的 onBlur 达到更新状态的效果。
By the way, 还监听了 onMouseDown 与 onMouseUp:
export default { bind: { tabIndex: -1, onBlur: () => { if (canBlur) { set(false); } }, onFocus: () => set(true), onMouseDown: () => (canBlur = false), onMouseUp: () => (canBlur = true) } };
可能意图是防止在 mouseDown 时触发 blur,因为 focus 的时机一般是 mouseDown。
2.11. Hover与 Focus 类似,只是触发时机为 Hover。
用法源码{({ hovered, bind }) => ( You are {hovered ? "hovering" : "not hovering"} this div.)}
源码地址
原料:Value
依然利用 Value 组件,value 重命名为 hovered 且初始值为 false,增加了 bind 方法。
bind 方法与 Active、Focus 如出一辙,仅是监听时机变成了 onMouseEnter 和 onMouseLeave。
2.12. Touch与 Hover 类似,只是触发时机为 Hover。
用法源码{({ touched, bind }) => ( You are {touched ? "touching" : "not touching"} this div.)}
源码地址
原料:Value
依然利用 Value 组件,value 重命名为 touched 且初始值为 false,增加了 bind 方法。
bind 方法与 Active、Focus、Hover 如出一辙,仅是监听时机变成了 onTouchStart 和 onTouchEnd。
2.13. Field与 Value 组件唯一的区别,就是
用法这个用法和 Value 没区别:
{({ value, set }) => ( set(e.target.value)} /> )}
但是用 bind 更简单:
源码{({ bind }) => }
源码地址
原料:Value
依然利用 Value 组件,value 保留不变,初始值为 "",增加了 bind 方法,保留 set reset 方法。
与 Value 的唯一区别是,支持了 bind 并封装 onChange 监听,与赋值受控属性 value。
export default { bind: { value, onChange: event => { if (isObject(event) && isObject(event.target)) { set(event.target.value); } else { set(event); } } } };2.14. Form
这是一个表单工具,有点类似 Antd 的 Form 组件。
用法 )} 源码源码地址
原料:Value
依然利用 Value 组件,value 重命名为 values 且初始值为 {},增加了 setValues field 方法,保留 reset 方法。
表单最重要的就是 field 函数,为表单的每一个控件做绑定,同时设置一个表单唯一 key:
export default { field: id => { const value = values[id]; const setValue = updater => typeof updater === "function" ? set(prev => ({ ...prev, [id]: updater(prev[id]) })) : set({ ...values, [id]: updater }); return { value, set: setValue, bind: { value, onChange: event => { if (isObject(event) && isObject(event.target)) { setValue(event.target.value); } else { setValue(event); } } } }; } };
可以看到,为表单的每一项绑定的内容与 Field 组件一样,只是 Form 组件的行为是批量的。
2.15. IntervalInterval 比较有意思,将定时器以 JSX 方式提供出来,并且提供了 stop resume 方法。
用法源码{({ start, stop }) => ( <> The time is now {new Date().toLocaleTimeString()}> )}
源码地址
原料:无
提供了 start stop toggle 方法。
实现方式是,在组件内部维护一个 Interval 定时器,实现了组件更新、销毁时的计时器更新、销毁操作,可以认为这种定时器的生命周期绑定了 React 组件的生命周期,不用担心销毁和更新的问题。
具体逻辑就不列举了,利用 setInterval clearInterval 函数基本上就可以了。
2.16. ComposeCompose 也是个有趣的组件,可以将上面提到的任意多个组件组合使用。
用法源码{(counter, toggle) => ( )}
源码地址
原料:无
通过递归渲染出嵌套结构,并将每一层结构输出的值存储到 propsList 中,最后一起传递给组件。这也是为什么每个函数 value 一般都要重命名的原因。
在 精读《Epitath 源码 - renderProps 新用法》 文章中,笔者就介绍了利用 generator 解决高阶组件嵌套的问题。
在 精读《React Hooks》 文章中,介绍了 React Hooks 已经实现了这个特性。
所以当你了解了这三种 "compose" 方法后,就可以在合适的场景使用合适的 compose 方式简化代码。
3. 总结看完了源码分析,不知道你是更感兴趣使用这个库呢,还是已经跃跃欲试开始造轮子了呢?不论如何,这个库的思想在日常的业务开发中都应该大量实践。
另外 Hooks 版的 PowerPlug 已经 4 个月没有更新了(非官方):react-powerhooks,也许下一个维护者/贡献者 就是你。
讨论地址是:精读《React PowerPlug》 · Issue #129 · dt-fe/weekly
如果你想参与讨论,请点击这里,每周都有新的主题,周末或周一发布。前端精读 - 帮你筛选靠谱的内容。
文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。
转载请注明本文地址:https://www.ucloud.cn/yun/102068.html
摘要:精读源码一共行,我们分析一下其精妙的方式。更多讨论讨论地址是精读新用法如果你想参与讨论,请点击这里,每周都有新的主题,周末或周一发布。前端精读帮你筛选靠谱的内容。 1 引言 很高兴这一期的话题是由 epitath 的作者 grsabreu 提供的。 前端发展了 20 多年,随着发展中国家越来越多的互联网从业者涌入,现在前端知识玲琅满足,概念、库也越来越多。虽然内容越来越多,但作为个体的...
摘要:可以看到,这样不仅没有占用组件自己的,也不需要手写回调函数进行处理,这些处理都压缩成了一行。效果通过拿到周期才执行的回调函数。实现等价于的回调仅执行一次时,因此直接把回调函数抛出来即可。 1 引言 上周的 精读《React Hooks》 已经实现了对 React Hooks 的基本认知,也许你也看了 React Hooks 基本实现剖析(就是数组),但理解实现原理就可以用好了吗?学的是...
摘要:会自动触发函数内回调函数的执行。因此利用并将依赖置为使代码在所有渲染周期内,只在初始化执行一次。同时代码里还对等公共方法进行了包装,让这些回调函数中自带效果。前端精读帮你筛选靠谱的内容。 1. 引言 react-easy-state 是个比较有趣的库,利用 Proxy 创建了一个非常易用的全局数据流管理方式。 import React from react; import { stor...
showImg(https://segmentfault.com/img/bVbvOmp?w=1612&h=888); 随着React Vue前端框架的兴起,出现了Vue-router,react-router-dom等前端路由管理库,利用他们构建出来的单页面应用,也是越来越接近原生的体验,再也不是以前的点击标签跳转页面,刷新整个页面了,那么他们的原理是什么呢? 优质gitHub开源练手项目: ...
阅读 2013·2021-08-21 14:09
阅读 480·2019-08-30 15:44
阅读 2106·2019-08-29 16:32
阅读 1369·2019-08-29 15:36
阅读 3432·2019-08-29 12:43
阅读 2775·2019-08-29 11:14
阅读 428·2019-08-28 18:26
阅读 2245·2019-08-26 13:57