Personalização de CSS do filtro de produtos WooCommerce: skins e correções
A personalização de CSS do filtro de produtos WooCommerce costuma começar com um pequeno desejo: caixas de seleção na cor da marca, títulos menores, uma lista suspensa que combine com o tema ou a correção para um tema que desenha uma segunda caixa ao lado de cada checkbox. O HUSKY cobre parte disso com configurações, e o resto exige algumas linhas de CSS, desde que você saiba onde colocá-las e quais classes usar. Este guia traz as duas coisas, além das correções para os conflitos de tema que encontramos com mais frequência.
Primeiro as configurações, depois o CSS
A aba Design (WooCommerce → Configurações → Products Filter → Design) muda a aparência sem código:
- Skin de botões de opção e caixas de seleção (Radio and checkboxes skin): os skins flat, minimal e square em dez cores, ou nenhum (none) para as caixas do próprio navegador.
- Skin da lista suspensa (Drop-down skin): Native, Chosen ou SelectWoo.
- Skin do range-slider (Range-slider skin) para o ion range-slider, Usar tooltip (Use tooltip) e Ícone do tooltip (Tooltip icon), as imagens de alternar e de mais/menos e a sobreposição de carregamento.
Todo o resto vai em Avançado (Advanced) → Código (Code) → Código CSS personalizado (Custom CSS code). O HUSKY imprime esse código logo depois da sua própria folha de estilo em todas as páginas em que é carregado e o mantém nas suas configurações, por isso as atualizações do plugin não mexem nele. Cole apenas regras CSS simples: tags HTML como <style> são removidas quando as configurações são salvas, e as barras invertidas não são mantidas de forma confiável, então escreva o símbolo diretamente (content: "✓") em vez de um escape de CSS como \2713. O CSS adicional (Additional CSS) do tema no Personalizador ou a folha de estilo de um tema filho funcionam igualmente bem. Nunca edite o css/front.css do plugin: a próxima atualização o substitui.
Link do arquivo de estilos CSS front personalizado (Custom front css styles file link), no fim da aba Design, é outra ferramenta. Ela carrega o seu arquivo no lugar do front.css, não além dele, então use-a apenas para uma reescrita completa que parta de uma cópia do arquivo do plugin.
Fazendo as suas regras prevalecerem
As folhas de estilo do tema muitas vezes são carregadas depois do plugin e usam seletores longos, e algumas regras do plugin trazem !important. Comece cada regra com .woof, ou body .woof quando o tema ainda vencer, e adicione !important apenas onde o plugin ou o tema já o usa. Para estilizar um filtro e deixar os outros em paz, dê a ele um ID com o atributo sid: [woof sid="sidebar"] adiciona a classe woof_sid_sidebar ao formulário. Mantenha o ID em uma só palavra, sem espaços. Três IDs já vêm com estilos prontos na folha de estilo do plugin: flat_grey, flat_dark e flat_white. O widget sempre usa woof_sid_widget. O filtro automático acima dos produtos obtém as suas classes da configuração de skin: woof_sid_auto_shortcode com o skin Padrão (Default) e woof_sid_flat_grey mais woof_auto_2_columns com o skin flat cinza com o qual uma nova instalação começa; inspecione o formulário para ver qual deles o seu site usa.
O mapa de classes
| Elemento | Seletor |
|---|---|
| Formulário inteiro do filtro | .woof, .woof_sid_<sid> |
| Um bloco do filtro | .woof_container, por tipo .woof_container_checkbox, .woof_container_radio, .woof_container_select; por taxonomia .woof_container_product_cat, .woof_container_pa_color |
| Título do bloco | .woof_container_inner h4 |
| Lista e itens | .woof_list, .woof_list li; subcategorias .woof_childs_list |
| Checkbox, rótulo, contagem | input.woof_checkbox_term, .woof_checkbox_label, .woof_checkbox_count; selecionado .woof_checkbox_label_selected |
| Botão de opção e rótulo | input.woof_radio_term, .woof_radio_label |
| Botões de rótulo | .woof_list_label .woof_label_term, selecionado .woof_label_term.checked |
| Lista suspensa nativa | select.woof_select |
| Botões Filtrar e Redefinir | .woof_submit_search_form_container button, .woof_submit_search_form, .woof_reset_search_form |
O inspetor do navegador (clique com o botão direito em um elemento, Inspecionar (Inspect)) mostra as classes exatas do seu filtro e qual regra prevalece. O CSS usado no site de demonstração é uma boa fonte de exemplos prontos.
Checkboxes e botões de opção: cor, tamanho e nitidez
Os skins flat, minimal e square desenham cada caixa a partir de um pequeno sprite de imagem: uma única imagem contém lado a lado os estados desmarcado, marcado e desativado, e o CSS mostra a parte certa dela. Duas consequências: o CSS não consegue recolorir a caixa, e alterar o width, o height ou a escala dela mostra estados vizinhos ou a deixa borrada e pixelada. Escolha a cor de skin mais próxima do seu design ou passe para as caixas do navegador.
Para uma cor da marca ou uma caixa maior, defina Skin de botões de opção e caixas de seleção (Radio and checkboxes skin) como nenhum (none) e estilize os inputs nativos. O accent-color os colore em todos os navegadores atuais:
/* Skin "none": colour and size of the browser's own boxes */
.woof .woof_list input.woof_checkbox_term,
.woof .woof_list input.woof_radio_term {
accent-color: #1f7a4d;
width: 18px;
height: 18px;
}
Se as caixas mantiverem a aparência do tema depois disso, é porque o tema reestiliza todos os checkboxes do site; veja a seção sobre conflitos de tema mais abaixo. Se você mantiver um skin, ainda pode substituir o sprite dele por uma cópia recolorida com o mesmo layout (as imagens estão na pasta js/icheck/skins/ do plugin) por meio de uma regra background-image na classe do skin, por exemplo .woof .icheckbox_flat-blue. Para elementos totalmente personalizados sem CSS, a extensão Smart Designer cria designs de checkbox, botão de opção e interruptor no admin; veja como criar o seu próprio elemento de filtro.
Caixas simples piscam antes de o skin aparecer
Os skins são aplicados por JavaScript depois que a página é carregada, então por um instante as caixas do próprio navegador ficam visíveis. O JavaScript adiado por um plugin de otimização prolonga esse instante; veja a otimização de JavaScript e o filtro. Com qualquer skin diferente de nenhum (none), oculte os inputs até que o skin os envolva:
/* Only with a skin other than "none": hide inputs until the skin wraps them */
.woof .woof_list li > input.woof_checkbox_term,
.woof .woof_list li > input.woof_radio_term {
visibility: hidden;
}
O skin move cada input para o seu próprio elemento de caixa, então a regra deixa de corresponder assim que o skin está pronto. Com o skin definido como nenhum (none) ela ocultaria as caixas para sempre, então não a use nesse caso.
Rótulos longos, espaçamento e botões de rótulo
O plugin exibe cada rótulo como um bloco em linha ao lado da sua caixa. Quando o nome de uma categoria ou atributo é mais longo que a linha, o rótulo inteiro cai para baixo do checkbox. Use uma destas duas correções, conforme a aparência desejada:
/* A: the text starts next to the box and wraps underneath it */
.woof .woof_list label {
display: inline !important;
}
/* B: the text stays in its own column next to the box */
.woof .woof_list label {
max-width: calc(100% - 35px);
vertical-align: top;
}
Ajuste 35px à largura das suas caixas. Quanto ao espaçamento, o plugin dá a cada bloco 5 px de preenchimento inferior e 9 px de margem inferior, e a cada rótulo 4 px de preenchimento acima e abaixo:
/* Tighter filter: less space between blocks and between items */
.woof .woof_container {
margin-bottom: 4px;
padding-bottom: 0;
}
.woof .woof_list label {
padding-top: 2px;
padding-bottom: 2px;
}
.woof .woof_checkbox_count {
margin-left: 6px;
color: #888;
}
Para o tipo rótulo (label) (termos como botões), o plugin define uma caixa cinza-clara e um estado azul ao passar o mouse e ao selecionar. Larguras iguais e as suas próprias cores:
.woof .woof_list_label .woof_label_term {
min-width: 60px;
}
.woof .woof_list_label li .woof_label_term:hover,
.woof .woof_list_label li .woof_label_term.checked {
background-color: #1f7a4d;
border-color: #1f7a4d;
}
O recuo e o recolhimento das subcategorias são tratados em árvores de categorias recolhíveis.
Títulos: fonte, tamanho e tag de título
Os títulos dos blocos são elementos h4 dentro de .woof_container_inner, inclusive o título do filtro de preço, e por isso herdam o estilo de h4 do tema:
.woof .woof_container_inner h4 {
font-family: inherit;
font-size: 15px;
font-weight: 600;
text-transform: none;
margin-bottom: 6px;
}
Para uma tag diferente, por exemplo para se encaixar na hierarquia de títulos da sua página, use o filtro woof_title_tag. Retorne p ou span se os títulos não devem ser cabeçalhos de forma alguma:
/*
* HUSKY: print filter block titles as <h3> instead of <h4>.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('woof_title_tag', function ($tag) {
return 'h3';
});
As regras escritas para h4 deixam então de ser aplicadas: a margem do próprio plugin, os estilos de título dos IDs de filtro integrados flat_grey e flat_dark e o seu próprio CSS. Reescreva-as para a nova tag, por exemplo .woof .woof_container_inner h3.
O título acima do widget inteiro é diferente. Em uma barra lateral do tema, ele usa a marcação de título de widget que o tema define para todos os widgets; woof_widget_title_tag (padrão h3) só se aplica quando o widget é impresso sem essa marcação. Para alterar os textos dos títulos em vez do estilo deles, veja como renomear os títulos do filtro.
Listas suspensas: Native, Chosen ou SelectWoo
Quando os estilos de um tema entram em choque com as listas suspensas (texto cortado, tags fora do lugar em seleções múltiplas, cores erradas), troque Skin da lista suspensa (Drop-down skin) antes de escrever CSS. Cada skin é uma biblioteca diferente, e o conflito muitas vezes desaparece com outra. Os snippets que usam o filtro woof_use_chosen não alteram mais nada; quem decide é a configuração.
- Native: o
selectdo navegador, estilizado pelo seu tema. Use como alvo.woof select.woof_select. - Chosen: a caixa é
.chosen-containercom.chosen-single(única) ou.chosen-choices(múltipla), e a lista aberta.chosen-results lifica dentro do filtro, então.woofdelimita tudo. - SelectWoo: a caixa é
.select2-containerdentro do filtro, mas a lista aberta é anexada ao final da página. As regras para.select2-dropdownnão podem ser delimitadas com.woofe afetam também outros campos SelectWoo, como o campo de país no checkout.
/* Chosen: closed box and open list */
.woof .chosen-container-single .chosen-single {
text-align: left;
background: #fff;
border-color: #ccc;
border-radius: 4px;
}
.woof .chosen-container .chosen-results li {
font-size: 15px;
color: #222;
}
Tooltips
O ícone de informação ao lado do título de um bloco abre, ao clicar, o texto da opção Tooltip do bloco. Ele usa a biblioteca Tooltipster com o tema noir:
.tooltipster-sidetip.tooltipster-noir .tooltipster-box {
background: #fff;
border: 1px solid #ddd;
border-radius: 6px;
}
.tooltipster-sidetip.tooltipster-noir .tooltipster-content {
color: #333;
font-size: 14px;
}
Caixas de tooltip vazias, ou tooltips em outras partes do site virando quadrados cinzentos, significam que outro script da página usa a mesma biblioteca de tooltips ou uma que entra em conflito com ela (relatado com o tema Flatsome e com plugins de selos de produto). Defina Usar tooltip (Use tooltip) como Não (No) na aba Design; os ícones de informação desaparecem então do filtro.
Os nomes que aparecem sobre as amostras de cor e de imagem são CSS simples (p.woof_tooltip span.woof_tooltip_data). Se um desses nomes cobrir a amostra vizinha e capturar os cliques dela, deixe os cliques passarem por ele:
.woof p.woof_tooltip span.woof_tooltip_data {
pointer-events: none;
}
Conflitos de tema: caixas duplas, cerquilhas e alinhamento
Muitos temas estilizam todas as listas, rótulos e checkboxes da página, inclusive o filtro. Inspecione o elemento intruso para encontrar a regra do tema e desative-a apenas dentro de .woof.
- Duas caixas por item. O tema desenha o seu próprio checkbox com um pseudoelemento nos rótulos. As listas do HUSKY não usam pseudoelementos, então é seguro removê-los ali:
.woof .woof_list label::before, .woof .woof_list label::after { display: none !important; } - Cerquilhas, setas ou ícones antes dos itens. Uma regra do tema para listas de widgets adiciona conteúdo antes de cada
li:.woof .woof_list li::before { content: none !important; } - Um marcador ao lado do widget inteiro. O tema imprime os widgets como itens de lista:
li.WOOF_Widget { list-style: none; }. - Campos centralizados ou cortados.
body .woof .woof_redraw_zone { text-align: left; }corrige o texto centralizado pelo tema; o conteúdo cortado na borda da barra lateral costuma vir deoverflow: hiddenno widget, então defina.widget.WOOF_Widget { overflow: visible; }. - Checkboxes invisíveis. Uma regra do tema oculta os inputs ou as caixas do skin; experimente outro skin primeiro e depois procure a regra no inspetor.
Para estilos diferentes no celular ou enquanto uma pesquisa está em andamento, veja CSS por dispositivo e estilizar a página durante a filtragem.
Checklist
- Skin, skin da lista suspensa e tooltips escolhidos na aba Design antes de escrever CSS.
- CSS em Código CSS personalizado (Custom CSS code) ou no tema, nunca na pasta do plugin; regras simples, sem escapes.
- Toda regra começa com
.woofou com uma classe.woof_sid_. - Skin nenhum (none) mais
accent-colorpara as cores da marca; sem redimensionar os skins de sprite. - Depois de uma mudança em
woof_title_tag, regras parah4reescritas. - Caches e otimização de CSS limpos antes de avaliar o resultado.
Para um layout específico que essas regras não cobrem, publique o link da página e uma descrição da aparência desejada no fórum de suporte do HUSKY; o FAQ sobre pequenas personalizações de CSS explica o que incluir.