Seriya: TanStack Router Dars 13

createFileRoute — Fayl orqali route e'lon qilish

TanStack Router'da createFileRoute: marshrutni faylga bog'lash, Route moduli, to'liq type-safe params va loaderlar, hamda Route.useParams() hooklari.

13-dars

createFileRoute — Fayl orqali route e'lon qilish

Tasavvur qiling, siz yangi uy sotib oldingiz va davlat xizmatlari markaziga bordingiz. U yerda mutaxassis sizning kadastr raqamingizni (faylning aniq manzilini) tekshiradi, reyestrga kiritadi va sizga rasmiy mulk huquqi guvohnomasini beradi. Ushbu guvohnomada uydagi barcha xonalar maydoni va shartlari aniq belgilangan bo‘ladi. Agar berilgan manzil real kadastrga to‘g‘ri kelmasa, hujjat berilmaydi.

TanStack Router’dagi createFileRoute funksiyasi aynan shu rasmiy reyestr vazifasini bajaradi. U faylni o‘zi turgan URL manziliga qat'iy muhrlab qo‘yadi (Path Binding) va o‘sha sahifa ichidagi barcha elementlarni — komponent, loader, parametrlar va holatlarni — 100% to‘liq type-safe kafolat bilan ta'minlaydi.


1. createFileRoute qanday ishlaydi?

Siz src/routes ichida biror fayl yaratganingizda (masalan, src/routes/posts/$postId.tsx), ushbu fayl oddiy React komponenti emas, balki to‘laqonli Route Moduli hisoblanadi.

Fayl ichida birinchi bo‘lib createFileRoute funksiyasi chaqiriladi va eksport qilinadi:

// src/routes/posts/$postId.tsx
import { createFileRoute } from '@tanstack/react-router'

// 1. createFileRoute orqali marshrut modulini e'lon qilamiz
// DIQQAT: Berilgan string faylning papka ichidagi aniq manziliga mos kelishi SHART!
export const Route = createFileRoute('/posts/$postId')({
  // Ma'lumotlarni yuklash (Loader)
  loader: async ({ params }) => {
    // params.postId avtomatik ravishda mavjud va string turi kafolatlangan
    const response = await fetch(`https://jsonplaceholder.typicode.com/posts/${params.postId}`)
    if (!response.ok) {
      throw new Error("Maqola topilmadi")
    }
    return (await response.json()) as { id: number; title: string; body: string }
  },

  // Sahifa yuklanganda ko'rinadigan asosiy komponent
  component: PostDetailPage,
})

// 2. Sahifa komponenti
function PostDetailPage() {
  // Route'ning o'ziga xos hooklari orqali ma'lumotlarni olamiz:
  const post = Route.useLoaderData()
  const { postId } = Route.useParams()

  return (
    <article style={{ padding: '2rem', maxWidth: '700px' }}>
      <span style={{ color: '#888' }}>Post ID: #{postId}</span>
      <h1 style={{ marginTop: '0.5rem' }}>{post.title}</h1>
      <p style={{ lineHeight: 1.6 }}>{post.body}</p>
    </article>
  )
}

[!NOTE] E'tibor bering, funksiya ikki bosqichda chaqiriladi: createFileRoute('/posts/$postId')(options). Bunga dasturlashda Currying (karring) deyiladi. Birinchi qavs yo‘lni TypeScript turiga aylantiradi, ikkinchi qavs esa shu yo‘lga tegishli parametrlarni avtomatik autocomplete qilib beradi.


2. createFileRoute nima uchun bunchalik muhim?

1. Yo'lni faylga qat'iy bog'lash (Path Binding)

createFileRoute('/posts/$postId') deb yozganingizda, Vite plagini va TypeScript bu fayl aynan src/routes/posts/$postId.tsx ekanini tekshiradi.

Agar siz fayl nomini o‘zgartirsangiz (masalan, $articleId.tsx qilsangiz) yoki string ichida xato qilib /posts/$id deb yozsangiz, TypeScript bir lahzada qizil chiziq tortib sizni ogohlantiradi:

// XATO! Fayl nomi $postId.tsx, lekin stringda $id yozilgan:
// Argument of type '"/posts/$id"' is not assignable to parameter of type '"/posts/$postId"'.
export const Route = createFileRoute('/posts/$id')({ ... })

2. To'liq Type-Safe Parametrlar va Loader

React Router’da useParams() ishlatganingizda, qaytgan obyekt doimo Record<string, string | undefined> turida bo‘lardi:

// React Router usuli (Xavfli va noaniq):
const params = useParams()
const id = params.postId // turi: string | undefined (Xatolik kelib chiqishi mumkin!)

TanStack Router’da esa Route.useParams() to‘g‘ridan-to‘g‘ri fayl nomidagi $postIdni o‘qiydi va aniq { postId: string } qaytaradi:

// TanStack Router usuli (100% Xavfsiz):
const { postId } = Route.useParams() // postId aniq mavjud va string!

Xuddi shunday, Route.useLoaderData() funksiyasi loader qanday obyekt qaytargan bo‘lsa, uni avtomatik aniqlaydi (infer qiladi). Alohida interface e'lon qilib o‘tirish shart emas!

flowchart TD
    File["src/routes/posts/$postId.tsx"] --> Call["createFileRoute('/posts/$postId')"]
    Call --> TypeCheck["TypeScript AST Tahlili"]
    TypeCheck --> RouteObj["export const Route"]
    RouteObj --> SafeParams["Route.useParams() -> { postId: string }"]
    RouteObj --> SafeLoader["Route.useLoaderData() -> PostType"]
    RouteObj --> SafeSearch["Route.useSearch() -> SearchParams"]

3. Route obyektining asosiy sozlamalari

createFileRoute(...)({ ... }) ichiga quyidagi eng muhim xususiyatlarni berishingiz mumkin:

Xususiyat Vazifasi
component Ushbu marshrut ochilganda chiziladigan asosiy React komponenti.
loader Komponent ekranga chiqishidan oldin ma'lumotlarni yuklab keluvchi asinxron funksiya.
beforeLoad Sahifaga kirishdan oldin autentifikatsiya yoki ruxsatnomalarni tekshirish (Redirect qilish).
pendingComponent Loader ma'lumot yuklayotganda ko‘rsatiladigan yuklanish indikatori (Skeleton / Spinner).
errorComponent Loaderda xatolik yuz berganda (throw new Error) ko‘rsatiladigan chiroyli xatolik sahifasi.
validateSearch URL query parametrlarini (?sort=asc) Zod yoki funksiya orqali tekshirish va tiplash.

4. React Router va TanStack Router taqqosi

Xususiyat React Router TanStack Router (createFileRoute)
Route e'lon qilish Umumiy bitta faylda massiv shaklida Har bir sahifa faylining ichida mustaqil
Parametrlarni olish Global useParams() (Turi noaniq: string | undefined) Lokal Route.useParams() (100% aniq va type-safe)
Loader ma'lumotlari Global useLoaderData() (Turi yo‘qotiladi, qo‘lda kasting kerak) Route.useLoaderData() (Loaderdan avtomatik infer qilinadi)
Fayl yo‘li xatolari Brauzerda ochmaguncha xato sezilmaydi IDE va TypeScript darhol qizil chiziq bilan to‘xtatadi

Xulosa

  • createFileRoute — bu TanStack Router’da har bir sahifa faylini o‘z manziliga muhrlab, uni to‘laqonli Route moduliga aylantiruvchi factory funksiyadir.
  • Ikki bosqichli (Currying) chaqiruv orqali yo‘l turlari birinchi qavsdan ikkinchi qavsdagi barcha sozlamalarga to‘liq uzatiladi.
  • Route.useParams() va Route.useLoaderData() orqali komponent ichida ma'lumotlar va parametrlarni mutlaq xavfsiz holatda ishlatish mumkin.