重慶分公司
重慶分公司，新征程啟航
為企業(yè)提供網(wǎng)站建設(shè)、域名注冊、服務(wù)器等服務(wù)
JS組件封裝的示例分析-創(chuàng)新互聯(lián)
這篇文章主要介紹了JS組件封裝的示例分析，具有一定借鑒價(jià)值，感興趣的朋友可以參考下，希望大家閱讀完這篇文章之后大有收獲，下面讓小編帶著大家一起了解一下。
一、擴(kuò)展已經(jīng)存在的組件
1、需求背景
很多時(shí)候，我們使用jquery.ajax的方式向后臺發(fā)送請求，型如
$.ajax({
type: "post",
url: "/User/Edit",
data: { data: JSON.stringify(postdata) },
success: function (data, status) {
if (status == "success") {
toastr.success('提交數(shù)據(jù)成功');
$("#tb_aaa").bootstrapTable('refresh');
}
},
error: function (e) {
},
complete: function () {
}
});這種代碼太常見了，這個(gè)時(shí)候我們有這樣一個(gè)需求：在自己調(diào)用ajax請求的時(shí)候，我們不想每次都寫error:function(e){}這種代碼，但是我們又想讓它每次都將ajax的錯(cuò)誤信息輸出到瀏覽器讓用戶能夠看到。怎么辦呢？
2、實(shí)現(xiàn)原理
要想實(shí)現(xiàn)以上效果其實(shí)并不難，我們可以將$.ajax({})封裝一層，在封裝的公共方法里面定義error對應(yīng)的事件即可。確實(shí)，這樣能達(dá)到我們的要求，但是并不完美，原因很簡單：1）在jquery的基礎(chǔ)上面再封裝一層，效率不夠高；2）需要改變調(diào)用者的習(xí)慣，每次調(diào)用ajax的時(shí)候需要按照我們定義的方法的規(guī)則來寫，而不能直接用原生的$.ajax({})這種寫法，這是我們不太想看到。
既然如此，那我們?nèi)绾巫龅郊炔环庋b控件，又能達(dá)到以上要求呢？答案就是通過我們的$.extend去擴(kuò)展原生的jquery.ajax。
其實(shí)實(shí)現(xiàn)起來也并不難，通過以下一段代碼就能達(dá)到我們的要求。
(function ($) {
//1.得到$.ajax的對象
var _ajax = $.ajax;
$.ajax = function (options) {
//2.每次調(diào)用發(fā)送ajax請求的時(shí)候定義默認(rèn)的error處理方法
var fn = {
error: function (XMLHttpRequest, textStatus, errorThrown) {
toastr.error(XMLHttpRequest.responseText, '錯(cuò)誤消息', { closeButton: true, timeOut: 0, positionClass: 'toast-top-full-width' });
},
success: function (data, textStatus) { },
beforeSend: function (XHR) { },
complete: function (XHR, TS) { }
}
//3.如果在調(diào)用的時(shí)候?qū)懥薳rror的處理方法，就不用默認(rèn)的
if (options.error) {
fn.error = options.error;
}
if (options.success) {
fn.success = options.success;
}
if (options.beforeSend) {
fn.beforeSend = options.beforeSend;
}
if (options.complete) {
fn.complete = options.complete;
}
//4.擴(kuò)展原生的$.ajax方法，返回最新的參數(shù)
var _options = $.extend(options, {
error: function (XMLHttpRequest, textStatus, errorThrown) {
fn.error(XMLHttpRequest, textStatus, errorThrown);
},
success: function (data, textStatus) {
fn.success(data, textStatus);
},
beforeSend: function (XHR) {
fn.beforeSend(XHR);
},
complete: function (XHR, TS) {
fn.complete(XHR, TS);
}
});
//5.將最新的參數(shù)傳回ajax對象
_ajax(_options);
};
})(jQuery);如果沒接觸過jquery里面$.extend這個(gè)方法的童鞋可能看不懂以上是什么意思。好，我們首先來看看jquery API對$.extend()方法是作何解釋的。
什么意思呢？我們來看官方的兩個(gè)例子就知道了
栗子一：
var settings = { validate: false, limit: 5, name: "foo" };
var options = { validate: true, name: "bar" };
$.extend(settings, options);結(jié)果：
settings == { validate: true, limit: 5, name: "bar" }栗子二：
var empty = {};
var defaults = { validate: false, limit: 5, name: "foo" };
var options = { validate: true, name: "bar" };
var settings = $.extend(empty, defaults, options);結(jié)果：
settings == { validate: true, limit: 5, name: "bar" }
empty == { validate: true, limit: 5, name: "bar" }以上的兩個(gè)簡單例子就說明extend()方法作用就是合并另個(gè)對象，有相同的則覆蓋，沒有相同的則添加。就是這么簡單。
了解了$.extend()的作用，我們就能大概看懂上面那個(gè)擴(kuò)展jquery.ajax的實(shí)現(xiàn)了吧。主要的步驟分為：
1）定義默認(rèn)的error處理方法。
var fn = {
error: function (XMLHttpRequest, textStatus, errorThrown) {
toastr.error(XMLHttpRequest.responseText, '錯(cuò)誤消息', { closeButton: true, timeOut: 0, positionClass: 'toast-top-full-width' });
},
success: function (data, textStatus) { },
beforeSend: function (XHR) { },
complete: function (XHR, TS) { }
}2）判斷用戶在調(diào)用$.ajax({})的時(shí)候是否自定了error:function(){}，如果定義過，則使用用戶定義的，反之則用默認(rèn)的error處理方法。
3）使用$.extend()將error默認(rèn)處理方法傳入$.ajax()的參數(shù)中。我們看options參數(shù)時(shí)包含$.ajax()方法里面所有的參數(shù)的，然后用默認(rèn)的fn去擴(kuò)展它即可。
通過以上三步就能夠?qū)崿F(xiàn)對$.ajax()方法里面error默認(rèn)處理方法。這樣擴(kuò)展，對于我們使用者來說完全感覺不到變化，我們?nèi)匀豢梢?.ajax({});這樣去發(fā)送ajax請求，如果沒有特殊情況，不用寫error處理方法。
3、組件擴(kuò)展的意義
使用組件擴(kuò)展，能夠幫助我們在原有組件上面增加一些和我們系統(tǒng)業(yè)務(wù)相關(guān)的處理需求，而在使用時(shí)，還是和使用原生組件一樣去調(diào)用，免去了在組件上面再封裝一層的臃腫。
二、擴(kuò)展自己組件
上面通過$.extend()方法擴(kuò)展了$.ajax()的error事件處理方法。下面我們來封裝一個(gè)自己的組件試試，功能很簡單，但比較有說明性。我們就以select這個(gè)組件為例，很多情況下，我們的select里面的option都是需要從數(shù)據(jù)庫里面取數(shù)據(jù)的，所以一般的做法就是發(fā)送一個(gè)ajax請求，然后在success方法里面拼html。現(xiàn)在我們就封裝一個(gè)select遠(yuǎn)程取數(shù)據(jù)的方法。
1、代碼實(shí)現(xiàn)以及使用示例
先上干貨吧，將寫好的整出來：
(function ($) {
//1.定義jquery的擴(kuò)展方法combobox
$.fn.combobox = function (options, param) {
if (typeof options == 'string') {
return $.fn.combobox.methods[options](this, param);
}
//2.將調(diào)用時(shí)候傳過來的參數(shù)和default參數(shù)合并
options = $.extend({}, $.fn.combobox.defaults, options || {});
//3.添加默認(rèn)值
var target = $(this);
target.attr('valuefield', options.valueField);
target.attr('textfield', options.textField);
target.empty();
var option = $('');
option.attr('value', '');
option.text(options.placeholder);
target.append(option);
//4.判斷用戶傳過來的參數(shù)列表里面是否包含數(shù)據(jù)data數(shù)據(jù)集，如果包含，不用發(fā)ajax從后臺取，否則否送ajax從后臺取數(shù)據(jù)
if (options.data) {
init(target, options.data);
}
else {
//var param = {};
options.onBeforeLoad.call(target, options.param);
if (!options.url) return;
$.getJSON(options.url, options.param, function (data) {
init(target, data);
});
}
function init(target, data) {
$.each(data, function (i, item) {
var option = $('');
option.attr('value', item[options.valueField]);
option.text(item[options.textField]);
target.append(option);
});
options.onLoadSuccess.call(target);
}
target.unbind("change");
target.on("change", function (e) {
if (options.onChange)
return options.onChange(target.val());
});
}
//5.如果傳過來的是字符串，代表調(diào)用方法。
$.fn.combobox.methods = {
getValue: function (jq) {
return jq.val();
},
setValue: function (jq, param) {
jq.val(param);
},
load: function (jq, url) {
$.getJSON(url, function (data) {
jq.empty();
var option = $('');
option.attr('value', '');
option.text('請選擇');
jq.append(option);
$.each(data, function (i, item) {
var option = $('');
option.attr('value', item[jq.attr('valuefield')]);
option.text(item[jq.attr('textfield')]);
jq.append(option);
});
});
}
};
//6.默認(rèn)參數(shù)列表
$.fn.combobox.defaults = {
url: null,
param: null,
data: null,
valueField: 'value',
textField: 'text',
placeholder: '請選擇',
onBeforeLoad: function (param) { },
onLoadSuccess: function () { },
onChange: function (value) { }
};
})(jQuery);先來看看我們自定義組件如何使用：
用法一：通過URL遠(yuǎn)程取數(shù)據(jù)并初始化
首先定義一個(gè)空的select
然后初始化它
$(function(){
$('#sel_search_plant').combobox({
url: '/apiaction/Plant/Find',
valueField: 'TM_PLANT_ID',
textField: 'NAME_C'
});
})參數(shù)很簡單，就不一一介紹了。很簡單有木有~~
用法二：取值和設(shè)置
var strSelectedValue = $('#sel_search_plant').combobox("getValue");
$('#sel_search_plant').combobox("setValue", "aaa");其實(shí)對于簡單的select標(biāo)簽，博主覺得這里的getValu和SetValue意義不大，因?yàn)橹苯油ㄟ^$('#sel_search_plant').val()就能解決的事，何必要再封一層。這里僅僅是做演示，試想，如果是封裝成類似select2或者multiselect這種組件，getValue和setValue的意義就有了，你覺得呢？
2、代碼詳細(xì)講解
上面的實(shí)現(xiàn)代碼，如果您一眼就能看懂，證明您是經(jīng)常封組件的大蝦了，下面的就不用看了。如果看不懂，也沒關(guān)系，我們將代碼拆開詳細(xì)看看里面是什么鬼。
（1）首先看看我們最常看到的如下寫法：
(function ($) {
//....封裝組件邏輯
})(jQuery);初初看到這種用法，博主也是狂抓，這是什么鬼嘛，四不像啊。使用多了之后才知道原來這就是一個(gè)匿名函數(shù)的形式。將它拆開來看如下：
var fn = function($){
//.....組件封裝邏輯
};
fn(jQuery);也就是說這種寫法就表示先定義一個(gè)方法，然后立即調(diào)用這個(gè)方法，jQuery相當(dāng)于實(shí)參。打開jquery.js的原文件可以看到，jQuery是這個(gè)文件里面的一個(gè)全局變量。
（2）定義自己的組件的代碼：
$.fn.combobox = function (options, param) {
};習(xí)慣這種寫法的應(yīng)該知道，這個(gè)就表示向jquery對象添加自定義方法，比如你想使用文章開始的 $("#id").MyJsControl({}) 這種用法，你就可以這樣定義$.fn.MyJsControl=function(options){}。
（3）options = $.extend({}, $.fn.combobox.defaults, options || {});這一句，看過上文的朋友應(yīng)該還記得extend這么一個(gè)方法吧，怎么樣，又來了你。這句話其實(shí)就沒什么好說的了，合并默認(rèn)參數(shù)和用戶傳進(jìn)來的參數(shù)。
（4）默認(rèn)參數(shù)列表
$.fn.combobox.defaults = {
url: null,
param: null,
data: null,
valueField: 'value',
textField: 'text',
placeholder: '請選擇',
onBeforeLoad: function (param) { },
onLoadSuccess: function () { },
onChange: function (value) { }
};如果用戶沒有傳參，就用默認(rèn)的參數(shù)列表。如果你夠細(xì)心，你會發(fā)現(xiàn)博主之前分享的其他bootstrap組件的js文件里面都有這么一個(gè)default參數(shù)列表。我們隨便找兩個(gè)：
bootstrap上傳組件
bootstrap table組件
基本都是這么些用法。這樣來看，是否也可以自己封一個(gè)js組件~~
感謝你能夠認(rèn)真閱讀完這篇文章，希望小編分享的“JS組件封裝的示例分析”這篇文章對大家有幫助，同時(shí)也希望大家多多支持創(chuàng)新互聯(lián)建站，關(guān)注創(chuàng)新互聯(lián)網(wǎng)站建設(shè)公司行業(yè)資訊頻道，更多相關(guān)知識等著你來學(xué)習(xí)!
另外有需要云服務(wù)器可以了解下創(chuàng)新互聯(lián)建站www.cdcxhl.com，海內(nèi)外云服務(wù)器15元起步，三天無理由+7*72小時(shí)售后在線，公司持有idc許可證，提供“云服務(wù)器、裸金屬服務(wù)器、高防服務(wù)器、香港服務(wù)器、美國服務(wù)器、虛擬主機(jī)、免備案服務(wù)器”等云主機(jī)租用服務(wù)以及企業(yè)上云的綜合解決方案，具有“安全穩(wěn)定、簡單易用、服務(wù)可用性高、性價(jià)比高”等特點(diǎn)與優(yōu)勢，專為企業(yè)上云打造定制，能夠滿足用戶豐富、多元化的應(yīng)用場景需求。
文章標(biāo)題：JS組件封裝的示例分析-創(chuàng)新互聯(lián)
URL鏈接：http://www.xueling.net.cn/article/djgips.html