Zum Inhalt springen
Loslegen

<ConsentBanner />-Props

Alle Props sind optional – die Standardwerte sind auf Englisch, überschreibe alles, um das Banner zu lokalisieren.

Prop Standard Beschreibung
title "We value your privacy" Überschrift des Banners. Übergib "", um sie wegzulassen.
message "We use cookies to enhance your experience. You can accept or decline them." Text des Banners.
acceptLabel "Accept" (oder "Accept all" mit categories) Beschriftung des Akzeptieren-Buttons.
declineLabel "Decline" (oder "Decline all" mit categories) Beschriftung des Ablehnen-Buttons.
saveLabel "Save preferences" Beschriftung des Speichern-Buttons, nur sichtbar, wenn categories gesetzt ist.
privacyHref (keiner) Wenn gesetzt, wird ein Link zu deiner Datenschutzerklärung gerendert.
privacyLabel "privacy policy" Linktext für privacyHref.
showReopenButton true Zeigt einen kleinen dauerhaften Button, um die Wahl erneut aufzurufen.
reopenLabel "Cookie settings" Beschriftung des Buttons zum erneuten Öffnen.
reopenAriaLabel "Change cookie preferences" aria-label des Buttons zum erneuten Öffnen.
categories (keine) { id, label, description?, default? }[] – aktiviert die Einwilligung pro Kategorie.
expiryDays 365 Tage, die eine gespeicherte Wahl gültig bleibt, bevor das Banner erneut erscheint.

Die Form jedes Eintrags in categories:

interface ConsentCategory {
/** Storage key for this category — must be stable across deploys. */
id: string;
/** Toggle label. */
label: string;
/** Optional helper text shown under the label. */
description?: string;
/** Pre-checks this category. Leave false for genuine opt-in consent. */
default?: boolean;
}

Ein vollständiges Beispiel findest du unter Einwilligung pro Kategorie.