Seriya: TanStack Router Dars 60

Form handling — Formalar va URL Search Params sinxronizatsiyasi

TanStack Router'da formalar va URL Search Params sinxronizatsiyasi: replace navigatsiya, debounce texnikasi, TanStack Form integratsiyasi va ulashish imkoniyati.

60-dars

Form handling — Formalar va URL Search Params sinxronizatsiyasi

Ko‘p dasturchilar qidiruv, saralash va filtr formalarini yaratishda ularni oddiygina React'ning useState xotirasiga bog‘lab qo‘yishadi.

Lekin bu yondashuvning katta kamchiligi bor: foydalanuvchi qidiruv maydoniga matn yozib, bir nechta filtrlarni tanlagach, sahifani yangilasa (F5) yoki havolani do‘stiga yuborsa — barcha kiritilgan qiymatlar yo‘qoladi. Natijada foydalanuvchi hamma narsani boshidan qayta tanlashga majbur bo‘ladi.

TanStack Router’da esa forma holatini (Form State) bevosita URL Search Params bilan sinxronlashtirish tavsiya etiladi. Bu orqali URL butun ilova uchun yagona va mustahkam holat manbaiga (Single Source of Truth) aylanadi.


1. Hayotiy o‘xshatish: Google Maps va Sayohat chiptalari

Tasavvur qiling, siz do‘stingiz bilan sayohatga bilet qidiryapsiz:

  • Eski usul (useState formasi): Siz qidiruv maydonida shahar, sana va yulduzlar sonini tanladingiz. Do‘stingizga "Mana shu arzon reysni ko‘r" deb havolani yubordingiz. Do‘stingiz havolani ochsa — bo‘sh bosh sahifa chiqadi, chunki siz tanlagan filtrlar faqat sizning kompyuteringiz xotirasida edi.
  • URL bilan sinxronlashgan forma: Siz qidiruv parametrlarini o‘zgartirganingiz zahoti URL manzili o‘z-o‘zidan yangilanadi (?city=samarkand&date=2026-12-01&stars=5). Ushbu havolani kimga yubormang, uning oldida ham aynan siz ko‘rib turgan natijalar bir zumda namoyon bo‘ladi!

2. Qidiruv va Filtr Formasini URL bilan bog‘lash

Keling, qidiruv maydoniga yozilgan matn va kategoriya tugmalarini URL bilan to‘liq bog‘lovchi toza arxitekturani ko‘rib chiqamiz:

// src/routes/search.tsx
import { createFileRoute, useNavigate } from '@tanstack/react-router'
import { z } from 'zod'

// 1. URL search parametrlari sxemasi
const searchSchema = z.object({
  query: z.string().default(''),
  category: z.enum(['all', 'frontend', 'backend']).default('all'),
})

export const Route = createFileRoute('/search')({
  validateSearch: (search) => searchSchema.parse(search),

  // 2. Search o'zgarganda loader avtomatik yangi ma'lumotni yuklaydi
  loaderDeps: ({ search }) => ({
    query: search.query,
    category: search.category,
  }),

  loader: async ({ deps, abortSignal }) => {
    const res = await fetch(
      `https://api.example.com/items?q=${deps.query}&cat=${deps.category}`,
      { signal: abortSignal }
    )
    return res.json()
  },

  component: SearchPage,
})

function SearchPage() {
  // 3. Qiymatlarni to'g'ridan-to'g'ri URL'dan o'qiymiz
  const { query, category } = Route.useSearch()
  const items = Route.useLoaderData()
  const navigate = useNavigate()

  // 4. Input harfiga qarab URL'ni yangilaymiz
  const handleQueryChange = (e: React.ChangeEvent<HTMLInputElement>) => {
    navigate({
      search: (prev) => ({ ...prev, query: e.target.value }),
      // MUHIM: Har bir harf brauzer tarixini (history stack) to'ldirmasligi uchun replace: true ishlatamiz
      replace: true,
    })
  }

  const handleCategoryChange = (cat: 'all' | 'frontend' | 'backend') => {
    navigate({
      search: (prev) => ({ ...prev, category: cat }),
    })
  }

  return (
    <div className="search-container">
      <h1>Mahsulotlar va Maqolalar Qidiruvi</h1>

      {/* Qidiruv inputi */}
      <input
        type="text"
        value={query}
        onChange={handleQueryChange}
        placeholder="Qidiruv so'zini kiriting..."
        className="search-input"
      />

      {/* Kategoriya filtri */}
      <div className="category-buttons">
        {(['all', 'frontend', 'backend'] as const).map((cat) => (
          <button
            key={cat}
            onClick={() => handleCategoryChange(cat)}
            className={category === cat ? 'btn-active' : 'btn'}
          >
            {cat.toUpperCase()}
          </button>
        ))}
      </div>

      {/* Natijalar ro'yxati */}
      <ul className="results-list">
        {items.map((item: any) => (
          <li key={item.id}>{item.title}</li>
        ))}
      </ul>
    </div>
  )
}

[!IMPORTANT] replace: true qoidasi juda muhim! Agar siz uni yozmasangiz, foydalanuvchi "React" deb 5 ta harf yozganda, brauzer tarixida 5 ta alohida qadam (?query=R, ?query=Re, ?query=Rea...) saqlanadi va foydalanuvchi "Orqaga" tugmasini 5 marta bosishga majbur bo‘ladi. replace: true esa joriy tarixiy yozuvni shunchaki yangilab boradi.


3. Sinxronizatsiya va Ma'lumot oqimi (Mermaid Diagram)

flowchart TD
    User["Foydalanuvchi inputga yozadi yoki filtr tanlaydi"] --> Navigate["navigate({ search: ..., replace: true })"]

    Navigate --> URL["URL manzili yangilanadi: /search?query=react&category=frontend"]

    URL --> LoaderDeps["loaderDeps({ search }) o'zgarishni aniqlaydi"]

    LoaderDeps --> Fetch["loader() serverdan yangi natijalarni tortadi"]

    Fetch --> UI["Komponent yangi natijalar bilan chiziladi"]
    UI --> Share["Havolani istalgan odamga yuborish mumkin (Holat saqlangan!)"]

4. TanStack Form bilan integratsiya

Katta, murakkab va ko‘p bosqichli formalarda (Multi-step wizard forms) TanStack ekotizimining yana bir kuchli vositasi — TanStack Form ishlatiladi.

TanStack Form va TanStack Router birgalikda ishlaganda:

  1. Forma maydonlari Zod sxemasi orqali 100% type-safe tekshiriladi.
  2. Har bir bosqichdagi qadam (?step=2) yoki vaqtinchalik ma'lumotlar URL bilan uzviy bog‘lanadi.
  3. Foydalanuvchi brauzerning "Orqaga" yoki "Oldinga" tugmasini bosganda, formaning bosqichlari tabiiy ravishda o‘zgaradi.

5. Local State va URL State taqqosi

Xususiyat Oddiy useState Formalari URL Search Params Formalari
Sahifa yangilanishi (F5) Barcha tanlangan filtrlar o‘chib ketadi Barcha ma'lumotlar 100% saqlanib qoladi
Havolani ulashish (Shareability) Imkonsiz (havolada ma'lumot yo‘q) Juda oson (havolaning o‘zi to‘liq holatni saqlaydi)
Brauzer tarixi (Back/Forward) Ishlamaydi Mukammal ishlaydi
Kesh bilan ishlash Qo‘lda kesh boshqarish talab etiladi loaderDeps orqali avtomatik keshlanadi
Tarixni to‘ldirmaslik Mavjud emas replace: true orqali toza tarix ta'minlanadi

Xulosa

  • Formadagi qidiruv va filtrlarni URL Search Params bilan sinxronlashtirish ilovaning professional va qulay bo‘lishini ta'minlaydi.
  • TanStack Router'da forma maydonlari qiymati Route.useSearch() orqali o‘qiladi va navigate({ search, replace: true }) orqali yangilanadi.
  • Klaviaturadan harf kiritish jarayonida brauzer tarixini ortiqcha to‘ldirmaslik uchun replace: true parametri qo‘llaniladi.
  • Bu yondashuv orqali foydalanuvchi o‘z qidiruv natijalarini istalgan odamga havola sifatida yuborishi va sahifa yangilanganda ma'lumotlarni yo‘qotmasligi kafolatlanadi.