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 →
</Link>
</article>
)
}
[!CAUTION] Agar siz
to="/posts/$postId"deb yozib, lekinparamspropini berishni esdan chiqarsangiz, TypeScript loyihanibuildqilishga 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: <Link to='/posts/$postId' params={{ postId: '42' }} />"]
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. activePropsorqali faol sahifalar uchun CSS sinflar va uslublar qo‘shimcha wrapperlarsiz oson belgilanadi.