Seriya: TanStack Router Dars 21

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.tsx fayliga, <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.
  • select opsiyasi 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.