React-Blogprojekt

Dieses Kapitel führt Sie von Grund auf durch die Erstellung eines React-Blog-Projekts mit Vite und vermittelt JSX-Syntax und Projektstruktur.


Umgebungs-Setup

Bevor Sie beginnen, stellen Sie sicher, dass Node.js auf Ihrem Computer installiert ist (v16 oder höher empfohlen).

Node.js ist eine JavaScript-Laufzeitumgebung und npm ist der integrierte Paketmanager.

Prüfen, ob Node.js installiert ist

$ node -v
v20.10.0

Wenn eine Versionsnummer angezeigt wird, bedeutet das, dass es installiert ist.

Wenn nicht, gehen Sie zunodejs.org, laden Sie die LTS-Version herunter und installieren Sie sie.


Ein React-Projekt erstellen

Vite ist derzeit eines der schnellsten Front-End-Build-Tools und bietet native Unterstützung für React.

Gehen Sie im Terminal in das Verzeichnis, in dem Sie das Projekt speichern möchten, und führen Sie aus:

$ npm create vite@latest blog-app -- --template react

Dieser Befehl weist Vite an, ein Projekt namens blog-app mit der React-Vorlage zu erstellen.

Wechseln Sie in das Projektverzeichnis, installieren Sie die Abhängigkeiten und starten Sie den Entwicklungsserver:

$ cd blog-app
$ npm install
$ npm run dev

Der Browser öffnet automatisch http://localhost:5173. Wenn Sie die standardmäßige Vite + React-Willkommensseite sehen, bedeutet das, dass das Projekt erfolgreich gestartet wurde.

Wenn beim Start ein Fehler über fehlende Abhängigkeiten gemeldet wird, versuchen Sie Folgendes auszuführennpm installund führen Sie es dann erneut aus.


Projektverzeichnisstruktur erklärt

Wenn Sie den Ordner blog-app öffnen, sehen Sie die folgende Struktur:

blog-app/
├── index.html              # 入口 HTML 文件
├── package.json            # 项目配置与依赖列表
├── vite.config.js          # Vite 构建工具配置
├── public/                 # 不经过编译的静态资源
├── src/
│   ├── main.jsx            # JS 入口,将 React 组件挂载到 DOM
│   ├── App.jsx             # 根组件,所有页面的外壳
│   ├── App.css             # App 组件的样式
│   ├── index.css           # 全局样式
│   └── assets/             # 需要编译的静态资源(图片等)

Zweck der Kerndateien

index.html— Die vom Browser aufgerufene Einstiegsdatei.

Sie enthält ein<div id="root"></div>, und die React-App wird auf dieses div gemountet.

src/main.jsx— Die Startdatei der React-App.

Sie ist für das Auffinden verantwortlich#rootElement, und danncreateRoothold<App />Komponente, die darin gerendert werden soll.

Beispiel

// Dateipfad: src/main.jsx
import React from 'react'
import ReactDOM from 'react-dom/client'
import App from './App.jsx'
import './index.css'

// Finde das <div id="root"></div> in HTML
// Verwende createRoot, um einen React-Root-Knoten zu erstellen, und rendere dann <App /> darin
ReactDOM.createRoot(document.getElementById('root')).render(
  <React.StrictMode>
    <App />
  </React.StrictMode>
)

src/App.jsx— Die Root-Komponente.

Es ist der äußerste Container aller Seiten, und das JSX, das es zurückgibt, wird auf der Seite gerendert.

<React.StrictMode>Es ist der Strict Mode von React, nur in der Entwicklung aktiv. Er führt zusätzliche Prüfungen an Komponenten durch (z. B. doppeltes Rendern), um dir zu helfen, potenzielle Probleme zu finden. In Produktions-Builds wird er automatisch ignoriert.


Was ist JSX?

JSXEs ist eine Syntaxerweiterung von JavaScript, mit der du HTML-ähnlichen Code in JS schreiben kannst.

Eine React-Komponente ist im Wesentlichen eine Funktion, die JSX zurückgibt.

Wichtige Unterschiede zwischen JSX und HTML

SzenarioHTMLJSX
class-Attributclass="container"className="container"
Selbstschließende Tags<img src="....html"><img src="....html" />
Einbetten von JS-AusdrückenNicht unterstützt<h1>{title}</h1>
style-Attributstyle="color: red"style={{ color: 'red' }}
Kommentare<!-- comment -->{/* comment */}
Event-Bindungonclick="fn()"onClick={fn}

Warum verwendenclassNameanstelle vonclass? Denn JSX ist im Wesentlichen JavaScript, undclassist ein reserviertes Schlüsselwort in JS. Ähnlich,forändern zuhtmlFor。

Beispiel

// JSX ist dieser HTML-ähnliche Code nach return
function Greeting() {
  const name = 'EXAMPLE'
  const isLoggedIn = true

  return (
    <div className="greeting">
      {/* JSX-Kommentar: Jeden beliebigen JS-Ausdruck in geschweifte Klammern setzen */}
      <h1>Hallo, {name}!</h1>
      <p>Aktuelle Zeit:{new Date().toLocaleDateString()}</p>
      {isLoggedIn && <p>Willkommen zurück!</p>}
    </div>
  )
}

Denke an die Kernregel:In JSX kannst du jeden JS-Ausdruck in geschweifte Klammern setzen— Variablen, Funktionsaufrufe, ternäre Operationen und Array-Map funktionieren alle.


React-Komponenten = Funktionen

Die Essenz einer React-Funktionskomponente ist:Eine Funktion, die props als Parameter entgegennimmt und ein Stück JSX zurückgibt。

Beispiel

// Definiere eine Komponente: Sie ist eine Funktion, die JSX zurückgibt
// Komponentennamen müssen mit einem Großbuchstaben beginnen
function BlogHeader() {
  return (
    <header>
      <h1>BEISPIEL Blog</h1>
    </header>
  )
}

// Eine Komponente verwenden: Schreiben Sie sie wie ein HTML-Tag; sowohl selbstschließend als auch mit Paar-Tags funktioniert beides
function App() {
  return (
    <div>
      <BlogHeader />
      <main>
        <p>Blog-Inhalt wird hier angezeigt</p>
      </main>
    </div>
  )
}

export default App

Komponentennamen müssenmit einem Großbuchstaben beginnen. Ein Beginn mit einem Kleinbuchstaben wird von React als normales HTML-Tag behandelt (div, span usw.), während ein Beginn mit einem Großbuchstaben als benutzerdefinierte Komponente behandelt wird.


Praktische Übung: Vorlage leeren und das Blog-Grundgerüst schreiben

Leeren Sie die Inhalte der standardmäßig generierten App.jsx und App.css und ersetzen Sie sie durch die grundlegende Blog-Struktur.

Beispiel

// Dateipfad: src/App.jsx
import './App.css'

function App() {
  return (
    <div className="app">
      {/* Obere Navigationsleiste */}
      <header className="navbar">
        <h1 className="logo">BEISPIEL Blog</h1>
        <nav>
          <a href="/">Startseite</a>
          <a href="#">Über</a>
        </nav>
      </header>

      {/* Hauptinhaltsbereich */}
      <main className="container">
        <p>Blog-Inhalt wird hier angezeigt</p>
      </main>

      {/* Fußzeile */}
      <footer className="footer">
        <p>© 2024 BEISPIEL Blog. Betrieben mit React.</p>
      </footer>
    </div>
  )
}

export default App

Beispiel

/* Dateipfad: src/App.css */
* {
  margin: 0;
  padding: 0;
  box-sizing: border-box;
}

body {
  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
  background: #f5f5f5;
  color: #333;
}

/* Navigationsleiste */
.navbar {
  display: flex;
  justify-content: space-between;
  align-items: center;
  padding: 16px 40px;
  background: #fff;
  box-shadow: 0 2px 8px rgba(0,0,0,0.1);
}

.logo {
  font-size: 24px;
  color: #61dafb;
}

.navbar nav a {
  margin-left: 20px;
  text-decoration: none;
  color: #333;
}

/* Hauptinhaltsbereich */
.container {
  max-width: 960px;
  margin: 40px auto;
  padding: 0 20px;
}

/* Fußzeile */
.footer {
  text-align: center;
  padding: 20px;
  color: #999;
  border-top: 1px solid #eee;
}

Nach dem Speichern wird der Browser automatisch aktualisiert, und Sie sehen ein sauberes Blog-Grundgerüst: obere Navigationsleiste + mittlerer Inhaltsbereich + unterer Footer.


Kapitelzusammenfassung

In diesem Kapitel haben Sie drei Dinge erreicht: ein React-Projekt mit Vite erstellt, die wichtigsten Unterschiede zwischen JSX und HTML verstanden und das grundlegende JSX-Grundgerüst des Blogs geschrieben.

Die wichtigsten Erkenntnisse: Eine React-Komponente ist eine Funktion, die JSX zurückgibt, und in JSX können Sie jeden beliebigen JS-Ausdruck in geschweiften Klammern einbetten.

Andere Erweiterungen