怎么写好组件

时间 2019-12-05

标签怎么写好组件繁體版

原文原文链接

咱们为何要写组件呢？这里不细分组件、插件、控件，追究其缘由无非让代码，可以复用，追求更快的开发效率。其实还有个重要的缘由，项目大了以后，难以维护。这个时候就会把项目中重复的部分抽取出来，造成一个组件。可是组件也会有些'缺点'，这个最后讲。javascript

组件需求

要实现如图的一个条件选择器html

有的时候，项目时间紧张，就会直接切图，经过jquery的dom选择器实现这个'简单的功能'。java

需求分析

为了更好的维护，以及更好的复用此组件，就要作些抽象。jquery

数据层：用来决定按钮个数以及按钮是否选择git
表现层：按钮使用现有的ui组件github
逻辑层：按钮事件等逻辑处理bootstrap

数据层

data: null,
choseT: 0,
choseF: 0,
getDataStatistics: function() {
    var list = this.data;
    var choseT = 0;
    var choseF = 0;
    var len = list.length;
    for (var i = 0; i < list.length; i++) {
        if(list[i].checked == 'checked') {
            choseT++;
        }else {
            choseF++;
        }
    }
    return {
        choseT: choseT,
        choseF: choseF,
        len: len
    };
},
dataChangeAll: function(checked) {
    var list = this.data;
    var len = list.length;
    checked = checked || '';
    if(checked == 'checked') {
        this.choseT = len;
        this.choseF = 0;
    }else {
        this.choseT = 0;
        this.choseF = len;
    }

    for (var i = 0; i < len; i++) {
        list[i].checked = checked;
    }
},
dataChangeSingle: function(index, checked) {
    var list = this.data;
    var choseT = this.choseT;
    var choseF = this.choseF;
    if(checked == 'checked') {
        choseT++;
        choseF--;
    }else {
        choseT--;
        choseF++;
    }
    this.choseT = choseT;
    this.choseF = choseF;
    list[index].checked = checked;
}

数据层主要对原始数据作些CURD的一些操做，具体的操做看具体的业务需求，可是要具备这个意识。dom

表现层

说白了表现层也就是template层或者view层，就是用户所看到的，通常会用一个比较成熟的ui库，好比bootstrap。ui

getHtml: function(list, statistic) {
    var html = 
        ['<div class="sales-dialog">',
           '<div>',
               '<div class="tag-box-chose J_view_checkNav">',
                   this.getChoseNav(statistic),
               '</div>',
               '<div class="mt_10 J_view_checkItems">',
                    this.getChoseItem(list),
               '</div>',
           '</div>',
        '</div>'].join('');
    return html;
},
getChoseNav: function(statistic) {
    var checkAll = '';
    var checkNone = '';
    var len = statistic.len;
    if(statistic.choseT == len) {
        checkAll = 'checked';
    }
    if(statistic.choseF == len) {
        checkNone = 'checked';
    }
    return [
        '<label class="tag '+checkAll+'">',
            '<input type="radio" name="radio-grade input-fat" class="J_view_checkAll" '+checkAll+' />',
            '<span class="tag-tit">全选</span>',
        '</label>',
        '<label class="tag '+checkNone+'">',
            '<input type="radio" name="radio-grade" class="J_view_checkNone" '+checkNone+'/>',
            '<span class="tag-tit">全不选</span>',
        '</label>'
    ].join('');
},
getChoseItem: function(list) {
    var inputs = '';
    var doInputFunc = function(i, detail) {
        return [
            '<div style="display:inline-block;width:150px;">',
                '<label data-toggle="checkbox" class="checkbox-pretty inline '+detail.checked+'">',
                    '<input type="checkbox" value="'+i+'" class="J_view_checkItem " '+detail.checked+'><span>'+detail.name+'</span>',
                '</label>',
            '</div>',
        ].join('');
    };

    for (var i = 0; i < list.length; i++) {
        inputs += doInputFunc(i, list[i]);
    }
    return inputs;
},
domAction: function($el, type, data) {
    var html = '';
    type = type || 'all';
    if(type == 'item') {
        html = this.getChoseItem(data);
        $el.find('.J_view_checkItems').html(html);
    }else if(type == 'all') {
        html = this.getChoseNav(data);
        $el.find('.J_view_checkNav').html(html);
    }
}

众所周知，template就是根据数据渲染成html，在spa项目尤为重要。this

逻辑层

这层主要作调用template方法将数据渲染到页面上；将页面上的一些事件结果，映射到数据层。其实如今流行的MVVM模式，就是在逻辑层这里作了更多的事情，只是开发者们不用去关心细节处理，更专一业务的开发。

eventBind: function($el) {
    var _this = this;
    var $target = '';
    
    // 全选
    $el.on('change', '.J_view_checkAll', function() {
        if(!$(this).parent().hasClass('checked')) {
            _this.module.dataChangeAll('checked');
            _this.view.domAction($el, 'all', _this.module.getDataStatistics());
            _this.view.domAction($el, 'item', _this.module.data);
        }
    });
    
    // 全不选
    $el.on('change', '.J_view_checkNone', function() {
        if(!$(this).parent().hasClass('checked')) {
            _this.module.dataChangeAll('');
            _this.view.domAction($el, 'all', _this.module.getDataStatistics());
            _this.view.domAction($el, 'item', _this.module.data);
        }
    });
    
    // 单个
    $el.on('click', '.J_view_checkItem', function() {
        $target = $(this);
        var index = $target.val();
        var checked = '';
        if($target.prop('checked')) {
            checked = 'checked';
        }
        _this.module.dataChangeSingle(index, checked);
        _this.view.domAction($el, 'all', _this.module.getDataStatistics());
    });
},
eventUnbind: function($el) {
    $el.off('change');
    $el.off('click');
},

完整案例

总结

这样子写能更好的抽象出公共部分，在其它模块就只要传入数据就能够了，不用重复拷贝代码了。

一开始说到组件会有‘缺点’？尤为是业务组件？

分析

项目版本迭代是一个很正常的事情，初版的时候，好比这个数据选择项这个组件，在每一个模块都有这样的需求。可是在下一个版本的时候，产品经理在其中一个模块更改了业务需求，这就致使这个模块的数据选择项，跟其它模块的数据选择项不同了，可是又有80%甚至90%的类似度，这个时候就很是困扰，究竟是从新写个，仍是再对原来的组件，增长个兼容配置项？

从新写会有不少重复的代码。新增配置项，又必须保证以前全部的模块都要正确，得必须都验证过去。有人就会以为直接去验证好了啊，可是项目大了以后，一个一个去验证不是解决问题的办法。

最终解决

在写组件的时候，业务逻辑部分，现预留配置项，以便后面业务发生改变，经过配置项来重置。尤为是以为产品经理会更改频繁的部分。

实在是以为更改逻辑较大，那就从新写个吧，由于一个一个去验证以前的模块的成本仍是很大的。

原文地址 http://tostring.site/2016/07/16/%E6%80%8E%E4%B9%88%E5%86%99%E5%A5%BD%E7%BB%84%E4%BB%B6/