正文
传统的redux项目里,我们写在reducer里的状态一定是要打通到store的,我们一开始就要规划好state、reducer等定义,有没有什么方法,既能够快速享受ui与逻辑分离的福利,又不需要照本宣科的从条条框框开始呢?本文从普通的react写法开始,当你一个收到一个需求后,脑海里有了组件大致的接口定义,然后丝滑般的接入到concent世界里,感受渐进式的快感以及全新api的独有魅力吧!
需求来了
上周天气其实不是很好,记得下了好几场雨,不过北京总部大厦的隔音太好了,以致于都没有感受到外面的风雨飘摇,在工位上正在思索着整理下现有代码时,接到一个普通的需求,大致是要实现一个弹窗。
- 左侧有一个可选字段列表,点击任意一个字段,就会进入右侧。
- 右侧有一个已选字段列表,该列表可以上下拖拽决定字段顺序决定表格里的列字段显示顺序,同时也可以删除,将其恢复到可选择列表。
- 点击保存,将用户的字段配置存储到后端,用户下次再次使用查看该表格时,使用已配置的显示字段来展示。
这是一个非常普通的需求,我相信不少码神看完后,脑海里已经把代码雏形大致写完了吧,嘿嘿,但是还请耐性看完本篇文章,来看看在concent的加持下,你的react
应用将如何变得更加灵活与美妙,正如我们的slogan:
concent, power your react
准备工作
产品同学期望快速见到一般效果原型,而我希望原型是可以持续重构和迭代的基础代码,当然要认真对待了,不能为了交差而乱写一版,所以要快速整理需求并开始准备工作了。
因为项目大量基于antd
来书写UI,听完需求后,脑海里冒出了一个穿梭框模样的组件,但因为右侧是一个可拖拽列表,查阅了下没有类似的组件,那就自己实现一个吧,初步整理下,大概列出了以下思路。
- 组件命名为
ColumnConfModal
,基于antd
的Modal
,Card
实现布局,antd
的List
来实现左侧的选择列表,基于react-beautiful-dnd
的可拖拽api来实现右侧的拖拽列表。
- 因为这个弹窗组件在不同页面被不同的table使用,传入的列定义数据是不一样的,所以我们使用事件的方式,来触发打开弹窗并传递表格id,打开弹窗后获取该表格的所有字段定义,以及用户针对表哥的已选择字段数据,这样把表格元数据的初始化工作收敛在
ColumnConfModal
内部。 - 基于表格左右两侧的交互,大致定义一下内部接口 1 moveToSelectedList(移入到已选择列表 ) 2 moveToSelectableList(移入到可选择列表) 3 saveSelectedList(保存用户的已选择列表) 4 handleDragEnd(处理已选择列表顺序调整完成时) 5 其他略.....
UI 实现
因为注册为concent
组件后天生拥有了emit&on
的能力,而且不需要手动off
,concent
在实例销毁前自动就帮你解除其事件监听,所以我们可以注册完成后,很方便的监听openColumnConf
事件了。
我们先抛弃各种store和reducer定义,快速的基于class
撸出一个原型,利用register
接口将普通组件注册为concent
组件,伪代码如下
import { register } from 'concent';
class ColumnConfModal extends React.Component {
state = {
selectedColumnKeys: [],
selectableColumnKeys: [],
visible: false,
};
componentDidMount(){
this.ctx.on('openColumnConf', ()=>{
this.setState({visible:true});
});
}
moveToSelectedList = ()=>{
//code here
}
moveToSelectableList = ()=>{
//code here
}
saveSelectedList = ()=>{
//code here
}
handleDragEnd = ()=>{
//code here
}
render(){
const {selectedColumnKeys, selectableColumnKeys, visible} = this.state;
return (
<Modal title="设置显示字段" visible={state._visible} onCancel={settings.closeModal}>
<Head />
<Card title="可选字段">
<List dataSource={selectableColumnKeys} render={item=>{
//...code here
}}/>
</Card>
<Card title="已选字段">
<DraggableList dataSource={selectedColumnKeys} onDragEnd={this.handleDragEnd}/>
</Card>
</Modal>
);
}
}
// es6装饰器还处于实验阶段,这里就直接包裹类了
// 等同于在class上@register( )来装饰类
export default register( )(ColumnConfModal)
可以发现,这个类的内部和传统的react
类写法并无区别,唯一的区别是concent
会为每一个实例注入一个上下文对象ctx
来暴露concent
为react
带来的新特性api。
消灭生命周期函数
因为事件的监听只需要执行一次,所以例子中我们在componentDidMount
里完成了事件openColumnConf
的监听注册。
根据需求,显然的我们还要在这里书写获取表格列定义元数据和获取用户的个性化列定义数据的业务逻辑
componentDidMount() {
this.ctx.on('openColumnConf', () => {
this.setState({ visible: true });
});
const tableId = this.props.tid;
tableService.getColumnMeta(`/getMeta/${tableId}`, (columns) => {
userService.getUserColumns(`/getUserColumns/${tableId}`, (userColumns) => {
//根据columns userColumns 计算selectedList selectableList
});
});
}
所有的concent
实例可以定义setup
钩子函数,该函数只会在初次渲染前调用一次。
现在让我们来用setup
代替掉此生命周期
//class 里定义的setup加$$前缀
$$setup(ctx){
//这里定义on监听,在组件挂载完毕后开始真正监听on事件
ctx.on('openColumnConf', () => {
this.setState({ visible: true });
});
//标记依赖列表为空数组,在组件初次渲染只执行一次
//模拟componentDidMount
ctx.effect(()=>{
//service call balabala.....
}, []);
}
如果已熟悉hook
的同学,看到setup
里的effect
api语法是不是和useEffect
有点像?
effect
和useEffect
的执行时机是一样的,即每次组件渲染完毕之后,但是effect
只需要在setup
调用一次,相当于是静态的,更具有性能提升空间,假设我们加一个需求,每次vibible
变为false时,上报后端一个操作日志,就可以写为
//依赖列表填入key的名称,表示当这个key的值发生变化时,触发副作用
ctx.effect( ctx=>{
if(!ctx.state.visible){
//当前最新的visible已是false,上报
}
}, ['visible']);
关于effect
就点到为止,说得太多扯不完了,我们继续回到本文的组件上。
提升状态到store
我们希望组件的状态变更可以被记录下来,方便观察数据变化,so,我们先定义一个store的子模块,名为ColumnConf
,
定义其sate为
// code in ColumnConfModal/model/state.js
export function getInitialState() {
return {
selectedColumnKeys: [],
selectableColumnKeys: [],
visible: false,
};
}
export default getInitialState();
然后利用concent
的configure
接口载入此配置
// code in ColumnConfModal/model/index.js
import { configure } from 'concent';
import state from './state';
// 配置模块ColumnConf
configure('ColumnConf', {
state,
});
注意这里,让model
跟着组件定义走,方便我们维护model
里的业务逻辑。
整个store
已经被concent
挂载到了window.sss
下,为了方便查看store,当当当当,你可以打开console,直接查看store
各个模块当前的最新数据。
然后我们把class注册为'配置模ColumnConf
的组件,现在class
里的state声明可以直接被我们干掉了。
import './model';//引用一下model文件,触发model配置到concent
@register('ColumnConf')
class ColumnConfModal extends React.Component {
// state = {
// selectedColumnKeys: [],
// selectableColumnKeys: [],
// visible: false,
// };
render(){
const {selectedColumnKeys, selectableColumnKeys, visible} = this.state;
}
}
大家可能注意到了,这样暴力的注释掉,render
里的代码会不会出问题?放心吧,不会的,concent组件的state和store
是天生打通的,同样的setState
也是和store
打通的,我们先来安装一个插件concent-plugin-redux-devtool
。
import ReduxDevToolPlugin from 'concent-plugin-redux-devtool';
import { run } from 'concent';
// storeConfig配置略,详情可参考concent官网
run(storeConfig, {
plugins: [ ReduxDevToolPlugin ]
});
注意哦,concent
驱动ui渲染的原理和redux
完全不一样的,核心逻辑部分也不是在redux
之上做包装,和redux
一点关系都没有的^_^,这里只是桥接了redux-dev-tool
插件,来辅助做状态变更记录的,小伙伴们千万不要误会,没有redux
,concent
一样能够正常运作,但是由于concent
提供完善的插件机制,为啥不利用社区现有的优秀资源呢,重复造无意义的轮子很辛苦滴(⊙﹏⊙)b......
现在让我们打开chrome
的redux插件看看效果吧。
上图里是含有大量的ccApi/setState,是因为还有不少逻辑没有抽离到reducer
,dispatch
export function moveToSelectedList() {
}
export function moveToSelectableList() {
}
export async function initSelectedList(tableId, moduleState, ctx) {
//这里可以不用基于字符串 ctx.dispatch('setLoading', true) 去调用了,虽然这样写也是有效的
await ctx.dispatch(setLoading, true);
const columnMeta = await tableService..getColumnMeta(`/getMeta/${tableId}`);
const userColumsn = await userService.getUserColumns(`/getUserColumns/${tableId}`);
//计算 selectedColumnKeys selectableColumnKeys 略
//仅返回需要设置到模块的片断state就可以了
return { loading: false, selectedColumnKeys, selectableColumnKeys };
}
export async function saveSelectedList(tableId, moduleState, ctx) {
}
export function handleDragEnd() {
}