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

时间:2024-01-20 14:40:06

引言

开发中,有好多地方用到联动菜单,以前每次遇到联动菜单的时候都去重新写,代码重用率很低,前几天又遇到联动菜单的问题,总结了下,发现可以开发一个联动菜单的功能,以后想用的时候就方便多了。项目中每个页面都有引用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);

效果

下面看看效果

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

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

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

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