Theming com tokens --fdl-*
Os tokens são a via suportada de mudar o aspeto da pesquisa com CSS.
São custom properties versionadas: declara-as uma vez e o widget aplica-as
em todos os seus componentes, por cima da configuração do painel e do preset visual ativo.
Uso básico
A partir de qualquer folha de estilos da sua loja (não é preciso tocar no painel):
.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;
}
Ou a partir do Custom CSS do painel (Aparência → Avançado), sobre a raiz do widget:
.kos-search {
--fdl-primary: #0d7a5e;
--fdl-btn-radius: 8px;
} Referência de tokens
Cor
| Token | Default | Controla |
| --fdl-primary | #18181b | Cor principal: botões, foco, elementos ativos. Equivale à «Cor principal» do painel. |
| --fdl-primary-soft | #f4f4f5 | Versão suave da cor principal (fundos de chips ativos, hovers marcados). |
| --fdl-accent | #dc2626 | Cor de destaque: preços em promoção, badges de desconto. Equivale à «Cor de destaque» do painel. |
| --fdl-text | #18181b | Cor do texto principal. |
| --fdl-text-muted | #71717a | Texto secundário: categorias, contadores, subtítulos. |
| --fdl-bg | #fafafa | Fundo geral da pesquisa. |
| --fdl-surface | #ffffff | Fundo de superfícies elevadas: cards, painéis, dropdowns. |
| --fdl-border | #e4e4e7 | Cor das bordas e separadores. |
| --fdl-hover | #f4f4f5 | Fundo dos elementos ao passar o rato. |
Carrinho
| Token | Default | Controla |
| --fdl-cart-btn-bg | color principal | Fundo do botão «Adicionar ao carrinho». |
| --fdl-cart-btn-text | #ffffff | Texto e ícone do botão «Adicionar ao carrinho». |
| --fdl-cart-btn-hover-bg | auto (aclarado) | Fundo do botão em hover. |
| --fdl-cart-btn-hover-text | hereda | Texto do botão em hover. |
| --fdl-cart-badge-bg | verde | Fundo do contador de unidades do carrinho (cabeçalho). |
Imagem
| Token | Default | Controla |
| --fdl-img-bg | gris suave | Fundo da caixa de imagem do produto nos cards. |
Forma
| Token | Default | Controla |
| --fdl-radius-sm | 0px | Raio de canto pequeno (inputs, chips internos). |
| --fdl-radius-md | 0px | Raio de canto médio (cards, painéis). |
| --fdl-radius-lg | 0px | Raio de canto grande (modal, sheets). |
| --fdl-btn-radius | 999px | Raio do botão «Adicionar ao carrinho» (999px = pílula). |
| --fdl-chip-radius | 999px | Raio de chips e sugestões. |
| --fdl-card-pad | 0px | Padding interior do card de produto. |
| --fdl-card-shadow | none | Sombra dos cards de produto. |
| --fdl-modal-shadow | 0 20px 60px rgba(0,0,0,.18) | Sombra do modal da pesquisa. |
Tipografia
| Token | Default | Controla |
| --fdl-font-display | hereda | Tipografia de títulos e nomes de produto. |
| --fdl-font-body | hereda | Tipografia dos restantes textos. |
Animação
| Token | Default | Controla |
| --fdl-anim-duration | 180ms | Duração das transições do widget. |
| --fdl-anim-easing | ease | Curva das transições do widget. |
Precedência
Da maior para a menor prioridade:
os seus tokens →
ajustes do painel (cores, colunas…) →
preset visual →
defaults do widget.
Um token que declare ganha sempre ao que está configurado no painel para essa mesma propriedade.
Valores responsive
Declare o token sempre (fora de media queries) e mude o seu valor dentro delas.
A presença do token é detetada ao carregar; o seu valor, esse, é seguido em direto.
.findalo-search-host { --fdl-card-pad: 12px; }
@media (max-width: 640px) {
.findalo-search-host { --fdl-card-pad: 8px; }
}