开发一个jQuery插件——多级联动菜单

2022-12-19 22:29:47

引言

开发中，有好多地方用到联动菜单，以前每次遇到联动菜单的时候都去重新写，代码重用率很低，前几天又遇到联动菜单的问题，总结了下，发现可以开发一个联动菜单的功能，以后想用的时候就方便多了。项目中每个页面都有引用jQuery，，开发个jQuery联动菜单插件，说动手就动手，下面跟大家分享分享。

我用的jQuery插件方式

(function($){

    $.fn.casmenu=function(argvs){

         //your code

    }

})(jQuery);

其中jQuery传入的是jquery对象，需要在扩展之前引用。在扩展中同样使用jQuery的短格式$。

$.fn是指jquery的命名空间，加在fn上的方法及属性，会对jquery实例每一个有效，看看下面的jquery源码101行左右：

jQuery.fn = jQuery.prototype = {

    ......

}

比如说后面要开发的$.fn.casmenu()，定义之后，在后面的jquery对象都可以使用该方法。

这里还有一种扩展的方法：

$.extend({

    funName: function(){

        //your code

   },

});

这种扩展方法和上面的是有区别的，要是拿类做类比的话，$.extend这种方法相当于类中的静态方法，上面的一种方式相当于非静态方法，必须有对象才可以使用。简单的理解，是下面这样的：

//$.fn.casemenu 方式扩展的方法，必须在有jquery对象的时候才可以使用

$("#mydiv").casmenu();

//$.extend({}) 方式扩展的方法，可以直接使用

$.add(2,3);

设计思路

首先是层级菜单的数据保存方式，看看下面的数据：

var levels={

    //内容中有引号，必须使用单引号，外引号必须用双引号

    //name => value

    1:{

        退出应用: "code1003",

        登录界面:"code1004",

        跳转至个人资料界面:"code1005",

    },

    2:{

        退出应用:{

            应用1:"gameid1",

            应用2:"gameid2",

            应用3:"gameid3",

            应用4:"gameid4",

            应用5:"gameid5",

        },

        跳转至个人资料界面:{

            主界面:"main interface",

        }

    },

    3:{

        应用1:{

            中级场:"12",

            高级场:"13",

            职业场:"14",

            比赛场:"15",

        }

    }

}

对象levels中的直接键值1、2、3代表菜单的层级，没有就不用些，每一项name=>value代表select中option的名称和value。

层级有规律，某一层级中的某一项要是有下一级菜单，在下一层及有该项的名称，就像levels[1]['退出应用']在有下级菜单，就有levels[2]['退出应用']，要是继续有下级菜单，就像levels[2]['退出应用']['应用1']，会在下一层及中继续有levels[3]['应用1']。这样一来，就实现了无限级联动菜单，不同的联动菜单只需要修改菜单配置文件就可以了。

但是这么做又有一个遗憾，就是如果level2[2]中的子项有两个名称相同的，都有下级菜单，而且下级菜单内容还不一样，就会有问题，因此在设置的时候，有下级菜单的项要取不同的名称，这里要注意下。就目前这种来说，简单，好理解，也够用了。

代码实现

在代码中也用到了$.extend，用来扩展默认配置。

还有一个点要注意，在联动的时候会将实事的菜单值放入一个属性为hidden的input中，用默认逗号分割每个层级之间的值，可以很轻松的获取到联动菜单所有项的值

if(typeof(AI.opts.saveinput) != "undefined" && (AI.opts.saveinput = AI.opts.saveinput.toString()) != ''){

            $("<input type='hidden' value='' name='"+AI.opts.saveinput+"' id='"+AI.opts.saveinput+"' />").appendTo($('body'));

        }

(function($){

    //配置

    var AI={

        opts:{

            saveinput:"jumpcode", //是否将结果保存至input

            levels:{},

            ulObj:{},//保存生成好的ul列表

            length:0, //层级菜单的层级

            divide:",",//默认各个层级菜单之间的分隔符

        }

    };

    $.fn.casmenu=function(opts){

        AI.opts = $.extend(AI.opts, opts);

        if((AI.opts.length = Object.keys(AI.opts.levels).length) <= 0){

            throw "levels arr must not be empty";

            return;

        }

        var _levels = AI.opts.levels;

        if(_levels[1] == undefined){

            throw "menu level 1 must not be empty";

            return;

        }

        var _levels_1 = _levels[1];

        if(typeof(AI.opts.saveinput) != "undefined" && (AI.opts.saveinput = AI.opts.saveinput.toString()) != ''){

            $("<input type='hidden' value='' name='"+AI.opts.saveinput+"' id='"+AI.opts.saveinput+"' />").appendTo($('body'));

        }

        AI.opts.ulObj['level_1'] = '<select class="casmenu" level="1">';

        AI.opts.ulObj['level_1'] += '<option value="null">请选择</option>';

        $("#"+AI.opts.saveinput).val('null');

        for(var i in _levels_1){

            AI.opts.ulObj['level_1'] += '<option name="'+i+'" value="'+_levels_1[i]+'">'+i+'</option>';

        }

        AI.opts.ulObj['level_1'] += '</select>';

        $(AI.opts.ulObj['level_1']).appendTo(this);

        $("body").on("change", ".casmenu", function(){

            var level = $(this).attr("level");

            if(level > AI.opts.length) return;

            level++;

            //移除当前触发菜单之后的菜单

            for(var num=level;num<=AI.opts.length;num++){

                $(".casmenu[level="+num+"]").remove();

            }

            //设置input的值，级联菜单的值

            var _val = '';

            for(var val=1;val<=AI.opts.length;val++){

                var __val = $("select[level="+val+"]");

                if(__val.length <= 0)

                    continue;

                _val += __val.val()+AI.opts.divide;

            }

            $("#"+AI.opts.saveinput).val(_val.substr(0, _val.length-1));

            //levels对象中不存在下一级别目录

            if(typeof(AI.opts.levels[level]) == "undefined") return;

            //获取下一级别目录的键值，值不存在的话返回

            var name = $(this).find("option:selected").attr("name");

            if(typeof(AI.opts.levels[level][name]) == "undefined") return;

            if(typeof(AI.opts.ulObj['level_'+level]) == "undefined" || typeof(AI.opts.ulObj['level_'+level][name]) == "undefined"){

                if(typeof(AI.opts.ulObj['level_'+level]) == "undefined")

                    AI.opts.ulObj['level_'+level] = {};

                AI.opts.ulObj['level_'+level][name] = '<select class="casmenu" level="'+level+'">';

                AI.opts.ulObj['level_'+level][name] += '<option value="null">请选择</option>';

                var levelinfo = AI.opts.levels[level][name];

                for(var i in levelinfo){

                    AI.opts.ulObj['level_'+level][name] += '<option name="'+i+'" value="'+levelinfo[i]+'" >'+i+'</option>';

                }

                AI.opts.ulObj['level_'+level][name] += '</select>';

            }

            $(AI.opts.ulObj['level_'+level][name]).appendTo($(this).parent());

            var _val = '';

            for(var val=1;val<=AI.opts.length;val++){

                var __val = $("select[level="+val+"]");

                if(__val.length <= 0)

                    continue;

                _val += __val.val()+AI.opts.divide;

            }

            $("#"+AI.opts.saveinput).val(_val.substr(0, _val.length-1));

        });

    }

})(jQuery);

效果

下面看看效果

例子：http://aizuyan.github.io/casmenu.html

我把完整的代码放在github上：https://github.com/aizuyan/jquery.plugin

本文版权归作者iforever(luluyrt@163.com)所有，未经作者本人同意禁止任何形式的转载，转载文章之后必须在文章页面明显位置给出作者和原文连接，否则保留追究法律责任的权利。

码农公寓

引言

我用的jQuery插件方式

设计思路

代码实现

效果

相关文章