;(function($) {
$.extend({
/**
* 獲取 URL 中的 GET 參數
* @returns {Object} 鍵值對對象
* @example
* // URL: ?id=123&name=abc
* var GET = $.urlGet();
* GET.id === "123"
*/
urlGet: function() {
const query = window.location.search.substring(1); // 去掉 ?
if (!query) return {};
const params = {};
const pairs = query.split('&');
for (let i = 0; i < pairs.length; i++) {
const pair = pairs[i].split('=');
const key = decodeURIComponent(pair[0]);
const value = pair.length > 1 ? decodeURIComponent(pair[1]) : '';
// 處理同名參數(數組化)
if (params[key] !== undefined) {
if (!Array.isArray(params[key])) {
params[key] = [params[key]];
}
params[key].push(value);
} else {
params[key] = value;
}
}
return params;
},
/**
* 獲取單個參數值
* @param {String} name - 參數名
* @param {String} defaultValue - 默認值
* @returns {String|Array}
*/
urlParam: function(name, defaultValue = null) {
const params = $.urlGet();
return params.hasOwnProperty(name) ? params[name] : defaultValue;
}
});
})(jQuery);
// URL: https://example.com/page?id=123&tag=js&tag=jquery&name=test
const GET = $.urlGet();
// { id: "123", tag: ["js", "jquery"], name: "test" }
const id = $.urlParam('id'); // "123"
const tags = $.urlParam('tag'); // ["js", "jquery"]
const missing = $.urlParam('none', 'default'); // "default"
// URLSearchParams API(現代瀏覽器原生支援)
const params = new URLSearchParams(window.location.search);
params.get('id'); // "123" - 取第一個
params.getAll('tag'); // ["js", "jquery"] - 取所有
params.has('name'); // true
params.toString(); // "id=123&tag=js&tag=jquery&name=test"
// 封裝通用函數
function getUrlParams(search = window.location.search) {
const params = new URLSearchParams(search);
const result = {};
for (const [key, value] of params) {
if (result[key] !== undefined) {
result[key] = Array.isArray(result[key]) ? [...result[key], value] : [result[key], value];
} else {
result[key] = value;
}
}
return result;
}
// 設置/更新參數
function setUrlParam(key, value, replace = true) {
const url = new URL(window.location.href);
if (value === null || value === undefined) {
url.searchParams.delete(key);
} else {
if (replace) url.searchParams.set(key, value);
else url.searchParams.append(key, value);
}
const newUrl = url.toString();
if (replace) history.replaceState(null, '', newUrl);
else history.pushState(null, '', newUrl);
return newUrl;
}
// 構建帶參數 URL
function buildUrl(base, params) {
const url = new URL(base);
Object.entries(params).forEach(([k, v]) => {
if (Array.isArray(v)) v.forEach(val => url.searchParams.append(k, val));
else url.searchParams.set(k, v);
});
return url.toString();
}
// 使用
buildUrl('/search', { q: 'js', tag: ['jquery', 'vue'], page: 1 });
// "/search?q=js&tag=jquery&tag=vue&page=1"
| API | IE | Edge | Chrome | Firefox | Safari |
|---|---|---|---|---|---|
| URLSearchParams | ❌ | 17+ | 49+ | 44+ | 10.1+ |
| URL | ❌ | 12+ | 32+ | 26+ | 10+ |
IE 環境需引入 Polyfill 或使用傳統字符串解析。