useRouter — Router instance va uning API'lari
TanStack Router'da useRouter hook'i: router instansiyasiga to'g'ridan-to'g'ri kirish, router.invalidate(), router.preloadRoute(), router.state va React Router bilan taqqos.
20-dars
useRouter — Router instance va uning API'lari
Tasavvur qiling, siz poyezdda ketayotgan oddiy yo‘lovchi emassiz, balki temir yo‘l boshqaruv markazining bosh dispetcherisiz. Sizning oldingizda barcha poyezdlar harakati, stansiyalar holati va relslar yo‘nalishini boshqaruvchi bosh kompyuter pulti turibdi. Siz istalgan poyezd yo‘nalishini oldindan tayyorlab qo‘yishingiz (preload), favqulodda harakatlar jadvalini yangilashingiz (invalidate) yoki tizim holatini soniya sayin kuzatishingiz (state) mumkin.
TanStack Router’dagi useRouter hook'i — bu sizga butun ilovangiz routing mexanizmining o‘sha markaziy boshqaruv pultiga bevosita kirish imkonini beruvchi qudratli vositadir.
1. useRouter nima va u qanday chaqiriladi?
Agar useNavigate faqat sahifalararo harakatlanish uchun mo‘ljallangan bo‘lsa, useRouter butun createRouter orqali yaratilgan router instansiyasining to‘liq API’larini ochib beradi:
import { useRouter } from '@tanstack/react-router'
export function AdminControlPanel() {
// Router instansiyasiga to'liq kirish huquqini olamiz
const router = useRouter()
const handleManualRefresh = () => {
// Joriy sahifaning barcha loader ma'lumotlarini majburiy qaytadan yangilaymiz
router.invalidate()
}
return (
<div style={{ padding: '1rem', background: '#f8fafc', borderRadius: '8px' }}>
<h3>Boshqaruv paneli</h3>
<button onClick={handleManualRefresh}>
Ma'lumotlarni yangilash (Refetch)
</button>
</div>
)
}
2. Real loyihalarda eng ko'p ishlatiladigan 3 ta super kuch
useRouter obyekti ichida o‘nlab yordamchi vositalar bor, ammo quyidagi uchta imkoniyat dasturchilar hayotini eng ko‘p yengillashtiradi:
A. router.invalidate() (Ma'lumotlarni majburiy yangilash)
Tasavvur qiling, foydalanuvchi modal darcha ichida yangi maqola qo‘shdi yoki profil ma'lumotlarini tahrirlab "Saqlash" tugmasini bosdi. API'ga so‘rov muvaffaqiyatli ketdi, ammo sahifadagi eski ro‘yxat o‘zgarishsiz qolib ketmasligi kerak.
Bunday paytda router.invalidate() chaqiriladi — u ayni damda ekranda ko‘rinib turgan barcha faol loader funksiyalarini avtomatik qaytadan ishga tushiradi:
import { useRouter } from '@tanstack/react-router'
export function EditUserModal({ userId, onClose }: { userId: string; onClose: () => void }) {
const router = useRouter()
const handleUpdate = async (newName: string) => {
// 1. Backend'ga ma'lumotni yuboramiz
await updateUserApi(userId, { name: newName })
// 2. Sahifadagi loader'larni qayta ishlatib, yangi ma'lumotlarni tortib kelamiz
await router.invalidate()
// 3. Modalni yopamiz
onClose()
}
return (
<div>
{/* Forma elementlari */}
</div>
)
}
async function updateUserApi(_id: string, _data: any) {
return Promise.resolve()
}
[!TIP] React Router bilan farqi: React Router’da buning uchun alohida
useRevalidator()hook'ini chaqirish kerak edi. TanStack Router’da esa bu to‘g‘ridan-to‘g‘ri router instansiyasining o‘ziga biriktirilgan.
B. router.preloadRoute() (Oldindan yuklab qo'yish / Prefetching)
Foydalanuvchi biror tugmaga sichqonchani olib kelganida (hover), uning o‘sha sahifaga kirish ehtimoli 80% dan oshadi. Nega foydalanuvchi tugmani bosishini kutishimiz kerak?
router.preloadRoute() orqali o‘sha sahifaning JavaScript kodini va uning loader ma'lumotlarini orqa fonda oldindan yuklab qo‘yish mumkin:
import { useRouter } from '@tanstack/react-router'
export function QuickNavigation() {
const router = useRouter()
const handleHoverSettings = () => {
// Foydalanuvchi sichqonchani olib kelishi bilanoq ma'lumotlarni orqa fonda yuklaymiz
router.preloadRoute({
to: '/dashboard/settings',
})
}
return (
<button
onMouseEnter={handleHoverSettings}
onClick={() => router.navigate({ to: '/dashboard/settings' })}
>
Sozlamalar (Chaqmoqdek tez ochiladi)
</button>
)
}
Natijada foydalanuvchi tugmani bosgan onda sahifa 0 millisekundda, hech qanday kutishlarsiz bir zumda ekranga chiqadi!
C. router.state (Router'ning global holati)
Router ayni damda nima ish qilayotganini (sahifa yuklanyaptimi, xatolik yuz berdimi, navigatsiya jarayoni bormi) to‘liq ko‘rib turadi.
Masalan, butun sayt bo‘ylab har qanday sahifa almashganda tepadagi qizil yuklanish chizig‘ini (Global Progress Bar) chiqarish uchun router.state.isLoading tekshiriladi:
import { useRouterState } from '@tanstack/react-router'
export function GlobalProgressBar() {
// router.state holatini reaktiv kuzatib boramiz
const isLoading = useRouterState({
select: (state) => state.isLoading,
})
if (!isLoading) return null
return (
<div
style={{
position: 'fixed',
top: 0,
left: 0,
right: 0,
height: '3px',
background: '#2563eb',
zIndex: 9999,
animation: 'pulse 1s infinite',
}}
/>
)
}
3. useRouter arxitekturasi (Mermaid Diagram)
flowchart TD
Hook["useRouter()"] --> Router["Yagona Markaziy Router Instansiyasi"]
Router --> Inv["router.invalidate() (Barcha faol loaderlarni yangilash)"]
Router --> Pre["router.preloadRoute() (Kod va ma'lumotni keshga oldindan yuklash)"]
Router --> State["router.state (isLoading, location, matches)"]
Router --> Nav["router.navigate() (Dasturiy navigatsiya)"]
style Router fill:#eff6ff,stroke:#2563eb,stroke-width:2px
4. React Router va TanStack Router taqqosi
| Xususiyat | React Router | TanStack Router (useRouter) |
|---|---|---|
| Boshqaruv arxitekturasi | Turli vazifalar uchun har xil hooklar (useRevalidator, useNavigation) |
Bitta yagona boshqaruvchi: useRouter |
| Loader ma'lumotlarini yangilash | const revalidator = useRevalidator(); revalidator.revalidate() |
router.invalidate() (Juda qisqa va qulay) |
| Oldindan yuklash (Prefetch) | Qo‘lda maxsus fetcherlar yozish talab etiladi | router.preloadRoute({ to: '...' }) tayyor API |
| Global holatni kuzatish | useNavigation().state === 'loading' |
router.state.isLoading yoki useRouterState |
| Type-Safety | Cheklangan | Barcha yo‘llar va parametrlar 100% type-safe |
Xulosa
useRouter— butun ilovani boshqarib turuvchi markaziy router instansiyasiga bevosita kirish imkonini beradi.router.invalidate()— forma yuborilgandan yoki ma'lumot o‘zgargandan keyin sahifadagi loader'larni qayta ishlatib, yangi ma'lumotlarni tortib keladi.router.preloadRoute()— sahifa kodini va ma'lumotlarini foydalanuvchi bosishidan oldinroq orqa fonda keshlab, chaqmoqdek tez ochilishini ta'minlaydi.router.state— ilovaning joriy yuklanish holati (isLoading) va navigatsiya oqimini global boshqarishga xizmat qiladi.