DIV CSS 佈局教程網

JavaScript 取得 URL 參數的簡潔實作與跨頁傳值範例
編輯:關於JavaScript     

頁面跳轉時把參數帶在網址上,是最不需要額外機制的跨頁傳值方式。以下示範一個簡短易懂、附帶註解的工具函數,並給出實際使用情境。

核心程式碼

function UrlSearch() {
  var name, value;
  var str = location.href;        // 取得完整網址
  var num = str.indexOf("?");     // 找到問號位置
  str = str.substr(num + 1);      // 取出問號之後的所有參數
  var arr = str.split("&");      // 以 & 切成陣列

  for (var i = 0; i < arr.length; i++) {
    num = arr[i].indexOf("=");    // 找名稱與值的分隔位置
    if (num > 0) {
      name = arr[i].substring(0, num);
      value = arr[i].substr(num + 1);
      this[name] = value;         // 動態掛成物件屬性
    }
  }
}

整個流程就是四步:截取問號後的字串、以 & 切開、以 = 分出名稱與值、把結果掛到 this 上。因為用 this[name] = value 而非固定變數,實例化之後就能用 . 直接存取任意參數。

實戰範例

假設在列表頁要跳到檢核報表頁,並把某筆資料的 ID 帶過去:

// 列表頁:組出帶參數的目標網址
var url = contextPath + "/page4nui/ci2k3/prreportcheckmngt/report_check.jsp?ciPrId=" + ciPrId;
window.location.href = url;
// 目標頁:把參數取出來用
var url = new UrlSearch();
var ciPrId = url.ciPrId;
// 後續可用 ciPrId 去請求該筆明細

使用前該補的防禦

這個版本在兩個地方不夠穩健,實戰時建議補上:

一、沒有問號時的處理。若網址是 report_check.jsp 而無參數,indexOf("?") 回傳 -1,substr(0) 會取到整段網址,接著切分雖然不會報錯,但會產生無意義的屬性。加上判斷即可:

var num = str.indexOf("?");
if (num < 0) return;          // 沒有參數,直接結束
str = str.substr(num + 1);

二、中文與特殊字元未解碼。參數值若含中文,會以百分號編碼形式傳送,需解碼後才可使用:

value = decodeURIComponent(arr[i].substr(num + 1));

更簡短的現代寫法

如果不需要支援舊版瀏覽器,同樣的功能一行就能讀完:

// 取單一參數
var ciPrId = new URLSearchParams(location.search).get('ciPrId');

// 需要多參數時解構一次
var params = new URLSearchParams(location.search);
var ciPrId = params.get('ciPrId');
var page   = params.get('page') || '1';

它自動處理解碼、重複參數(getAll)與存在性檢查(has),也沒有污染全域的風險。手寫版本的價值在於讓你理解參數字串的真實結構——知道 ?、&、= 這三個分隔符各自扮演什麼角色,遇到需要客製解析(例如自訂分隔符或特殊格式)時才改得動。

小提醒:網址參數是使用者可任意竄改的輸入,任何從 query string 取到的值在寫入 DOM 或送到後端前,都應該經過驗證與轉義,切勿直接信任。

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