Seriya: TanStack Router Dars 32

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

  1. Ma'lumotlar yo'qolishidan kafolatlangan himoya: ...prev orqali ilovadagi boshqa barcha filtrlarning saqlanib qolishi ta'minlanadi.
  2. 100% Type-Safety va Intellisense: prev argumenti allaqachon Zod sxemasi orqali tekshirilgan. prev. deb yozishingiz bilan IDE sizga mavjud barcha parametrlar ro‘yxatini to‘liq chiqarib beradi.
  3. Qisman o'chirish (Selective deletion): Agar biror parametrni tozalash kerak bo‘lsa, shunchaki kalit: undefined beriladi, 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 undefined qiymati uzatiladi.