Seriya: TanStack Router Dars 46

Route preloading — Navigation'dan oldin data va route yuklash

TanStack Router'da Route Preloading: preload='intent' va 'viewport' strategiyalari, global sozlamalar, dasturiy router.preloadRoute va React Router bilan taqqos.

46-dars

Route preloading — Navigation'dan oldin data va route yuklash

Tasavvur qiling, siz nufuzli mehmonxonada VIP xizmatidan foydalanyapsiz.

Siz eshik oldiga kelib qo‘ng‘iroqni bosishingizdan (linkni bosishingizdan) oldinroq, eshikbon sizning yaqinlashib kelayotganingizni ko‘rib (hover / intent), xona eshigini ochib, chiroqlarni yoqib, stolda issiq choyni tayyorlab qo‘yadi (Route & Data Preload). Siz xonaga kirgan oningizda hech narsani kutib o‘tirmaysiz — hammasi muhayyo.

TanStack Router’dagi Route Preloading aynan shu tamoyil asosida ishlaydi: foydalanuvchi link ustiga kursor olib borgan zahoti, router sahifaning JavaScript kodini ham, uning loader ma'lumotlarini ham oldindan yuklab keshga saqlab qo‘yadi.


1. Preloading vaqtida nima sodir bo'ladi?

TanStack Router preloading jarayonida bir vaqtning o‘zida ikkita parallel yuklashni amalga oshiradi:

+-----------------------------------------------------------------------------------+
|                           PRELOADING IKKI TUSTUNI                                 |
+-----------------------------------------------------------------------------------+
| 1. Route Code Preload (JavaScript Chunks):                                        |
|    Lazy-loading bilan bo'lingan sahifa komponenti (JS fayli) fonda yuklanadi.    |
|                                                                                   |
| 2. Route Data Preload (Loader Execution):                                         |
|    Sahifaning loader funksiyasi ishga tushib, API ma'lumotlari keshga yoziladi.  |
+-----------------------------------------------------------------------------------+

Foydalanuvchi linkni bosgan paytda, sahifaning kodi ham, unga kerakli barcha ma'lumotlar ham xotirada 100% tayyor turgan bo‘ladi. Natijada sahifa 0 millisoniya kechikish (Zero-Latency) bilan bir zumda ochiladi.


2. Preload strategiyalari

TanStack Router linklarda preloading qilish uchun bir nechta qulay usullarni taqdim etadi:

A. preload="intent" (Eng ommabop va aqlli usul)

Foydalanuvchi kursorini link ustiga olib borganda (onMouseEnter) yoki mobil ekranda barmog‘ini bosishga tayyorlaganda (onTouchStart), router fonda yuklashni boshlaydi.

import { Link } from '@tanstack/react-router'

function NavigationBar() {
  return (
    <nav className="nav-links">
      {/* Kursor link ustiga kelishi bilan fonda yuklanadi */}
      <Link to="/dashboard" preload="intent">
        Boshqaruv paneli
      </Link>
      
      <Link to="/analytics" preload="intent">
        Tahlil
      </Link>
    </nav>
  )
}

[!TIP] TanStack Router tasodifiy kursor harakatlarida tarmoqqa ortiqcha yuklama bermaslik uchun 50 ms intent delay (kechikish) qo‘llaydi. Agar kursor link ustida 50 ms dan kamroq vaqt turib o‘tib ketsa, keraksiz so‘rov yuborilmaydi!

B. preload="viewport" (Ko‘rinish maydoni)

Agar sahifada uzun postlar ro‘yxati bo‘lsa, ekran skroll qilinib havolalar ko‘rinish sohasiga (viewport) tushishi bilan router ularni fonda yuklab qo‘yadi (IntersectionObserver yordamida).

<Link to="/posts/$postId" params={{ postId: post.id }} preload="viewport">
  {post.title}
</Link>

3. Global miqyosda Preload'ni yoqish

Har bir <Link> komponentiga alohida preload="intent" deb yozib chiqish shart emas. Buni router yaratilayotganda butun ilova uchun standart (default) qilib belgilash mumkin:

// src/router.tsx
import { createRouter } from '@tanstack/react-router'
import { routeTree } from './routeTree.gen'

export const router = createRouter({
  routeTree,
  // 1. Standart holatda barcha Link'lar uchun intent preloading yoqiladi
  defaultPreload: 'intent',

  // 2. Kursor link ustida qancha vaqt turganda yuklash boshlansin (millisoniya)
  defaultPreloadDelay: 50,

  // 3. Preload qilingan ma'lumotlar keshda qancha vaqt yangi hisoblansin
  defaultPreloadStaleTime: 1000 * 30, // 30 soniya
})

Agar ma'lum bir og‘ir sahifada preloading kerak bo‘lmasa, o‘sha linkning o‘zida uni o‘chirib qo‘yish mumkin:

<Link to="/heavy-reports" preload={false}>
  Katta hisobotlar (Preload yo'q)
</Link>

4. Dasturiy (Programmatic) Preloading: router.preloadRoute

Ba'zan link bosilishidan tashqari maxsus foydalanuvchi harakatlarida (masalan, qidiruv natijalarida yoki buyruqlar menyusida - Command Palette) dasturiy yo‘l bilan marshrutni yuklash talab etiladi:

// src/components/SearchDropdown.tsx
import { useRouter } from '@tanstack/react-router'

export function SearchDropdownItem({ product }: { product: { id: string; name: string } }) {
  const router = useRouter()

  const handleMouseEnter = () => {
    // Kursor qidiruv natijasi ustiga kelganda sahifani oldindan yuklaymiz
    router.preloadRoute({
      to: '/products/$productId',
      params: { productId: product.id },
    })
  }

  return (
    <div className="search-result-row" onMouseEnter={handleMouseEnter}>
      <span>{product.name}</span>
    </div>
  )
}

5. Preloading jarayoni (Mermaid Sequence Diagram)

sequenceDiagram
    autonumber
    actor User as Foydalanuvchi
    participant Link as Link Komponenti
    participant Router as TanStack Router
    participant Server as Tarmoq / Server

    User->>Link: Kursorni link ustiga olib bordi (Hover)
    Link->>Router: 50 ms kutish (Intent tekshiruvi o'tdi)
    
    par Fonda yuklash (Background Preload)
        Router->>Server: JS Chunks yuklash (Code Splitting)
        Router->>Server: loader() orqali ma'lumotlarni yuklash (API)
    end
    
    Server-->>Router: Kod va ma'lumotlar Keshga saqlandi
    
    User->>Link: Linkni bosdi (Click!)
    Router-->>User: Sahifa 0 ms kechikish bilan zudlik bilan ochildi!

6. React Router va TanStack Router taqqosi

Xususiyat React Router TanStack Router
preload="intent" ❌ O‘rnatilgan emas (qo‘lda hover eventlar yozish kerak) ✅ O‘rnatilgan va 50 ms debounce bilan himoyalangan
preload="viewport" ❌ Yo‘q ✅ O‘rnatilgan IntersectionObserver orqali ishlaydi
Kod va Ma'lumot parallel yuklanishi ⚠️ Faqat qo‘lda konfiguratsiya orqali ✅ Har ikkalasi avtomatik ravishda parallel yuklanadi
Global sozlash (defaultPreload) ❌ Yo‘q ✅ createRouterda bir qatorda global yoqiladi
Dasturiy API Cheklangan ✅ router.preloadRoute() to‘liq tiplangan va qulay

Xulosa

  • Route Preloading — foydalanuvchi sahifaga o‘tishidan oldinroq uning kodini va loader ma'lumotlarini fonda yuklab qo‘yish usuli.
  • preload="intent" kursor yaqinlashganda yuklashni boshlaydi va saytni native dasturlardek chaqmoqdek tez qiladi.
  • defaultPreload: 'intent' orqali butun ilovadagi barcha havolalarga bu imkoniyatni global tatbiq etish mumkin.
  • router.preloadRoute() orqali har qanday maxsus hodisa yoki interfeys elementlarida oldindan yuklashni dasturiy boshqarish mumkin.