DIV CSS 佈局教程網

自訂 JS 函式:動態新增與修改網址參數
編輯:JavaScript綜合知識     

分頁跳轉、多條件查詢、篩選排序——這些功能都需要在網址上增刪參數。與其每次手寫字串拼接,不如封裝一個函式。以下是思路與實作。

先看現成的屬性

取得當前網址相關資訊,其實有現成的內建屬性:

<script type="text/javascript">
thisURL = document.URL;
thisHREF = document.location.href;
thisSLoc = self.location.href;
thisDLoc = document.location;
strwrite = " thisURL: [" + thisURL + "]<br>"
strwrite += " thisHREF: [" + thisHREF + "]<br>"
strwrite += " thisSLoc: [" + thisSLoc + "]<br>"
strwrite += " thisDLoc: [" + thisDLoc + "]<br>"
document.write(strwrite);
</script>

這幾個寫法在大多數情況下回傳相同的值,但語意與可靠性略有差異。document.location 在舊 IE 有已知的問題,實務上以 window.location.href 最穩妥。

核心函式

思路很直接:先把網址拆成「主體」與「參數串」,把參數串按 & 切成陣列,逐項檢查是否為要改的參數,改完再拼回去。

//=============== 改變網址的參數值 ================
function ChangeURLParm(Turl, Parm, PValue, ClearParm) {
  // Turl:網址 Parm:要改的參數
  // PValue:新的參數值 ClearParm:要清空的參數
  var URL, Parms, ParmsArr, IsExist;
  var NewURL = Turl;
  IsExist = false;

  with (Turl) {
    if (indexOf('?') > 0) {
      URL = substr(0, indexOf('?'));      // 不含參數的主體
      Parms = substr(indexOf('?') + 1);   // 參數部分
    } else {
      URL = Turl;
      Parms = '';
    }
  }

  if (Parms != '') {
    var i;
    ParmsArr = Parms.split("&");
    for (i = 0; i <= ParmsArr.length - 1; i++) {
      if (String(Parm).toUpperCase() == String(ParmsArr[i].split("=")[0]).toUpperCase()) {
        // 原本就有這個參數,改它的值
        ParmsArr[i] = Parm + "=" + PValue;
        IsExist = true;
        if (String(ClearParm) == "") { break; }
      } else if ((String(ClearParm) != "") &&
              (String(ClearParm).toUpperCase() == String(ParmsArr[i].split("=")[0]).toUpperCase())) {
        // 清空指定參數的值
        ParmsArr[i] = ClearParm + "=";
      }
    }

    // 把陣列拼回字串
    for (i = 0; i <= ParmsArr.length - 1; i++) {
      if (i == 0) { Parms = ParmsArr[i]; }   // 第一項不加 &
      else { Parms = Parms + "&" + ParmsArr[i]; }
    }

    NewURL = URL + "?" + Parms;
    if (!IsExist) {
      NewURL = NewURL + "&" + Parm + "=" + PValue;   // 原本沒有,附加上去
    }
  } else {
    NewURL = URL + "?" + Parm + "=" + PValue;
  }
  return NewURL;
}

三個分支涵蓋了所有情況:參數已存在就改值、原本沒有就附加、完全沒有查詢字串就直接建立第一個。這種「窮舉所有狀態」的結構是寫工具函式時該有的態度。

實際應用上很好使,尤其在分頁跳轉與多條件查詢搜尋中——使用者點「第 2 頁」時保留原本的篩選條件,或勾選新條件時重設頁碼,都靠它。

幾個必須修正的問題

用 with 陳述句是壞習慣。with(Turl){ indexOf(...) } 讓程式碼變短,但它在 strict mode 下直接是語法錯誤,而且會讓作用域解析變得難以追蹤,是公認該避免的寫法。改成 Turl.indexOf('?') 就好,長度差不多。

沒有做 URL 編碼。PValue 若含中文、空格或 &,直接拼上去會產生無效網址。必須 encodeURIComponent(PValue)。

用 toUpperCase 做不分大小寫比較,是錯的。參數名稱在標準中是有大小寫之分的,?ID=1 與 ?id=1 是兩個不同的參數。這裡把它們視為相同,會造成難以察覺的錯誤。

值裡含 = 時會出錯。split("=")[0] 取等號左邊是對的,但 base64 編碼的值常以 = 結尾(例如 ?token=abc==),這裡的比對邏輯沒有處理這種情況。

fragment 沒被考慮。若網址是 page.php?id=1#section,這裡會把 section 當成參數值的一部分。應該先切掉 # 後面再處理。

現代寫法

這個需求現在有標準 API,而且簡短得多:

function changeUrlParam(url, key, value) {
  var u = new URL(url, window.location.origin);
  u.searchParams.set(key, value);
  return u.toString();
}

// 清空的話用 delete
function removeUrlParam(url, key) {
  var u = new URL(url, window.location.origin);
  u.searchParams.delete(key);
  return u.toString();
}

URL 與 URLSearchParams 幫你處理了編碼解碼、fragment 隔離、重複參數、以及各種邊界情況,程式碼也短到不需要註解。

若要直接改當前網址而不重新載入頁面:

const u = new URL(window.location.href);
u.searchParams.set('page', '3');
window.history.replaceState({}, '', u);   // 不新增歷史紀錄
// 或 pushState 讓使用者可以用「上一頁」回到前一個狀態

選 replaceState 還是 pushState 是個設計決定:篩選條件的變更通常用 replaceState(不想讓按上一頁變成層層返回),而分頁翻頁通常用 pushState(使用者會期待能往回翻)。

自己寫一遍仍然有價值——它讓你理解查詢字串的結構,而這個理解在處理 API、除錯、或需要解析非標準格式的時候都用得上。但正式專案請用標準 API。

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