Series: TanStack Router Lesson 47

Pending UI — Loading jarayonini boshqarish

TanStack Router'da Pending UI: pendingComponent, pendingMs va pendingMinMs bilan miltillashning oldini olish, global progress bar va React Router bilan taqqos.

47-dars

Pending UI — Loading jarayonini boshqarish

Tasavvur qiling, siz zamonaviy aqlli binoda tezyurar lift chaqiryapsiz.

Agar lift siz turgan qavatning o‘zida bo‘lsa, siz tugmani bosgan zahotingiz eshik ochiladi — sizga lift qayerda harakatlanayotgani haqida ekranda uzoq ma'lumot berish shart emas. Lekin lift uzoq qavatdan kelayotgan bo‘lsa, sizga "Lift harakatlanmoqda, kuting..." degan chiroyli ko‘rsatkich namoyish etiladi. Eng muhimi, bu ko‘rsatkich ko‘zingizni qamashtirib bir soniyaning o‘ndan birida miltillab o‘chib qolmaydi, balki silliq va barqaror turadi.

Veb-ilovalarda ma'lumotlar yuklanishi (loading) jarayoni foydalanuvchi tajribasiga (UX) eng kuchli ta'sir qiluvchi omillardan biridir. TanStack Router bu jarayonni boshqarish uchun pendingComponent, pendingMs va pendingMinMs kabi aqlli vositalarni taqdim etadi.


1. Route darajasidagi Pending UI (pendingComponent)

Har bir route o‘zining loader ma'lumotlari serverdan kelguncha ko‘rsatiladigan shaxsiy yuklanish holatini belgilashi mumkin:

// src/routes/reports.tsx
import { createFileRoute } from '@tanstack/react-router'

export const Route = createFileRoute('/reports')({
  // Og'ir ma'lumotlarni yuklovchi loader
  loader: async ({ abortSignal }) => {
    const res = await fetch('https://api.example.com/reports/annual', { signal: abortSignal })
    return res.json()
  },

  // 1. Ma'lumot kelguncha ko'rsatiladigan qiyofa (Skeleton yoki Spinner)
  pendingComponent: () => (
    <div className="reports-skeleton">
      <div className="skeleton-header">Yillik hisobotlar tayyorlanmoqda...</div>
      <div className="skeleton-bar" />
      <div className="skeleton-bar" />
      <div className="skeleton-bar" />
    </div>
  ),

  // 2. Asosiy sahifa komponenti (faqat ma'lumot tayyor bo'lganda chiqadi)
  component: ReportsPage,
})

function ReportsPage() {
  const reports = Route.useLoaderData()

  return (
    <div className="reports-container">
      <h1>Yillik hisobotlar</h1>
      <ul>
        {reports.map((item: any) => (
          <li key={item.id}>{item.title} — {item.amount}</li>
        ))}
      </ul>
    </div>
  )
}

2. Aqlli kechikish va miltillashning oldini olish: pendingMs va pendingMinMs

Dasturchilar ko‘p duch keladigan eng yoqimsiz muammo — Yuklanish indikatorining miltillashi (Loading Flicker):

  1. Agar internet juda tez bo‘lsa (so‘rov 50 ms da kelsa), ekranda spinner bir zum miltillab yo‘qoladi. Bu foydalanuvchi ko‘zini charchatadi.
  2. Agar spinner ko‘ringanidan 10 ms o‘tib yo‘qolsa, sahifada yoqimsiz sakrash (layout shift) ro‘y beradi.

TanStack Router bu muammoni ikkita maxsus vaqt parametri orqali mukammal hal qiladi:

export const Route = createFileRoute('/dashboard')({
  loader: async () => fetchDashboardStats(),
  
  pendingComponent: DashboardSkeleton,

  // 1. pendingMs: Agar javob 200ms dan tezroq kelsa, pendingComponent umuman ko'rsatilmaydi!
  pendingMs: 200,

  // 2. pendingMinMs: Agar pendingComponent ko'ringan bo'lsa, u kamida 500ms ekranda tursin (sakrashni oldini oladi)
  pendingMinMs: 500,
})

3. Pending vaqt mantig'i (Mermaid Diagram)

flowchart TD
    Start["Navigatsiya boshlandi (loader ishga tushdi)"] --> Timer["Timer boshlanadi (pendingMs: 200ms)"]

    Timer --> FastCheck{"Ma'lumot 200ms ichida keldimi?"}

    FastCheck -- "HA (Tezkor tarmoq)" --> NoFlicker["pendingComponent ko'rsatilmaydi (0 miltillash!)"]
    NoFlicker --> MainUI["Asosiy sahifa bir zumda ochiladi"]

    FastCheck -- "YO'Q (Sekinroq yuklanish)" --> ShowPending["pendingComponent ekranga chiqadi"]
    ShowPending --> MinCheck{"pendingMinMs (500ms) o'tdimi?"}
    
    MinCheck -- "HA" --> MainUI
    MinCheck -- "YO'Q" --> Wait["500ms to'lguncha silliq kutib turiladi"]
    Wait --> MainUI

4. Butun ilova bo‘ylab Global Progress Bar

Faqat alohida sahifada emas, balki YouTube yoki GitHub kabi butun ilova bo‘ylab har qanday sahifaga o‘tish vaqtida ekranning eng tepasida yuklanish chizig‘ini (Top Loading Bar) chiqarish uchun useRouterState ishlatiladi:

// src/routes/__root.tsx
import { createRootRoute, Outlet, useRouterState } from '@tanstack/react-router'

export const Route = createRootRoute({
  component: RootLayout,
})

function RootLayout() {
  // Router umumiy yuklanish holatini kuzatib boramiz
  const isLoading = useRouterState({
    select: (state) => state.status === 'pending',
  })

  return (
    <div className="app-root">
      {/* Global yuklanish chizig'i */}
      {isLoading && <div className="top-global-loading-bar" />}

      <header className="main-header">
        <h2>Mening Ilovam</h2>
      </header>

      <main className="content">
        <Outlet />
      </main>
    </div>
  )
}
/* Silliq animatsiyali progress chizig'i */
.top-global-loading-bar {
  position: fixed;
  top: 0;
  left: 0;
  height: 3px;
  width: 100%;
  background: linear-gradient(90deg, #3b82f6, #60a5fa);
  animation: pulse 1s infinite;
  z-index: 9999;
}

5. React Router va TanStack Router taqqosi

Xususiyat React Router TanStack Router
Pending UI e'lon qilish ⚠️ Faqat qo‘lda useNavigation().state === 'loading' ✅ Deklarativ pendingComponent har bir routedagi xossa
Miltillashdan himoya (pendingMs) ❌ O‘rnatilgan emas (qo‘lda setTimeout yozish kerak) ✅ O‘rnatilgan va deklarativ (pendingMs: 200)
Minimal ko‘rinish vaqti (pendingMinMs) ❌ Mavjud emas ✅ O‘rnatilgan (pendingMinMs: 500)
Global yuklanish holati useNavigation() orqali useRouterState({ select: s => s.status === 'pending' })
Skeleton / Suspense uyg‘unligi React 18 Suspense bilan alohida ulanadi Loader va Suspense bilan avtomatik bog‘langan

Xulosa

  • Pending UI — sahifa ma'lumotlari yuklanayotganda foydalanuvchiga qulay va tushunarli kutish tajribasini yaratish vositasi.
  • pendingComponent har bir route uchun shaxsiy skeleton yoki spinnerlarni biriktirish imkonini beradi.
  • pendingMs tezkor tarmoqda spinnerlarning asabga teguvchi miltillashini yo‘qotadi, pendingMinMs esa interfeysning silliq o‘tishini ta'minlaydi.
  • useRouterState orqali butun ilova bo‘ylab universal va zamonaviy global progress bar yaratish mumkin.