Cookie banner a norma in vibe coding: regole e codice

Il banner fatto in casa con l’AI spesso è brutto e fuori norma. Regole del Garante, design che aumenta i consensi, prompt e codice completo da copiare.

Minuto Innovativo

In un minuto

  1. Perché il cookie banner fatto in casa viene male? Perché l’agente AI consegna un riquadro che sembra un banner, e nessuno gli ha chiesto le regole.
  2. Cosa deve avere un cookie banner a norma? Un rifiuto facile quanto l’accettazione, nessuna scelta già fatta e nessun tracciamento prima del clic.
  3. Cosa dicono Garante ed EDPB? Il Garante italiano chiede cinque elementi nel banner, e l’EDPB ha chiarito quali trucchi rendono nullo il consenso.

Capitolo 3 di 14: Cosa dicono Garante ed EDPB?

Il Garante italiano chiede cinque elementi nel banner, e l’EDPB ha chiarito quali trucchi rendono nullo il consenso.

La base è l’articolo 122 del Codice privacy, che recepisce la direttiva europea ePrivacy. Per salvare o leggere informazioni sul dispositivo di una persona serve il suo consenso, salvo per ciò che è tecnicamente necessario. Come deve essere quel consenso lo dice il GDPR.

Il testo di riferimento in Italia sono le linee guida sui cookie del Garante, del 10 giugno 2021. Secondo le linee guida il banner contiene:

  • un comando per chiudere e proseguire senza consenso, indicato con una X in alto a destra;
  • un’informativa breve su quali cookie usi e perché;
  • il link all’informativa completa;
  • un comando per accettare tutto;
  • il link a un’area dove scegliere categoria per categoria.

Le linee guida fissano anche questi paletti.

RegolaCosa significa in pratica
Niente scelte già fatteCaselle e interruttori facoltativi partono spenti.
Niente tracciamento prima del clicGli script di statistica e pubblicità si caricano dopo il consenso.
Lo scroll non bastaScorrere la pagina, da solo, non vale come consenso.
Niente cookie wallNon puoi chiudere il sito a chi rifiuta, salvo offrire un’alternativa equivalente.
Sei mesi di pausaA chi ha rifiutato non ripresenti il banner prima di sei mesi.
Cambiare idea sempreSu ogni pagina c’è un comando per riaprire le scelte, nel footer o in un’icona fissa.
Comandi alla pariIl Garante chiede comandi di «uguali dimensioni, enfasi e colori».

Sulle scelte già fatte la regola viene da più in alto. Il considerando 32 del GDPR esclude la preselezione di caselle, e la Corte di giustizia dell’Unione europea l’ha confermato nella sentenza Planet49. Una casella già spuntata, che l’utente deve togliere per dire di no, non è un consenso.

A livello europeo c’è poi il rapporto della task force dell’EDPB sui cookie banner. Per la maggior parte delle autorità un banner senza rifiuto nella prima schermata è una violazione. Su colori e contrasti non esiste uno standard, si valuta caso per caso.

Capitolo 4 di 14: Quanto conta il design sul consenso?

In uno studio, togliere «Rifiuta» dalla prima schermata ha alzato i consensi di 22-23 punti percentuali.

Lo studio si intitola Dark Patterns after the GDPR ed è stato presentato alla conferenza CHI. I ricercatori hanno analizzato i banner di 680 siti, presi tra i 10.000 più visitati del Regno Unito. Poi hanno provato otto varianti di banner con 40 persone. Tre risultati interessano chi progetta un banner.

  • Senza il pulsante di rifiuto nella prima schermata i consensi salgono di 22-23 punti.
  • Con gli interruttori delle categorie nella prima schermata i consensi scendono tra 8 e 20 punti.
  • Banner in un angolo o finestra che blocca la pagina, tra chi sceglie il risultato non cambia.
Effetto di due scelte di design sui consensi Grafico a barre su un asse da meno 20 a più 20 punti percentuali. Senza il pulsante Rifiuta nella prima schermata i consensi salgono di 22-23 punti. Con gli interruttori nella prima schermata scendono tra 8 e 20 punti. Effetto sui consensi, in punti percentuali Senza «Rifiuta» +22/23 punti Con gli interruttori da −8 a −20 punti −20 −10 0 +10 +20 meno consensi più consensi
Quanto cambiano i consensi, rispetto al banner di confronto, con due scelte nella prima schermata. La parte chiara delle barre è l’intervallo misurato. Dati dello studio «Dark Patterns after the GDPR».

Il primo risultato spiega perché tanti banner nascondono il rifiuto. È la leva più forte, ed è quella che le autorità contestano. Il campione è piccolo, quindi i numeri vanno presi come ordine di grandezza.

Il terzo risultato va letto bene. Riguarda le persone che una scelta la fanno. Un banner piccolo in un angolo, però, molti non lo toccano proprio. Senza scelta non c’è consenso, e senza consenso statistiche e Pixel restano spenti.

Capitolo 5 di 14: Come aumentare i consensi restando in regola?

Fai scegliere tutti, tieni un solo pulsante pieno e spiega in una riga cosa ci guadagna chi accetta.

Queste sono le mosse che usiamo, in ordine di peso.

  1. Metti il banner al centro, con la pagina scurita dietro. Chi arriva deve scegliere prima di andare avanti. Può sempre rifiutare, quindi non è un cookie wall.
  2. Un solo pulsante pieno. «Accetta tutti» ha il colore del brand, gli altri hanno solo il bordo. Stessa altezza e stesso peso del testo per tutti.
  3. Sul telefono «Accetta tutti» va in fondo. È il punto dove arriva il pollice.
  4. Testo corto, che parte dal vantaggio. Di’ a cosa servono i cookie e ricorda che si può cambiare idea. Sapere di poter tornare indietro toglie un motivo per dire di no.
  5. Un pulsante centrale che dice cosa accetta. «Accetta marketing» è chiaro. «Accetta selezionati» con tutto spento è un secondo rifiuto travestito.
  6. Il rifiuto si chiama «Rifiuta». Una parola sola, chiara per chi legge. Le etichette creative confondono.
  7. Dopo sei mesi richiedi. A chi ha rifiutato tutto puoi ripresentare il banner quando sono passati sei mesi.
Le parti del banner sul telefono Schema del banner. Dall’alto ci sono tre schede, un testo corto, tre interruttori di cui due spenti, il pulsante Rifiuta, il pulsante Accetta marketing e in fondo il pulsante pieno Accetta tutti. Consenso Dettagli Informazioni Necessari Statistiche Marketing Rifiuta Accetta marketing Accetta tutti 1 Tre schede 2 Testo corto 3 Interruttori spenti 4 Rifiuto in vista 5 Uno solo è pieno
Il banner sul telefono. L’interruttore dei cookie necessari è fisso, gli altri due partono spenti. I tre pulsanti hanno la stessa misura e solo «Accetta tutti» è pieno.

Due avvertenze. Il pulsante pieno è una zona grigia. Il Garante chiede comandi alla pari, mentre l’EDPB valuta colori e contrasti caso per caso. Per stare sul sicuro tieni «Rifiuta» grande come gli altri, ben leggibile e nella prima schermata.

La seconda riguarda gli interruttori. Se vuoi il massimo dei consensi, spostali nella scheda dei dettagli e lascia nella prima schermata solo testo e pulsanti. Lo studio dice che averli subito sotto gli occhi fa perdere consensi.

Capitolo 6 di 14: Quali scorciatoie annullano il consenso?

Interruttori già accesi, rifiuto nascosto, conferme insistenti e script che partono prima del clic.

Sono gli errori tipici del banner fatto in casa. Qualcuno alza i numeri. Tutti lasciano il sito con dati raccolti senza una base valida.

  • Interruttori accesi in partenza. È il caso della sentenza Planet49. Che siano in bella vista e si possano spegnere con un tocco non cambia nulla.
  • Rifiuto solo nel secondo livello. Un link «Personalizza» al posto del pulsante «Rifiuta» è una delle pratiche esaminate dalla task force dell’EDPB.
  • Rifiuto poco leggibile. Testo grigio chiaro su bianco, o un link perso dentro un paragrafo.
  • «Sei sicuro?» dopo il rifiuto. Chiedere conferma solo a chi dice di no è insistenza.
  • Banner che torna a ogni pagina. Chi chiude o rifiuta ha scelto. Vale la pausa di sei mesi.
  • Script caricati comunque. Il banner è perfetto ma il Pixel è nel codice della pagina e parte al caricamento. Con un agente AI succede quando gli chiedi il banner e non gli dici di spostare gli script.
  • Nessun modo per cambiare idea. Il banner sparisce dopo la prima scelta e non torna più. Chi ha accettato non ha un comando per ritirare il consenso.
  • Cookie wall. Niente consenso, niente sito.

Capitolo 7 di 14: Prova e configura il banner

Qui sotto puoi provare il banner e adattarlo al tuo sito. Il codice da copiare si aggiorna mentre scegli.

Cambia il colore, il tema, gli angoli, i testi e le categorie. Guardalo come appare da computer e da telefono, prova i pulsanti e le schede. Nella scheda «Codice» trovi i pezzi pronti con le tue scelte.

Nell’anteprima la scelta non viene salvata. Con «Rivedi il banner» lo fai ricomparire da capo.

Capitolo 8 di 14: Come farlo in vibe coding, passo per passo

Dai all’agente il codice già pronto e le regole scritte, invece di fargli inventare il banner da zero.

Il nostro banner è un componente React senza altre dipendenze, più un foglio di stile. Li trovi interi nel capitolo «Il codice completo da copiare», con licenza MIT. È nero su bianco, così lo adatti al tuo brand cambiando poche variabili o usando il configuratore qui sopra.

  1. Copia i due file. Salvali come CookieBanner.tsx e cookie-banner.css.
  2. Dai il prompt all’agente. Allega i due file e incolla il prompt qui sotto.
  3. Controlla gli script. Statistiche e Pixel devono partire solo dopo il consenso, con useConsent.
  4. Metti il comando per cambiare idea. Nel footer oppure con l’icona fissa in un angolo.
  5. Metti i colori del brand. Bastano poche variabili.
  6. Prova da visitatore. Finestra anonima e scheda della rete aperta.

Il prompt per Lovable, Claude Code o un altro agente:

Aggiungi al sito il cookie banner che trovi nei due file allegati: il componente React CookieBanner.tsx e il suo foglio di stile cookie-banner.css. Copiali nel progetto senza cambiarne la logica, importa il CSS e monta il componente una volta sola nel layout principale, con due categorie facoltative, Statistiche e Marketing, e con il pulsante centrale che propone il marketing. Fai partire tutti gli script di statistica e pubblicità solo dopo il consenso, con l’hook useConsent del componente, e controlla che non restino caricati altrove. Aggiungi nel footer di ogni pagina un pulsante «Gestisci cookie» che chiama openCookiePreferences(); se il sito non ha un footer su tutte le pagine, usa invece la prop manageButton="left" per l’icona fissa. Usa i colori del sito ridefinendo le variabili CSS del banner. Non accendere nessun interruttore in partenza e non togliere il pulsante «Rifiuta». Alla fine apri il sito con un profilo pulito e verifica che prima della scelta non parta nessuna richiesta verso servizi di terze parti.

Se preferisci farlo a mano, monta il banner una volta sola nel layout del sito.

import { CookieBanner } from "./CookieBanner";
import "./cookie-banner.css";

export function CookieConsent() {
  return (
    <CookieBanner
      proposed="marketing"
      categories={[
        {
          id: "analytics",
          label: "Statistiche",
          description: "Quali pagine funzionano.",
        },
        {
          id: "marketing",
          label: "Marketing",
          description: "Misura delle campagne.",
        },
      ]}
    />
  );
}

Il banner da solo non blocca niente. Ogni script di tracciamento parte solo quando useConsent dice che la sua categoria è consentita.

import { useEffect } from "react";
import { useConsent } from "./CookieBanner";

export function MetaPixel() {
  const allowed = useConsent("marketing");
  useEffect(() => {
    if (!allowed) return;
    // qui lo snippet del Meta Pixel
  }, [allowed]);
  return null;
}

Poi serve il comando per cambiare idea. Le linee guida del Garante chiedono che la scelta si possa modificare in ogni momento, e suggeriscono un segno grafico su ogni pagina che ricordi il consenso dato. Hai due strade.

La prima è un pulsante «Gestisci cookie» nel footer, accanto a privacy e cookie policy. È la più discreta e funziona se il footer c’è su tutte le pagine, checkout compreso.

import { openCookiePreferences } from "./CookieBanner";

<button type="button" onClick={openCookiePreferences}>
  Gestisci cookie
</button>

La seconda è l’icona di un biscotto fissa in un angolo in basso, sempre visibile dopo la scelta. Serve quando alcune pagine non hanno il footer, come le landing o le pagine di pagamento. Mettila dalla parte opposta alla chat o al pulsante di WhatsApp, così non si coprono.

<CookieBanner
  manageButton="left"
  categories={categories}
/>

Per spostarla a destra usa manageButton="right".

Per i colori ridefinisci le variabili dopo il foglio di stile del banner. Il configuratore le calcola per te.

.ckb-root {
  --ckb-accent: #0b5fff;
  --ckb-accent-hover: #0952db;
  --ckb-on-accent: #ffffff;
}

L’ultimo passo è la prova. Apri il sito in una finestra anonima, apri gli strumenti per sviluppatori e guarda la scheda della rete. Prima del clic non devono comparire richieste verso Google, Meta o altri servizi di tracciamento.

Capitolo 9 di 14: Farlo in casa o usare una piattaforma?

Dipende da quanti servizi di terze parti usi e da quanto vuoi controllare l’aspetto.

SoluzioneQuando convieneCosa tenere d’occhio
Banner fatto in casaPochi servizi che conosci bene e un design tuo.Elenco dei servizi e aggiornamenti li tieni tu.
Piattaforma di consenso (iubenda, Cookiebot, CookieYes)Tanti servizi, più siti, serve un registro dei consensi.Costo ricorrente e impostazioni di partenza da ricontrollare.
Plugin del CMS (per esempio Complianz su WordPress)Sito WordPress con pochi servizi.Convivenza con tema e altri plugin.

Una piattaforma ti dà la scansione dei cookie e i testi legali aggiornati. Non ti garantisce da sola la conformità. Colori, pulsanti e categorie accese li decidi tu nelle impostazioni, e le scorciatoie viste sopra si possono fare con qualsiasi strumento.

Capitolo 10 di 14: Come lo usiamo noi in Minnovo

Sul sito di Minnovo Academy abbiamo sostituito il riquadro in basso a destra con il banner di questa pagina, nei colori del brand.

Sulla home compare al centro e chiede una scelta. Sulle altre pagine, pagamento compreso, resta una barra sottile in basso che non blocca niente. Chi sta comprando o seguendo una lezione non va interrotto.

Abbiamo lavorato come facciamo sempre. Prima un prototipo in locale, provato da computer e da telefono, poi le istruzioni all’agente che scrive il codice del sito. Dopo la pubblicazione abbiamo aperto il sito con un browser pulito e controllato che il Pixel partisse solo dopo il clic.

Anche da noi gli interruttori partono spenti. Accesi avrebbero alzato i numeri, con consensi che non valgono nulla.

Capitolo 11 di 14: Limiti da conoscere

Un banner fatto bene non basta a rendere conforme un sito.

  • Non siamo uno studio legale. Questa guida non è un parere legale, e le posizioni delle autorità cambiano. Fai sempre controllare banner e informative a un legale esperto di queste materie.
  • Serve l’informativa. La cookie policy elenca i servizi, chi li fornisce e a cosa servono. Il banner la richiama soltanto.
  • La prova del consenso. Il nostro banner salva la scelta nel browser. Se ti serve un registro sul server, lo costruisci tu a partire dall’evento che il banner lancia a ogni scelta.
  • Google ha le sue richieste. Per Analytics e Ads esiste la Consent Mode, che riceve la scelta dell’utente. Va collegata al banner.

Capitolo 12 di 14: Da dove cominciare

Apri il tuo sito in una finestra anonima e fai tre controlli. Gli interruttori partono spenti? «Rifiuta» è nella prima schermata? Prima del clic parte qualche richiesta verso servizi di tracciamento? Se una risposta è sbagliata, parti da lì.

Se vuoi rifare il banner insieme al sito, o collegare bene Pixel e statistiche al consenso, è un lavoro che facciamo nel nostro servizio di sviluppo web.

Capitolo 13 di 14: Il codice completo da copiare

Sono due file con licenza MIT. Li puoi usare, modificare e ridistribuire, anche in progetti commerciali.

Il primo è CookieBanner.tsx, il componente React. Funziona con React 18 e 19. Regge anche il rendering lato server, perché sul server non disegna niente e il banner compare quando la pagina si carica nel browser.

"use client";
/*! Cookie banner a schede | MIT | Minnovo S.r.l. */
/* Non è una consulenza legale. Prima di usarlo fai
   controllare banner e informative a un legale
   esperto di privacy. */
import {
  useCallback,
  useEffect,
  useLayoutEffect,
  useRef,
  useState,
  type KeyboardEvent,
  type ReactNode,
} from "react";

export type CookieService = {
  name: string;
  provider?: string;
  purpose: string;
  policyUrl?: string;
  policyLabel?: string;
};

export type CookieCategory = {
  id: string;
  label: string;
  description: string;
  services?: CookieService[];
};

export type Consent = {
  categories: Record<string, boolean>;
  timestamp: string;
};

const TEXTS = {
  tabConsent: "Consenso",
  tabDetails: "Dettagli",
  tabInfo: "Informazioni sui cookie",
  title: "Questo sito usa i cookie",
  intro:
    "Usiamo cookie tecnici e, con il tuo consenso, " +
    "cookie di statistica e di marketing. Puoi " +
    "cambiare idea quando vuoi da «Gestisci cookie».",
  infoTitle: "Cosa sono i cookie",
  // un paragrafo per voce
  info: [
    "Sono piccoli file di testo che i siti salvano " +
      "sul tuo dispositivo per rendere la navigazione " +
      "più semplice.",
    "Per legge possiamo salvare senza chiederti " +
      "niente solo i cookie strettamente necessari al " +
      "funzionamento del sito. Per tutti gli altri ci " +
      "serve il tuo permesso. I cookie necessari si " +
      "basano sul legittimo interesse (art. 6, par. 1, " +
      "lett. f del GDPR), quelli di statistica e di " +
      "marketing sul tuo consenso (art. 6, par. 1, " +
      "lett. a del GDPR).",
    "Alcuni cookie li impostano servizi di terze " +
      "parti che compaiono sulle nostre pagine.",
  ],
  // le due frasi finiscono con il link
  infoChange:
    "Puoi cambiare o ritirare il consenso quando " +
    "vuoi da «Gestisci cookie», in fondo a ogni " +
    "pagina. L'elenco dei cookie è nella ",
  infoPrivacy:
    "Chi siamo, come contattarci e come trattiamo " +
    "i dati personali lo trovi nella ",
  cookiePolicy: "Cookie Policy",
  privacy: "Privacy Policy",
  reject: "Rifiuta",
  acceptSelected: "Accetta selezionati",
  acceptOne: "Accetta ",
  acceptAll: "Accetta tutti",
  alwaysOn: "Sempre attivi",
  policy: "Informativa",
  close: "Chiudi senza modificare",
  manage: "Gestisci cookie",
};

export type CookieTexts = typeof TEXTS;

export type CookieBannerProps = {
  // categorie facoltative: partono sempre spente
  categories: CookieCategory[];
  necessary?: Omit<CookieCategory, "id">;
  // categoria del pulsante centrale, oppure null
  proposed?: string | null;
  links?: { cookiePolicy: string; privacy: string };
  texts?: Partial<CookieTexts>;
  theme?: "light" | "dark";
  // pulsante fisso per riaprire le scelte
  manageButton?: "none" | "left" | "right";
  storageKey?: string;
  // giorni prima di richiedere a chi ha rifiutato
  renewRejectAfterDays?: number;
  onChange?: (consent: Consent) => void;
  // anteprima: sempre aperto, non salva niente
  preview?: boolean;
};

// useLayoutEffect solo nel browser (niente avvisi in SSR)
const useBrowserLayout =
  typeof window === "undefined"
    ? useEffect
    : useLayoutEffect;

const PHONE = "(max-width: 639px)";

const KEY = "cookie_consent_v1";
const CHANGE = "cookieconsent:change";
const OPEN = "cookieconsent:open";

// ---- Funzioni da usare nel resto del sito ----

export function getConsent(key = KEY): Consent | null {
  if (typeof window === "undefined") return null;
  try {
    return JSON.parse(localStorage.getItem(key) || "null");
  } catch {
    return null;
  }
}

// Per il link «Gestisci cookie» nel footer.
export function openCookiePreferences() {
  window.dispatchEvent(new Event(OPEN));
}

// true quando la categoria è consentita.
export function useConsent(id: string, key = KEY) {
  const [allowed, setAllowed] = useState(false);
  useEffect(() => {
    const read = () =>
      setAllowed(!!getConsent(key)?.categories?.[id]);
    read();
    window.addEventListener(CHANGE, read);
    return () => window.removeEventListener(CHANGE, read);
  }, [id, key]);
  return allowed;
}

function needsAnswer(
  saved: Consent | null,
  ids: string[],
  days: number,
) {
  if (!saved?.categories) return true;
  const c = saved.categories;
  // categoria nuova: si richiede
  if (ids.some((id) => !(id in c))) return true;
  if (ids.some((id) => c[id])) return false;
  // rifiuto completo: si richiede dopo i giorni indicati
  const age =
    Date.now() - new Date(saved.timestamp).getTime();
  return !(age <= days * 864e5);
}

type Tab = "consent" | "details" | "info";
const TABS: Tab[] = ["consent", "details", "info"];

function Chevron() {
  return (
    <svg viewBox="0 0 24 24" aria-hidden="true">
      <path d="m6 9 6 6 6-6" />
    </svg>
  );
}

function Cross() {
  return (
    <svg viewBox="0 0 24 24" aria-hidden="true">
      <path d="M18 6 6 18M6 6l12 12" />
    </svg>
  );
}

// Icona del biscotto (Lucide, licenza ISC).
function CookieIcon() {
  return (
    <svg viewBox="0 0 24 24" aria-hidden="true">
      <path
        d={
          "M12 2a10 10 0 1 0 10 10 " +
          "4 4 0 0 1-5-5 4 4 0 0 1-5-5"
        }
      />
      <path d="M8.5 8.5v.01M16 15.5v.01M12 12v.01" />
      <path d="M11 17v.01M7 14v.01" />
    </svg>
  );
}

function Locked({ label }: { label: string }) {
  return (
    <span
      className="ckb-switch is-locked"
      role="img"
      aria-label={label}
    />
  );
}

// Una categoria nella scheda Dettagli.
function Group(props: {
  id: string;
  label: string;
  description: string;
  services: CookieService[];
  open: boolean;
  onToggle: () => void;
  policy: string;
  children: ReactNode;
}) {
  const { id, services } = props;
  return (
    <div className="ckb-group">
      <div className="ckb-group-head">
        <button
          type="button"
          className="ckb-group-toggle"
          aria-expanded={props.open}
          aria-controls={"ckb-svc-" + id}
          onClick={props.onToggle}
        >
          <Chevron />
          <span className="ckb-group-name">
            {props.label}
          </span>
          {services.length > 0 && (
            <span className="ckb-count">
              {services.length}
            </span>
          )}
        </button>
        {props.children}
      </div>
      <p>{props.description}</p>
      <ul
        className="ckb-services"
        id={"ckb-svc-" + id}
        hidden={!props.open}
      >
        {services.map((s) => (
          <li key={s.name}>
            <b>
              {s.name}
              {s.provider && <small>{s.provider}</small>}
            </b>
            <span>
              {s.purpose}{" "}
              {s.policyUrl && (
                <a
                  href={s.policyUrl}
                  target="_blank"
                  rel="noopener"
                >
                  {s.policyLabel || props.policy}
                </a>
              )}
            </span>
          </li>
        ))}
      </ul>
    </div>
  );
}

export function CookieBanner({
  categories,
  necessary = {
    label: "Necessari",
    description:
      "Fanno funzionare il sito e restano sempre attivi.",
  },
  proposed = null,
  links = {
    cookiePolicy: "/cookie-policy",
    privacy: "/privacy",
  },
  texts,
  theme = "light",
  manageButton = "none",
  storageKey = KEY,
  renewRejectAfterDays = 182,
  onChange,
  preview = false,
}: CookieBannerProps) {
  const t = { ...TEXTS, ...texts };
  const ids = categories.map((c) => c.id);
  const idsKey = ids.join("|");

  const [open, setOpen] = useState(false);
  const [manual, setManual] = useState(false);
  const [mounted, setMounted] = useState(false);
  const [tab, setTab] = useState<Tab>("consent");
  const [state, setState] =
    useState<Record<string, boolean>>({});
  const [expanded, setExpanded] =
    useState<Record<string, boolean>>({});
  const dialog = useRef<HTMLElement>(null);
  // Sul telefono il banner tiene l'altezza della prima
  // scheda: nelle altre il testo scorre e i pulsanti
  // restano sempre visibili.
  const body = useRef<HTMLDivElement>(null);
  const firstHeight = useRef(0);
  const [lock, setLock] = useState<number>();
  const [more, setMore] = useState(false);
  const tabRefs = useRef<(HTMLButtonElement | null)[]>(
    [],
  );

  const show = useCallback(
    (isManual: boolean) => {
      const saved =
        isManual && !preview
          ? getConsent(storageKey)
          : null;
      const next: Record<string, boolean> = {};
      // al primo accesso è tutto spento
      idsKey.split("|").forEach((id) => {
        next[id] = !!saved?.categories?.[id];
      });
      setState(next);
      setManual(isManual);
      setTab(isManual ? "details" : "consent");
      setExpanded({});
      setOpen(true);
    },
    [idsKey, preview, storageKey],
  );

  useEffect(() => {
    setMounted(true);
    const saved = preview ? null : getConsent(storageKey);
    const list = idsKey.split("|");
    if (needsAnswer(saved, list, renewRejectAfterDays)) {
      show(false);
    }
    const reopen = () => show(true);
    window.addEventListener(OPEN, reopen);
    return () => window.removeEventListener(OPEN, reopen);
  }, [
    show,
    preview,
    storageKey,
    idsKey,
    renewRejectAfterDays,
  ]);

  useEffect(() => {
    if (!open) return;
    dialog.current?.focus({ preventScroll: true });
  }, [open]);

  useBrowserLayout(() => {
    const el = body.current;
    if (!open || !el) return;
    el.scrollTop = 0;
    if (tab === "consent") {
      setLock(undefined);
      firstHeight.current = el.offsetHeight;
      return;
    }
    if (!window.matchMedia(PHONE).matches) {
      setLock(undefined);
      return;
    }
    setLock(
      firstHeight.current ||
        Math.round(window.innerHeight * 0.45),
    );
  }, [open, tab]);

  // L'altezza della prima scheda cambia se il carattere
  // arriva dopo: la si rilegge finché resta aperta.
  useEffect(() => {
    const el = body.current;
    if (!open || !el || tab !== "consent") return;
    const ro = new ResizeObserver(() => {
      firstHeight.current = el.offsetHeight;
    });
    ro.observe(el);
    return () => ro.disconnect();
  }, [open, tab]);

  // Sfumatura in basso finché c'è altro testo da leggere.
  const checkMore = useCallback(() => {
    const el = body.current;
    if (!el) return;
    const left =
      el.scrollHeight - el.scrollTop - el.clientHeight;
    setMore(left > 4);
  }, []);
  useBrowserLayout(checkMore, [open, tab, lock, expanded]);

  const all: Record<string, boolean> = {};
  const none: Record<string, boolean> = {};
  ids.forEach((id) => {
    all[id] = true;
    none[id] = false;
  });
  const anyOn = ids.some((id) => state[id]);
  const offered = categories.find((c) => c.id === proposed);

  function finish(choice: Record<string, boolean>) {
    const consent: Consent = {
      categories: { necessary: true },
      timestamp: new Date().toISOString(),
    };
    ids.forEach((id) => {
      consent.categories[id] = !!choice[id];
    });
    if (!preview) {
      try {
        localStorage.setItem(
          storageKey,
          JSON.stringify(consent),
        );
      } catch {
        /* navigazione privata */
      }
      window.dispatchEvent(
        new CustomEvent(CHANGE, { detail: consent }),
      );
    }
    onChange?.(consent);
    setOpen(false);
    setManual(false);
  }

  function closeWithoutChanges() {
    setOpen(false);
    setManual(false);
    const saved = getConsent(storageKey);
    if (
      !preview &&
      needsAnswer(saved, ids, renewRejectAfterDays)
    ) {
      show(false);
    }
  }

  function middle() {
    if (anyOn) return finish(state);
    if (offered) finish({ ...none, [offered.id]: true });
  }

  function onTabKey(
    e: KeyboardEvent<HTMLButtonElement>,
    i: number,
  ) {
    const step =
      e.key === "ArrowRight" ? 1
        : e.key === "ArrowLeft" ? TABS.length - 1 : 0;
    if (!step) return;
    e.preventDefault();
    const n = (i + step) % TABS.length;
    setTab(TABS[n]);
    tabRefs.current[n]?.focus();
  }

  // Esc chiude solo se l'ha aperto l'utente;
  // il fuoco resta dentro il banner.
  function onKey(e: KeyboardEvent<HTMLElement>) {
    if (e.key === "Escape") {
      e.preventDefault();
      if (manual) closeWithoutChanges();
      return;
    }
    if (e.key !== "Tab" || !dialog.current) return;
    const items = Array.from(
      dialog.current.querySelectorAll<HTMLElement>(
        "button, a[href]",
      ),
    ).filter((n) => n.offsetParent && n.tabIndex !== -1);
    const first = items[0];
    const last = items[items.length - 1];
    const active = document.activeElement;
    if (
      e.shiftKey &&
      (active === first || active === dialog.current)
    ) {
      e.preventDefault();
      last?.focus();
    } else if (!e.shiftKey && active === last) {
      e.preventDefault();
      first?.focus();
    }
  }

  if (!open) {
    if (!mounted || manageButton === "none") return null;
    return (
      <div className="ckb-root" data-ckb-theme={theme}>
        <button
          type="button"
          className={
            "ckb-manage ckb-manage-" + manageButton
          }
          aria-label={t.manage}
          title={t.manage}
          onClick={() => show(true)}
        >
          <CookieIcon />
        </button>
      </div>
    );
  }

  const tabLabels: Record<Tab, string> = {
    consent: t.tabConsent,
    details: t.tabDetails,
    info: t.tabInfo,
  };
  const toggle = (id: string) =>
    setState((s) => ({ ...s, [id]: !s[id] }));
  const expand = (id: string) =>
    setExpanded((x) => ({ ...x, [id]: !x[id] }));

  return (
    <div className="ckb-root" data-ckb-theme={theme}>
      <div className="ckb-scrim" />
      <section
        ref={dialog}
        className="ckb"
        role="dialog"
        aria-modal="true"
        aria-labelledby="ckb-title"
        tabIndex={-1}
        onKeyDown={onKey}
      >
        <div className="ckb-tabs" role="tablist">
          {TABS.map((id, i) => (
            <button
              key={id}
              ref={(el) => {
                tabRefs.current[i] = el;
              }}
              type="button"
              className="ckb-tab"
              role="tab"
              id={"ckb-tab-" + id}
              aria-controls={"ckb-panel-" + id}
              aria-selected={tab === id}
              tabIndex={tab === id ? 0 : -1}
              onClick={() => setTab(id)}
              onKeyDown={(e) => onTabKey(e, i)}
            >
              {tabLabels[id]}
            </button>
          ))}
          {manual && (
            <button
              type="button"
              className="ckb-close"
              aria-label={t.close}
              onClick={closeWithoutChanges}
            >
              <Cross />
            </button>
          )}
        </div>

        <div
          ref={body}
          className={"ckb-body" + (more ? " has-more" : "")}
          style={lock ? { maxHeight: lock } : undefined}
          onScroll={checkMore}
        >
          <div
            className="ckb-panel"
            role="tabpanel"
            id="ckb-panel-consent"
            aria-labelledby="ckb-tab-consent"
            hidden={tab !== "consent"}
          >
            <h2 className="ckb-title" id="ckb-title">
              {t.title}
            </h2>
            <p>{t.intro}</p>
          </div>

          <div
            className="ckb-panel"
            role="tabpanel"
            id="ckb-panel-details"
            aria-labelledby="ckb-tab-details"
            hidden={tab !== "details"}
          >
            <Group
              id="necessary"
              label={necessary.label}
              description={necessary.description}
              services={necessary.services || []}
              open={!!expanded.necessary}
              onToggle={() => expand("necessary")}
              policy={t.policy}
            >
              <Locked label={t.alwaysOn} />
            </Group>
            {categories.map((c) => (
              <Group
                key={c.id}
                id={c.id}
                label={c.label}
                description={c.description}
                services={c.services || []}
                open={!!expanded[c.id]}
                onToggle={() => expand(c.id)}
                policy={t.policy}
              >
                <button
                  type="button"
                  className="ckb-switch"
                  role="switch"
                  aria-checked={!!state[c.id]}
                  aria-label={c.label}
                  onClick={() => toggle(c.id)}
                />
              </Group>
            ))}
          </div>

          <div
            className="ckb-panel"
            role="tabpanel"
            id="ckb-panel-info"
            aria-labelledby="ckb-tab-info"
            hidden={tab !== "info"}
          >
            <h2 className="ckb-title">{t.infoTitle}</h2>
            {t.info.map((p) => (
              <p key={p}>{p}</p>
            ))}
            <p>
              {t.infoChange}
              <a href={links.cookiePolicy}>
                {t.cookiePolicy}
              </a>
              .
            </p>
            <p>
              {t.infoPrivacy}
              <a href={links.privacy}>{t.privacy}</a>.
            </p>
          </div>

          {tab === "consent" && (
            <div className="ckb-cats">
              <div className="ckb-cat">
                <span className="ckb-cat-name">
                  {necessary.label}
                </span>
                <Locked label={t.alwaysOn} />
              </div>
              {categories.map((c) => (
                <button
                  key={c.id}
                  type="button"
                  className="ckb-cat"
                  role="switch"
                  aria-checked={!!state[c.id]}
                  onClick={() => toggle(c.id)}
                >
                  <span className="ckb-cat-name">
                    {c.label}
                  </span>
                  <span
                    className="ckb-switch"
                    aria-hidden="true"
                  />
                </button>
              ))}
            </div>
          )}
        </div>

        <div className="ckb-actions">
          <button
            type="button"
            className="ckb-btn"
            onClick={() => finish(none)}
          >
            {t.reject}
          </button>
          {(anyOn || offered) && (
            <button
              type="button"
              className="ckb-btn"
              onClick={middle}
            >
              {anyOn || !offered
                ? t.acceptSelected
                : t.acceptOne + offered.label.toLowerCase()}
            </button>
          )}
          <button
            type="button"
            className="ckb-btn ckb-primary"
            onClick={() => finish(all)}
          >
            {t.acceptAll}
          </button>
        </div>
      </section>
    </div>
  );
}

Il secondo è cookie-banner.css, il foglio di stile.

/*! Cookie banner a schede | MIT | Minnovo S.r.l. */

/* Colori e forme: ridefinisci queste variabili. */
.ckb-root {
  --ckb-accent: #111111;
  --ckb-accent-hover: #333333;
  --ckb-on-accent: #ffffff;
  --ckb-bg: #ffffff;
  --ckb-text: #111111;
  --ckb-muted: #5c5f66;
  --ckb-border: #e3e4e8;
  --ckb-soft: #f3f4f6;
  --ckb-off: #6b6f78;
  --ckb-locked: #b9bcc4;
  --ckb-scrim: rgba(17, 17, 17, .5);
  --ckb-radius: 16px;
  --ckb-btn-radius: 10px;
  /* --ckb-font: "Inter", sans-serif; */
  --ckb-ease: cubic-bezier(.16, 1, .3, 1);
}
.ckb-root[data-ckb-theme="dark"] {
  --ckb-accent: #ffffff;
  --ckb-accent-hover: #d9d9d9;
  --ckb-on-accent: #111111;
  --ckb-bg: #17181b;
  --ckb-text: #f4f4f5;
  --ckb-muted: #a5a8b0;
  --ckb-border: #2e3035;
  --ckb-soft: #232529;
  --ckb-locked: #4a4d54;
  --ckb-scrim: rgba(0, 0, 0, .62);
}
.ckb-root, .ckb-root * { box-sizing: border-box; }

.ckb-scrim {
  position: fixed; inset: 0; z-index: 9990;
  background: var(--ckb-scrim);
  animation: ckb-fade .28s var(--ckb-ease);
}
.ckb {
  position: fixed; z-index: 9991; left: 50%; top: 50%;
  width: min(720px, calc(100vw - 48px));
  max-height: calc(100dvh - 48px);
  display: flex; flex-direction: column;
  overflow: hidden; text-align: left;
  background: var(--ckb-bg); color: var(--ckb-text);
  border-radius: var(--ckb-radius);
  font-family: var(--ckb-font, inherit);
  font-size: 15px; line-height: 1.5;
  box-shadow: 0 1px 2px rgba(17, 17, 17, .08),
    0 28px 70px -26px rgba(17, 17, 17, .5);
  transform: translate(-50%, -50%);
  animation: ckb-rise .42s var(--ckb-ease);
}
@keyframes ckb-fade { from { opacity: 0; } }
@keyframes ckb-rise {
  from {
    opacity: 0;
    transform: translate(-50%, calc(-50% + 14px));
  }
}
.ckb:focus { outline: none; }
.ckb :where(button) {
  margin: 0; font: inherit; color: inherit;
}
.ckb [hidden] { display: none; }
.ckb svg {
  flex: none; width: 18px; height: 18px; fill: none;
  stroke: currentColor; stroke-width: 2;
  stroke-linecap: round; stroke-linejoin: round;
}
.ckb :focus-visible {
  outline: 3px solid var(--ckb-muted);
  outline-offset: 2px;
}

/* Schede */
.ckb-tabs {
  display: flex;
  border-bottom: 1px solid var(--ckb-border);
}
.ckb-tab {
  flex: 1 1 auto; min-height: 54px; padding: 0 14px;
  margin-bottom: -1px; background: none; border: 0;
  border-bottom: 2px solid transparent;
  border-radius: 0; font-size: 15px; font-weight: 600;
  color: var(--ckb-muted); cursor: pointer;
  transition: color .2s, background-color .2s;
}
.ckb-tab:hover { background: var(--ckb-soft); }
.ckb-tab[aria-selected="true"] {
  color: var(--ckb-text);
  border-bottom-color: var(--ckb-accent);
}
.ckb-close {
  flex: none; align-self: center; display: grid;
  place-items: center; width: 44px; height: 44px;
  margin: 0 6px; padding: 0; border: 0;
  border-radius: 8px; background: none;
  color: var(--ckb-muted); cursor: pointer;
  transition: color .2s;
}
.ckb-close:hover { color: var(--ckb-text); }
.ckb-tab:focus-visible, .ckb-cat:focus-visible,
.ckb-close:focus-visible { outline-offset: -3px; }

/* Contenuto */
.ckb-body {
  flex: 1 1 auto; min-height: 0; overflow-y: auto;
  overscroll-behavior: contain; scrollbar-width: thin;
}
.ckb-body.has-more {
  -webkit-mask-image: linear-gradient(
    to bottom, #000 calc(100% - 48px), transparent
  );
  mask-image: linear-gradient(
    to bottom, #000 calc(100% - 48px), transparent
  );
}
.ckb-panel { padding: 24px 28px; }
.ckb-title {
  margin: 0 0 8px; font-size: 21px; line-height: 1.2;
  font-weight: 700; letter-spacing: -.01em;
}
.ckb-panel p {
  margin: 0; max-width: 68ch; font-size: 15px;
  line-height: 1.6; color: var(--ckb-muted);
}
.ckb-panel p + p { margin-top: 10px; }
.ckb a {
  color: var(--ckb-text); font-weight: 600;
  text-decoration: underline; text-underline-offset: 3px;
}

/* Riga delle categorie: la casella è l'interruttore */
.ckb-cats {
  display: grid; grid-auto-flow: column;
  grid-auto-columns: 1fr;
  border-top: 1px solid var(--ckb-border);
}
.ckb-cat {
  display: flex; flex-direction: column;
  align-items: center; gap: 10px;
  padding: 16px 12px 18px; text-align: center;
  background: none; border: 0; border-radius: 0;
  transition: background-color .2s;
}
.ckb-cat + .ckb-cat {
  border-left: 1px solid var(--ckb-border);
}
button.ckb-cat { cursor: pointer; }
button.ckb-cat:hover,
button.ckb-cat[aria-checked="true"] {
  background: var(--ckb-soft);
}
.ckb-cat-name {
  font-size: 15px; font-weight: 600; line-height: 1.2;
}

/* Interruttore: spento a sinistra, acceso a destra */
.ckb-switch {
  position: relative; display: block; flex: none;
  width: 48px; height: 28px; padding: 0; border: 0;
  border-radius: 999px; background: var(--ckb-off);
  transition: background-color .2s;
}
button.ckb-switch { cursor: pointer; }
.ckb-switch::after {
  content: ""; position: absolute; top: 3px; left: 3px;
  width: 22px; height: 22px; border-radius: 50%;
  background: var(--ckb-bg);
  box-shadow: 0 1px 2px rgba(17, 17, 17, .3);
  transition: transform .22s var(--ckb-ease);
}
.ckb-switch[aria-checked="true"],
.ckb-cat[aria-checked="true"] .ckb-switch {
  background: var(--ckb-accent);
}
.ckb-switch[aria-checked="true"]::after,
.ckb-cat[aria-checked="true"] .ckb-switch::after,
.ckb-switch.is-locked::after {
  transform: translateX(20px);
}
.ckb-switch.is-locked { background: var(--ckb-locked); }

/* Scheda Dettagli: una fisarmonica per categoria */
.ckb-group {
  padding: 18px 0;
  border-top: 1px solid var(--ckb-border);
}
.ckb-group:first-child { border-top: 0; padding-top: 2px; }
.ckb-group:last-child { padding-bottom: 2px; }
.ckb-group-head {
  display: flex; align-items: center;
  justify-content: space-between; gap: 16px;
}
.ckb-group-toggle {
  display: flex; align-items: center; gap: 12px;
  min-height: 36px; margin-left: -6px;
  padding: 0 10px 0 6px; border: 0; border-radius: 8px;
  background: none; cursor: pointer; text-align: left;
  transition: background-color .2s;
}
.ckb-group-toggle:hover { background: var(--ckb-soft); }
.ckb-group-toggle svg {
  transition: transform .25s var(--ckb-ease);
}
.ckb-group-toggle[aria-expanded="true"] svg {
  transform: rotate(180deg);
}
.ckb-group-name {
  font-size: 16px; font-weight: 600; line-height: 1.2;
}
.ckb-count {
  min-width: 26px; padding: 3px 8px;
  border-radius: 999px; background: var(--ckb-soft);
  font-size: 12.5px; font-weight: 600; line-height: 1.2;
  text-align: center;
}
.ckb-group p {
  margin-top: 8px; padding-left: 30px;
  font-size: 14.5px; line-height: 1.55;
}
.ckb-services {
  list-style: none; margin: 14px 0 0 30px; padding: 0;
  border: 1px solid var(--ckb-border);
  border-radius: 12px; overflow: hidden;
}
.ckb-services li {
  display: grid; grid-template-columns: 170px 1fr;
  gap: 4px 16px; margin: 0; padding: 12px 14px;
  font-size: 13.5px; line-height: 1.5;
}
.ckb-services li + li {
  border-top: 1px solid var(--ckb-border);
}
.ckb-services b { font-weight: 600; }
.ckb-services small {
  display: block; font-size: 12.5px; font-weight: 400;
  color: var(--ckb-muted);
}
.ckb-services span { color: var(--ckb-muted); }
.ckb-services a { font-size: 12.5px; white-space: nowrap; }

/* Pulsanti: stessa misura, cambia solo il riempimento */
.ckb-actions {
  display: grid; grid-auto-flow: column;
  grid-auto-columns: 1fr; gap: 12px;
  padding: 16px 28px 24px;
  border-top: 1px solid var(--ckb-border);
}
.ckb-btn {
  min-height: 50px; padding: 0 14px;
  border: 1.5px solid var(--ckb-accent);
  border-radius: var(--ckb-btn-radius);
  background: var(--ckb-bg); color: var(--ckb-text);
  font-size: 15px; font-weight: 600; cursor: pointer;
  transition: background-color .2s, border-color .2s;
}
.ckb-btn:hover { background: var(--ckb-soft); }
.ckb .ckb-primary {
  background: var(--ckb-accent);
  color: var(--ckb-on-accent);
}
.ckb .ckb-primary:hover {
  background: var(--ckb-accent-hover);
  border-color: var(--ckb-accent-hover);
}

/* Pulsante fisso per riaprire le scelte */
.ckb-manage {
  position: fixed; bottom: 16px; z-index: 9989;
  display: grid; place-items: center;
  width: 48px; height: 48px; padding: 0;
  border: 1px solid var(--ckb-border);
  border-radius: 50%; cursor: pointer;
  background: var(--ckb-bg); color: var(--ckb-text);
  box-shadow: 0 6px 20px -10px rgba(17, 17, 17, .35);
  transition: background-color .2s;
}
.ckb-manage svg {
  width: 24px; height: 24px; fill: none;
  stroke: currentColor; stroke-width: 2;
  stroke-linecap: round; stroke-linejoin: round;
}
.ckb-manage:hover { background: var(--ckb-soft); }
.ckb-manage:focus-visible {
  outline: 3px solid var(--ckb-muted);
  outline-offset: 2px;
}
.ckb-manage-left { left: 16px; }
.ckb-manage-right { right: 16px; }

/* Telefono: foglio dal basso, pulsanti in colonna */
@media (max-width: 639px) {
  .ckb {
    left: 0; right: 0; top: auto; bottom: 0;
    width: 100%; max-height: 92dvh;
    border-radius: 20px 20px 0 0; transform: none;
    animation-name: ckb-sheet;
  }
  @keyframes ckb-sheet {
    from { opacity: 0; transform: translateY(24px); }
  }
  .ckb-tab {
    min-height: 50px; padding: 0 8px; font-size: 13.5px;
  }
  .ckb-panel { padding: 18px 20px; }
  .ckb-title { font-size: 19px; }
  .ckb-panel p { font-size: 14.5px; line-height: 1.55; }
  .ckb-cat { padding: 12px 6px 14px; gap: 8px; }
  .ckb-cat-name { font-size: 14px; }
  .ckb-group p { padding-left: 0; }
  .ckb-services { margin-left: 0; }
  .ckb-services li { grid-template-columns: 1fr; }
  .ckb-actions {
    grid-auto-flow: row; gap: 8px;
    padding: 12px 20px 16px;
    padding-bottom: calc(
      16px + env(safe-area-inset-bottom)
    );
  }
  .ckb-btn { min-height: 48px; }
}
@media (prefers-reduced-motion: reduce) {
  .ckb, .ckb-scrim, .ckb *, .ckb *::after {
    transition: none !important;
    animation: none !important;
  }
}

Capitolo 14 di 14: Domande frequenti

Il pulsante «Rifiuta» è obbligatorio?

Serve un comando per proseguire senza consenso già nel banner. Il Garante lo indica con una X in alto a destra. Un pulsante «Rifiuta» ben visibile fa lo stesso lavoro. Per la maggior parte delle autorità europee la sua assenza dalla prima schermata è una violazione.

Posso colorare solo il pulsante «Accetta»?

È una zona grigia. L’EDPB non fissa uno standard su colori e contrasti e valuta caso per caso. Il Garante chiede comandi di uguali dimensioni, enfasi e colori. Tieni almeno la stessa misura per tutti e un rifiuto ben leggibile.

Ogni quanto posso richiedere il consenso a chi ha rifiutato?

Non prima di sei mesi. Puoi ripresentare il banner prima solo se cambiano in modo significativo le condizioni, per esempio se aggiungi nuovi servizi di terze parti.

Lo scroll della pagina vale come consenso?

No. Per il Garante il semplice scorrimento non è mai sufficiente da solo a esprimere il consenso.

Se uso solo cookie tecnici serve il banner?

No, basta l’informativa. Lo stesso vale per le statistiche quando sono equiparate ai cookie tecnici. Succede se l’indirizzo IP è mascherato, i dati sono solo aggregati e il fornitore non li incrocia con altri.

Dove metto il link per cambiare il consenso?

Nel footer di ogni pagina, con un’etichetta chiara come «Gestisci cookie». Se alcune pagine non hanno il footer, usa un’icona fissa in un angolo in basso, a sinistra o a destra, con il nome «Gestisci cookie» per chi usa un lettore di schermo. L’importante è che sia raggiungibile da ogni pagina.

Posso chiedere il banner all’AI senza dargli il codice?

Puoi, ma devi scrivere tu le regole nel prompt. Chiedi interruttori spenti, rifiuto nella prima schermata e script caricati solo dopo il consenso. Poi controlla il risultato da visitatore, perché l’agente non lo fa da solo.

Felice NittiCEO & co-founder di Minnovo

Ti è stato utile?

Newsletter · Briefinn

Sette notizie ogni lunedì. Il resto è rumore.

La leggono già oltre 22.000 innovatori.

Gratis, niente spam. Ti cancelli quando vuoi.