useRouterState — Router state'ni kuzatish
TanStack Router'da useRouterState: reaktiv holatni kuzatish, select funksiyasi orqali optimallashgan renderlar, Global Loading Bar va React Router bilan taqqos.
21-dars
useRouterState — Router state'ni kuzatish
Tasavvur qiling, siz zamonaviy tezyurar poyezdda ketyapsiz. Vagonda yo‘lovchilar uchun kichik axborot ekrani o‘rnatilgan. Poyezdning boshqaruv tizimida minglab datchiklar (turbina aylanishi, tormoz bosimi, motor harorati) tinimsiz o‘zgarib turadi. Lekin vagon ekranida bu millionlab texnik ko‘rsatkichlar chiqarilmaydi — u faqat kerakli ikkita narsani: "Hozirgi tezlik" va "Keyingi bekat"ni saralab oladi (select qiladi). Qolgan minglab datchiklar o‘zgarganda vagon ekrani miltillab qayta-qayta yangilanavermaydi.
TanStack Router’dagi useRouterState hook'i aynan shu aqlli sensor ekrani kabi ishlaydi. U routerning butun ichki holatidan (status, yuklanish, URL, matches) faqat sizning komponentingizga kerakli qismini saralab olib, komponentni ortiqcha qayta render bo‘lishdan (re-render) himoya qiladi.
1. Asosiy ishlatilish misoli: Global Loading Bar
Real loyihalarda useRouterStatening eng mashhur vazifasi — foydalanuvchi sahifalararo harakatlanganda ekranning tepasida ingichka chiroyli yuklanish chizig‘ini (YouTube yoki GitHub uslubidagi Progress Bar) chiqarishdir:
import { useRouterState } from '@tanstack/react-router'
export function GlobalLoadingBar() {
// 1. useRouterState orqali router'ning statusini reaktiv kuzatamiz
const isPending = useRouterState({
// select yordamida faqat navigatsiya holatini ajratib olamiz
select: (state) => state.status === 'pending',
})
// Agar sahifa yuklanmayotgan bo'lsa, hech narsa ko'rsatmaymiz
if (!isPending) return null
return (
<div
style={{
position: 'fixed',
top: 0,
left: 0,
width: '100%',
height: '3px',
background: 'linear-gradient(90deg, #3b82f6 0%, #9333ea 50%, #f43f5e 100%)',
zIndex: 9999,
boxShadow: '0 0 12px rgba(147, 51, 234, 0.7)',
animation: 'progress-pulse 1.2s ease-in-out infinite',
}}
/>
)
}
[!TIP] Ushbu komponentni
src/routes/__root.tsxfayliga,<Outlet />ning tepasiga qo‘shib qo‘ysangiz, butun sayt bo‘ylab istalgan sahifaga o‘tilayotganda foydalanuvchi chiroyli animatsiyani ko‘radi.
2. Nima uchun select (Selector) funksiyasi o'ta muhim?
TanStack Router holati (router.state) juda ulkan obyekt hisoblanadi: unda barcha marshrutlar xaritasi, har bir ota-bola sahifaning yuklanish vaqti, parametrlar, so‘rov natijalari va tarix saqlanadi.
Agar siz komponent ichida shunchaki const state = useRouterState() deb yozsangiz:
- URL'dagi hatto bitta harf o‘zgarsa;
- Orqa fonda biron bir boshqa sahifaning ma'lumoti oldindan yuklansa (
preload); - Istalgan kichik o‘zgarish sodir bo‘lsa — komponentingiz har safar qaytadan boshdan-oyoq render bo‘ladi!
// YOMON AMALIYOT (Keraksiz re-renderlar chaqiradi):
const state = useRouterState() // Har bir o'zgarishda komponent qayta chiziladi
// TO'G'RI AMALIYOT (Ajoyib Performance):
const currentPath = useRouterState({
select: (state) => state.location.pathname, // Faqat pathname o'zgargandagina yangilanadi!
})
select funksiyasidan foydalanilganda TanStack Router faqat siz tanlagan qiymatni avvalgi qiymat bilan solishtiradi (shallow equality). Agar siz ajratib olgan qiymat o‘zgarmagan bo‘lsa, komponentingiz umuman qayta render qilinmaydi!
3. state ichida yana nimalarni kuzatish mumkin?
select: (state) => state... orqali quyidagi muhim qismlarga kirish mumkin:
| Xossa | Turi | Tavsif |
|---|---|---|
state.status |
'idle' | 'pending' |
Router bo‘sh turibdimi yoki yangi sahifani yuklayaptimi |
state.isLoading |
boolean |
Sahifadagi loaderlar ma'lumot olayotganini bildiradi |
state.location |
ParsedLocation |
Joriy manzil: pathname, search, hash va href |
state.matches |
RouteMatch[] |
Joriy sahifada turgan barcha ota va bola marshrutlar ro‘yxati |
state.pendingMatches |
RouteMatch[] | undefined |
Hali yuklanayotgan va tez orada ochiladigan yangi sahifa ma'lumotlari |
Joriy URL manzilni kuzatish misoli:
import { useRouterState } from '@tanstack/react-router'
export function Breadcrumbs() {
const pathname = useRouterState({
select: (state) => state.location.pathname,
})
const segments = pathname.split('/').filter(Boolean)
return (
<nav style={{ padding: '0.5rem', color: '#64748b' }}>
Home {segments.map((seg) => ` / ${seg}`)}
</nav>
)
}
4. Selector ishlash prinsipi (Mermaid Diagram)
flowchart TD
State["Ulkan Router State (Location, Matches, Search, Status, History)"]
subgraph Selector["useRouterState({ select: (s) => s.status })"]
Filter["Faqat 'status' qiymatini ajratib olish"]
Check{"'status' avvalgi qiymatdan farq qiladimi?"}
end
State --> Filter
Filter --> Check
Check -- Ha --> ReRender["Komponent qayta chiziladi (Re-render)"]
Check -- Yo'q (Masalan faqat URL query o'zgardi) --> Ignore["Render bo'lmaydi (Resurslar tejaladi)"]
5. React Router va TanStack Router taqqosi
| Xususiyat | React Router (useNavigation) |
TanStack Router (useRouterState) |
|---|---|---|
| Holatni olish | const navigation = useNavigation() |
useRouterState({ select: ... }) |
| Selector mexanizmi | Mavjud emas (to‘liq obyekt qaytadi) | O‘rnatilgan nozik select funksiyasi mavjud |
| Re-render nazorati | Navigatsiyaning har bir bosqichida qayta render | Faqat tanlangan qiymat o‘zgarganda render bo‘ladi |
| URL va Location | Alohida useLocation() hook kerak |
state.location orqali to‘g‘ridan-to‘g‘ri olinadi |
| Active Matches | useMatches() alohida hook talab etiladi |
state.matches orqali butun daraxt holati mavjud |
Xulosa
useRouterState— butun router tizimining ichki holatini real vaqt rejimida kuzatib boruvchi reaktiv hookdir.selectopsiyasi yordamida holatning faqat kerakli qismini ajratib olish (masalan,state.status === 'pending') ilovani keraksiz qayta renderlardan asraydi.- Uning yordamida Global Loading Bar, dinamik Breadcrumbs va sahifalararo o‘tish animatsiyalarini yuqori unumdorlik bilan yaratish mumkin.