分享我对JS插件开发的一些感想和心得

本文阅读目录：

•起因
•如何开发一个轻量级的适用性强的插件
•总结

起因


如果大家平时做过一些前端开发方面的工作，一定会有这样的体会：页面需要某种效果或者插件的时候，我们一般会有两种选择：

1、上网查找相关的JS插件，学习其用法
2、自己造轮子，开发插件。

寻找存在的插件

第一种做法，上网查找JS插件

这种方式如果是有刚好符合项目需求的插件，那是非常幸运的事了。但是我相信大部分情况下，我们找到的插件会有下面的几个问题：

（1）UI定制：很多插件提供的UI和我们的项目设计风格完全不搭，可能写好的html和css不符合插件使用的方式，结果我们还要去修改html和css来适应插件的用法。
（2）学习成本：如果是比较复杂的插件，存在着一个学习成本的问题，要去学习这个插件怎么使用。
（3）插件不符合需求：我们找到的插件并不完全保证符合我们项目的需求，这个时候你可能要去修改它的代码来支持项目需求，这也是可能存在的问题
（4）插件功能太大而全：假设你的项目需要一个简单的轮播插件，结果找到一个很牛逼的轮播插件，各种酷炫的效果，而且刚好也能使用，但是这个插件的体积和一个js库的体积差不多，而如果自己写效果的话，其实只要几十行代码就可以搞定了，这时候引入这个插件是否太过多余了。
这是使用js插件可能存在的一些问题，当然具体情况具体分析，我也并非不使用已经写好的js插件，毕竟有些插件是经过了时间考验的，使用起来更有益于项目的进行。如果是下面几种情况，我会考虑使用已经存在的js插件：

（1）复杂的功能：比如文件上传，批量上传，进度显示等等，比如HTML编辑器
（2）项目工期紧急，对性能要求不高的场景
（3）js插件刚好符合项目的需求

自己造轮子


第二种做法，自己造轮子开发插件
自己写插件主要有下面几个问题：

（1）开发插件需要时间，可能拖延项目工期，如果工期紧急不建议选用这种方式
（2）自己造的轮子未必有现有轮子的好用，要考虑到队友是否适用
（3）需要比较高的开发水平

如果平时项目不紧急的话，我会考虑自己造轮子，主要有几个好处：

（1）完全符合项目需求，这一条是显而易见的，因为完全针对项目来开发的插件
（2）知根知底，容易修改，插件完全是自己开发的，项目有什么需求变化完全可以灵活应对
（3）轻量级，因为我们不像其他开源插件要应对那么多种需求，所以我们自己的轮子也只需要符合自己的车，不需要很多变化，相对来说，变化少功能少，代码也会少。
（4）对个人能力是一个很大的锻炼，不要重复造轮子这是在程序员中广为流传的一句话，这也成为很多人偷懒的一个借口，但是我们不应该以此为借口来阻碍自己的前进的脚步。造过轮子的同学应该深有体会，造过一个轮子，远比你使用别人写的100个插件的收获还要多，我们的轮子可以不在项目中使用，但这是一种效率极高的学习方式，强烈推荐。

如何开发一个轻量级的适用性强的插件

怎么开发一个适应性强的且轻量的插件呢？所谓适用性强，简单地说就是有几点：

1、对UI限制越少越好，最好没有
2、不提供太多功能，只提供简单的api，让使用者易于扩展

我们举个例子，假设我们要开发一个jQuery分页插件，关于jQuery插件开发教程，请参考jQuery插件开发。

确定需求

确定需求是开发插件的第一步。要开发一个轻量级的分页插件，我们还是用从插件最基本的需求开始说起，分页插件最基本的需求是什么呢，无非就是页码显示，页码之间的切换，所以，我们的插件要围绕着这基本需求开始，而暂时不要考虑其他可能存在的需求。

确定插件html和css


确定好插件的需求后，第二步就是插件的UI，也就是html和css。

假设基本的ui如下：



基本的分页UI

看到上面的基本ui，不知道大家会想到什么样的html结构。对于我们开发人员来说，html和css要越简单越好，所以最基本的html结构无非就是a标签和span标签的混合，有的同学可能会想到使用ul，li标签，但这其实增加的复杂度，得不偿失。我们编写html代码如下：

?
这是最基本html代码结构，包含了分页插件的容器div.pager，当前页span.curPage，其他页码a标签，上一页，下一页等按钮。

接着是css代码，主要当前页标签，其他页面标签，上一页下一页，鼠标悬停在按钮上等几种样式，编写如下：

?
编写js代码

写好基本的html和css，接下来最关键的就是js代码了。首先我们搭建好jQuery插件开发的基本形式：

?
这里主要提供了一些可选参数的默认值，比如页码默认为0，每页数量6条等等。

接着我们来考虑一下分页插件的思路：

1、设置当前页码为0，表示第一页
2、生成分页插件的html代码
3、修改页码，再生成html代码

基于这个思路，我们编写代码如下：

?
这段代码中有两个关键点要记住：

（1）html代码的生成，由于页码可能太多，需要隐藏部分页码，所以我们要生成一个省略号表示被隐藏的页码，通过maxButtonCount来表示最多的页码按钮

（2）事件绑定，每次页码改变都会重新生成html，我们采用事件代理的方式，提高了性能，也不用重复绑定事件
这样一个最基本的分页插件已经可以了。

但是这样足够了吗？

假设我们需要支持输入页码直接跳转的功能，那该如何呢，是否需要修改原有的html结构和css？前面我们说到，开发一个插件要围绕最基本的需求开始，那对于这些潜在的可能存在的需求又该如何处理呢。

我的解决方案是这样的，提供简单的api，不提供UI，完全由用户自定义。

我们在上面的代码增加三个api：getPageIndex，setPageIndex和setItemCount，分别表示获取当前索引，设置当前索引，设置项目总数量。代码如下：

?
提供了这三个api，假设用户需要跳转页码的功能，可以直接使用setPageIndex方法来跳转，UI完全由用户自定义，插件本身只专注基本功能，不干涉其它。

大家可以查看DEMO

整个插件的代码已经放在我的github上，有兴趣的同学可以点击查看github

总结

最后，我整理一下我开发一些js插件的思路：

1、专注最基本的需求本身，暂时不考虑可能潜在的需求
2、尽量不提供或少提供UI，减少对使用者的限制
3、考虑可能潜在的需求，提供api，潜在的需求完全由用户自定义