Search params navigation — Link va navigate orqali query yangilash
TanStack Router'da Search Params yangilash: funksional search prop, Link va navigate orqali parametrlarni saqlagan holda o'zgartirish va React Router bilan taqqos.
31-dars
Search params navigation — Link va navigate orqali query yangilash
Tasavvur qiling, siz supermarketda xarid aravachasi bilan harakatlanyapsiz. Aravachangizda non, mevalar va ichimliklar bor. Agar siz aravachaga bitta yangi quti sharbat qo‘shmoqchi bo‘lsangiz yoki nonlar sonini bittadan ikkitaga ko‘paytirmoqchi bo‘lsangiz, aravachadagi hamma narsani yerga to‘kib tashlab qaytadan yig‘maysiz. Siz faqat kerakli mahsulotni o‘zgartirasiz yoki qo‘shasiz, qolgan barcha narsalar savatda o‘z joyida saqlanib qoladi.
Veb-ilovalarda query parametrlari (?page=2&filter=tech&sort=recent) bilan ishlaganda ham aynan shunday: foydalanuvchi keyingi sahifaga o‘tganda uning tanlagan filtrlari yoki saralash tartibi yo‘qolib ketmasligi kerak.
TanStack Router’da query parametrlarini yangilash uchun chalkash URLSearchParams matnlari bilan ovora bo‘lmaysiz — barcha o‘zgarishlar funksional yondashuv va to‘liq type-safe obyektlar orqali amalga oshiriladi.
1. <Link> komponenti yordamida query parametrlarini yangilash
Eng keng tarqalgan holat — bu sahifalash (Pagination) yoki saralash tugmalaridir.
Bunda search propiga funksiya uzatiladi: (prev) => ({ ...prev, page: prev.page + 1 }). Ushbu prev parametri avvaldan mavjud bo‘lgan barcha query parametrlarni o‘zida saqlab turadi:
// src/routes/posts.tsx
import { Link } from '@tanstack/react-router'
export function PaginationControls({ currentPage }: { currentPage: number }) {
return (
<div style={{ display: 'flex', gap: '1rem', marginTop: '1.5rem' }}>
{/* 1. Oldingi sahifaga o'tish */}
<Link
to="/posts"
disabled={currentPage <= 1}
// prev - bu joriy validatsiyadan o'tgan toza search obyekti
search={(prev) => ({
...prev,
page: Math.max(1, (prev.page ?? 1) - 1),
})}
style={{ padding: '0.5rem 1rem', border: '1px solid #cbd5e1', borderRadius: '4px' }}
>
← Oldingi sahifa
</Link>
{/* 2. Keyingi sahifaga o'tish */}
<Link
to="/posts"
search={(prev) => ({
...prev,
page: (prev.page ?? 1) + 1,
})}
style={{ padding: '0.5rem 1rem', border: '1px solid #cbd5e1', borderRadius: '4px' }}
>
Keyingi sahifa →
</Link>
</div>
)
}
[!TIP] Nima uchun bu muhim? Agar URL manzilda
?filter=javascript&sortBy=likes&page=1bo‘lsa, keyingi sahifaga o‘tgandafiltervasortByo‘chib ketmaydi, manzil to‘g‘ri?filter=javascript&sortBy=likes&page=2ko‘rinishiga o‘tadi!
2. useNavigate yordamida dasturiy (programmatic) yangilash
Query parametrlarni havolalar orqali emas, balki <select> tanlanganda, qidiruv maydoniga matn kiritilganda yoki tugma bosilganda o‘zgartirish uchun navigate funksiyasidan foydalaniladi:
import { useNavigate } from '@tanstack/react-router'
import { Route } from './posts' // tegishli route moduli
export function CategoryFilter() {
const navigate = useNavigate()
const search = Route.useSearch()
const handleCategoryChange = (newCategory: string) => {
navigate({
to: '/posts',
// Yangi kategoriya tanlanganda uni yangilaymiz va sahifani 1-ga qaytaramiz
search: (prev) => ({
...prev,
category: newCategory,
page: 1, // Kategoriya o'zgarganda doimo 1-sahifadan boshlash tavsiya etiladi
}),
})
}
return (
<div style={{ marginBottom: '1rem' }}>
<label style={{ marginRight: '0.5rem' }}>Kategoriya:</label>
<select
value={search.category || 'all'}
onChange={(e) => handleCategoryChange(e.target.value)}
style={{ padding: '0.4rem' }}
>
<option value="all">Barchasi</option>
<option value="tech">Texnologiya</option>
<option value="business">Biznes</option>
<option value="design">Dizayn</option>
</select>
</div>
)
}
3. Parametrni URL'dan butunlay olib tashlash
Agar biror filtrni o‘chirib yubormoqchi bo‘lsangiz, unga bo‘sh satr "" emas, balki undefined qiymatini berishingiz kerak. TanStack Router undefined bo‘lgan parametrlarni avtomatik tarzda URL'dan tozalab yuboradi:
// Filtrni tozalash tugmasi:
navigate({
to: '/posts',
search: (prev) => ({
...prev,
category: undefined, // URL'dan ?category=... butunlay olib tashlanadi
page: 1,
}),
})
4. Query yangilanish oqimi (Mermaid Diagram)
flowchart LR
CurrentURL["Hozirgi URL: ?category=tech&page=1"] --> Action["Foydalanuvchi 'Keyingi sahifa'ni bosdi"]
Action --> Callback["search: (prev) => ({ ...prev, page: 2 })"]
subgraph Engine["TanStack Router Serialization"]
Callback --> Merge["Eski parametrlar saqlanadi: category='tech'"]
Merge --> Update["Faqat 'page' yangilanadi: page=2"]
Update --> Stringify["URL Query String hosil qilinadi"]
end
Stringify --> NewURL["Yangi URL: ?category=tech&page=2"]
5. React Router va TanStack Router taqqosi
| Xususiyat | React Router (setSearchParams) |
TanStack Router (search: (prev) => ...) |
|---|---|---|
| Oldingi parametrlarni saqlash | new URLSearchParams(prev) bilan qo‘lda |
(prev) => ({ ...prev, key: val }) bilan oson |
| Parametr turlari | Faqat string berish majburiy |
number, boolean, array kabi real tiplar |
| Autocomplete va Type-Safety | Mavjud emas (ixtiyoriy so‘zni yozish mumkin) | Faqat Zod sxemasida bor parametrlar taklif qilinadi |
| Parametrni o‘chirish | prev.delete('key') |
key: undefined |
| Havola ichida o‘zgartirish | <Link to="?page=2"> (eski parametrlarni o‘chirib yuboradi) |
<Link search={(prev) => ...}> (avtomatik saqlaydi) |
Xulosa
- Search Navigation — qidiruv, saralash va sahifalash holatlarini brauzer tarixiga (URL query) xavfsiz yozish mexanizmidir.
(prev) => ({ ...prev, [kalit]: qiymat })funksional shablonidan foydalanish boshqa parametrlarning tasodifan o‘chib ketishining oldini oladi.- Parametrni URL'dan tozalash uchun unga
undefinedqiymati beriladi. - Barcha amallar to‘liq type-safe bo‘lib, mavjud bo‘lmagan yoki noto‘g‘ri turdagi qiymatlarni kiritishga TypeScript yo‘l qo‘ymaydi.