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 HooksMit benutzerdefinierten Hooks
Jede Komponente schreibt ihre eigene Fetch- + Filter-LogikEin usePosts() wird überall wiederverwendet
Datenlogik und UI-Logik sind miteinander vermischtDatenlogik 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+ ZeilenKomponenten sind normalerweise < 80 Zeilen

Namenskonventionen und Hook-Regeln

RegelBeschreibungBeispiel
withusePräfixReact nutzt dies, um Hooks zu erkennen und Lint-Regeln anzuwendenusePosts、useDarkMode
Im hooks/-Verzeichnis ablegenFür einfaches Nachschlagen und Wartungsrc/hooks/usePosts.js
Kann nur auf der obersten Ebene von Funktionskomponenten aufgerufen werdenKann nicht innerhalb von Bedingungen, Schleifen oder verschachtelten Funktionen aufgerufen werden—
Daten oder Methoden zurückgebenDem Aufrufer den Zugriff auf den State und die Logik innerhalb des Hooks ermöglichenreturn { 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

// Dateipfad: src/hooks/usePosts.js
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

// Dateipfad: src/pages/HomePage.jsx
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

// Dateipfad: src/pages/PostPage.jsx
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

// Dateipfad: src/hooks/useDarkMode.js
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

// Dateipfad: src/components/NavBar.jsx
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 ? '&#x2600; Hell' : '☾ Dunkel'}
        </button>
      </nav>
    </header>
  )
}

export default NavBar

Implementierung des Theme-Wechsels mit CSS-Variablen

Beispiel

/* Dateipfad: src/index.css (globale Stile) */
/* 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

MerkmalReact Custom HookVue3 Composable
NamenskonventionBeginnt mit "use"Beginnt mit "use"
WesenEine Funktion, die React Hooks verwendetEine Funktion, die Vue3 APIs verwendet
ReaktivitätWird über den von useState zurückgegebenen Setter ausgelöstAutomatisch verfolgt über ref/reactive
AufrufbeschränkungNur auf der obersten Ebene von FunktionskomponentenNur auf der obersten Ebene von <script setup>
NebeneffekteuseEffectwatch / 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