做分頁、篩選、排序這類功能時,把狀態寫進網址列是一個很實用的做法:使用者可以重新整理、收藏、分享,後端也能直接依參數取值。本文整理兩個小而好用的函數,一個負責取值,一個負責改值。
location.search 抓到的是網址中「?」之後、「#」之前的字串,包含問號但不包含井號。例如 https://example.com/list?page=2&size=10#top,location.search 的結果就是 ?page=2&size=10。理解這一點,下面的字串處理就很好懂了。
把查詢字串去掉問號後以 & 切開,再一組一組以 = 拆成鍵值,比對名稱即可。
// 取得網址中 param 參數的值
function get_param(param){
var query = location.search.substring(1).split('&');
for(var i=0;i<query.length;i++){
var kv = query[i].split('=');
if(kv[0] == param){
return kv[1];
}
}
return null;
}
寫回的做法是用正則表達式判斷該參數是否已存在:存在就替換掉舊值,不存在就接在後面。三種狀況都要照顧到——原本沒有查詢字串、原本有但沒有這個參數、原本就有這個參數。
// 設定網址中 param 的值
function set_param(param,value){
var query = location.search.substring(1);
var p = new RegExp("(^|&"+param+")=[^&]*");
if(p.test(query)){
query = query.replace(p,"$1="+value);
location.search = '?'+query;
}else{
if(query == ''){
location.search = '?'+param+'='+value;
}else{
location.search = '?'+query+'&'+param+'='+value;
}
}
}
提醒一點:直接指派 location.search 會觸發一次瀏覽器跳轉(重新載入頁面),這正是分頁想要的效果;如果你只想改網址而不重新載入,就得改用 history.pushState 或 history.replaceState。
有了 set_param,翻頁只需要把 page 參數加減一,邊界條件記得擋掉。
// 上一頁
function page_pre(current_page,page_total){
if(current_page <= 1 || current_page > page_total){
return false;
}
var pre_page = parseInt(current_page) - 1;
set_param('page',pre_page);
}
// 下一頁
function page_next(current_page,page_total){
if(current_page < 1 || current_page >= page_total){
return false;
}
var next_page = parseInt(current_page) + 1;
set_param('page',next_page);
}
這兩個函數搭配起來,就能做出「不重新寫死連結、由參數驅動」的翻頁控制項。若要處理中文或含特殊字元的參數值,記得搭配 encodeURIComponent 編碼、以 decodeURIComponent 解碼,避免值裡出現 & 或 = 時把字串切壞。