Search params updater — Oldingi search state asosida yangilash
TanStack Router'da Search Params Updater pattern: (prev) => ... orqali parametrlarni xavfsiz saqlash, qisman yangilash va React Router bilan taqqoslash.
32-dars
Search params updater — Oldingi search state asosida yangilash
Tasavvur qiling, siz smartfoningiz sozlamalarida ekranning yorug‘ligini biroz pasaytirdingiz. Siz ekranni o‘zgartirganingiz uchun telefoningizdagi Wi-Fi, Bluetooth yoki ovoz balandligi o‘z-o‘zidan o‘chib ketmaydi. Tizim joriy barcha sozlamalarni saqlagan holda faqat siz tegingan bitta parametrni o‘zgartiradi. Agar har safar yorug‘likni pasaytirganda telefon boshqa barcha sozlamalarni zavod holatiga qaytarib yuborsa (reset qilsa), undan foydalanish haqiqiy boshog‘rig‘iga aylanardi.
Veb-ilovalarda ham foydalanuvchi bir vaqtning o‘zida bir nechta filtrlarni tanlagan bo‘lishi mumkin: qidiruv so‘zi (q), toifa (category), saralash (sortBy) va sahifa raqami (page). Agar foydalanuvchi faqat saralash tartibini o‘zgartirsa, qolgan hamma filtrlarni tasodifan o‘chirib yubormaslik kerak.
TanStack Router bu muammoni hal qilish uchun Search Params Updater ((prev) => ...) pattern'ini taqdim etadi.
1. Updater Function qanday ishlaydi?
navigate yoki <Link> komponentlaridagi search propiga oddiy obyekt o‘rniga funksiya (callback) uzatilganda, u xuddi React'dagi setState((prev) => ...) kabi ishlaydi.
Bu funksiya o‘ziga argument sifatida ayni damda URL'da turgan, validatsiyadan o‘tgan toza holatni (prev) qabul qiladi:
// src/components/ProductToolbar.tsx
import { useNavigate } from '@tanstack/react-router'
export function ProductToolbar() {
const navigate = useNavigate()
// 1. Faqat saralash tartibini o'zgartiruvchi funksiya
const handleSortChange = (newSort: 'price_asc' | 'price_desc' | 'popular') => {
navigate({
to: '/products',
// search ichida funksiya ishlatamiz (Updater pattern)
search: (prev) => ({
...prev, // Oldingi barcha parametrlarni (qidiruv, filtrlar) saqlab qolamiz!
sortBy: newSort, // Faqat saralash qiymatini o'zgartiramiz
page: 1, // Saralash o'zgarganda foydalanuvchini 1-sahifaga qaytaramiz
}),
})
}
// 2. Qidiruv so'zini yangilovchi funksiya
const handleSearch = (queryText: string) => {
navigate({
to: '/products',
search: (prev) => ({
...prev,
// Agar matn bo'sh bo'lsa, URL'dan olib tashlaymiz (undefined orqali)
q: queryText ? queryText : undefined,
page: 1,
}),
})
}
return (
<div style={{ display: 'flex', gap: '1rem', marginBottom: '1.5rem' }}>
<input
type="text"
placeholder="Mahsulot qidirish..."
onChange={(e) => handleSearch(e.target.value)}
/>
<select onChange={(e) => handleSortChange(e.target.value as any)}>
<option value="popular">Ommabop</option>
<option value="price_asc">Arzondan qimmatga</option>
<option value="price_desc">Qimmatdan arzonga</option>
</select>
</div>
)
}
2. Oddiy obyekt berish vs Updater Function berish
Keling, ikkita yondashuv orasidagi halokatli farqni ko‘rib chiqaylik:
A. XATOLIKKA MOYIL USUL (Oddiy obyekt uzatish):
// Aytaylik, URL: /products?category=phones&q=iphone&page=3
navigate({
to: '/products',
search: { sortBy: 'price_asc' }, // XATO!
})
// Natija URL: /products?sortBy=price_asc
// FOJIA: category, q va page butunlay o'chib ketdi!
B. XAVFSIZ VA TO'G'RI USUL (Updater funksiya):
navigate({
to: '/products',
search: (prev) => ({
...prev,
sortBy: 'price_asc',
}),
})
// Natija URL: /products?category=phones&q=iphone&page=3&sortBy=price_asc
// Barcha avvalgi parametrlar o'z joyida saqlandi!
3. Updater Function'ning asosiy afzalliklari
- Ma'lumotlar yo'qolishidan kafolatlangan himoya:
...prevorqali ilovadagi boshqa barcha filtrlarning saqlanib qolishi ta'minlanadi. - 100% Type-Safety va Intellisense:
prevargumenti allaqachon Zod sxemasi orqali tekshirilgan.prev.deb yozishingiz bilan IDE sizga mavjud barcha parametrlar ro‘yxatini to‘liq chiqarib beradi. - Qisman o'chirish (Selective deletion): Agar biror parametrni tozalash kerak bo‘lsa, shunchaki
kalit: undefinedberiladi, boshqa parametrlarga zarar yetmaydi.
4. Parametrlarni yangilash mexanizmi (Mermaid Diagram)
flowchart TD
CurrentState["Joriy State: { q: 'laptop', category: 'electronics', page: 2 }"] --> Call["navigate chaqirildi"]
subgraph Updater["search: (prev) => ({ ...prev, page: 3 })"]
Input["prev = { q: 'laptop', category: 'electronics', page: 2 }"]
Input --> Spread["...prev (Eski parametrlar saqlanadi)"]
Spread --> Override["page: 3 (Faqat kerakli qiymat yangilanadi)"]
end
Call --> Updater
Override --> NewState["Yangi State: { q: 'laptop', category: 'electronics', page: 3 }"]
NewState --> URL["URL yangilanadi: /products?q=laptop&category=electronics&page=3"]
5. React Router va TanStack Router taqqosi
| Xususiyat | React Router | TanStack Router (Updater) |
|---|---|---|
| Qisman yangilash usuli | new URLSearchParams(prev) bilan qo‘lda set() |
(prev) => ({ ...prev, key: val }) (Deklarativ) |
| Eski qiymatlarni olish | useSearchParams()dan doimo o‘qib turish kerak |
Funksiyaning prev argumenti avtomatik beradi |
| Autocomplete yordami | Mavjud emas (xom stringlar) | prev. orqali barcha maydonlar 100% tiplangan |
| Kod hajmi | Bir nechta qatordan iborat imperativ kod | Bitta qatordan iborat toza va ixcham funksiya |
Xulosa
- Search Params Updater — mavjud parametrlarni yo‘qotmasdan faqat kerakli maydonlarni qisman yangilash uchun eng yaxshi amaliyotdir.
search: (prev) => ({ ...prev, o'zgaruvchi: yangiQiymat })shabloni orqali URL holati xuddi React State kabi xavfsiz boshqariladi.- Parametrni butunlay olib tashlash uchun unga
undefinedqiymati uzatiladi.