然而,無論有多麼接近,通過客戶端與服務端的一來一回,必定會有等待加載數據的時間。所以,大多數網站都通過一個Gif動態圖標或‘Loading...'等字樣來告知用戶數據還在加載中。但有時候這個問題會非常繁瑣和麻煩,要麼將這個‘Loading'顯示在ajax請求之前,然後在ajax成功後隱藏它,或者將它寫在jquery的ajax的全局事件jQuery.ajaxStart()和jQuery.ajaxStop()中來控制整個頁面的ajax狀態。前者方法使用起來太瑣碎,每個請求都要寫一遍這個‘Loading',而且無論請求成功或失敗都需要隱藏它。後者是全局的,也就是整個頁面的請求狀態,有時候無法滿足在局部顯示加載狀態的要求。
為了解決這些問題,我開發了jQuery的插件,名為:Ajax請求狀態管理器。使用這個插件可以讓loading不再那麼麻煩了。你可以在觸發ajax請求前,用該插件事先添加寫好所有請求,你要做的只是在用戶交互的事件中執行下.request()方法。你可以將一個頁面上所有請求設置為獨立顯示loading,也可以設置為全局顯示(只顯示一個loading)。下面是插件的具體使用方法:
自定義loading的css樣式:
.state-loading { background: #fff url(images/icon-ajax-loader.gif) ... }
引用jquery最新版本文件:
<script src="http://ajax.googleapis.com/ajax/libs/jquery/1/jquery.js"></script>
注意:該插件只在jquery1.4.4及之後的版本中測試通過。
引用Ajax請求狀態管理器插件文件:
<script src="js/jquery-ajaxloader.js"></script>
在jquery的ready事件中執行.install()方法:
$.loader.install( className, isGlobal );
參數說明:
className:string,表示你自定義的loading的class名稱,比如上面css定義的state-loading。
isGlobal:boolean,定義是否是全局顯示還是獨立顯示loading,默認值是true,該參數可以省略。
添加所需的ajax請求參數和成功後的回調方法:
$.loader( key ).add( modules, settings , callback );
參數說明:
key:string,通過這個key來創建或獲取指定模塊的加載器。當然,同一個key可以執行多次add()方法來添加不同的module,但是settings和callback是對於這個key是共享的,所以之後添加的settings和callback會覆蓋之前的。
modules:jquery object,一個頁面中同一個請求可以處理多個模塊的數據,所以,如果之前install()方法是設置為false的,在執行ajax請求時,添加到這個loader的所有module都會顯示loading狀態。
settings:map,jquery的ajax settings參數,但不要設置ajax事件,這樣會覆蓋插件中的回調方法,默認請求類型為GET。
callback:function,成功後的回調函數,它有一個參數data,默認是json類型返回的對象。
add()方法返回一個由'module'前綴的字符串數組,比如你添加了3個元素,那結果為['module1', 'module2', 'module3']。你可以通過返回的數組來刪除指定的其中一個模塊的loading,也可以不指定,也就是全部刪除,當然如果你需要這樣做的話。
remove()方法刪除指定的模塊:
$.loader( key ).remove( moduleId );
參數說明:
moduleId:string或者array,指定為string的話會刪除其中一個module,指定為數組會批量刪除模塊,如果未指定參數,會將模塊全部刪除。
示例
添加2個模塊到名為userinfo的加載器中:
.
代碼如下:
var id1 = $.loader( 'userinfo' ).add(
$( '#userinfo, #top-userinfo' ),
{ url: 'server/userinfo.php' },
function( data ) {
updateContent( $( '#userinfo, #topsection, #footer-userinfo' ), data );
}
);
再添加一個模塊到userinfo的加載器中:
var id2 = $.loader( 'userinfo' ).add( $('#footer-userinfo') );
var idList = id1.concat( id2 );
// result: [ 'module1', 'module2', 'module3' ]
刪除第2個模塊的loading,也就是‘#top-userinfo':
var ret = $.loader( 'userinfo' ).remove( idList[1] );
// result: true, modules: [ 'module1', 'module3' ]
在交互事件中執行.request()方法:
$.loader( key ).request();
]
當然,你也可以拋棄之前add的ajax settings和callback,在交互事件中自己寫$.ajax或$.get等。然後在請求前調用$.loader( key ).show(),在回調函數內調用$.loader( key ).hide()。這樣也可以靈活控制loading的狀態。
示例
.
代碼如下:
$( '#getUserInfo' ).bind( 'click', function() {
$.loader( 'userinfo' ).request();
});
你也可以從新重新寫請求:
.
代碼如下:
$( '#getUserInfo' ).bind( 'click', function() {
$.loader( 'userinfo' ).show();
$.get( 'server/userinfo.php', function( data ) {
$.loader( 'userinfo' ).hide();
updateContent( $( '#userinfo, #topsection, #footer-userinfo' ), data );
})
});
注意:一個請求反復觸發時,管理器會執行abor()來阻止之前未完成的請求,重新發布新的請求,然而如果你在頁面中通過jquery的ajaxError事件輸出錯誤信息,會把該信息一並認為是錯誤的,所以如果有必要的話,需要你自行過濾。
示例
.
代碼如下:
// 輸出錯誤日志
$( 'body' ).bind( 'ajaxError', function( event, xhr, setting, thrownError ) {
// 過濾掉 abort 的錯誤信息
if ( xhr.status === 0 || xhr.readyState === 0 || xhr.statusText === 'abort' ) {
return;
}
$( '#log' ).append( '<p>' + thrownError + '</p>' );
});
該插件簡單易用,代碼邏輯也不是很復雜,但本人能力和技術水平有限,如遇到使用問題或任何bug請通過郵件方式告訴我:nicolas-zhao@hotmail.com。謝謝捧場!
打包下載:Ajax請求狀態管理器。