DIV CSS 佈局教程網

動態載入 JS/CSS 的兩種寫法(原生與 jQuery 版)
編輯:關於JavaScript     

前端常需要按需求 inject 資源:某個功能模組才載它的腳本、某個主題才載它的樣式。這裡整理兩套可直接複用的工具函式。

寫法一:原生 JavaScript

第一個版本用 document.write,只適合在頁面解析階段同步使用;第二個版本建立元素後掛進 head,並支援載入完成回呼,是比較實用的做法。

/**
 * 以 document.write 輸出標籤(僅限頁面載入階段)
 * @param jsonData.path 前綴路徑
 * @param jsonData.url  檔案路徑
 * @param jsonData.type 'js' | 'css'
 */
function loadWriteFiles(jsonData) {
  jsonData.path = jsonData.path != undefined ? jsonData.path : "";
  if (jsonData.type == "js") {
    document.writeln("<script type='text/javascript' src='"+ jsonData.path + jsonData.url +"'></script>");
  } else if (jsonData.type == "css") {
    document.writeln("<link rel='stylesheet' href='"+ jsonData.path + jsonData.url +"' type='text/css' />");
  }
}

/**
 * 動態建立元素掛到 head,並在載入完成後執行 callback
 */
function loadFilesToHead(jsonData) {
  jsonData.path = jsonData.path != undefined ? jsonData.path : "";

  if (jsonData.type == "js") {
    var _js = document.createElement("script");
    _js.setAttribute("type", "text/javascript");
    _js.setAttribute("src", jsonData.path + jsonData.url);
    _js.onload = _js.onreadystatechange = function(){
      if (!this.readyState || this.readyState == 'loaded' || this.readyState == 'complete') {
        if ("function" == typeof(jsonData["callback"]) && jsonData["callback"]) {
          jsonData["callback"].call(this);
        }
      }
      _js.onload = _js.onreadystatechange = null;
    };
    document.getElementsByTagName("head")[0].appendChild(_js);
  } else if (jsonData.type == "css") {
    var _css = document.createElement("link");
    _css.setAttribute("type", "text/css");
    _css.setAttribute("rel", "stylesheet");
    _css.setAttribute("href", jsonData.path + jsonData.url);
    document.getElementsByTagName("head")[0].appendChild(_css);
  }
}

寫法二:jQuery 版(Deferred 串接)

用 $.Deferred 把多個檔案串成一條序列,並以快取表避免重複載入:

var uiLoad = uiLoad || {};
(function($, $document, uiLoad) {
  "use strict";
  var loaded = [], promise = false, deferred = $.Deferred();

  uiLoad.load = function (srcs) {
    srcs = $.isArray(srcs) ? srcs : srcs.split(/\s+/);
    if (!promise) { promise = deferred.promise(); }

    $.each(srcs, function(index, src) {
      promise = promise.then(function(){
        return src.indexOf('.css') >= 0 ? loadCSS(src) : loadScript(src);
      });
    });

    deferred.resolve();
    return promise;
  };

  var loadScript = function (src) {
    if (loaded[src]) return loaded[src].promise();
    var deferred = $.Deferred();
    var script = $document.createElement('script');
    script.src = src;
    script.onload = function (e) { deferred.resolve(e); };
    script.onerror = function (e) { deferred.reject(e); };
    $document.body.appendChild(script);
    loaded[src] = deferred;
    return deferred.promise();
  };

  var loadCSS = function (href) {
    if (loaded[href]) return loaded[href].promise();
    var deferred = $.Deferred();
    var style = $document.createElement('link');
    style.rel = 'stylesheet';
    style.type = 'text/css';
    style.href = href;
    style.onload = function (e) { deferred.resolve(e); };
    style.onerror = function (e) { deferred.reject(e); };
    $document.head.appendChild(style);
    loaded[href] = deferred;
    return deferred.promise();
  };
})(jQuery, document, uiLoad);

三、現代寫法:原生 Promise

如果專案已不用 jQuery,同樣的需求用 Promise 幾行就能寫完,還能直接用 async/await:

function loadScript(src) {
  return new Promise((resolve, reject) => {
    const s = document.createElement('script');
    s.src = src;
    s.async = true;
    s.onload = resolve;
    s.onerror = () => reject(new Error('載入失敗:' + src));
    document.head.appendChild(s);
  });
}

function loadCSS(href) {
  return new Promise((resolve, reject) => {
    const l = document.createElement('link');
    l.rel = 'stylesheet';
    l.href = href;
    l.onload = resolve;
    l.onerror = () => reject(new Error('載入失敗:' + href));
    document.head.appendChild(l);
  });
}

// 使用
await loadScript('/js/chart.min.js');
await loadCSS('/css/chart.css');

實務上仍要提醒:動態載入會讓依賴關係變得不明顯,除錯時要留意載入順序;同一資源重複 inject 也會造成多餘的網路請求,記得加上去重。

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