Seriya: React Basics Dars 5

React loyiha strukturasi — src, public, main.tsx, App.tsx va index.html vazifalari

Zamonaviy React loyihasining papka va fayl tuzilishi, har bir qismning vazifasi va restoran analogiyasi.

5-dars

React loyiha strukturasi — src, public, main.tsx, App.tsx va index.html vazifalari

Zamonaviy React loyihasini (odatda Vite yoki Create React App yordamida) yaratganingizda, sizga oldindan tayyorlangan fayllar va papkalar to'plami beriladi. Bu tartib barcha kodlarni bir joyga tiqib yubormasdan, ularni mantiqiy guruhlash uchun xizmat qiladi.

Tipik React (Vite) loyiha strukturasi:

my-react-app/
├── public/
│   └── favicon.svg
├── src/
│   ├── assets/
│   ├── App.tsx
│   ├── main.tsx
│   └── index.css
├── index.html
├── package.json
└── vite.config.js

Keling, eng muhim qismlarning vazifalarini birma-bir ko'rib chiqamiz:

1. public/ papkasi

Bu papka to'g'ridan-to'g'ri o'zgartirilmasdan (processing qilmasdan) foydalanuvchiga taqdim etiladigan statik fayllar (favicon, logotiplar, shriftlar, robots.txt) uchun mo'ljallangan.

Vazifasi: Bu yerdagi fayllarga dastur kodidan to'g'ridan-to'g'ri root havolasi (/favicon.svg) orqali murojaat qilish mumkin.

2. index.html fayli

Bu SPA (Single Page Application) uchun yagona asosiy HTML sahifa hisoblanadi.

Vazifasi: Ichida boshqa sahifalar yo'q, faqat bitta muhim element bor — div id si root bo'lgan qism:

<div id="root"></div>

Butun React ilovangiz ana shu kichkina root degan id ichiga "o'rnashadi" (render bo'ladi).

3. src/ (Source) papkasi

Siz yozadigan barcha kodlar, komponentlar, uslublar va mantiqiy qismlar shu papka ichida saqlanadi. Loyihaning yuragi aynan shu yerda uradi.

4. main.tsx (yoki index.js) fayli

Bu fayl React ilovangizning kirish eshigi (entry point) hisoblanadi.

Vazifasi: U index.html dagi <div id="root"></div> elementini topadi va asosiy App komponentini shu div ichiga joylab (mount qilib) beradi.

Misol:

import React from 'react'
import ReactDOM from 'react-dom/client'
import App from './App.tsx'

ReactDOM.createRoot(document.getElementById('root')!).render(
  <React.StrictMode>
    <App />
  </React.StrictMode>,
)

5. App.tsx (yoki App.jsx) fayli

Bu sizning ilovangizning boshlang'ich (root) komponenti.

Vazifasi: Barcha boshqa quyi komponentlar (menyular, tugmalar, sahifalar) shu App komponenti ichida yig'iladi. Uni boshqa uy qurishdagi "asosiy zal" deb tasavvur qilsangiz bo'ladi — qolgan barcha xonalar shu zalga ulanadi.

Real hayotiy misol: Restoran analogiyasi

React loyiha strukturasini restoran binosiga o'xshatish mumkin:

index.html — Restoranning asosiy binosi va bosh kirish eshigi.

main.tsx — Menejer: u binoga kelgan mehmonlarni qayerga o'tqizishni (root elementga) boshqaradi.

App.tsx — Restoranning bosh zali: bu yerdan oshxona, bar va stollar ko'rinib turadi, hamma narsa shu yerdan boshlanadi.

src/ — Oshxona va xodimlar xonasi (barcha asosiy ishlar va tayyorgarliklar ketadigan joy).

public/ — Restoranning tashqi peshlavhasi va menyu qog'ozlari (hech qanday o'zgarishsiz mijozga ko'rsatiladigan tayyor narsalar).