Series: TanStack Router Lesson 18

Link — Type-safe navigatsiya va route manzillari

TanStack Router'da <Link /> komponenti: to'liq type-safe yo'llar, params va search parametrlari, activeProps orqali faol holatni boshqarish va React Router bilan taqqoslash.

18-dars

Link — Type-safe navigatsiya va route manzillari

Tasavvur qiling, siz poyezdda harakatlanyapsiz. Oddiy avtomobilda haydovchi xaritani adashtirib, berk ko‘chaga yoki jarlikka burilib ketishi mumkin (React Router’dagi xom string yo‘llar kabi). Temir yo‘lda esa poyezd faqat oldindan puxta yotqizilgan mustahkam relslar bo‘ylabgina yura oladi. Yo‘q relsga burilishning imkoni yo‘q — po‘lat relslar poyezdni doimo xavfsiz va aniq manzilga olib boradi.

TanStack Router’dagi <Link /> komponenti — bu o‘sha ishonchli temir yo‘l tizimidir. Loyihangizdagi avtomatik yaratilgan Route Tree tufayli kod muharriringiz (IDE) ilovadagi barcha mavjud yo‘llar, ularning parametrlari va query parametrlarini oldindan 100% biladi. Natijada sizda noto‘g‘ri yoki buzilgan havolalar yozish xavfi mutlaqo yo‘qoladi.


1. Oddiy statik havolalar (to prop)

Oddiy statik sahifalarga havola berish uchun to xossasidan foydalaniladi. Siz tirnoq ichida / yozishingiz bilan IDE mavjud bo‘lgan barcha marshrutlarni avtomatik taklif (autocomplete) qiladi:

import { Link } from '@tanstack/react-router'

function NavigationBar() {
  return (
    <nav style={{ display: 'flex', gap: '1rem', padding: '1rem', background: '#f8fafc' }}>
      {/* 1. To'g'ri statik havolalar */}
      <Link to="/">Bosh sahifa</Link>
      <Link to="/about">Biz haqimizda</Link>
      <Link to="/contact">Bog'lanish</Link>

      {/* 2. XATO YO'L YOZILSA:
          TypeScript darhol qizil chiziq tortib kodni ishga tushirishdan to'xtatadi!
          Type '"/abt"' is not assignable to type '"/" | "/about" | "/contact"'. */}
      {/* <Link to="/abt">Xato havola</Link> */}
    </nav>
  )
}

2. Dinamik parametrli havolalar (params prop)

React Router’da dinamik yo‘llarni yozganda satrlar ulanmasidan (to={'/posts/' + post.id}) foydalanilardi. Agar biror sahifada parametr berishni unutib qoldirsangiz yoki noto‘g‘ri nomlasangiz, brauzerda 404 xatosi chiqmaguncha buni bilolmasdingiz.

TanStack Router’da to qismiga marshrut shabloni (/posts/$postId), alohida params propiga esa uning qiymati uzatiladi:

import { Link } from '@tanstack/react-router'

interface Post {
  id: string
  title: string
}

function PostCard({ post }: { post: Post }) {
  return (
    <article style={{ border: '1px solid #e2e8f0', padding: '1rem', borderRadius: '8px' }}>
      <h3>{post.title}</h3>

      {/* to qismida fayl shabloni, params ichida esa o'zgaruvchilar beriladi */}
      <Link
        to="/posts/$postId"
        params={{ postId: post.id }}
        style={{ color: '#2563eb', textDecoration: 'none' }}
      >
        Maqolani to'liq o'qish &rarr;
      </Link>
    </article>
  )
}

[!CAUTION] Agar siz to="/posts/$postId" deb yozib, lekin params propini berishni esdan chiqarsangiz, TypeScript loyihani build qilishga ruxsat bermaydi: Property 'params' is missing in type '{ to: "/posts/$postId"; }' but required in type ...


3. Query / Search parametrlari (search prop)

URL oxiridagi qidiruv parametrlarini (?page=2&sortBy=date) uzatish ham to‘liq nazorat qilinadi:

import { Link } from '@tanstack/react-router'

export function PaginationControls() {
  return (
    <div style={{ display: 'flex', gap: '0.5rem', marginTop: '1rem' }}>
      {/* 1. Obyekt ko'rinishida search uzatish */}
      <Link
        to="/posts"
        search={{ page: 2, sortBy: 'date' }}
      >
        2-sahifa
      </Link>

      {/* 2. Funksiya ko'rinishida: oldingi parametrlarni saqlab qolgan holda o'zgartirish */}
      <Link
        to="/posts"
        search={(prev) => ({ ...prev, page: (prev.page ?? 1) + 1 })}
      >
        Keyingi sahifa
      </Link>
    </div>
  )
}

Agar siz ushbu route uchun Zod orqali page: z.number() deb belgilagan bo‘lsangiz, search={{ page: "ikki" }} deb yozishga TypeScript yo‘l qo‘ymaydi!


4. Faol (Active) holatni boshqarish (activeProps)

Foydalanuvchi joriy sahifada turganini bildirish uchun havolani rang yoki qalin shrift bilan ajratib ko‘rsatish lozim. React Router’da buning uchun alohida NavLink komponenti talab etilardi.

TanStack Router’da esa bitta yagona <Link> komponentining o‘zida activeProps va inactiveProps xususiyatlari mavjud:

import { Link } from '@tanstack/react-router'

export function SidebarNavigation() {
  return (
    <aside style={{ width: '200px' }}>
      <Link
        to="/dashboard"
        // Foydalanuvchi aynan /dashboard manzilida turganda ishlaydi:
        activeProps={{
          style: { fontWeight: 'bold', color: '#2563eb' },
          className: 'active-menu-item',
        }}
        // Foydalanuvchi boshqa sahifada turganda ishlaydi:
        inactiveProps={{
          style: { color: '#64748b' },
        }}
      >
        Asosiy panel
      </Link>
    </aside>
  )
}

[!TIP] Agar ota route o‘zining ichki bola sahifalarida faol bo‘lib qolmasligini xohlasangiz, activeOptions={{ exact: true }} sozlamasini qo‘shib qo‘yish kifoya.


5. Xavfsizlik zanjiri (Mermaid Diagram)

flowchart TD
    Code["Dasturchi yozdi: &lt;Link to='/posts/$postId' params={{ postId: '42' }} /&gt;"]
    
    subgraph TS["TypeScript va Route Tree Tekshiruvi"]
        CheckPath{"/posts/$postId mavjudmi?"}
        CheckParams{"params.postId uzatildimi?"}
        CheckSearch{"Search parametrlari to'g'rimi?"}
    end

    Code --> CheckPath
    CheckPath -- Ha --> CheckParams
    CheckPath -- Yo'q --> Error1["Compile Error: Noto'g'ri manzil!"]
    CheckParams -- Ha --> CheckSearch
    CheckParams -- Yo'q --> Error2["Compile Error: Parametr yetishmayapti!"]
    CheckSearch -- Ha --> Success["Brauzerda 100% xatosiz navigatsiya"]

6. React Router va TanStack Router taqqosi

Xususiyat React Router (<Link> / <NavLink>) TanStack Router (<Link>)
Yo‘lni ko‘rsatish Xom matn (string): to="/posts/10" Shablon va autocomplete: to="/posts/$postId"
Parametrlar xavfsizligi String interpolatsiyasi, xatoliklar brauzerda bilinadi params xossasi majburiy va 100% tekshiriladi
Search query uzatish to="/posts?page=2" (string yoki qo‘shimcha obyekt) search={{ page: 2 }} (Zod bilan to‘liq tiplangan)
Faol holatni boshqarish Alohida <NavLink> va ({ isActive }) => ... Yagona <Link activeProps={{ ... }}>
Marshrut o‘zgarganda Eskirgan linklar sezilmay qolishi mumkin Buzilgan linklar bo‘lsa kod compile bo‘lmaydi

Xulosa

  • <Link /> — bu butun Route Tree bilan bevosita integratsiyalashgan, 100% type-safe navigatsiya komponentidir.
  • Mavjud bo‘lmagan yo‘llar, yetishmayotgan parametrlar (params) yoki noto‘g‘ri query parametrlar (search) dasturni ishga tushirishdan oldinoq TypeScript tomonidan to‘xtatiladi.
  • activeProps orqali faol sahifalar uchun CSS sinflar va uslublar qo‘shimcha wrapperlarsiz oson belgilanadi.