const searchParams = new URLSearchParams(window.location.search);
// ["1", "2"]
searchParams.getAll("a");
// "1"
searchParams.get(a);
// ["true"]
searchParams.getAll(b);
// "true"
searchParams.get(b);

添加

searchParams.append("a", "1");
searchParams.append("a", "2");
// ?a=1&a=2
searchParams.set("b", "3");
searchParams.set("b", "4");
// ?b=4

從上面的結果可以得知，無論什么值最后都會被解析成 string 類型，如果存在兩個名字相同的 key，則會被解析為 string[]。所以從 url 參數獲取到的類型只會為 string ｜ string[]。

最后使用 history.pushState 來修改瀏覽器地址欄的 url 參數。與 history.replaceState 不同的是，一個是添加一條新記錄，一個是替換。在這里我們當然是選擇添加新記錄了。

設計思路

首先肯定要知道哪些值需要同步到 url 參數上，所以我們定義了一個 configs 參數，來配置需要同步的值。類型為數組，這樣可以讓用戶自定義順序，每項需要傳入一個 key 值。

hook 內部返回一個 syncToUrl 方法，傳入包含配置的所有 key 的值。用戶可以在自己需要的時候同步 url。

const { syncToUrl } = useSyncUrl({
  configs: [{ key: "title" }, { key: "status" }]
})
// 同步
syncToUrl(values)

假設 title 與輸入框綁定，且沒有值，傳入 syncToUrl 的是 ""，這就沒有必要同步到 url 上了。所以我們添加一個配置 omitEmptyString，如果值為空字符串，則忽略。

[{ key: "title", omitEmptyString: true }]

同理，可以增加 omitNull、omitUndefined。這三個默認都設為 true。

接下來，我們先明白兩個概念。在頁面第一次加載、執(zhí)行瀏覽器前進回退操作時，需要將 url 參數的值轉換到當前頁面的組件中，在這里我們稱其為 decode。

在頁面中篩選結束點擊提交或切換頁碼時，需要將這些值轉換成參數并設置到 url 的參數上，在這里我們稱其為 encode。

decode

了解后，我們就可以知道上面例子中 key: "status"，可以想成是一個 Select 組件，值為 boolean 類型。從基礎知識可以得知，從 url 取下來的值為 string 類型。需要使用 decode 轉換成 boolean 類型。

const values = reactive({ title: "", status: false });
const booleanValues = {
  true: true,
  false: false,
}
const { syncToUrl } = useSyncUrl({
  configs: [
    {
      // title 的值是字符串類型，所以不需要 decode
      key: "title",
    },
    { 
      key: "status", 
      // 參數是從 url 上 key 為 status 的值
      decode: (value) => booleanValues[value] 
    }
  ],
  onDecode: (params) => {
    Object.keys(params).forEach(key => {
        values[key] = params[key]
    });
    // 設置完成后，在這里請求數據
  }
})

在 decode 中，我們將值 return 出去，在 onDecode 中將每個配置項返回的值統(tǒng)一收集起來，設置完成后，請求列表數據。像 title 這種值本身是字符串的就不用寫 decode。假設 url 上的參數為 ?title=11&status=true，這里的 params 的值就為

{
  title: "11",
  status: true
}

decode 也可以返回一個對象，如果是對象也會被收集到 onDecode 中。如果不想被收集，可以返回空對象 {}。所以如果你想在 decode 中進行賦值也可以，但要返回 {}。

decode: (value) => {
  return {
    a: "1",
    b: "2"
  }
}
// 不會被收集
decode: (value) => {
  return {};
}

encode

const values = reactive({ rangeDate: ["2022-10-1", "2022-10-2"] });
useSyncUrl({
  configs: [
   {
     key: "rangeDate",
     encode: (value) => {
       return {
         starDate: value[0],
         endDate: value[1]
       }
     }
   }
  ]
})

encode 可以將值轉換成你想要的格式同步到 url 上。這個例子中如果不寫 encode，通過了解上面的基礎知識，則會被轉換成兩個 rangeDate 的鍵值對。這里自定義轉換成了 starDate 和 endDate。所以還要配合 decode 使用。

decode: (value) => ...

但是這個 value 返回的是 url 上 key 為 "rangeDate" 的值，我們要怎么 decode starDate 和 endDate 呢？所以增加一個配置項 decodeKeys 來實現。。

{
 key: "rangeDate",
 decodeKeys: ["starDate", "endDate"],
 decode: value => {
   return {
     rangeDate: [value.starDate, value.endDate]
   }
 }
}

通過上面基礎知識可以得知，url 的值只能為 string | string[]，所以 encode 返回的值也只能是 EncodeResult | Record<string, EncodeResult>。內部將 number 和 boolean 轉換成了 string。

type EncodeResult = string | number | boolean | (string | number | boolean)[];

這時候就有問題了，我想將一個比較復雜類型的值同步到 url 上怎么辦？這時候就要用到 encodeURIComponent 和 decodeURIComponent 了，如果你不認識，可以上 MDN 學習。這里判定數據一定為正確的，實際使用中在 decode 這步中 JSON.parse 可能會報錯，你需要自行處理一下，因為 url 可能會被人為修改。

const values = reactive({
  obj: { a: { b: { c: true } } },
});
const { syncToUrl } = useSyncUrl({
  configs: [
    {
      key: "obj",
      encode: (value) => encodeURIComponent(JSON.stringify(value)),
      decode: (value) => JSON.parse(decodeURIComponent(value)),
    },
  ],
});

詳情頁返回列表頁

假如你的詳情頁有一個按鈕點擊返回列表頁，要怎么保留上次的篩選條件呢？因為 vue-router 的 push 操作，不能直接傳 url 參數的字符串，只能傳對象，所以返回一個參數對象。

localStorage.setItem("listSearch", window.location.search);
// 在詳情頁
router.push(`/list${localStorage.getItem("listSearch")}`)
或
const { searchParams } = useSyncUrl(...)
localStorage.setItem("listSearch", JSON.stringify(searchParams))
// 在詳情頁
router.push({ path: "/list", query: JSON.parse(localStorage.getItem("listSearch")) })