"use client"; import { usePathname, useRouter, useSearchParams } from "next/navigation"; import { useCallback, useEffect, useMemo, useRef, useTransition } from "react"; /** * เก็บ state ของตาราง (หน้า, ขนาดหน้า, การเรียง, คำค้น, ตัวกรอง) ไว้ใน URL * * เก็บใน URL ไม่ใช่ useState เพราะ: * - server component อ่าน searchParams แล้ว query เฉพาะหน้าที่ขอได้ * - ก๊อป URL ส่งต่อ หรือ refresh แล้วเห็นตารางหน้าเดิม * * ใช้ router.replace ไม่ใช่ push โดยตั้งใจ — การกดตัวกรองทีละครั้งไม่ควรถมประวัติ * เบราว์เซอร์จนกดย้อนกลับออกจากหน้าไม่ได้ ผลคือปุ่ม back จะพาออกจากหน้านี้เลย * ไม่ได้ย้อนทีละสถานะของตาราง * * ทุกการเปลี่ยนค่าห่อด้วย startTransition เพื่อให้ React แสดงข้อมูลเดิมค้างไว้ * ระหว่างรอ server ตอบ แทนที่จะกระพริบเป็นหน้าว่าง */ export const TABLE_PARAM = { page: "page", pageSize: "pageSize", sort: "sort", order: "order", search: "q", } as const; /** ชื่อ param ที่สงวนไว้ ที่เหลือถือเป็น faceted filter */ const RESERVED = new Set(Object.values(TABLE_PARAM)); export type TableSearchState = { page: number; pageSize: number; sort: string | null; order: "asc" | "desc"; search: string; filters: Record; }; export function useTableSearchParams(defaults?: { pageSize?: number }) { const router = useRouter(); const pathname = usePathname(); const searchParams = useSearchParams(); const [isPending, startTransition] = useTransition(); const state = useMemo(() => { // ไม่มี prototype: key จาก URL อย่าง "__proto__"/"constructor" เป็นแค่ตัวกรองชื่อหนึ่ง ไม่ไปทับ prototype const filters: Record = Object.create(null); for (const key of new Set(searchParams.keys())) { if (RESERVED.has(key)) continue; const values = searchParams .getAll(key) .flatMap((v) => v.split(",")) .filter(Boolean); if (values.length > 0) filters[key] = values; } const page = Number.parseInt(searchParams.get(TABLE_PARAM.page) ?? "1", 10); const pageSize = Number.parseInt( searchParams.get(TABLE_PARAM.pageSize) ?? String(defaults?.pageSize ?? 50), 10, ); return { page: Number.isFinite(page) && page > 0 ? page : 1, pageSize: Number.isFinite(pageSize) && pageSize > 0 ? pageSize : (defaults?.pageSize ?? 50), sort: searchParams.get(TABLE_PARAM.sort), order: searchParams.get(TABLE_PARAM.order) === "asc" ? "asc" : "desc", search: searchParams.get(TABLE_PARAM.search) ?? "", filters, }; }, [searchParams, defaults?.pageSize]); // setter หลายตัวในจังหวะเดียว (เช่น setFilter แล้ว setSort) ต้องต่อจากค่าที่เพิ่งตั้ง ไม่ใช่ searchParams ตอน render // (router.replace ยังไม่ทันเปลี่ยน URL → ตัวหลังเขียนทับตัวแรก) — ล้างเมื่อ URL เปลี่ยนจริงแล้ว // จำ URL ที่เราเพิ่งสั่ง (value) คู่กับ URL ตอนสั่ง (base) — ใช้ต่อเฉพาะเมื่อ URL ยังเป็น base เดิม // (เดิมล้างตามตัวอ้างอิงของ searchParams ซึ่ง Next คืนตัวเดิมเมื่อ URL ไม่เปลี่ยน → ค่าเก่าค้าง) const latest = useRef<{ base: string; value: string } | null>(null); useEffect(() => { latest.current = null; }, [searchParams]); const push = useCallback( (mutate: (params: URLSearchParams) => void) => { const base = searchParams.toString(); const pending = latest.current?.base === base ? latest.current.value : base; const params = new URLSearchParams(pending); mutate(params); latest.current = { base, value: params.toString() }; startTransition(() => { router.replace(`${pathname}?${params.toString()}`, { scroll: false }); }); }, [router, pathname, searchParams], ); /** ตั้งค่าแล้วลบ param ทิ้งเมื่อค่าว่าง เพื่อไม่ให้ URL รก */ const setParam = useCallback((params: URLSearchParams, key: string, value: string | null) => { if (value === null || value === "") params.delete(key); else params.set(key, value); }, []); const setPage = useCallback( (page: number) => push((p) => setParam(p, TABLE_PARAM.page, page > 1 ? String(page) : null)), [push, setParam], ); const setPageSize = useCallback( (pageSize: number) => push((p) => { setParam(p, TABLE_PARAM.pageSize, String(pageSize)); // เปลี่ยนขนาดหน้าแล้วหน้าเดิมอาจไม่มีอยู่จริง กลับไปหน้าแรกเสมอ p.delete(TABLE_PARAM.page); }), [push, setParam], ); const setSort = useCallback( (field: string | null, order: "asc" | "desc" = "desc") => push((p) => { setParam(p, TABLE_PARAM.sort, field); setParam(p, TABLE_PARAM.order, field ? order : null); p.delete(TABLE_PARAM.page); }), [push, setParam], ); const setSearch = useCallback( (search: string) => push((p) => { setParam(p, TABLE_PARAM.search, search.trim()); p.delete(TABLE_PARAM.page); }), [push, setParam], ); const setFilter = useCallback( (key: string, values: string[]) => push((p) => { setParam(p, key, values.length > 0 ? values.join(",") : null); p.delete(TABLE_PARAM.page); }), [push, setParam], ); const resetFilters = useCallback( () => push((p) => { for (const key of [...p.keys()]) { if (!RESERVED.has(key)) p.delete(key); } p.delete(TABLE_PARAM.search); p.delete(TABLE_PARAM.page); }), [push], ); return { state, isPending, setPage, setPageSize, setSort, setSearch, setFilter, resetFilters }; }