Series: TanStack Router Lesson 15

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.tsx fayli uchun createFileRoute('/_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["&lt;Outlet /&gt;"]
    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.tsx yoki _admin/users.tsx sahifalariga kirmoqchi bo‘lgan har qanday foydalanuvchi avval ota layoutdagi beforeLoad tekshiruvidan 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 beforeLoad yordamida sahifalar guruhini oson himoyalash uchun xizmat qiladi.