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 →
</Link>
{/* 2. Bir pog'ona yuqoriga — ro'yxatga qaytish: /dashboard/users */}
<Link to=".." style={{ color: '#64748b' }}>
← 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.fullPathnima uchun kerak? Komponent chuqur ichma-ich joylashgan bo‘lsa,fromxossasini 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,./childesa 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.