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
loaderma'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.