Zum Inhalt springen
UI Kit
Accent

Popups und Consent

Native Dialoge mit Fokusfalle und Escape, eine Einwilligungsleiste mit Einstellungen und ein Hinweis-Stapel.

7 Variants
Kategorie wechseln

Popups und Einwilligung

Details

Was Popups und Einwilligung mitbringt, aus Registry und Quellcode gelesen.

Bereich
Marketing
Variants
7
Version
1.0.0 · seit 1.0.0
Datei
components/ui/popup.tsx
Bringt mit
utilskitbuttonicon
npm-Pakete
Keine
Sprachen
Englisch und Deutsch, 22 eigene Texte

Props

Die Schnittstelle PopupProps aus components/ui/popup.tsx. Beschreibungen stammen aus den Kommentaren im Code und sind auf Englisch.

  • variantoptional
    PopupVariant

    cookie-consentnewsletter-modalofferannouncementexit-intentconfirmationtoast-stack

  • titleoptional
    React.ReactNode
  • descriptionoptional
    React.ReactNode
  • defaultOpenoptional
    boolean

    Open on load. Server rendered open too, so the content is there without JavaScript.

  • triggerLabeloptional
    string

    Renders a button that opens the dialog (or adds a toast)

  • mediaoptional
    React.ReactNode

    A picture: side of newsletter-modal, top of announcement and exit-intent

  • tagoptional
    string

    Small label above the title

  • actionoptional
    PopupAction
  • secondaryActionoptional
    PopupAction
  • categoriesoptional
    ConsentCategory[]

    cookie-consent: the switches in the settings dialog

  • onConsentoptional
    (choices: Record<string, boolean>) => void

    cookie-consent: called with every category and its state

  • policyoptional
    { label: string; href: string }

    cookie-consent: privacy policy link

  • onSubscribeoptional
    (email: string) => void | Promise<void>

    newsletter-modal, exit-intent: called with the email

  • noteoptional
    React.ReactNode

    newsletter-modal, exit-intent: small print under the form

  • valueoptional
    string

    offer: the big number and the code

  • codeoptional
    string
  • itemsoptional
    { icon: IconName; title: string; text?: string }[]

    announcement: what is new

  • confirmTextoptional
    string

    confirmation: the word to type before the action unlocks, e.g. the project name

  • onConfirmoptional
    () => void
  • toastsoptional
    ToastItem[]

    toast-stack: the toasts on screen and the one the trigger adds

  • durationoptional
    number

    toast-stack: closes each toast after so many milliseconds

Eingebaute Texte

Diese Texte schreibt Popups und Einwilligung selbst. Die Sprache folgt dem KitProvider, über die Prop labels ersetzt du einzelne.

Alle 22 Texte anzeigen
closeEnglisch CloseDeutsch Schließen
acceptAllEnglisch Accept allDeutsch Alle akzeptieren
rejectAllEnglisch Reject allDeutsch Alle ablehnen
settingsEnglisch SettingsDeutsch Einstellungen
saveEnglisch Save choicesDeutsch Auswahl speichern
alwaysOnEnglisch Always onDeutsch Immer aktiv
cookiesEnglisch Privacy settingsDeutsch Datenschutz-Einstellungen
emailEnglisch Email addressDeutsch E-Mail-Adresse
placeholderEnglisch you@example.comDeutsch du@beispiel.de
subscribeEnglisch SubscribeDeutsch Abonnieren
sendingEnglisch SendingDeutsch Wird gesendet
invalidEnglisch Please enter a full email address.Deutsch Bitte gib eine vollständige E-Mail-Adresse ein.
failedEnglisch That did not work. Please try again.Deutsch Das hat nicht geklappt. Bitte versuch es noch einmal.
doneEnglisch Check your inbox to confirm. Thank you!Deutsch Bitte bestätige im Postfach. Danke dir!
noThanksEnglisch No thanksDeutsch Nein, danke
copyEnglisch CopyDeutsch Kopieren
copiedEnglisch CopiedDeutsch Kopiert
cancelEnglisch CancelDeutsch Abbrechen
confirmEnglisch DeleteDeutsch Löschen
typeToConfirmEnglisch Type {text} to confirmDeutsch Zum Bestätigen {text} eingeben
notificationsEnglisch NotificationsDeutsch Benachrichtigungen
dismissEnglisch DismissDeutsch Ausblenden

Barrierefreiheit

Aus dem Quellcode der Component abgeleitet.

  • Popups und Einwilligung reagiert selbst auf die Tasten Entf.
  • Baut auf dem nativen dialog-Element auf. Der Browser hält den Fokus im Fenster und schließt es mit Escape.
  • Setzt aria-describedby, aria-invalid, aria-label, aria-labelledby und aria-live, damit Screenreader Zweck und Zustand ansagen.
  • Nutzt die Rollen alert, alertdialog, region, role, status und switch.
  • Meldet Änderungen über eine Live-Region, ohne den Fokus zu verschieben.
  • Jedes Feld hat ein Label, sichtbar oder für Screenreader.
  • Zeigt bei Bedienung mit der Tastatur einen sichtbaren Fokusring.
  • Der Server rendert den Startzustand vollständig, JavaScript ergänzt nur die Interaktion.

Bewegung

  • Erscheint beim ersten Sichtkontakt mit einem kurzen Auftritt (kit-rise, useInView).
  • Bewegt sich mit dem Scrollen, der Fortschritt folgt der Position auf der Seite.
  • Bringt eigene Animationen mit, ruhig getaktet und ohne Wackeln.
  • Bei reduzierter Bewegung (prefers-reduced-motion) bleibt sie ruhig. 8 Stellen im Code schalten Bewegung dann ab.

Häufige Fragen

Wie installiere ich Popups und Einwilligung?

Mit aiw add @ai-website/popup. Der Befehl legt die Datei components/ui/popup.tsx in dein Projekt, der Code gehört danach dir. Mit dabei sind button und icon. Weitere npm-Pakete braucht sie nicht.

Welche Varianten hat Popups und Einwilligung?

7 Varianten, Cookie-Einwilligung, Newsletter-Dialog, Angebot, Ankündigung, Beim Verlassen, Bestätigung und Hinweis-Stapel. Du wählst sie mit der Prop variant, zum Beispiel variant="newsletter-modal".

Kann ich die Texte von Popups und Einwilligung übersetzen?

Ja. Popups und Einwilligung bringt 22 eigene Texte auf Deutsch und Englisch mit, etwa „Schließen“, „Alle akzeptieren“ und „Alle ablehnen“. Die Sprache folgt dem KitProvider, einzelne Texte ersetzt du über die Prop labels.

Kann ein KI-Assistent Popups und Einwilligung einbauen?

Ja. Über den MCP-Server der aiw CLI finden Claude, Cursor, GitHub Copilot, Windsurf, Codex und Gemini Popups und Einwilligung mit aiw_components und installieren sie mit aiw_add @ai-website/popup. Nenn im Prompt die Variante, etwa variant="cookie-consent", dann schreibt der Assistent deine Inhalte direkt in die Props.

Kann ich Popups und Einwilligung ohne Code anpassen?

Ja, im Studio. Alle 7 Varianten lassen sich dort bearbeiten, Texte, Listen und Schalter. Das Studio schreibt den passenden Popup-Code zum Kopieren.

Oft gesucht

Direkt zu

In die Zwischenablage kopiert