Custom Hooks — Wiederverwendbare Logik kapseln
In diesem Kapitel lernst du React-Best-Practices kennen — den Einsatz benutzerdefinierter Hooks zum Kapseln wiederverwendbarer Logik, wodurch Komponenten sauberer und einfacher zu warten werden.
Was ist ein benutzerdefinierter Hook?
Wenn der Funktionsumfang wächst, sind useState und useEffect über Komponenten verstreut, und zwischen verschiedenen Komponenten gibt es duplizierte Logik.
Benutzerdefinierter Hookextrahiert die kombinierte Logik mehrerer Hooks in eine Funktion, die mit "use" beginnt.
Sein Wesen:Eine reguläre JS-Funktion, die intern React-Hooks verwendet.。
Warum brauchst du benutzerdefinierte Hooks?
| Ohne benutzerdefinierte Hooks | Mit benutzerdefinierten Hooks |
|---|---|
| Jede Komponente schreibt ihre eigene Fetch- + Filter-Logik | Ein usePosts() wird überall wiederverwendet |
| Datenlogik und UI-Logik sind miteinander vermischt | Datenlogik ist unabhängig, Komponenten kümmern sich nur um die UI |
| Das Ändern eines Teils der Logik erfordert das Ändern mehrerer Dateien | Ändere eine Stelle, alle Komponenten aktualisieren sich synchron |
| Komponenten überschreiten oft 200+ Zeilen | Komponenten sind normalerweise < 80 Zeilen |
Namenskonventionen und Hook-Regeln
| Regel | Beschreibung | Beispiel |
|---|---|---|
withusePräfix | React nutzt dies, um Hooks zu erkennen und Lint-Regeln anzuwenden | usePosts、useDarkMode |
| Im hooks/-Verzeichnis ablegen | Für einfaches Nachschlagen und Wartung | src/hooks/usePosts.js |
| Kann nur auf der obersten Ebene von Funktionskomponenten aufgerufen werden | Kann nicht innerhalb von Bedingungen, Schleifen oder verschachtelten Funktionen aufgerufen werden | — |
| Daten oder Methoden zurückgeben | Dem Aufrufer den Zugriff auf den State und die Logik innerhalb des Hooks ermöglichen | return { data, isLoading } |
Regeln für die Verwendung von Hooks: 1. Hooks nur auf der obersten Ebene von Funktionskomponenten aufrufen; 2. Hooks nur in React-Funktionen aufrufen (Funktionskomponenten oder benutzerdefinierte Hooks). Dies stellt sicher, dass die Reihenfolge der Hook-Aufrufe bei jedem Rendern konsistent ist.
usePosts — Kapselung der Post-Daten-Logik
Beispiel
import { useState, useEffect, useMemo } from 'react'
export function usePosts() {
const [articles, setArticles] = useState([])
const [isLoading, setIsLoading] = useState(true)
const [error, setError] = useState(null)
const [activeCategory, setActiveCategory] = useState('Alle')
const [keyword, setKeyword] = useState('')
// Daten laden
useEffect(() => {
let cancelled = false
async function fetchPosts() {
setIsLoading(true)
setError(null)
try {
const res = await fetch('/posts.json')
if (!res.ok) throw new Error(`HTTP ${res.status}`)
const data = await res.json()
if (!cancelled) setArticles(data)
} catch (err) {
if (!cancelled) setError(err.message)
} finally {
if (!cancelled) setIsLoading(false)
}
}
fetchPosts()
return () => { cancelled = true }
}, [])
// Alle Kategorien extrahieren
const categories = useMemo(() => {
return ['Alle', ...new Set(articles.map(a => a.category))]
}, [articles])
// Nach Kategorie + Stichwort filtern
const filteredArticles = useMemo(() => {
let result = articles
if (activeCategory !== 'All') {
result = result.filter(a => a.category === activeCategory)
}
if (keyword.trim()) {
const kw = keyword.trim().toLowerCase()
result = result.filter(a =>
a.title.toLowerCase().includes(kw) ||
a.summary.toLowerCase().includes(kw)
)
}
return result
}, [articles, activeCategory, keyword])
// Beitrag nach ID finden
function getArticleById(id) {
return articles.find(a => a.id === Number(id))
}
// Neu laden
function refetch() {
// Eine andere Möglichkeit, useEffect auszulösen: einen Key verwenden oder den State erweitern
window.location.reload()
}
return {
articles, isLoading, error,
activeCategory, setActiveCategory,
keyword, setKeyword,
categories,
filteredArticles,
getArticleById,
refetch
}
}
Startseite mit usePosts
Beispiel
import { usePosts } from '../hooks/usePosts'
import BlogCard from '../components/BlogCard'
import CategoryFilter from '../components/CategoryFilter'
function HomePage() {
// Alle beitragsbezogenen Daten und Operationen mit einer Zeile Code abrufen
const {
isLoading, error,
activeCategory, setActiveCategory,
keyword, setKeyword,
categories,
filteredArticles,
refetch
} = usePosts()
if (isLoading) return <p className="status-msg">Wird geladen...</p>
if (error) return (
<div className="status-msg error">
<p>Laden fehlgeschlagen:{error}</p>
<button onClick={refetch}>Erneut versuchen</button>
</div>
)
return (
<div>
<h2 className="section-title">Neueste Beiträge</h2>
<div className="search-bar">
<input
type="text"
value={keyword}
onChange={e => setKeyword(e.target.value)}
placeholder="Nach Beitragstiteln oder Zusammenfassungen suchen..."
className="search-input"
/>
{keyword && <span className="clear-btn" onClick={() => setKeyword('')}>✕</span>}
</div>
<CategoryFilter
categories={categories}
activeCategory={activeCategory}
onCategoryChange={setActiveCategory}
/>
<p className="result-info">common{filteredArticles.length}Artikel</p>
{filteredArticles.length === 0 ? (
<p className="empty-tip">Keine passenden Beiträge</p>
) : (
<div className="article-grid">
{filteredArticles.map(article => (
<BlogCard key={article.id} {...article} />
))}
</div>
)}
</div>
)
}
export default HomePage
Detailseite mit usePosts
Beispiel
import { useParams, Link } from 'react-router-dom'
import { usePosts } from '../hooks/usePosts'
function PostPage() {
const { id } = useParams()
const { isLoading, error, getArticleById } = usePosts()
const article = getArticleById(id)
if (isLoading) return <p className="status-msg">Wird geladen...</p>
if (error) return <p className="status-msg error">Laden fehlgeschlagen:{error}</p>
if (!article) {
return (
<div className="not-found">
<h2>Beitrag nicht gefunden</h2>
<Link to="/">Zurück zur Startseite</Link>
</div>
)
}
return (
<article className="post-view">
<span className="category-tag">{article.category}</span>
<h1>{article.title}</h1>
<time>{article.date}</time>
<div className="content" dangerouslySetInnerHTML={{ __html: article.content }} />
<Link to="/" className="back-link">← Zurück zur Startseite</Link>
</article>
)
}
export default PostPage
Hinweis: Wenn der Benutzer direkt die URL der Detailseite aufruft (z. B. beim Aktualisieren der Seite), ruft usePosts die Daten erneut ab. Dies ist korrektes Verhalten — denn die usePosts-Instanz auf der Startseite und die usePosts-Instanz auf der Detailseite sind unabhängig und rufen jeweils ihr eigenes useEffect auf.
useDarkMode — Mit einer Zeile Code in den Dunkelmodus wechseln
Beispiel
import { useState, useEffect } from 'react'
export function useDarkMode() {
// Vorherige Einstellung aus localStorage lesen
const [isDark, setIsDark] = useState(() => {
return localStorage.getItem('blog-theme') === 'dark'
})
// Wenn sich isDark ändert, mit DOM und localStorage synchronisieren
useEffect(() => {
if (isDark) {
document.documentElement.classList.add('dark')
localStorage.setItem('blog-theme', 'dark')
} else {
document.documentElement.classList.remove('dark')
localStorage.setItem('blog-theme', 'light')
}
}, [isDark])
function toggleDark() {
setIsDark(!isDark)
}
return { isDark, toggleDark }
}
Verwendung in NavBar:
Beispiel
import { useDarkMode } from '../hooks/useDarkMode'
function NavBar() {
const { isDark, toggleDark } = useDarkMode()
return (
<header className="navbar">
<a href="/" className="logo">BEISPIEL Blog</a>
<nav>
<a href="/">Startseite</a>
<button className="theme-btn" onClick={toggleDark}>
{isDark ? '☀ Hell' : '☾ Dunkel'}
</button>
</nav>
</header>
)
}
export default NavBar
Implementierung des Theme-Wechsels mit CSS-Variablen
Beispiel
/* Heller Modus (Standard) */
:root {
--bg-primary: #f5f5f5;
--bg-card: #ffffff;
--text-primary: #333333;
--text-secondary: #666666;
--border-color: #eeeeee;
}
/* Dunkler Modus */
html.dark {
--bg-primary: #1a1a2e;
--bg-card: #16213e;
--text-primary: #e0e0e0;
--text-secondary: #a0a0a0;
--border-color: #2a2a4a;
}
body {
background: var(--bg-primary);
color: var(--text-primary);
}
.card, .article-card {
background: var(--bg-card);
border: 1px solid var(--border-color);
}
React Custom Hooks vs Vue3 Composables
| Merkmal | React Custom Hook | Vue3 Composable |
|---|---|---|
| Namenskonvention | Beginnt mit "use" | Beginnt mit "use" |
| Wesen | Eine Funktion, die React Hooks verwendet | Eine Funktion, die Vue3 APIs verwendet |
| Reaktivität | Wird über den von useState zurückgegebenen Setter ausgelöst | Automatisch verfolgt über ref/reactive |
| Aufrufbeschränkung | Nur auf der obersten Ebene von Funktionskomponenten | Nur auf der obersten Ebene von <script setup> |
| Nebeneffekte | useEffect | watch / watchEffect / onMounted |
Kapitelzusammenfassung
In diesem Kapitel hast du das wichtigste Entwurfsmuster von React gemeistert – benutzerdefinierte Hooks: beginnend mit "use", die intern mehrere React-Hooks kombinieren und Status und Operationen zurückgeben.
usePosts verwaltet zentral das Laden von Daten + Filtern + Suchen, und useDarkMode ermöglicht die Dark-Mode-Integration mit einer Zeile Code. Komponenten kümmern sich jetzt nur noch um das UI-Rendering.
Andere Erweiterungen