DIV CSS 佈局教程網

論 JavaScript 模塊化編程:為什麼需要,以及 RequireJS 怎麼用
編輯:關於JavaScript     

JavaScript 是弱型別語言,天生具備極大的靈活性——而靈活性的代價,就是團隊協作時容易失控。本文談談模塊化到底解決了什麼問題,並以一個 Leaflet 地圖繪圖工具的封裝實例,示範 RequireJS 的實際用法。

一、沒有模塊化會遇到的三個痛點

早期的做法是寫一個個 .js 檔,再用 script 標籤在頁面裡依序引入。專案小的時候沒問題,一旦規模上來就會同時爆發三個問題:

1. 全局變量氾濫。JavaScript 在任何地方都能宣告全局變量,一旦團隊成員各寫各的、沒有統一規範,全局命名空間很快就會塞滿雜物,甚至出現互相覆蓋的嚴重事故,後續維護成本極高。

2. 腳本載入順序被依賴關係綁死。最簡單的例子:a.js 依賴 b.js,那麼 b.js 就必須排在前面引入,否則直接報錯。當專案裡有幾十個檔案、彼此交叉依賴時,這個順序會變成一張無人能維護的迷宮。

3. 一次性載入過多腳本導致頁面假死。初始化時同步載入大量 JS,瀏覽器會忙著解析與執行而無法回應互動,使用者感受到的就是「卡住」。

二、RequireJS 的角色

RequireJS 的目標是鼓勵程式碼模塊化。它採用與傳統 script 標籤不同的腳本載入步驟:不再一次把全部檔案塞進頁面,而是宣告式地說明「這個模塊需要哪些依賴」,由 RequireJS 在執行時按需載入。

官方對它的定位說得很清楚:

RequireJS 的目標是鼓勵程式碼的模塊化,它使用了不同於傳統 script 標籤的腳本載入步驟。可以用它來加速、優化程式碼,但其主要目的還是為了程式碼的模塊化。它鼓勵在使用腳本時以 module ID 替代 URL 位址。

換句話說,加速只是附帶好處,用模塊 ID 取代 URL 依賴才是核心價值。關於安裝與設定(尤其是 require.config 裡的 paths 對應),建議直接參考官方文件,這裡不贅述。

三、實際案例:封裝 Leaflet 的繪圖能力

我在專案中遇到一個很典型的情境:使用了輕量級開源地圖庫 Leaflet,但團隊裡不少成員並非 GIS 背景,直接面對 Leaflet 的原始 API 門檻偏高。於是在它之上再包一層,把介面換成更貼近領域語言的方法名,同時也讓分工變得清楚——每個人只要照 RequireJS 的規範寫好自己的模塊、預留好介面即可。

需求很單純:做一個繪圖輔助類,能畫點、線、面。

define(['leaflet'], function () {

  /**
   * 繪製多段線
   */
  var _drawLine = function (latlngs, options) {
    return L.polyline(latlngs, options);
  };

  /**
   * 繪製多邊形
   */
  var _drawPolygon = function (latlngs, options) {
    if (latlngs.length < 3) {
      console.log("點數少於 3,無法繪製多邊形!");
      return;
    }
    // 若終點與起點相同,先移除,避免 Leaflet 多畫一層
    var firstPt = latlngs[0];
    var lastPt = latlngs[latlngs.length - 1];
    if (firstPt.equals(lastPt)) {
      latlngs.pop();
    }
    return L.polygon(latlngs, options);
  };

  /**
   * 繪製矩形
   */
  var _drawRect = function (bounds, options) {
    return L.rectangle(bounds, options);
  };

  /**
   * 繪製圓形
   */
  var _drawCircle = function (center, radius, options) {
    return L.circle(center, radius, options);
  };

  // 只暴露公共方法,其餘一律隱藏
  return {
    drawLine: _drawLine,
    drawPolygon: _drawPolygon,
    drawRect: _drawRect,
    drawCircle: _drawCircle
  };
});

這個結構有幾個刻意安排的細節。define() 的第一個參數宣告了依賴 leaflet,第二個參數的工廠函式會在依賴就緒後才執行,因此裡面可以安心使用全域的 L。所有實作函式都加上底線前綴表示「內部使用」,最後只回傳一個包含公共方法的物件——這正是上一篇文章談閉包時提到的「隱藏細節」在模塊層級的應用。

另外,_drawPolygon 裡順手處理了兩個實務上常遇到的問題:點數不足 3 無法構成多邊形,以及首尾點重複時要先移除,否則 Leaflet 會畫出多餘的線段。把這類防呆邏輯收進模塊,呼叫方就不必每個地方重寫一次。

四、呼叫端

require(['drawHelper'], function (drawHelper) {

  function drawLine() {
    var latlngs = [];
    for (var i = 20; i < 30; i++) {
      for (var j = 100; j < 110; j++) {
        latlngs.push(new L.latLng(i, j));
      }
    }
    var opt = { color: 'blue', weight: '2', opacity: 0.8, smoothFactor: 2.0 };
    drawHelper.drawLine(latlngs, opt).addTo(mainmap);
  }

  function drawPolygon() {
    var latlngs = [
      L.latLng(31, 110), L.latLng(31, 111), L.latLng(32, 111),
      L.latLng(32, 110), L.latLng(32, 109)
    ];
    var opt = {
      stroke: true, color: 'blue', weight: '2', opacity: 0.8,
      fill: true, fillColor: 'red', fillOpacity: 0.6
    };
    drawHelper.drawPolygon(latlngs, opt).addTo(mainmap);
  }

  function drawRect() {
    var bounds = [[33, 110], [36, 113]];
    var opt = {
      stroke: true, color: 'blue', weight: '2', opacity: 0.8,
      fill: true, fillColor: 'yellow', fillOpacity: 0.6
    };
    drawHelper.drawRect(bounds, opt).addTo(mainmap);
  }

  function drawCircle() {
    var center = L.latLng(32, 116);
    var opt = {
      stroke: true, color: 'red', weight: '2', opacity: 0.8,
      fill: true, fillColor: 'green', fillOpacity: 0.6
    };
    drawHelper.drawCircle(center, 200000, opt).addTo(mainmap);
  }

  drawLine();
  drawPolygon();
  drawRect();
  drawCircle();
});

呼叫端只依賴 drawHelper 這個模塊 ID,完全不需要知道 Leaflet 的檔案路徑,也不必關心它何時載入完成。

這裡的封裝還不算徹底,但已經足夠用。像基礎地圖操作、圖層控制這些,都可以另外寫一個 mapControl 模塊統一管理。

五、今日的建議

值得補充的是,RequireJS 屬於 AMD 規範的實作,如今新專案多半已改用 ES Module(import / export)搭配打包工具,語法更簡潔、靜態分析能力也更好。但 AMD 所建立的觀念——用依賴聲明取代全局命名空間、用模塊邊界隱藏實作細節、按需載入而非一次塞滿——完全沒有過時。理解它解決了什麼問題,比記住哪個函式庫的 API 重要得多。

以上就是關於 JavaScript 模塊化編程的探討,希望對大家的學習有所幫助。

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