easyui源码翻译1.32--Menu（菜单）
前言
使用$.fn.menu.defaults重写默认值对象。下载该插件翻译源码
菜单组件通常用于快捷菜单。他是构建其他菜单组件的必备基础组件。比如：menubutton和splitbutton。它还可以用于导航和执行命令。
源码
/** * jQuery EasyUI 1.3.2 * * 翻译：qq 1364386878 * *g=this p=g.options */ (function ($) { //初始化 function _init(target) { $(target).appendTo("body"); $(target).addClass("menu-top"); $(document).unbind(".menu").bind("mousedown.menu", function (e) { var visible = $("body>div.menu:visible"); var m = $(e.target).closest("div.menu", visible); if (m.length) { return; } $("body>div.menu-top:visible").menu("hide"); }); var menus = adjust($(target)); for (var i = 0; i < menus.length; i++) { wrapMenu(menus[i]); } //递归获取菜单项 function adjust(menu) { var menus = []; menu.addClass("menu"); if (!menu[0].style.width) { menu[0].autowidth = true; } menus.push(menu); if (!menu.hasClass("menu-content")) { menu.children("div").each(function () { var divchild = $(this).children("div"); if (divchild.length) { divchild.insertAfter(target); this.submenu = divchild; var mm = adjust(divchild); menus = menus.concat(mm); } }); } return menus; }; function wrapMenu(menu) { if (!menu.hasClass("menu-content")) { menu.children("div").each(function () { var item = $(this); if (item.hasClass("menu-sep")) { } else { var options = $.extend({}, $.parser.parseOptions(this, ["name", "iconCls", "href"]), { disabled: (item.attr("disabled") ? true : undefined) }); item.attr("name", options.name || "").attr("href", options.href || ""); var text = item.addClass("menu-item").html(); item.empty().append($("<div class=\"menu-text\"></div>").html(text)); if (options.iconCls) { $("<div class=\"menu-icon\"></div>").addClass(options.iconCls).appendTo(item); } if (options.disabled) { _enableItem(target, item[0], true); } if (item[0].submenu) { $("<div class=\"menu-rightarrow\"></div>").appendTo(item); } item._outerHeight(22); _f(target, item); } }); $("<div class=\"menu-line\"></div>").prependTo(menu); } _10(target, menu); menu.hide(); menuEvent(target, menu); }; }; function _10(target, parm) { var options = $.data(target, "menu").options; var d = parm.css("display"); parm.css({ display: "block", left: -10000 }); var width = parm._outerWidth(); var menuwidth = 0; parm.find("div.menu-text").each(function () { if (menuwidth < $(this)._outerWidth()) { menuwidth = $(this)._outerWidth(); } }); menuwidth += 65; parm._outerWidth(Math.max(width, menuwidth, options.minWidth)); parm.css("display", d); }; //菜单事件 function menuEvent(target, menu2) { var menu = $.data(target, "menu"); menu2.unbind(".menu").bind("mouseenter.menu", function () { if (menu.timer) { clearTimeout(menu.timer); menu.timer = null; } }).bind("mouseleave.menu", function () { menu.timer = setTimeout(function () { _hide(target);//隐藏菜单 }, 100); }); }; //菜单项事件 function _f(target, item) { item.unbind(".menu"); item.bind("click.menu", function () { if ($(this).hasClass("menu-item-disabled")) { return; } if (!this.submenu) { _hide(target); var _1d = $(this).attr("href"); if (_1d) { location.href = _1d; } } var _1e = $(target).menu("getItem", this); $.data(target, "menu").options.onClick.call(target, _1e); }).bind("mouseenter.menu", function (e) { item.siblings().each(function () { if (this.submenu) { hideMenu(this.submenu); } $(this).removeClass("menu-active"); }); item.addClass("menu-active"); if ($(this).hasClass("menu-item-disabled")) { item.addClass("menu-active-disabled"); return; } var _1f = item[0].submenu; if (_1f) { $(target).menu("show", { menu: _1f, parent: item }); } }).bind("mouseleave.menu", function (e) { item.removeClass("menu-active menu-active-disabled"); var menu = item[0].submenu; if (menu) { if (e.pageX >= parseInt(menu.css("left"))) { item.addClass("menu-active"); } else { hideMenu(menu); } } else { item.removeClass("menu-active"); } }); }; //隐藏菜单 function _hide(target) { var menu = $.data(target, "menu"); if (menu) { if ($(target).is(":visible")) { hideMenu($(target)); menu.options.onHide.call(target); } } return false; }; // //显示菜单到指定的位置pos(left/right) function _showmenu(target, pos) { var left, top; var menu = $(pos.menu || target); if (menu.hasClass("menu-top")) { var options = $.data(target, "menu").options; left = options.left; top = options.top; if (pos.alignTo) { var at = $(pos.alignTo); left = at.offset().left; top = at.offset().top + at._outerHeight(); } if (pos.left != undefined) { left = pos.left; } if (pos.top != undefined) { top = pos.top; } if (left + menu.outerWidth() > $(window)._outerWidth() + $(document)._scrollLeft()) { left = $(window)._outerWidth() + $(document).scrollLeft() - menu.outerWidth() - 5; } if (top + menu.outerHeight() > $(window)._outerHeight() + $(document).scrollTop()) { top -= menu.outerHeight(); } } else { var parent = pos.parent; left = parent.offset().left + parent.outerWidth() - 2; if (left + menu.outerWidth() + 5 > $(window)._outerWidth() + $(document).scrollLeft()) { left = parent.offset().left - menu.outerWidth() + 2; } var top = parent.offset().top - 3; if (top + menu.outerHeight() > $(window)._outerHeight() + $(document).scrollTop()) { top = $(window)._outerHeight() + $(document).scrollTop() - menu.outerHeight() - 5; } } menu.css({ left: left, top: top }); menu.show(0, function () { if (!menu[0].shadow) { menu[0].shadow = $("<div class=\"menu-shadow\"></div>").insertAfter(menu); } menu[0].shadow.css({ display: "block", zIndex: $.fn.menu.defaults.zIndex++, left: menu.css("left"), top: menu.css("top"), width: menu.outerWidth(), height: menu.outerHeight() }); menu.css("z-index", $.fn.menu.defaults.zIndex++); if (menu.hasClass("menu-top")) { $.data(menu[0], "menu").options.onShow.call(menu[0]); } }); }; //隐藏菜单项 function hideMenu(menu) { if (!menu) { return; } _hideshadow(menu); menu.find("div.menu-item").each(function () { if (this.submenu) { hideMenu(this.submenu); } $(this).removeClass("menu-active"); }); function _hideshadow(m) { m.stop(true, true); if (m[0].shadow) { m[0].shadow.hide(); } m.hide(); }; }; //查找的指定菜单项 function _findItem(target, text) { var item = null; var tmp = $("<div></div>"); function find(parentMenu) { parentMenu.children("div.menu-item").each(function () { var item = $(target).menu("getItem", this); var s = tmp.empty().html(item.text).text(); if (text == $.trim(s)) { item = item; } else { if (this.submenu && !item) { find(this.submenu); } } }); }; find($(target)); tmp.remove(); return item; }; //启用禁用菜单项 function _enableItem(target, itemEl, disabled) { var t = $(itemEl); if (disabled) { t.addClass("menu-item-disabled"); if (itemEl.onclick) { itemEl.onclick1 = itemEl.onclick; itemEl.onclick = null; } } else { t.removeClass("menu-item-disabled"); if (itemEl.onclick1) { itemEl.onclick = itemEl.onclick1; itemEl.onclick1 = null; } } }; //追加新的菜单项 function menuppendItem(target, options) { var parm = $(target); if (options.parent) { if (!options.parent.submenu) { var menu = $("<div class=\"menu\"><div class=\"menu-line\"></div></div>").appendTo("body"); menu[0].autowidth = true; menu.hide(); options.parent.submenu = menu; $("<div class=\"menu-rightarrow\"></div>").appendTo(options.parent); } parm = options.parent.submenu; } var item = $("<div class=\"menu-item\"></div>").appendTo(parm); $("<div class=\"menu-text\"></div>").html(options.text).appendTo(item); if (options.iconCls) { $("<div class=\"menu-icon\"></div>").addClass(options.iconCls).appendTo(item); } if (options.id) { item.attr("id", options.id); } if (options.href) { item.attr("href", options.href); } if (options.name) { item.attr("name", options.name); } if (options.onclick) { if (typeof options.onclick == "string") { item.attr("onclick", options.onclick); } else { item[0].onclick = eval(options.onclick); } } if (options.handler) { item[0].onclick = eval(options.handler); } _f(target, item); if (options.disabled) { _enableItem(target, item[0], true); } menuEvent(target, parm); _10(target, parm); }; //移除指定的菜单项 function _removeItem(target, itemEl) { function remove(el) { if (el.submenu) { el.submenu.children("div.menu-item").each(function () { remove(this); }); var shadow = el.submenu[0].shadow; if (shadow) { shadow.remove(); } el.submenu.remove(); } $(el).remove(); }; remove(itemEl); }; //销毁菜单 function textestroy(target) { $(target).children("div.menu-item").each(function () { _removeItem(target, this); }); if (target.shadow) { target.shadow.remove(); } $(target).remove(); }; //实例化菜单 $.fn.menu = function (target, parm) { if (typeof target == "string") { return $.fn.menu.methods[target](this, parm); } target = target || {}; return this.each(function () { var menu = $.data(this, "menu"); if (menu) { $.extend(menu.options, target); } else { menu = $.data(this, "menu", { options: $.extend({}, $.fn.menu.defaults, $.fn.menu.parseOptions(this), target) }); _init(this); } $(this).css({ left: menu.options.left, top: menu.options.top }); }); }; //默认的方法 $.fn.menu.methods = { //返回属性对象 options: function (jq) { return $.data(jq[0], "menu").options; }, //显示菜单到指定的位置pos(left/right) show: function (jq, pos) { return jq.each(function () { _showmenu(this, pos); }); }, //隐藏菜单 hide: function (jq) { return jq.each(function () { _hide(this); }); }, //销毁菜单 destroy: function (jq) { return jq.each(function () { textestroy(this); }); }, //设置指定菜单项的文本 'param'参数包含2个属性：target：DOM对象，要设置值的菜单项。 text: 字符串，要设置的新文本值。 setText: function (jq, param) { return jq.each(function () { $(param.target).children("div.menu-text").html(param.text); }); }, //设置指定菜单项图标。'param'参数包含2个属性： target：DOM对象，要设置的菜单项。 iconCls：新的图标CSS类ID。 setIcon: function (jq, param) { return jq.each(function () { var item = $(this).menu("getItem", param.target); if (item.iconCls) { $(item.target).children("div.menu-icon").removeClass(item.iconCls).addClass(param.iconCls); } else { $("<div class=\"menu-icon\"></div>").addClass(param.iconCls).appendTo(param.target); } }); }, //获取指定的菜单项。得到的是一个菜单项的DOM元素。下面的例子展示了如何根据ID获取指定的项： getItem: function (jq, itemEl) { var t = $(itemEl); var item = { target: itemEl, id: t.attr("id"), text: $.trim(t.children("div.menu-text").html()), disabled: t.hasClass("menu-item-disabled"), href: t.attr("href"), name: t.attr("name"), onclick: itemEl.onclick }; var submenu = t.children("div.menu-icon"); if (submenu.length) { var cc = []; var aa = submenu.attr("class").split(" "); for (var i = 0; i < aa.length; i++) { if (aa[i] != "menu-icon") { cc.push(aa[i]); } } item.iconCls = cc.join(" "); } return item; }, //查找的指定菜单项，返回的对象和getItem方法是一样的。 findItem: function (jq, text) { return _findItem(jq[0], text); }, //追加新的菜单项，'options'参数代表新菜单项属性。默认情况下添加的项在菜单项的顶部。追加一个子菜单项， //'parent'属性应该设置指定的父项元素，并且该父项元素必须是已经定义在页面上的。 appendItem: function (jq, options) { return jq.each(function () { menuppendItem(this, options); }); }, //移除指定的菜单项。 removeItem: function (jq, itemEl) { return jq.each(function () { _removeItem(this, itemEl); }); }, //启用菜单项 enableItem: function (jq, itemEl) { return jq.each(function () { _enableItem(this, itemEl, false); }); }, //禁用菜单项 disableItem: function (jq, itemEl) { return jq.each(function () { _enableItem(this, itemEl, true); }); } }; $.fn.menu.parseOptions = function (target) { return $.extend({}, $.parser.parseOptions(target, ["left", "top", { minWidth: "number" }])); }; //菜单默认属性+事件 $.fn.menu.defaults = { zIndex: 110000,//菜单z-index样式，增加它的值 left: 0,//菜单的左边距位置 top: 0,//菜单的上边距位置 minWidth: 120,//菜单的最小宽度 //在菜单显示之后触发 onShow: function () { }, //在菜单隐藏之后触发 onHide: function () { }, //在菜单项被点击的时候触发。下面的例子显示了如何处理所有菜单项的点击 onClick: function (item) { } }; })(jQuery);
示例代码
<!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title>Basic Menu - jQuery EasyUI Demo</title> <link rel="stylesheet" type="text/css" href="../../themes/default/easyui.css"> <link rel="stylesheet" type="text/css" href="../../themes/icon.css"> <link rel="stylesheet" type="text/css" href="../demo.css"> <script type="text/javascript" src="../../jquery-1.8.0.min.js"></script> <script src="../../plugins2/jquery.parser.js"></script> <script src="../../plugins2/jquery.menu.js"></script> </head> <body> <h2>Basic Menu</h2> <div class="demo-info"> <div class="demo-tip icon-tip"></div> <div>Right click on page to display menu.</div> </div> <div style="margin:10px 0;"></div> <div id="mm" class="easyui-menu" style="width:120px;"> <div onclick="javascript:alert('new')">New</div> <div> <span>Open</span> <div style="width:150px;"> <div><b>Word</b></div> <div>Excel</div> <div>PowerPoint</div> <div> <span>M1</span> <div style="width:120px;"> <div>sub1</div> <div>sub2</div> <div> <span>Sub</span> <div style="width:80px;"> <div onclick="javascript:alert('sub21')">sub21</div> <div>sub22</div> <div>sub23</div> </div> </div> <div>sub3</div> </div> </div> <div> <span>Window Demos</span> <div style="width:120px;"> <div data-options="href:'window.html'">Window</div> <div data-options="href:'dialog.html'">Dialog</div> <div><a href="http://www.jeasyui.com" target="_blank">EasyUI</a></div> </div> </div> </div> </div> <div data-options="iconCls:'icon-save'">Save</div> <div data-options="iconCls:'icon-print',disabled:true">Print</div> <div class="menu-sep"></div> <div>Exit</div> </div> <script> $(function(){ $(document).bind('contextmenu',function(e){ e.preventDefault(); $('#mm').menu('show', { left: e.pageX, top: e.pageY }); }); }); </script> </body> </html>
插件效果
