Seriya: TanStack Router Dars 26

Relative navigation — Nisbiy route orqali navigatsiya

TanStack Router'da nisbiy navigatsiya: .. va ./ belgilarining ishlashi, Link va useNavigate'da ota-bola sahifalariga harakatlanish va React Router bilan taqqos.

26-dars

Relative navigation — Nisbiy route orqali navigatsiya

Tasavvur qiling, siz ko‘p qavatli biznes markazining 4-qavatidagi 402-xonadasiz. Qo‘shni 403-xonaga kirish uchun binodan tashqariga — ko‘chaga chiqib, qaytadan kirish eshigidan 4-qavatga ko‘tarilmaysiz (/dashboard/users/42/edit deb to‘liq manzil aytmaysiz). Shunchaki koridor bo‘ylab qo‘shni eshikka o‘tasiz (./edit). Yoki qabulxonaga tushish uchun bir qavat pastga tushasiz (..).

Veb-ilovalarda ham har safar boshlang‘ich / dan boshlab to‘liq (absolute) manzilni yozib o‘tirmasdan, joriy sahifaga nisbatan harakatlanish imkoniyati mavjud. Bu usul Relative Navigation (Nisbiy Navigatsiya) deb ataladi.


1. Nisbiy belgilar qanday ishlaydi?

TanStack Router xuddi kompyuter terminali (cd .., cd ./folder) kabi qat'iy va mantiqiy nisbiy belgilarga tayanadi:

Belgisi Ma'nosi Vazifasi
.. Ota sahifaga chiqish Ierarxiya bo‘yicha bir pog‘ona yuqoridagi marshrutga qaytadi
../.. Bobo sahifaga chiqish Ierarxiya bo‘yicha ikki pog‘ona yuqoriga chiqadi
./edit yoki edit Bola sahifaga o‘tish Joriy sahifa ichidagi yangi ichki sahifaga kiradi

Manzillarning o'zgarish jadvali:

Aytaylik, siz hozir /dashboard/users/42 sahifasida turibsiz:

Nisbiy manzil Yakuniy manzil
to="./edit" /dashboard/users/42/edit
to=".." /dashboard/users
to="../.." /dashboard

2. <Link> orqali nisbiy o'tish

Sahifa ichida havolalar berishda nisbiy yo‘llar kodni o‘ta toza va qayta ishlatiluvchan qiladi:

// src/routes/dashboard/users/$userId.tsx
import { createFileRoute, Link } from '@tanstack/react-router'

export const Route = createFileRoute('/dashboard/users/$userId')({
  component: UserProfilePage,
})

function UserProfilePage() {
  const { userId } = Route.useParams()

  return (
    <div style={{ padding: '2rem' }}>
      <h2>Foydalanuvchi #{userId}</h2>

      <div style={{ display: 'flex', gap: '1rem', marginTop: '1.5rem' }}>
        {/* 1. Ichki sahifaga kirish: /dashboard/users/42/edit */}
        <Link to="./edit" style={{ color: '#2563eb' }}>
          Tahrirlash &rarr;
        </Link>

        {/* 2. Bir pog'ona yuqoriga — ro'yxatga qaytish: /dashboard/users */}
        <Link to=".." style={{ color: '#64748b' }}>
          &larr; Ro'yxatga qaytish
        </Link>

        {/* 3. Ikki pog'ona yuqoriga — dashboard boshiga: /dashboard */}
        <Link to="../.." style={{ color: '#64748b' }}>
          Asosiy panelga qaytish
        </Link>
      </div>
    </div>
  )
}

3. useNavigate orqali dasturiy nisbiy o'tish

Forma muvaffaqiyatli saqlangandan so‘ng foydalanuvchini avtomatik tarzda ota sahifaga qaytarish uchun navigate funksiyasida ham to: '..' ishlatiladi:

// src/routes/dashboard/users/$userId.edit.tsx
import { createFileRoute, useNavigate } from '@tanstack/react-router'

export const Route = createFileRoute('/dashboard/users/$userId/edit')({
  component: EditUserForm,
})

function EditUserForm() {
  const navigate = useNavigate()

  const handleSave = async (e: React.FormEvent) => {
    e.preventDefault()

    // 1. Ma'lumotlarni saqlaymiz
    await saveUserData()

    // 2. Muvaffaqiyatli saqlangach, bir pog'ona yuqoriga (profil sahifasiga) qaytamiz
    navigate({
      to: '..',
      // from: Route.fullPath berish orqali TypeScript qayerdan hisoblashni 100% aniq biladi
      from: Route.fullPath,
    })
  }

  return (
    <form onSubmit={handleSave}>
      <h3>Foydalanuvchini tahrirlash</h3>
      {/* Forma elementlari */}
      <button type="submit">Saqlash va qaytish</button>
      <button type="button" onClick={() => navigate({ to: '..', from: Route.fullPath })}>
        Bekor qilish
      </button>
    </form>
  )
}

async function saveUserData() {
  return Promise.resolve()
}

[!TIP] from: Route.fullPath nima uchun kerak? Komponent chuqur ichma-ich joylashgan bo‘lsa, from xossasini berish orqali TypeScript nisbiy hisoblashni aynan qaysi marshrutdan boshlashni aniq biladi va autocomplete mukammal ishlaydi.


4. Nisbiy navigatsiya ierarxiyasi (Mermaid Diagram)

flowchart LR
    Dashboard["/dashboard"]
    Users["/dashboard/users"]
    UserDetail["/dashboard/users/42"]
    Edit["/dashboard/users/42/edit"]

    UserDetail -- "to: '..'" --> Users
    UserDetail -- "to: '../..'" --> Dashboard
    UserDetail -- "to: './edit'" --> Edit
    Edit -- "to: '..'" --> UserDetail

5. React Router va TanStack Router taqqosi

Xususiyat React Router TanStack Router
Nisbiy rejimlar relative="path" va relative="route" o‘rtasida chalkashliklar Route Tree tuzilishi asosida tabiiy va yagona standart
Type-Safety Nisbiy yo‘llar to‘liq tiplanmagan (xom string) from orqali to‘liq tekshiriladi va autocomplete qilinadi
Layout routes bilan ishlash Pathless layoutlar ba'zan .. o‘tishlarini buzib qo‘yadi Ierarxiya mantiqiy Route Tree bo‘yicha to‘g‘ri hisoblanadi
Dasturiy navigatsiya navigate('..') (ba'zida kutilmagan manzilga o‘tadi) navigate({ to: '..', from: Route.fullPath })

Xulosa

  • Relative Navigation — joriy marshrutga nisbatan qisqa va qulay harakatlanish imkonini beradi.
  • .. belgisi ota sahifaga qaytish uchun, ./child esa ichki bola sahifaga o‘tish uchun ishlatiladi.
  • TanStack Router’da nisbiy o‘tishlar Route Tree ierarxiyasiga asoslangani uchun layout va dinamik parametrlarda hech qachon chalkashlik keltirib chiqarmaydi.