EasyLoader 是 jQuery EasyUI 內建的一套輕量級動態載入機制。它能夠在執行階段按需載入指定元件模組,例如 messager、dialog、datagrid,而不必在頁面初始化時就把所有 JavaScript 與 CSS 一次引入。對於功能眾多的後台管理系統而言,這種「用到才載入」的策略能有效縮短首次開啟的等待時間。
使用時通常先透過 easyloader.base 告訴載入器 easyui 的根路徑位置,接著呼叫 load 方法,並在回呼函數中操作剛剛載入完成的元件。
easyloader.base = '../'; // 設定 easyui 的基本路徑
easyloader.load('messager', function(){
// 模組載入成功後,即可正常使用該元件
$.messager.alert('Title', 'load ok');
});
| 名稱 | 類型 | 說明 | 預設值 |
|---|---|---|---|
| modules | object | 預先定義好的模組清單。 | 無 |
| locales | object | 預先定義好的語言環境資源。 | 無 |
| base | string | easyui 的基本路徑,必須以 '/' 結尾。若未明確指定,載入器會自動以 easyloader.js 所在位置為基準進行換算。 | 無 |
| theme | string | 指定 themes 目錄底下要使用的佈景主題名稱。 | default |
| css | boolean | 決定載入模組時是否一併載入對應的 CSS 檔。 | true |
| locale | string | 語言環境名稱。 | null |
| timeout | number | 逾時門檻,單位為毫秒;載入超過此時間仍未完成即觸發逾時處理。 | 2000 |
af、bg、ca、cs、da、de、en、fr、nl、zh_CN、zh_TW。專案若面向繁體中文使用者,將 locale 設為 zh_TW 即可套用對應的訊息文字。
| 名稱 | 參數 | 說明 |
|---|---|---|
| onProgress | name | 每當有一個模組被成功載入時觸發。 |
| onLoad | name | 當目標模組及其所有相依模組都載入完成後觸發。 |
load(module, callback):載入指定模組,完成後呼叫回呼函數。module 參數可接受四種寫法:
由於載入流程是非同步的,所有依賴該元件的程式碼都應寫在 callback 之內,避免出現元件尚未就緒就呼叫的錯誤。