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 (
useStateformasi): 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: trueqoidasi 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: trueesa 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:
- Forma maydonlari Zod sxemasi orqali 100% type-safe tekshiriladi.
- Har bir bosqichdagi qadam (
?step=2) yoki vaqtinchalik ma'lumotlar URL bilan uzviy bog‘lanadi. - 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 vanavigate({ search, replace: true })orqali yangilanadi. - Klaviaturadan harf kiritish jarayonida brauzer tarixini ortiqcha to‘ldirmaslik uchun
replace: trueparametri qo‘llaniladi. - Bu yondashuv orqali foydalanuvchi o‘z qidiruv natijalarini istalgan odamga havola sifatida yuborishi va sahifa yangilanganda ma'lumotlarni yo‘qotmasligi kafolatlanadi.