CookieConsent

GDPR cookie consent modal and banner wired to site providers.

Status: beta. Group: overlay. Markdown version: /design-system/components/cookie-consent.md

When to use

GDPR cookie consent: banner plus settings modal, gating analytics providers until consent and persisting the choice. Mounted once by the app shell.

The contract records no forbidden uses.

The contract names no look-alike with a deciding condition.

CookieConsent props
Prop	Type	Default	Description	Required
`className`	`string`	none	Additional CSS classes on the consent banner region.	No

No variant dimensions and no props with a fixed set of values.

The contract records no invalid combinations.

The contract records no keyboard interaction.

Every item under When not to use is a MUST NOT. MUST and SHOULD follow RFC 2119.

CookieConsent rules
Level	Rule	How it is checked
MUST	Required stories produce no axe violations at the configured severity.	Automated by `npm run test:stories:matrix:ci`. WCAG 2.5.8.
MUST	The accessibility tree (role, name, state) matches the committed snapshot for every required story.	Automated by `npm run test:stories:matrix:ci`. WCAG 1.3.1, 4.1.2.
MUST	The component remains legible and operable under a real browser forced-colors: active pass.	Automated by `npm run test:stories:hc`.
MUST	A human completed an end-to-end accessibility review of this component.	Manual review, last on 2026-05-28.
MUST NOT	Maintainers: Do not bypass design tokens or skip forced-colors verification at beta.	Release review; not machine-checked.

Install: npm install @digitaltableteur/react (version 0.9.1, restricted access on npm).
Import: import { CookieConsent } from "@digitaltableteur/react";
Entry point: @digitaltableteur/react/consent exports it too.
Styles: import @digitaltableteur/react/style.css once at the app boundary.
Also available as the custom element <dt-cookie-consent>; see the custom elements manifest.