Layout routes — Parent route va umumiy layout (Pathless Layouts)
TanStack Router'da Pathless Layout routes: pastki chiziq (_) prefiksi, toza URL manzillari, beforeLoad orqali umumiy himoya (guards) va React Router bilan taqqoslash.
15-dars
Layout routes — Parent route va umumiy layout (Pathless Layouts)
Tasavvur qiling, siz nufuzli tadbirga tashrif buyurdingiz. Barcha mehmonlar uchun maxsus kiyim almashtirish va xavfsizlik nazorati zali ajratilgan. Siz o‘sha xavfsizlik zonasidan o‘tasiz, ustki kiyimlaringizni topshirasiz va to‘g‘ridan-to‘g‘ri marosim zaliga kirasiz. Sizning taklifnomangizda "Xavfsizlik zali orqali marosim" deb yozilmaydi, oddiygina "Marosim zali" deb yoziladi. Lekin siz baribir o‘sha umumiy xavfsizlik va xizmat ko‘rsatish qatlamidan o‘tasiz.
Veb-ilovalarda ham aynan shunday vaziyatlar ko‘p uchraydi: bir nechta sahifalar (masalan, /login va /register) umumiy ramkaga (ekran markazidagi chiroyli oq quti, fon rasmi yoki xavfsizlik tekshiruviga) ega bo‘lishi kerak, lekin ularning URL manzilida ortiqcha so‘zlar (/auth/login emas, balki shunchaki /login) ko‘rinmasligi lozim.
TanStack Router’da bunday marshrutlar Pathless Layout Routes (manzilga ta'sir qilmaydigan layoutlar) deb ataladi.
1. File-based routing'da Layout Route qanday yasaladi?
TanStack Router’ning fayl tizimida biror fayl yoki papka nomining boshiga pastki chiziq (_) qo‘yilsa, router uni URL manziliga qo‘shmaydi, lekin uni o‘z ichidagi barcha sahifalar uchun Ota Layout deb hisoblaydi.
Fayl va papka strukturasi:
src/
└── routes/
├── _auth.tsx -> 1. Pathless layout fayli (URL'ga qo'shilmaydi!)
└── _auth/ -> 2. Underscore bilan nomlangan papka
├── login.tsx -> URL: "/login" (diqqat: "/_auth/login" emas!)
└── register.tsx -> URL: "/register"
Ota Layout fayli: src/routes/_auth.tsx
// src/routes/_auth.tsx
import { createFileRoute, Outlet } from '@tanstack/react-router'
// createFileRoute ichida yo'l prefiksi '_' bilan ko'rsatiladi
export const Route = createFileRoute('/_auth')({
component: AuthLayout,
})
function AuthLayout() {
return (
<div
style={{
display: 'flex',
justifyContent: 'center',
alignItems: 'center',
minHeight: '100vh',
background: '#f1f5f9',
}}
>
<div
style={{
width: '100%',
maxWidth: '420px',
padding: '2rem',
background: '#ffffff',
borderRadius: '12px',
boxShadow: '0 10px 25px -5px rgba(0, 0, 0, 0.1)',
}}
>
{/* /login yoki /register sahifalari aynan shu yerda chiqadi */}
<Outlet />
</div>
</div>
)
}
Bola sahifa: src/routes/_auth/login.tsx
// src/routes/_auth/login.tsx
import { createFileRoute, Link } from '@tanstack/react-router'
export const Route = createFileRoute('/_auth/login')({
component: LoginPage,
})
function LoginPage() {
return (
<div>
<h2 style={{ marginBottom: '1rem' }}>Tizimga kirish</h2>
<form style={{ display: 'flex', flexDirection: 'column', gap: '0.75rem' }}>
<input type="email" placeholder="Elektron pochta" style={{ padding: '0.5rem' }} />
<input type="password" placeholder="Parol" style={{ padding: '0.5rem' }} />
<button type="submit" style={{ padding: '0.6rem', background: '#2563eb', color: '#fff', border: 'none', borderRadius: '4px' }}>
Kirish
</button>
</form>
<p style={{ marginTop: '1rem', fontSize: '0.875rem' }}>
Hisobingiz yo'qmi? <Link to="/register">Ro'yxatdan o'tish</Link>
</p>
</div>
)
}
[!IMPORTANT]
src/routes/_auth/login.tsxfayli uchuncreateFileRoute('/_auth/login')yoziladi, lekin foydalanuvchi brauzerida URL faqat /login bo‘lib ko‘rinadi!
2. Vizual arxitektura va Marshrutlash oqimi
flowchart TD
URL["Foydalanuvchi kirdi: /login"] --> Match["TanStack Router tahlili"]
Match --> Layout["_auth.tsx (Oq fonli karta va markazlash)"]
Layout --> OutletSlot["<Outlet />"]
OutletSlot --> Child["_auth/login.tsx (Forma)"]
style Layout fill:#f0fdf4,stroke:#16a34a,stroke-width:2px
3. Nima uchun Pathless Layouts juda muhim?
1. Toza va estetik URL manzillar (Clean URLs)
Dasturchi sifatida siz barcha autentifikatsiya fayllarini bitta papkaga yig‘ishni xohlaysiz (_auth/login.tsx, _auth/register.tsx, _auth/forgot-password.tsx).
Agar oddiy papka ishlatsangiz, URL mysite.uz/auth/login bo‘lib xunuklashardi. _auth papkasi orqali esa URL go‘zal va qisqa qoladi: mysite.uz/login.
2. Guruhlangan Route Guard'lar (Umumiy Himoya)
Tasavvur qiling, sizda bir nechta admin sahifalari bor: /analytics, /users, /billing. Bu sahifalarning barchasiga faqat adminlar kirishi shart.
Har bir sahifaga alohida-alohida tekshiruv yozib chiqmaysiz! Ularni bitta _admin layouti ostiga qo‘yasiz:
// src/routes/_admin.tsx
import { createFileRoute, Outlet, redirect } from '@tanstack/react-router'
export const Route = createFileRoute('/_admin')({
beforeLoad: async ({ context }) => {
// Agar foydalanuvchi admin bo'lmasa, uni darhol login sahifasiga yo'naltiramiz
const user = (context as any)?.auth?.user
if (!user || user.role !== 'ADMIN') {
throw redirect({
to: '/login',
search: { redirect: window.location.pathname },
})
}
},
component: () => (
<div className="admin-shell">
<Outlet />
</div>
),
})
[!TIP] Endi
_admin/analytics.tsxyoki_admin/users.tsxsahifalariga kirmoqchi bo‘lgan har qanday foydalanuvchi avval ota layoutdagibeforeLoadtekshiruvidan o‘tadi!
4. React Router va TanStack Router taqqosi
| Xususiyat | React Router | TanStack Router (_prefix) |
|---|---|---|
| Pathless layout e'lon qilish | pathsiz <Route element={<Layout />} /> yoziladi |
Fayl/papka nomiga _ belgisi qo‘yiladi (_auth.tsx) |
| Fayllar tuzilmasida boshqarish | Qo‘lda konfiguratsiyaga ulab chiqish shart | Fayl nomining o‘zi avtomatik tarzda tushuniladi |
| Type-Safe havolalar | <Link to="/login"> (qo‘lda boshqariladi) |
<Link to="/login"> (Avtomatik toza URL'ga bog‘lanadi) |
| Umumiy Guard (Himoya) | Har bir route yoki Layout ichida useEffect / Navigate |
beforeLoad orqali sahifa render bo‘lmasdanoq to‘xtatiladi |
Xulosa
- Pathless Layout Routes — URL manzilga ta'sir o‘tkazmaydigan, lekin ichki sahifalar uchun umumiy layout va himoya (guard) beruvchi ota marshrutlardir.
- Fayl yoki papka boshiga
_(pastki chiziq) qo‘yish orqali hosil qilinadi (_auth.tsx,_auth/login.tsx). - Bu usul loyiha arxitekturasini tartibli saqlash, URL manzillarni toza saqlash va
beforeLoadyordamida sahifalar guruhini oson himoyalash uchun xizmat qiladi.