Series: TanStack Router Lesson 31

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' }}
      >
        &larr; 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 &rarr;
      </Link>
    </div>
  )
}

[!TIP] Nima uchun bu muhim? Agar URL manzilda ?filter=javascript&sortBy=likes&page=1 bo‘lsa, keyingi sahifaga o‘tganda filter va sortBy o‘chib ketmaydi, manzil to‘g‘ri ?filter=javascript&sortBy=likes&page=2 ko‘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 undefined qiymati beriladi.
  • Barcha amallar to‘liq type-safe bo‘lib, mavjud bo‘lmagan yoki noto‘g‘ri turdagi qiymatlarni kiritishga TypeScript yo‘l qo‘ymaydi.