DIV CSS 佈局教程網

jQuery EasyUI 的 EasyLoader 動態載入器完整用法解析
編輯:JQuery特效代碼     

EasyLoader 是什麼

EasyLoader 是 jQuery EasyUI 內建的一套輕量級動態載入機制。它能夠在執行階段按需載入指定元件模組,例如 messager、dialog、datagrid,而不必在頁面初始化時就把所有 JavaScript 與 CSS 一次引入。對於功能眾多的後台管理系統而言,這種「用到才載入」的策略能有效縮短首次開啟的等待時間。

基本用法

使用時通常先透過 easyloader.base 告訴載入器 easyui 的根路徑位置,接著呼叫 load 方法,並在回呼函數中操作剛剛載入完成的元件。

easyloader.base = '../'; // 設定 easyui 的基本路徑

easyloader.load('messager', function(){
    // 模組載入成功後,即可正常使用該元件
    $.messager.alert('Title', 'load ok');
});

設定參數

名稱類型說明預設值
modulesobject預先定義好的模組清單。無
localesobject預先定義好的語言環境資源。無
basestringeasyui 的基本路徑,必須以 '/' 結尾。若未明確指定,載入器會自動以 easyloader.js 所在位置為基準進行換算。無
themestring指定 themes 目錄底下要使用的佈景主題名稱。default
cssboolean決定載入模組時是否一併載入對應的 CSS 檔。true
localestring語言環境名稱。null
timeoutnumber逾時門檻,單位為毫秒;載入超過此時間仍未完成即觸發逾時處理。2000

內建的語言環境

af、bg、ca、cs、da、de、en、fr、nl、zh_CN、zh_TW。專案若面向繁體中文使用者,將 locale 設為 zh_TW 即可套用對應的訊息文字。

事件

名稱參數說明
onProgressname每當有一個模組被成功載入時觸發。
onLoadname當目標模組及其所有相依模組都載入完成後觸發。

方法

load(module, callback):載入指定模組,完成後呼叫回呼函數。module 參數可接受四種寫法:

  • 單一模組名稱,例如 'messager'。
  • 模組名稱組成的陣列,可一次載入多個元件。
  • 以 .css 結尾的樣式檔路徑。
  • 以 .js 結尾的腳本檔路徑。

由於載入流程是非同步的,所有依賴該元件的程式碼都應寫在 callback 之內,避免出現元件尚未就緒就呼叫的錯誤。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved