React ブログプロジェクト
この章では、ゼロから Vite を使って React ブログプロジェクトを作成し、JSX 構文とプロジェクト構造を理解します。
環境準備
始める前に、コンピューターに Node.js(v16 以上推奨)がインストールされていることを確認してください。
Node.js は JavaScript の実行環境であり、npm はその標準パッケージマネージャーです。
Node.js がインストールされているか確認
$ node -v v20.10.0
バージョン番号が表示されれば、インストールされています。
ない場合は、次の場所へ移動してください:nodejs.orgLTS バージョンをダウンロードしてインストールします。
React プロジェクトを作成
Vite は現在最も高速なフロントエンドビルドツールの一つで、React をネイティブにサポートしています。
ターミナルでプロジェクトを保存したいディレクトリに移動し、次を実行します:
$ npm create vite@latest blog-app -- --template react
このコマンドは Vite に、blog-app という名前のプロジェクトを React テンプレートで作成するよう指示します。
プロジェクトディレクトリに移動し、依存関係をインストールして開発サーバーを起動します:
$ cd blog-app $ npm install $ npm run dev
ブラウザが自動的に http://localhost:5173 を開き、Vite + React のデフォルトのウェルカムページが表示されれば、プロジェクトの起動は成功です。
起動時に依存関係が不足しているというエラーが表示された場合は、次を実行してみてください:
npm installその後、再実行します。
プロジェクトディレクトリ構造の詳細
blog-app フォルダーを開くと、以下の構造が表示されます:
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/ # 需要编译的静态资源(图片等)
主要ファイルの役割
index.html— ブラウザがアクセスするエントリーファイル。
その中には<div id="root"></div>、React アプリはこの div にマウントされます。
src/main.jsx— React アプリの起動ファイル。
それは#root要素を見つけて、次にcreateRootを<App />コンポーネントをレンダリングします。
実例
import React from 'react'
import ReactDOM from 'react-dom/client'
import App from './App.jsx'
import './index.css'
// HTML 内の <div id="root"></div> を見つける
// createRoot で React ルートノードを作成し、<App /> をレンダリングする
ReactDOM.createRoot(document.getElementById('root')).render(
<React.StrictMode>
<App />
</React.StrictMode>
)
src/App.jsx— ルートコンポーネント。
これはすべてのページの最外層コンテナであり、返された JSX がページにレンダリングされます。
<React.StrictMode>StrictMode StrictMode は React の StrictMode で、開発環境でのみ有効です。コンポーネントに対して追加のチェック(例:重複レンダリング)を行い、潜在的な問題を発見するのに役立ちます。本番ビルドでは自動的に無視されます。
JSX とは?
JSXは JavaScript の構文拡張であり、JS 内で HTML に似たコードを書くことができます。
React コンポーネントは本質的には JSX を返す関数です。
JSX と HTML の主な違い
| シナリオ | HTML | JSX |
|---|---|---|
| class 属性 | class="container" | className="container" |
| 自己終了タグ | <img src="....html"> | <img src="....html" /> |
| JS 式の埋め込み | サポートしない | <h1>{title}</h1> |
| style 属性 | style="color: red" | style={{ color: 'red' }} |
| コメント | <!-- コメント --> | {/* コメント */} |
| イベントバインド | onclick="fn()" | onClick={fn} |
なぜ使うのか
classNameではなくclass?なぜなら JSX は本質的に JavaScript であり、一方classは JS の予約語です。同様に、forは ... に変更します。htmlFor。
実例
function Greeting() {
const name = 'サンプル'
const isLoggedIn = true
return (
<div className="greeting">
{/* JSX コメント:波括弧内には任意の JS 式を置ける */}
<h1>Hello, {name}!</h1>
<p>現在時刻:{new Date().toLocaleDateString()}</p>
{isLoggedIn && <p>おかえりなさい!</p>}
</div>
)
}
核心ルールを覚えてください:JSX の波括弧内には任意の JS 式を置けます——変数、関数呼び出し、三項演算、配列の map なども可能です。
React コンポーネント = 関数
React 関数コンポーネントの本質は:props を引数として受け取り、JSX を返す関数です。
実例
// コンポーネント名は大文字で始める必要があります
function BlogHeader() {
return (
<header>
<h1>サンプル Blog</h1>
</header>
)
}
// コンポーネントの使用:HTML タグのように書き、自己終了またはペアのどちらでも可
function App() {
return (
<div>
<BlogHeader />
<main>
<p>ブログの内容はここに表示されます</p>
</main>
</div>
)
}
export default App
コンポーネント名は必ず大文字で始める必要があります。小文字で始まると React は通常の HTML タグ(div、span など)と見なし、大文字で始まるとカスタムコンポーネントとして処理します。
実践:テンプレートを空にしてブログの骨組みを書く
デフォルトで生成された App.jsx と App.css の内容を消して、ブログの基本構造に置き換えます。
実例
import './App.css'
function App() {
return (
<div className="app">
{/* 上部ナビゲーションバー */}
<header className="navbar">
<h1 className="logo">サンプル Blog</h1>
<nav>
<a href="/">ホーム</a>
<a href="#">について</a>
</nav>
</header>
{/* メインコンテンツ領域 */}
<main className="container">
<p>ブログの内容はここに表示されます</p>
</main>
{/* フッター */}
<footer className="footer">
<p>© 2024 サンプル Blog. Powered by React.</p>
</footer>
</div>
)
}
export default App
実例
* {
margin: 0;
padding: 0;
box-sizing: border-box;
}
body {
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
background: #f5f5f5;
color: #333;
}
/* ナビゲーションバー */
.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;
}
/* メインコンテンツ領域 */
.container {
max-width: 960px;
margin: 40px auto;
padding: 0 20px;
}
/* フッター */
.footer {
text-align: center;
padding: 20px;
color: #999;
border-top: 1px solid #eee;
}
保存すると、ブラウザは自動的にリフレッシュされ、上部ナビゲーションバー + 中央コンテンツ領域 + 下部フッターというクリーンなブログの骨組みが表示されます。
本章のまとめ
この章では、3つのことを達成しました:Vite で React プロジェクトを作成し、JSX と HTML の主な違いを理解し、ブログの基本 JSX 骨組みを書きました。
核心的な収穫:React コンポーネントは JSX を返す関数であり、JSX の波括弧内には任意の JS 式を埋め込めます。
その他の拡張