上一篇(Semantic-UI的React实现(三):基本元素组件)已经提到过,基本元素组件的实现因为没有复杂的交互,仅仅是CSS类的编辑和组装,因此实现原理相对比较简单。

但简单的东西要想做的简洁,往往不简单。

抽象与封装

想要简洁高效地封装数十个基本组件,将组件的相同处理部分抽象出来是非常必要的。在ES6中js新增了class关键字(当然这只是一个语法糖,其背后的处理原理仍然是prototype那一套东西。),有了这个关键字js在抽象与封装的思想上比之前更进了一步。

当用“继承”的思想去考虑问题后,组件的共通处理很明显可以通过继承一个共同父类来完成(通常我更愿意用接口而非继承,无奈js学艺不精,不清楚接口继承如何实现)。继承以后,所有基本组件的以下处理,均可以由父类的处理完成:

  1. 编辑和组装CSS类

  2. 渲染组件本身

  3. 封装事件系统的方法回调

图片描述

实现细节

编辑和组装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={this.handleClick}>Btn</Button>

但在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中,实现了三类公共功能供基本组件类调用:

  1. 编辑和组装CSS类

  2. 渲染组件本身

  3. 封装事件系统的方法回调

实现以后,基本组件类的相同处理均被抽离出来,仅剩下一些声明性质的代码。例如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;

这样的好处是显而易见的:

  1. 简化实现代码提高可阅读性

  2. 封装共通处理提高可维护性

  3. 通过方法覆写保持可扩展性

通过这几篇,基础组件的封装处理应该说完了,接下来的几篇打算说说复杂组件的实现。在完成所有组件的封装后,还打算扩展一些复杂组件的功能(代码丑,只能多实现些功能了。总之要和官方做成不一样的/(ㄒoㄒ)/~~)。


sheva
17 声望4 粉丝

JS从初学到放弃,三个月一个疗程(U_U)