上一篇(Semantic-UI的React实现(三):基本元素组件)已经提到过,基本元素组件的实现因为没有复杂的交互,仅仅是CSS类的编辑和组装,因此实现原理相对比较简单。
但简单的东西要想做的简洁,往往不简单。
抽象与封装
想要简洁高效地封装数十个基本组件,将组件的相同处理部分抽象出来是非常必要的。在ES6中js新增了class关键字(当然这只是一个语法糖,其背后的处理原理仍然是prototype那一套东西。),有了这个关键字js在抽象与封装的思想上比之前更进了一步。
当用“继承”的思想去考虑问题后,组件的共通处理很明显可以通过继承一个共同父类来完成(通常我更愿意用接口而非继承,无奈js学艺不精,不清楚接口继承如何实现)。继承以后,所有基本组件的以下处理,均可以由父类的处理完成:
编辑和组装CSS类
渲染组件本身
封装事件系统的方法回调
实现细节
编辑和组装CSS类
在系列文章二的时候有提到过,基本组件的CSS编辑和组装,在PropsHelper中实现,所有细节对外隐藏,组件仅需声明相关属性即可。如Header使用到的属性:
// 属性定义
const PROP_TYPES = PropsHelper.getDefaultPropTypes().concat([
'size', 'sub', 'dividing', 'floated', 'aligned', 'inverted', 'inline', 'color'
]);
这些可用属性的声明,再加上Button组件实例的props,即可编辑和组装出所需的CSS类名集合。在Header的render方法中,仅需调用:
render() {
// 渲染元素
let style = this.createElementStyle(this.props, PROP_TYPES) + ' header';
return super.render(style);
}
具体的生成style的细节,在Header的父类UiElement中:
/**
* 生成元素的style
*/
createElementStyle(props, propsDef) {
...
return PropsHelper.createStyle(props, propsDef) + ' ' + style;
}
渲染组件
渲染组件也是共通处理实现的,作为子类的基本组件,仅需调用super.render即可:
render(style, children, props) {
return React.createElement(
this.props.as, // 组件的html标签(默认div)
{
id: this.props.id, // 组件ID
className: style, // 组件class
...this.getEventCallback(), // 事件回调声明
...props // 组件其他props(用于生成class的props不需要了)
},
children ? children : this.props.children
);
}
最开始的时候,其实并没有这个实现,各个组件的渲染过程还是留在组件各自的render中的。但随着组件的增多,发现这部分代码可重用性非常大。如果有特殊的组件不适用这个过程,直接在该组件中覆写该方法即可。这对整体代码的可维护性也有很大程度的提高。
事件系统的回调
这个功能目前还在实现中。我的目标是,任何组件仅需声明而无需在该组件内部实现回调,由公共方法来实现回调处理。如一个Button想要用onClick方法,直接声明:
但在Button组件内部无需实现onClick的回调处理。(实际上也无法实现,因为Button的render处理是在其父类UiElement中实现的)
const EVENT_CALLBACK = [
'onKeyDown', 'onKeyPress', 'onKeyUp',
'onFocus', 'onBlur',
'onChange', 'onInput', 'onSubmit',
'onClick', 'onContextMenu', 'onDoubleClick', 'onDrag', 'onDragEnd', 'onDragEnter',
'onDragExit', 'onDragLeave', 'onDragOver', 'onDragStart', 'onDrop', 'onMouseDown',
'onMouseEnter', 'onMouseLeave', 'onMouseMove', 'onMouseOut', 'onMouseOver', 'onMouseUp',
'onSelect',
'onTouchCancel', 'onTouchEnd', 'onTouchMove', 'onTouchStart',
'onScroll', 'onWheel',
'onLoad', 'onError',
'onTransitionEnd',
'onAnimationStart', 'onAnimationEnd', 'onAnimationIteration',
];
对于事件系统的回调,在constructor中是这样定义的:
constructor(props) {
super(props);
let eventProps = {};
for (let key in props) {
if (key.indexOf('on') == 0 && EVENT_CALLBACK.indexOf(key) >= 0) {
eventProps[key] = this.handleCallback.bind(this, key);
}
}
this.eventCallbacks = eventProps;
}
这个组件传入的props中如果包含'onXXX'并且这个'onXXX'在EVENT_CALLBACK中有定义,则认为该组件声明了一个事件系统的回调,那么UiElement将绑定这个回调的具体处理。处理过程如此实现:
handleCallback(callback, e) {
if (this.props.callback) {
this.props.callback(e);
}
}
回顾
在UiElement中,实现了三类公共功能供基本组件类调用:
编辑和组装CSS类
渲染组件本身
封装事件系统的方法回调
实现以后,基本组件类的相同处理均被抽离出来,仅剩下一些声明性质的代码。例如Header组件的实现被简化为:
import React from 'react';
import PropsHelper from './PropsHelper';
import UiElement from './UiElement';
// 属性定义
const PROP_TYPES = PropsHelper.getDefaultPropTypes().concat([
'size', 'sub', 'dividing', 'floated', 'aligned', 'inverted', 'inline', 'color'
]);
/**
* 标题组件
*/
class Header extends UiElement {
// 类型定义
static propTypes = {
...PropsHelper.createPropTypes(PROP_TYPES)
};
// 默认值定义
static defaultProps = {
...PropsHelper.getDefaultPropsValue(PROP_TYPES)
};
/**
* 取得渲染内容
*/
render() {
// 渲染元素
let style = this.createElementStyle(this.props, PROP_TYPES) + ' header';
return super.render(style);
}
}
export default Header;
这样的好处是显而易见的:
简化实现代码提高可阅读性
封装共通处理提高可维护性
通过方法覆写保持可扩展性
通过这几篇,基础组件的封装处理应该说完了,接下来的几篇打算说说复杂组件的实现。在完成所有组件的封装后,还打算扩展一些复杂组件的功能(代码丑,只能多实现些功能了。总之要和官方做成不一样的/(ㄒoㄒ)/~~)。