Theming con i token --fdl-*
I token sono la via supportata per cambiare l'aspetto della ricerca con il CSS.
Sono custom properties versionate: le dichiari una volta e il widget le applica
in tutti i suoi componenti, sopra la configurazione del pannello e il preset visivo attivo.
Uso di base
Da un foglio di stile qualsiasi del tuo negozio (non serve toccare il pannello):
.findalo-search-host {
--fdl-primary: #0d7a5e;
--fdl-radius-md: 14px;
--fdl-card-shadow: 0 4px 12px rgba(0, 0, 0, 0.06);
--fdl-font-display: "Poppins", sans-serif;
}
Oppure dal Custom CSS del pannello (Aspetto → Avanzato), sulla radice del widget:
.kos-search {
--fdl-primary: #0d7a5e;
--fdl-btn-radius: 8px;
} Riferimento dei token
Colore
| Token | Default | Controlla |
| --fdl-primary | #18181b | Colore principale: pulsanti, focus, elementi attivi. Equivale al «Colore principale» del pannello. |
| --fdl-primary-soft | #f4f4f5 | Versione tenue del colore principale (sfondi dei chip attivi, hover marcati). |
| --fdl-accent | #dc2626 | Colore d'accento: prezzi in offerta, badge di sconto. Equivale al «Colore d'accento» del pannello. |
| --fdl-text | #18181b | Colore del testo principale. |
| --fdl-text-muted | #71717a | Testo secondario: categorie, contatori, sottotitoli. |
| --fdl-bg | #fafafa | Sfondo generale del widget di ricerca. |
| --fdl-surface | #ffffff | Sfondo delle superfici in rilievo: card, pannelli, dropdown. |
| --fdl-border | #e4e4e7 | Colore di bordi e separatori. |
| --fdl-hover | #f4f4f5 | Sfondo degli elementi al passaggio del mouse. |
Carrello
| Token | Default | Controlla |
| --fdl-cart-btn-bg | color principal | Sfondo del pulsante «Aggiungi al carrello». |
| --fdl-cart-btn-text | #ffffff | Testo e icona del pulsante «Aggiungi al carrello». |
| --fdl-cart-btn-hover-bg | auto (aclarado) | Sfondo del pulsante in hover. |
| --fdl-cart-btn-hover-text | hereda | Testo del pulsante in hover. |
| --fdl-cart-badge-bg | verde | Sfondo del contatore di unità del carrello (intestazione). |
Immagine
| Token | Default | Controlla |
| --fdl-img-bg | gris suave | Sfondo del riquadro immagine del prodotto nelle card. |
Forma
| Token | Default | Controlla |
| --fdl-radius-sm | 0px | Raggio del bordo piccolo (input, chip interni). |
| --fdl-radius-md | 0px | Raggio del bordo medio (card, pannelli). |
| --fdl-radius-lg | 0px | Raggio del bordo grande (modal, sheet). |
| --fdl-btn-radius | 999px | Raggio del pulsante «Aggiungi al carrello» (999px = pillola). |
| --fdl-chip-radius | 999px | Raggio di chip e suggerimenti. |
| --fdl-card-pad | 0px | Padding interno della card prodotto. |
| --fdl-card-shadow | none | Ombra delle card prodotto. |
| --fdl-modal-shadow | 0 20px 60px rgba(0,0,0,.18) | Ombra del modal di ricerca. |
Tipografia
| Token | Default | Controlla |
| --fdl-font-display | hereda | Tipografia dei titoli e dei nomi dei prodotti. |
| --fdl-font-body | hereda | Tipografia di tutti gli altri testi. |
Animazione
| Token | Default | Controlla |
| --fdl-anim-duration | 180ms | Durata delle transizioni del widget. |
| --fdl-anim-easing | ease | Curva delle transizioni del widget. |
Precedenza
Dalla priorità più alta alla più bassa:
i tuoi token →
impostazioni del pannello (colori, colonne…) →
preset visivo →
default del widget.
Un token che dichiari vince sempre su quanto configurato nel pannello per quella stessa proprietà.
Valori responsive
Dichiara il token sempre (fuori dalle media query) e cambia il suo valore al loro interno.
La presenza del token viene rilevata al caricamento; il suo valore invece viene seguito in tempo reale.
.findalo-search-host { --fdl-card-pad: 12px; }
@media (max-width: 640px) {
.findalo-search-host { --fdl-card-pad: 8px; }
}