首页 > 代码库 > jQuery 插件开发——PopupLayer(弹出层)
jQuery 插件开发——PopupLayer(弹出层)
导读:上次写了一篇关于GridView的插件开发方法,上几天由于工作需要,花了一天左右的事件封装了popupLayer(弹出层)插件。今天有时间就记录一下自己的开发思想与大家分享下,同时也算是对这段时间的工作概要吧。
就我在开发过程中的理解和开发的经验,一般常用的弹出层有三类(其实还有一类就是弹出可以输入内容的,但是这种可以被替代,所以就特别拿出来写了):Confirm、Alert、LoadContent(url)。其中Alert又可以分成五种(当然也可以是四种),分别是: "error"、"info"、"question"、"warning"、"alert" 。对于每个名词我就不一一介绍了,相信大家对这几个名词也都不陌生。如果实在了解,可以看下easy ui中的说明。因为很多弹出插件就是类似这样的命名,这样既为了便于他人理解,也便于和主流相一致吧(算是一种“规范”命名吧)。
也扯很多了,下面开始真正的开发环节:
还是我上次说过的,开发插件首先要对这个插件有一定的了解。知道它需要什么样的功能,是用来做什么的。这也算是“需求分析”吧。虽然弹出层算是大家得常识吧,也要对其中的作用在进行一次逻辑分析。分析的好处在于你可以提炼这些弹出层的异同点。说到这里我想大家都了解了这是为什么了,对,就是要将共同点封装起来。
这几个弹出层的共同点很多,例如:弹出的样式、弹出的位置、弹出的方式等等。。。这些都可以封装起来。当然他们的不同点也很容易看出来,例如:加载的按钮可能不一样(Alert一般只有确定按钮,Confirm一般都是两个按钮,也可以是一个)、警告的图标不同等等。。。这些都是不同的地方。当然不同时相对的。我们也是可以进一个提炼的。
先说下开发步骤吧:
第一步:“需求分析”,也就是我上面说的那些。确定各种弹出层的异同点。
第二步:封装共同点
第三步:特殊处理,也就是不同点的处理。(建议写代码的时候分开点,不要所有逻辑都写到一起)
第四步:整合代码,实现功能。(就是通过自己封装的东西,获得想要的效果)
第五步:扩展性问题。这个是我最想强调的。很多人开发的眼光太过短浅(这里不是特指谁,因为我以前也常犯这种问题),开发的插件(或是写的代码),不具有重用性。例如我开发这个的时候就出现了,插件开发完成了,单个测试都很好,没问题。但是同时(或先后)弹出多个层就出问题了,这就是因为当时写代码时候,把一些变量写的太死,导致不可以扩展了。同时弹出来那个层的ID相同了。。。。。。这样悲剧的事情想必很多人都会遇到,以前也用过私人写的第三方插件出现类似的问题。其实出现这样问题归根究底还是需求分析没做好。
第六步:测试。测试时很重要的环节,很多错误情况都是测试出来的。所以不要吝惜那点测试的时间。好的插件(代码)是测出来的。
由于篇幅受限只能贴出部分代码如下:
(function () {
//说明:
// alert弹出 五种状态 "error"、"info"、"question"、"warning"、"alert"
var popupEnumType = {
Error: 1,
Info: 2,
Question: 3,
Warning: 4,
Alert: 5
};
//说明:
// 显示button的类型
var popupEnumBtn = {
SureAndCancel: 1,
SureOnly: 2,
CancelOnly: 3
};
var popupCommon = {
//获取 Confirm 基础元素
getBasicElements_Confirm: function (content, isShowIcon) {
var htmlStr = "";
htmlStr += "<div class=‘cancel_dingdai_tixing‘>" +
" <dl class=‘f-oh‘>";
if (isShowIcon) {
htmlStr += " <dd class=‘f-fl infoIcon‘></dd>";
}
htmlStr += " <dd class=‘f-fl cancel_dingdai_text cancel_dingdai_text_content‘>" + content + "</dd>" +
" </dl>" +
" </div>";
return htmlStr;
},
//获取 Alert 基础元素
getBasicElements_Alert: function (popupType, content) {
var htmlStr = "";
htmlStr += "<div class=‘cancel_dingdai_tixing‘>" +
" <dl class=‘f-oh‘>";
htmlStr += "<dd class=‘f-fl ";
switch (popupType) {
case popupEnumType.Error:
htmlStr += "errorIcon";
break;
case popupEnumType.Info:
htmlStr += "infoIcon";
break;
case popupEnumType.Question:
htmlStr += "questionIcon";
break;
case popupEnumType.Warning:
htmlStr += "warningIcon";
break;
case popupEnumType.Alert:
htmlStr += "";
break;
}
htmlStr += "‘></dd>";
htmlStr += " <dd class=‘f-fl cancel_dingdai_text cancel_dingdai_text_content‘>" + content + "</dd>" +
" </dl>" +
" </div>";
return htmlStr;
},
//获得要显示的弹出层
getPopupLayerHtml: function (title, boxstyle, contentHtml, popupBtnType, btnSureText, btnCancelText) {
var htmlStr = "";
htmlStr += "<div id=‘" + this.returnId("popupBg") + "‘ userDefinedAttr=‘popupLayerBg‘ class=‘popupBg‘ style=‘z-index:" + this.returnPopupBgZIndex() + "‘ ></div>";
htmlStr += "<div id=‘" + this.returnId("popupShow") + "‘ class=‘popupShow‘ style=‘z-index:" + this.returnPopupShowZIndex() + "‘>" +
" <div class=‘cancel_dingdai_pop‘>" +
" <div class=‘cancel_dingdai_wrap_out‘ id=‘" + this.returnId("wrapOut") + "‘>" +
" <div id=‘popupBox‘ class=‘cancel_dingdai_wrap " + boxstyle + "‘ >" +
" <h2 class=‘cancel_dingdai_title f-oh‘>" +
" <span class=‘cancel_dingdai_text f-fl‘>" + title + "</span>" +
" <em id=‘" + this.returnId("cancelImg") + "‘ class=‘cancel_dingdai_title_icon f-fr‘></em>" +
" </h2>" +
" <div id=‘" + this.returnId("popupContent") + "‘ style=‘width:100%;height:auto;background-color:white‘>";
htmlStr += contentHtml;
htmlStr += " </div>";
htmlStr += this.getPopupLayerBtn(popupBtnType, btnSureText, btnCancelText);
htmlStr += " </div>" +
" </div>" +
" </div>" +
"</div>";
return htmlStr;
},
//弹出层按钮选择
getPopupLayerBtn: function (popupBtnType, btnSureText, btnCancelText) {
btnSureText = this.getParam(btnSureText) == "" ? "确定" : btnSureText;
btnCancelText = this.getParam(btnCancelText) == "" ? "取消" : btnCancelText;
var htmlStr = "";
htmlStr += "<div class=‘cancel_dingdai_tijiao‘>" +
" <dl class=‘f-fr f-oh‘>";
var sureBtnStr = "<dd class=‘f-fl cancel_dingdai_submit‘>" +
" <input type=‘button‘ id=‘" + this.returnId("popupBtnSure") + "‘ value=http://www.mamicode.com/‘" + btnSureText + "‘ />" +
"</dd>";
var cancelBtnStr = "<dd class=‘f-fl cancel_dingdai_cancel‘>" +
" <input type=‘button‘ id=‘" + this.returnId("popupBtnCancel") + "‘ value=http://www.mamicode.com/‘" + btnCancelText + "‘ />" +
"</dd>";
switch (popupBtnType) {
case popupEnumBtn.SureAndCancel:
htmlStr += sureBtnStr + cancelBtnStr;
break;
case popupEnumBtn.SureOnly:
htmlStr += sureBtnStr;
break;
case popupEnumBtn.CancelOnly:
htmlStr += cancelBtnStr;
break;
}
htmlStr += " </dl>" +
"</div>";
return htmlStr;
},
//判断元素是否存在,存在后部分加1
returnId: function (prefix) {
var len = $("div[userDefinedAttr=‘popupLayerBg‘]").length;
if (len < 0) {
return prefix + "_1";
}
len++;
return prefix + "_" + len;
},
returnPopupBgZIndex: function () {
var len = $("div[userDefinedAttr=‘popupLayerBg‘]").length;
if (len < 0) {
return 1001;
}
return 1002 + 2 * len - 1;
},
returnPopupShowZIndex: function () {
var len = $("div[userDefinedAttr=‘popupLayerBg‘]").length;
if (len < 0) {
return 1002;
}
return 1002 + 2 * len;
},
//显示弹出层
showPopup: function () {
var len = $("div[userDefinedAttr=‘popupLayerBg‘]").length;
$("#popupBg_" + len).show();
$("#popupBg_" + len).css("height", $(document).height());
$("#popupShow_" + len).show();
},
//关闭弹出层
closePopup: function () {
var len = $("div[userDefinedAttr=‘popupLayerBg‘]").length;
$("#popupBg_" + len).hide();
$("#popupShow_" + len).hide();
$("#popupBg_" + len).remove();
$("#popupShow_" + len).remove();
},
//注册基础事件
registerBasicEvent: function () {
//“X”号图标和取消按钮
var len = $("div[userDefinedAttr=‘popupLayerBg‘]").length;
$("#cancelImg_" + len + ",#popupBtnCancel_" + len).click(function () {
popupCommon.closePopup();
});
},
getParam: function (param) {
if (typeof (param) == "undefined") {
return "";
} else {
return param;
}
},
popupLayerPosition: function () {
var len = $("div[userDefinedAttr=‘popupLayerBg‘]").length;
var objHeight = $("#wrapOut_" + len).height() / 2;
var topValue = http://www.mamicode.com/$(window).height() / 2 - objHeight +"px";
$("#wrapOut_" + len).css("margin-top", topValue);
},
coverObject: function (obj1, obj2) {
var o = this.cloneObject(obj1, false);
var name;
for (name in obj2) {
if (obj2.hasOwnProperty(name)) {
o[name] = obj2[name];
}
}
return o;
},
cloneObject: function (obj, deep) {
if (obj === null) {
return null;
}
var con = new obj.constructor();
var name;
for (name in obj) {
if (!deep) {
con[name] = obj[name];
} else {
if (typeof (obj[name]) == "object") {
con[name] = $.cloneObject(obj[name], deep);
} else {
con[name] = obj[name];
}
}
}
return con;
}
};
/************************(弹出层:加载url)*************************/
var popupLoad = function () {
this.defaultParams = {
//参数定义
title: "",
boxstyle: "",
url: "",
data: "",
loadback: $.noop,
callback: $.noop,//注意:返回值要是true/false的方法
btnId: "",
btnSureText: "",
btnCancelText: ""
};
this.options = {};
this.popupLength = 0;
};
popupLoad.prototype = {
constructor: popupLoad,
init: function (params) {
this.options = popupCommon.coverObject(this.defaultParams, params);
this._init(this.options);
},
_init: function (options) {
var popupLay = popupCommon.getPopupLayerHtml(this.options.title, this.options.boxstyle, "", popupEnumBtn.SureAndCancel, this.options.btnSureText, this.options.btnCancelText);
$("body").append(popupLay);
$("#" + options.btnId).attr("disabled", "disabled");//防止多次发送请求
$.ajaxSetup({
cache: false //关闭 AJAX 缓存
});
this.popupLength = $("div[userDefinedAttr=‘popupLayerBg‘]").length;
$("#popupContent_" + this.popupLength).load(options.url, options.data, function () {
popupCommon.showPopup();
popupCommon.popupLayerPosition();
$("#" + options.btnId).removeAttr("disabled");
if ($.isFunction(options.loadback)) {
options.loadback();
}
});
popupCommon.registerBasicEvent();
this._registerBtnClick(options);
},
_registerBtnClick: function (options) {
var len = this.popupLength;
$("#popupBtnSure_" + len).click(function () {
if (!$.isFunction(options.callback)) {
return;
}
if (!options.callback()) {
return;
}
popupCommon.closePopup();
});
}
};
$.popupLoad = new popupLoad();
/************************(弹出层:confirm框)*************************/
var popupConfirm = function () {
//参数定义
this.defaultParams = {
//参数定义
title: "",
content: "",
boxstyle: "",
isShowIcon: true,
callback: $.noop,//注意:返回值要是true/false的方法
btnSureText: "",
btnCancelText: ""
};
this.options = {};
this.popupLength = 0;
};
popupConfirm.prototype = {
constructor: popupConfirm,
init: function (params) {
this.options = popupCommon.coverObject(this.defaultParams, params);
this._init(this.options);
},
_init: function (options) {
var contentHtml = popupCommon.getBasicElements_Confirm(this.options.content, this.options.isShowIcon);
var popupLay = popupCommon.getPopupLayerHtml(this.options.title, this.options.boxstyle, contentHtml, popupEnumBtn.SureAndCancel, this.options.btnSureText, this.options.btnCancelText);
$("body").append(popupLay);
this.popupLength = $("div[userDefinedAttr=‘popupLayerBg‘]").length;
popupCommon.showPopup();
popupCommon.registerBasicEvent();
popupCommon.popupLayerPosition();
this._registerBtnClick(options);
},
_registerBtnClick: function (options) {
var len = this.popupLength;
$("#popupBtnSure_" + len).click(function () {
popupCommon.closePopup();
if ($.isFunction(options.callback)) {
options.callback();
}
});
}
};
$.popupConfirm = new popupConfirm();
/************************(弹出层:Alert框)*************************/
var popupAlert = function (popupType) {
//参数定义
this.defaultParams = {
title: "",
content: "",
boxstyle: "",
callback: $.noop,//注意:返回值要是true/false的方法
};
this.options = {};
this.popupLength = 0;
this.popupType = popupType;
};
popupAlert.prototype = {
constructor: popupAlert,
init: function (params) {
this.options = popupCommon.coverObject(this.defaultParams, params);
this._init(this.options);
},
_init: function (options) {
var contentHtml = popupCommon.getBasicElements_Alert(this.popupType, this.options.content);
var popupLay = popupCommon.getPopupLayerHtml(this.options.title, this.options.boxstyle, contentHtml, popupEnumBtn.SureOnly);
$("body").append(popupLay);
this.popupLength = $("div[userDefinedAttr=‘popupLayerBg‘]").length;
popupCommon.showPopup();
popupCommon.registerBasicEvent();
popupCommon.popupLayerPosition();
this._registerBtnClick(options);
},
_registerBtnClick: function (options) {
var len = this.popupLength;
$("#popupBtnSure_" + len).click(function () {
popupCommon.closePopup();
if ($.isFunction(options.callback)) {
options.callback();
}
});
}
};
$.popupError = new popupAlert(popupEnumType.Error);
$.popupInfo = new popupAlert(popupEnumType.Info);
$.popupQuestion = new popupAlert(popupEnumType.Question);
$.popupWarning = new popupAlert(popupEnumType.Warning);
$.popupAlert = new popupAlert(popupEnumType.Alert);
})(jQuery);
总结:由于篇幅问题css样式就不贴了很多,如果有需要或者想共同探讨的人,随时联系我,QQ:296319075 同时也希望有大神提出宝贵意见,不吝赐教。如有转载,麻烦注明出处,谢谢!