大型項目中,常需根據後端配置或用戶權限動態加載不同功能模塊的 JS 文件。使用 XML 作為配置格式,結合 jQuery AJAX 解析並動態注入 <script> 標籤,實現模塊化按需加載。
<?xml version="1.0" encoding="UTF-8"?>
<module>
<moduleName name="管理">
<func>js/module/testXml</func>
<func>js/module/device</func>
</moduleName>
<moduleName name="報表">
<func>js/module/report</func>
<func>js/module/chart</func>
</moduleName>
</module>
$(function() {
$.ajax({
url: 'js/config/jsConfig.xml',
dataType: 'xml', // 關鍵:指定數據類型為 XML,jQuery 自動解析為 Document
cache: false, // 避免緩存導致配置不更新
success: function(xmlDoc) {
// 遍歷每個 moduleName 節點
$(xmlDoc).find("moduleName").each(function(i, moduleNode) {
var $module = $(moduleNode);
var moduleName = $module.attr("name"); // 獲取模塊名稱屬性
console.log("加載模塊:", moduleName);
// 遍歷該模塊下的所有 func 節點
$module.find("func").each(function(j, funcNode) {
var jsPath = $(funcNode).text().trim(); // 獲取 JS 文件路徑
if (!jsPath) return; // 跳過空節點
// 構建 script 標籤並追加到 body
var scriptTag = '<script type="text/javascript" src="' + jsPath + '.js"></script>';
$("body").append(scriptTag);
console.log("已加載:", jsPath + ".js");
});
});
},
error: function(xhr, status, error) {
console.error("XML 配置加載失敗:", status, error);
// 降級處理:加載默認核心模塊
loadDefaultModules();
}
});
});
// 降級方案
function loadDefaultModules() {
var defaults = ["js/module/core", "js/module/ui"];
defaults.forEach(function(path) {
$("body").append('<script src="' + path + '.js"></script>');
});
}
dataType: 'xml' 自動將響應解析為 XMLDocument 對象find, children, attr, text) 遍歷 XML 節點// 方式一:字符串拼接(簡單但無法監聽加載完成)
$("body").append('<script src="path.js"></script>');
// 方式二:DOM 創建(推薦,可監聽 onload/onerror)
var script = document.createElement("script");
script.src = jsPath + ".js";
script.onload = function() { console.log("加載成功:", jsPath); };
script.onerror = function() { console.error("加載失敗:", jsPath); };
document.body.appendChild(script);
XML 中 <func> 順序即加載順序。若有依賴關係,需在 XML 中體現順序,或引入依賴聲明:
<func depends="core,utils">js/module/advanced</func>
// 解析時構建依賴圖,拓撲排序後加載
function loadScript(src) {
return new Promise(function(resolve, reject) {
var script = document.createElement("script");
script.src = src;
script.onload = resolve;
script.onerror = reject;
document.body.appendChild(script);
});
}
function loadModulesFromXml(xmlUrl) {
return $.ajax({ url: xmlUrl, dataType: 'xml', cache: false })
.then(function(xmlDoc) {
var promises = [];
$(xmlDoc).find("moduleName").each(function() {
var $module = $(this);
$module.find("func").each(function() {
var src = $(this).text().trim() + ".js";
if (src) promises.push(loadScript(src));
});
});
return Promise.all(promises);
});
}
// 使用
loadModulesFromXml("js/config/jsConfig.xml")
.then(function() { console.log("所有模塊加載完成"); initApp(); })
.catch(function(err) { console.error("模塊加載失敗", err); showFallback(); });
| 風險 | 對策 |
|---|---|
| XSS:XML 內容被篡改注入惡意腳本 | 服務端簽名驗證 XML、CSP 策略限制腳本來源、白名單校驗路徑 |
| 重複加載同一腳本 | 維護 loadedScripts Set,去重 |
| 阻塞頁面渲染 | 添加 async 或 defer 屬性、或延遲加載 |
| 網絡失敗導致功能缺失 | 超時重試、降級方案、錯誤邊界 UI |
const module = await import('./module.js'),Promise 基礎、按需加載import() 觸發懶加載jQuery + XML 實現動態 JS 加載是「配置驅動開發」的經典模式。核心流程:AJAX 獲取 XML → jQuery 遍歷解析 → 動態創建 script 標籤注入。關鍵點在於異步加載管理、依賴順序控制、錯誤容錯與安全防範。現代項目建議遷移至 ES Modules + 構建工具代碼分割,但在無構建環境、需運行時動態配置的場景下,此方案仍具實用價值。