DIV CSS 佈局教程網

JavaScript 類別、命名空間與程式碼組織
編輯:關於JavaScript     

當 JavaScript 檔案從一個變成十個,最大的問題不是語法而是「東西放哪裡」。這份程式碼示範一種用物件字面值做命名空間、並依 URL 自動分派初始化的組織方式。

整體結構

$(function () {
  pageJs.urls = [
    '/',     'Index',
  ];
  pageJs.run();
});

這裡的 urls 是一個「路徑 → 初始化物件」的對照表,採兩兩配對的扁平陣列存放。DOM Ready 之後呼叫 run(),由它依當前路徑決定要執行哪個物件的 init()。

三層分工

第一層:Common(跨頁共用)

// 包含 HTML 元素操作。Ajax 函式也可以放在這裡
var Common = {
  init: function () {
    alert('Common');
  }
};

第二層:Index(頁面專屬)

// url —— pages
var Index = {
  init: function () {
    Common.init();
    this.test();
    this.test2();
    alert(location.pathname);
  },
  test: function () {
    alert('test');
  }
};
Index.test2 = function () {
  Index.test();
  alert('test2');
};

注意這裡示範了兩種定義方法的寫法:物件字面值內部的 test,以及外部掛上去的 test2。兩者等效,但用 this.test() 呼叫時要小心 this 的指向——若把 init 拆出來單獨傳遞,this 就會丟失,實務上建議統一寫成 Index.test() 這種明確形式。

第三層:Utils(純工具,不碰 DOM)

// 應移到其他 js 檔,並在本檔之前載入
// 不含任何 HTML 元素操作
var Utils = {
  debug: function () { }
};

路由分派器

var pageJs = {
  urls: [],
  run: function () {
    var urls = this.urls;
    alert(urls.length);
    if ((urls.length % 2) != 0) {
      throw "urls error";        // 兩兩配對,長度必須是偶數
    }
    var len = urls.length / 2;
    for (var i = 0; i <= len; i = i + 2) {
      var pattern = new RegExp(urls[i], 'i');
      if (pattern.test(location.pathname)) {
        eval(urls[i + 1] + ".init()");
        break;
      }
    }
  }
};

它先用正則比對 location.pathname,命中之後就呼叫對應物件的 init。長度必須是偶數的檢查是個不錯的防呆設計,能及早攔下設定表的筆誤。

這份設計的三個優點

  • 命名空間清楚:Common / Index / Utils 三個全域名稱職責分明,不會互相污染。
  • 頁面程式碼與路由分離:新增頁面只要加一個物件並在 urls 補一行,不必改動分派邏輯。
  • 分層依賴明確:Utils 不碰 DOM 所以可以獨立測試,Common 處理共用互動,Index 只負責頁面特有的行為。

該避免的地方

eval 的使用是這份程式碼最大的問題。eval(urls[i + 1] + ".init()") 完全可以改成 window[urls[i + 1]].init(),效果相同但沒有 eval 的效能與安全風險,也能被編輯器靜態分析到。這裡用 eval 顯然只是為了示範,實務上請務必替換。

正則比對路徑也值得商榷:'/' 作為正則會匹配到任何含斜線的路徑,也就是永遠命中第一筆。正確做法要加上錨點 ^/,或改用 location.pathname === urls[i] 精確比對。

迴圈邊界也有小瑕疵:i <= len 配合 i += 2 會多跑一次,應寫成 i < urls.length。

現代對照

這套「依路徑載入對應初始化程式」的想法,今天由前端路由函式庫(React Router、Vue Router)以更成熟的方式實作,並額外提供了巢狀路由、路由參數、懶加載與瀏覽器 history 整合。而命名空間的部分,則由 ES Module 的 import / export 完全取代——每個檔案就是一個模組,依賴關係由編譯器靜態分析,不必再靠全域變數與載入順序來維持。

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