0Pricing
React Academy · Lektion

Eine Modal-Komponente mit Portals erstellen

Erstellen Sie ein wiederverwendbares Modal, das über createPortal in document.body gerendert wird.

Eine Modal-Komponente mit Portals erstellen ist eine kostenlose React Academy-Lektion auf CoddyKit. Dies ist Lektion 2 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des React Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der React Academy-Kurs umfasst insgesamt 4 Lektionen.

Willkommen

In dieser Lektion erstellen Sie eine wiederverwendbare Modal-Komponente, die mit React.createPortal in document.body rendert und das Schließen durch einen Klick auf den Hintergrund sowie durch die Escape-Taste unterstützt.

Grundgerüst der Modal-Komponente

Beginnen Sie mit der grundlegenden Struktur: einer Modal-Komponente, die die Props `isOpen`, `onClose` und `children` entgegennimmt. Wenn `isOpen` false ist, rendern Sie nichts.
function Modal({ isOpen, onClose, children }) {
  if (!isOpen) return null;
  return createPortal(
    <div className="backdrop" onClick={onClose}>
      <div className="modal" onClick={e => e.stopPropagation()}>
        {children}
      </div>
    </div>,
    document.body
  );
}

Hintergrund und Ereignisweitergabe stoppen

Das äußere `backdrop`-Div bedeckt den gesamten Bildschirm. Ein Klick darauf ruft `onClose` auf. Das innere `modal`-Div ruft `e.stopPropagation()` auf, damit Klicks innerhalb des Modals nicht zum Hintergrund weitergereicht werden und es versehentlich schließen.

Mit der Escape-Taste schließen

Fügen Sie einen `useEffect` hinzu, der auf das `keydown`-Ereignis hört. Wenn die Escape-Taste gedrückt wird und das Modal geöffnet ist, rufen Sie `onClose` auf. Entfernen Sie den Listener beim Aufräumen.
useEffect(() => {
  if (!isOpen) return;
  const handle = (e) => { if (e.key === 'Escape') onClose(); };
  document.addEventListener('keydown', handle);
  return () => document.removeEventListener('keydown', handle);
}, [isOpen, onClose]);

Scrollen des Bodys verhindern

Wenn ein Modal geöffnet ist, soll die dahinterliegende Seite normalerweise nicht scrollen können. Fügen und entfernen Sie `overflow: hidden` innerhalb eines `useEffect` bei `document.body`.
useEffect(() => {
  if (isOpen) {
    document.body.style.overflow = 'hidden';
  }
  return () => { document.body.style.overflow = ''; };
}, [isOpen]);

Grundlegendes CSS für das Modal

Der Hintergrund sollte ein fest positioniertes Overlay über den gesamten Bildschirm sein. Das Modal-Fenster sollte zentriert werden. Ein minimalistischer CSS-Ansatz verwendet Flexbox im Hintergrund, um das Modal zu zentrieren.
.backdrop {
  position: fixed; inset: 0;
  background: rgba(0,0,0,0.5);
  display: flex; align-items: center; justify-content: center;
  z-index: 1000;
}
.modal {
  background: white;
  border-radius: 8px;
  padding: 24px;
  min-width: 320px;
}

Das Modal verwenden

Steuern Sie das Modal im übergeordneten Element mit einer booleschen State-Variable. Übergeben Sie die Props `isOpen` und `onClose` an das Modal. Fügen Sie beliebige Inhalte als children ein.
function App() {
  const [open, setOpen] = useState(false);
  return (
    <>
      <button onClick={() => setOpen(true)}>Open Modal</button>
      <Modal isOpen={open} onClose={() => setOpen(false)}>
        <h2>Hello from the modal!</h2>
        <button onClick={() => setOpen(false)}>Close</button>
      </Modal>
    </>
  );
}

Eine Schaltfläche zum Schließen hinzufügen

Stellen Sie innerhalb des Modals immer eine ausdrückliche Schaltfläche zum Schließen bereit – für Nutzer, die die Tastatur nicht verwenden können oder den Hintergrund nicht bemerken. Übergeben Sie `onClose` über children oder eine Prop an den Inhalt.

Animationen mit CSS-Transitions

Für einen Einblendeffekt sollten Sie bei geschlossenem Modal nicht null zurückgeben, sondern das Portal immer rendern und stattdessen eine CSS-Klasse umschalten. Verwenden Sie eine CSS-Transition für `opacity` und `transform` des Hintergrunds.
// Toggle class based on isOpen
<div className={`backdrop ${isOpen ? 'visible' : 'hidden'}`}>

Modal-Header und -Footer zusammensetzen

Teilen Sie das Modal in Unterkomponenten auf: `Modal.Header`, `Modal.Body`, `Modal.Footer`. Verwenden Sie das Compound-Component-Muster, damit Nutzer das Modal-Layout zusammensetzen können, ohne Klassennamen kennen zu müssen.

Schnelltest

Warum rufen wir e.stopPropagation() im onClick-Handler des inneren Modal-Divs auf?

Zusammenfassung

Sie haben mit createPortal ein Modal erstellt: Ein Klick auf den Hintergrund schließt es, ebenso die Escape-Taste. Während es geöffnet ist, wird das Scrollen des Bodys gesperrt, und stopPropagation verhindert, dass Klicks innerhalb des Modals es schließen.

Als Nächstes

Nächste Lektion: **Fokus und Tastaturfallen in Modals verwalten** – Sie halten den Fokus innerhalb des geöffneten Modals, um die Anforderungen an die Barrierefreiheit zu erfüllen.

Häufig gestellte Fragen

Ist die Lektion „Eine Modal-Komponente mit Portals erstellen“ kostenlos?

Ja — der vollständige Text von „Eine Modal-Komponente mit Portals erstellen“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des React Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der React Academy-Kurs umfasst insgesamt 4 Lektionen.

Was lerne ich in „Eine Modal-Komponente mit Portals erstellen“?

Erstellen Sie ein wiederverwendbares Modal, das über createPortal in document.body gerendert wird. Du übst React Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.

Brauche ich Erfahrung, um React Academy zu starten?

Keine Vorkenntnisse erforderlich. React Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 2 von 4.

Wie lange dauert die Lektion „Eine Modal-Komponente mit Portals erstellen“?

Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.

Kann ich in dieser React Academy-Lektion Code schreiben und ausführen?

Ja. Jede React Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.

Alle Lektionen in diesem Kurs

  1. Was sind React-Portals?
  2. Eine Modal-Komponente mit Portals erstellen
  3. Fokus und Tastaturfallen in Modals verwalten
  4. Tooltips und Dropdown-Menüs mit Portals
← Zurück zu React Academy