Scroll restoration — Navigation davomida scroll holatini boshqarish
TanStack Router'da Scroll Restoration: ScrollRestoration komponenti, orqaga/oldinga harakatda skrolni tiklash, asinxron loaderlar bilan ishlash va React Router bilan taqqos.
55-dars
Scroll restoration — Navigation davomida scroll holatini boshqarish
Oddiy Single Page Application (SPA) ilovalarida foydalanuvchilarning eng katta shikoyatlaridan biri — bu skrol holatining yo‘qolib qolishidir: Tasavvur qiling, siz internet-do‘konda 300 ta mahsulotni pastga qarab ko‘rib tushdingiz. 150-chi mahsulotni bosib, uning sahifasiga kirdingiz. So‘ngra brauzerning "Orqaga" (Back) tugmasini bosganingizda, sahifa yana eng tepaga (0-chi pikselga) sakrab chiqib ketadi. Natijada siz o‘rningizni yo‘qotib, yana pastga skrol qilishga majbur bo‘lasiz.
TanStack Router bu muammoni ScrollRestoration mexanizmi orqali ildizidan hal qiladi: u foydalanuvchining har bir sahifadagi skrol koordinatasini xotirada saqlab, orqaga qaytganda uni nuqtasigacha tiklab beradi.
1. Hayotiy o‘xshatish: Qalin kitob va Xatcho‘p (Bookmark)
Tasavvur qiling, siz 1000 sahifalik qalin ensiklopediyani o‘qiyapsiz:
- Eski usul (Skrol tiklanmaganda): Siz 450-betdasiz. Boshqa kitobdan izoh o‘qish uchun uni yopdingiz. Asosiy kitobga qaytganingizda, xatcho‘p bo‘lmagani uchun yana 1-bet ochiladi va siz 450-betni qidirib asabiylashasiz.
ScrollRestorationusuli: Siz qaysi betda to‘xtasangiz, aqlli xatcho‘p o‘sha yerga o‘z-o‘zidan qo‘yiladi. Orqaga qaytganingizda kitob bir zumda aynan 450-betidan ochiladi.- Yangi sahifaga o‘tish: Agar siz yangi bobni o‘qishni boshlasangiz (PUSH navigation), kitob tabiiy ravishda uning boshidan (eng yuqoridan) boshlanadi.
2. <ScrollRestoration /> komponentini ulash
TanStack Router'da skrolni boshqarish juda oson. Buni amalga oshirish uchun src/routes/__root.tsx faylining eng quyi qismiga <ScrollRestoration /> komponentini joylashtirish kifoya:
// src/routes/__root.tsx
import {
createRootRouteWithContext,
Outlet,
ScrollRestoration
} from '@tanstack/react-router'
export const Route = createRootRouteWithContext<RouterContext>()({
component: RootLayout,
})
function RootLayout() {
return (
<div className="app-container">
<header className="main-nav">
<h1>Onlayn Do‘kon</h1>
</header>
{/* Sahifa kontenti chiziladigan maydon */}
<main className="content">
<Outlet />
</main>
{/*
ScrollRestoration komponenti butun ilova bo'ylab
skrol hodisalarini avtomatik kuzatadi va tiklaydi
*/}
<ScrollRestoration />
</div>
)
}
3. Navigatsiya turlari bo‘yicha skrol harakati (Mermaid Diagram)
flowchart TD
NavAction["Foydalanuvchi navigatsiyani amalga oshirdi"] --> CheckType{"Navigatsiya turi qanday?"}
CheckType -- "1. Yangi link bosildi (PUSH)" --> ScrollTop["Sahifa eng tepaga chiqadi: window.scrollTo(0, 0)"]
CheckType -- "2. 'Orqaga' yoki 'Oldinga' bosildi (POP)" --> CheckCache{"Xotirada ushbu sahifa skrol koordinatasi bormi?"}
CheckCache -- "HA" --> WaitContent["loader() tugashini va DOM render bo'lishini kutadi"]
WaitContent --> RestoreExact["Aynan oldingi skrol nuqtasi tiklanadi: (x, y)"]
CheckCache -- "YO'Q" --> ScrollTop
4. Asinxron Loader'lar va Skrolni to‘g‘ri tiklash
Ko‘p kutubxonalarda uchraydigan texnik xatolik:
Agar sahifa ochilganda ma'lumotlar serverdan kechikib kelsa (loader ishlab turganda), sahifaning balandligi hali kichkina bo‘ladi. Agar skrol o‘sha paytda tiklansa, sahifa pastga tusha olmay, yuqorida qolib ketadi.
TanStack Router esa juda aqlli:
U loader to‘liq yakunlanib, DOM elementlari to‘liq render bo‘lgandan keyingina skrolni tiklaydi. Bu orqali uzun ro‘yxatlar, jadval va kartochkalar to‘liq chizilishi kafolatlanadi.
5. Maxsus kalit (getKey) orqali skrolni nozik sozlash
Ba'zi sahifalarda faqat sahifa manzili (pathname) bo‘yicha emas, balki qidiruv parametrlari (search params) bo‘yicha ham skrolni alohida saqlash kerak bo‘ladi:
<ScrollRestoration
getKey={(location) => {
// Har bir tab yoki sahifa raqami uchun alohida skrol holati saqlanadi:
return location.pathname + location.searchStr
}}
/>
6. React Router va TanStack Router taqqosi
| Xususiyat | React Router (<ScrollRestoration />) |
TanStack Router (<ScrollRestoration />) |
|---|---|---|
| O‘rnatish qulayligi | Mavjud | Bitta komponent bilan qutidan chiqqan holda ishlaydi |
| Asinxron ma'lumotlar bilan ishlash | ⚠️ Loader kechikishida skrol to‘liq tushmay qolishi mumkin | ✅ Loader va Pending holatlari tugashini kutadi |
Maxsus kesh kalitlari (getKey) |
Mavjud | Type-safe location orqali to‘liq qo‘llab-quvvatlanadi |
Qo‘lda useEffect yozish |
Ko‘pincha talab qilinadi | Umuman talab qilinmaydi (Zero Boilerplate) |
Xulosa
- Scroll Restoration — foydalanuvchi "Orqaga" yoki "Oldinga" tugmalarini bosganda sahifaning avvalgi skrol o‘rnini qayta tiklovchi mexanizm.
<ScrollRestoration />komponenti__root.tsxfayliga joylashtirilib, butun ilovaning skrol holatlarini avtomatlashtiradi.- Yangi sahifaga o‘tilganda (
PUSH) sahifa doimo eng yuqoriga chiqadi (scrollTop = 0). - TanStack Router ma'lumotlar yuklanishi (
loader) tugashini kutib, so‘ngra skrolni tiklagani sababli hech qachon pozitsiya yo‘qolmaydi.