Seriya: React Router Dars 14

React Router o‘rnatish — Vite + React + TypeScript loyihasiga ulash

Vite + React + TypeScript loyihasiga react-router-dom paketini o'rnatish, BrowserRouter provayderini main.tsx orqali ulash va paketdagi tayyor TypeScript turlari.

14-dars

React Router o‘rnatish — Vite + React + TypeScript loyihasiga ulash

Tasavvur qiling, siz yangi uy quryapsiz. Xonadon bo'ylab chiroqlar, muzlatkich va televizorlar ishlashi uchun avvalo uyning kiraverishiga markaziy elektr taqsimlash qutisini (shchit) o'rnatishingiz va asosiy tok kabelini ulashingiz kerak. Shundan so'ngгина barcha rozetkalar quvvat oladi.

React loyihasiga React Routerni ulash ham xuddi shunday jarayon: kutubxonani o'rnatib, ilovaning eng yuqori nuqtasiga "markaziy quti" — <BrowserRouter> ni o'rnatib qo'ysangiz, butun ilovangiz bo'ylab marshrutlash tizimi hayotga kiradi.


react-router vs react-router-dom: Qaysi birini o'rnatamiz?

Ko'p yangi o'rganuvchilar paket nomida adashishadi:

  • react-router: Marshrutlashning asosiy mantiqiy yadrosi (Core). U brauzerga bog'lanmagan (masalan, React Native uchun ham ishlaydi).
  • react-router-dom: Veb-brauzerlar uchun mo'ljallangan to'liq to'plam. U o'z ichiga HTML5 History API, <BrowserRouter>, <Link>, <NavLink> kabi brauzer komponentlarini oladi va asosiy react-router yadrosini ham avtomatik o'rnatib beradi.

[!IMPORTANT] Veb-ilovalarda (Vite, Create React App) biz doimo react-router-dom paketini o'rnatamiz!


1-Qadam: Kutubxonani o'rnatish

Loyihangiz terminalida quyidagi buyruqni ishga tushirasiz:

# NPM orqali
npm install react-router-dom

# Yoki PNPM orqali
pnpm add react-router-dom

# Yoki Yarn orqali
yarn add react-router-dom

TypeScript turlari (Types):

React Router v6 zamonaviy TypeScript'da yozilgan. Shu sababli alohida @types/react-router-dom paketini qidirib o'rnatish shart emas — barcha turlar va interfeyslar paketning o'zida tayyor holda keladi!


2-Qadam: main.tsx da <BrowserRouter> ni ulash

Vite + React loyihalarida butun dasturning kirish eshigi src/main.tsx faylidir. Biz barcha quyi komponentlar marshrutlash ma'lumotlaridan foydalana olishi uchun eng yuqori pog'onada <BrowserRouter> provayderini ulaymiz:

// src/main.tsx
import React from 'react';
import ReactDOM from 'react-dom/client';
import { BrowserRouter } from 'react-router-dom'; // 1. Import qilamiz
import App from './App.tsx';
import './index.css';

ReactDOM.createRoot(document.getElementById('root')!).render(
  <React.StrictMode>
    {/* 2. Butun ilovani BrowserRouter bilan o'raymiz */}
    <BrowserRouter>
      <App />
    </BrowserRouter>
  </React.StrictMode>,
);

Nega aynan main.tsx da o'rash tavsiya etiladi?

Ba'zi dasturchilar <BrowserRouter> ni App.tsx faylining ichiga qo'yishadi. Biroq uni eng yuqorida — main.tsx da o'rash eng to'g'ri amaliyot (Best Practice) hisoblanadi:

  1. App.tsx ning o'zida ham hook'larni ishlatish mumkin bo'ladi: Agar sizga App.tsx darajasida useLocation() yoki useNavigate() kerak bo'lib qolsa, u xatosiz ishlayveradi.
  2. Sinov va testlar (Testing) qulayligi: Ilova tuzilishi modulli va toza bo'ladi.

3-Qadam: Birinchi sinov (Tezkor tekshirish)

O'rnatish muvaffaqiyatli bo'lganini bilish uchun src/App.tsx faylida birinchi oddiy marshrutlarni yozib ko'ramiz:

// src/App.tsx
import React from 'react';
import { Routes, Route, Link } from 'react-router-dom';

function Home() {
  return <h2>🏠 Bosh sahifaga xush kelibsiz!</h2>;
}

function About() {
  return <h2>ℹ️ Biz haqimizda ma'lumot</h2>;
}

export default function App() {
  return (
    <div style={{ padding: '20px', fontFamily: 'sans-serif' }}>
      <nav style={{ display: 'flex', gap: '12px', marginBottom: '16px' }}>
        <Link to="/">Bosh sahifa</Link>
        <Link to="/about">Biz haqimizda</Link>
      </nav>

      <hr />

      <Routes>
        <Route path="/" element={<Home />} />
        <Route path="/about" element={<About />} />
      </Routes>
    </div>
  );
}

Brauzerda npm run dev orqali ochib ko'rsangiz, havolalarni bosganda sahifa umuman qayta yuklanmasdan (no full reload), silliq tarzda almashayotganiga guvoh bo'lasiz!


Eng ko'p uchraydigan xatolik: "useNavigate() may be used only in the context of a <Router> component"

[!CAUTION] Xatolik mazmuni: Agar siz useNavigate(), useLocation(), useParams() yoki <Link> komponentlarini <BrowserRouter> o'ramidan tashqarida chaqirib qo'ysangiz, React Router qizarib qulaydi:

Error: useNavigate() may be used only in the context of a <Router> component.

Yechimi: Barcha router komponentlari va hook ishlatayotgan qismlar doimo <BrowserRouter> teglari ichida joylashgan bo'lishi shart!


Xulosa

Vite + React + TypeScript loyihasiga React Router'ni o'rnatish atigi 2 ta qadamdan iborat: npm install react-router-dom buyrug'i va main.tsx da <BrowserRouter> bilan ilovani o'rash. Poydevor tayyor bo'lgach, keyingi darslarda React Router taqdim etadigan barcha zamonaviy imkoniyatlarni bosqichma-bosqich o'rganishga o'tamiz!