🎉 USE O CUPOM DESCONTO.FULL | 20% OFF acima de R$ 50,00

Como corrigir o CSS personalizado que não aplica no WPForms

Time Full Services Time Full Services
Tipo Outros erros
Nome do erro CSS personalizado não aplica no WPForms EN: WPForms custom CSS not applying
Severidade Atenção
Descrição O CSS do WPForms que não aplica acontece quando o estilo personalizado e ignorado e o formulário mantem a aparencia padrão. A causa quase sempre e a especificidade do seletor padrão do plugin (div.wpforms-container-full) vencendo o seu, ou o cache servindo a folha antiga.

O que é o CSS do WPForms que não aplica no formulário?

O WPForms carrega sua própria folha de estilo para garantir uma aparencia consistente do formulário em qualquer tema do WordPress. Quando você adiciona CSS personalizado, ele compete com esses estilos padrão: se o seu seletor for menos específico que o do plugin, o navegador aplica o estilo do WPForms e ignora o seu. Por isso o formulário abre com a aparencia padrão mesmo depois de você salvar o CSS. Não e um bug do plugin, e a regra de especificidade do CSS resolvendo o conflito a favor do seletor mais longo.

Como identificar

  • O formulário abre com a fonte, cores e botão padrão do WPForms mesmo depois de salvar o CSS personalizado no Personalizar – CSS adicional.
  • Ao inspecionar o campo no navegador, a regra do WPForms aparece ativa e a sua regra aparece riscada (sobrescrita).
  • Você adiciona um !important no CSS e mesmo assim o estilo padrão do WPForms continua vencendo.
  • O CSS funciona em uma janela anonima mas não na navegação normal, ou aparece em um navegador e não em outro.

Como prevenir

  • Sempre inicie o CSS personalizado pela cadeia div.wpforms-container-full para igualar a especificidade padrão do WPForms desde o comeco.
  • Mantenha o CSP de formulários em Aparencia – Personalizar – CSS adicional, num so lugar versionado, em vez de espalhado por campos.
  • Após qualquer alteração de CSS, limpe o cache do plugin e do servidor para não testar uma folha antiga.

Causa

  • Seletor do seu CSS menos específico que o padrão do WPForms: o plugin usa div.wpforms-container-full .wpforms-form .wpforms-title e o seu .wpforms-title perde a disputa de especificidade.
  • Opção Include Form Styling em WPForms - Settings - General definida como Base and form theme styling, o tema de formulário mais agressivo que sobrescreve estilos do tema e do seu CSS.
  • Cache do navegador, do plugin de cache ou do servidor servindo a versão antiga da folha de estilo, sem o CSS recem-adicionado.
  • Sintaxe de CSS invalida: chave de abertura ou fechamento faltando, dois-pontos ausente entre propriedade e valor, ponto e virgula esquecido ou espaco dentro da unidade (26 px em vez de 26px).
  • CSS personalizado colado dentro do formulário ou no Custom CSS de um campo em vez do CSS adicional do tema, sem o aninhamento de seletor necessário.

Como resolver

  1. Inspecione o campo e copie o seletor padrão: no navegador, clique com o botão direito no elemento do formulário e abra Inspecionar para ver qual regra do WPForms esta vencendo. Use exatamente a mesma cadeia de seletor, do maior container ao menor, como base do seu CSS.
    div.wpforms-container-full .wpforms-form .wpforms-title { font-size: 26px; }
  2. Iguale a especificidade no seu CSS: reescreva a sua regra com a cadeia completa do container, em vez de apenas a classe do campo, para que ela vença a regra padrão sem depender de gambiarra.
    div.wpforms-container-full .wpforms-form .wpforms-title { font-size: 32px; }
  3. Coloque o CSS no lugar certo: adicione o CSS em Aparencia - Personalizar - CSS adicional, e não dentro do formulário nem no Custom CSS de um campo isolado, para que ele carregue em toda página que exibe o formulário.
  4. Ajuste o Include Form Styling se o tema agressivo atrapalhar: em WPForms - Settings - General, mude Include Form Styling de Base and form theme styling para Base styling only quando o tema de formulário do plugin estiver sobrescrevendo o estilo do seu tema e o seu CSS.
    WPForms - Settings - General - Include Form Styling: Base styling only
  5. Limpe todos os caches e revalide a sintaxe: limpe o cache do navegador, do plugin de cache e do servidor, e confira se cada regra tem chave de abertura e fechamento, dois-pontos e ponto e virgula, sem espaco na unidade, antes de testar de novo.
CSS
/* CSS adicional do tema (Aparencia > Personalizar > CSS adicional). */
/* Igualar a cadeia de seletor padrao do WPForms vence sem !important. */
div.wpforms-container-full .wpforms-form .wpforms-title {
  font-size: 32px;
  margin: 0 0 12px 0;
}

div.wpforms-container-full .wpforms-form input.wpforms-field-medium {
  border: 1px solid #2563eb;
  border-radius: 6px;
}

div.wpforms-container-full .wpforms-form button[type=submit].wpforms-submit {
  background: #2563eb;
  color: #ffffff;
}

Perguntas frequentes

Por que meu CSS do WPForms não aplica mesmo salvo?
Porque o seletor padrão do WPForms e mais específico que o seu. O plugin usa cadeias longas como div.wpforms-container-full .wpforms-form, e o navegador aplica o seletor mais específico. Reescreva a sua regra com a mesma cadeia completa do container para que ela vença a disputa.
Coloquei !important e o estilo padrão do WPForms continua vencendo. Por que?
O !important nem sempre resolve. A própria documentação do WPForms avisa que, em muitos casos, o navegador prefere a especificidade da regra padrão mesmo com !important. O caminho confiavel e igualar a cadeia de seletor, comecando por div.wpforms-container-full, em vez de depender do !important.
Onde devo colar o CSS personalizado do WPForms?
Em Aparencia - Personalizar - CSS adicional do WordPress. Esse local carrega o estilo em toda página que exibe o formulário. Evite colar dentro do formulário ou no Custom CSS de um único campo, porque ali o aninhamento de seletor fica incompleto e o estilo não se aplica de forma consistente.
O que e a opção Include Form Styling do WPForms?
E um menu em WPForms - Settings - General que controla quanto CSS o plugin carrega. Base and form theme styling e o padrão e o mais agressivo. Base styling only carrega so o básico e devolve o controle ao tema. No styling remove todo o estilo e exige CSS extenso, sendo voltado a desenvolvedores.
Mudar Include Form Styling para No styling resolve o conflito?
Geralmente não e a melhor escolha. No styling remove toda a folha do WPForms e, segundo a documentação, exige CSS personalizado extenso para layouts e campos voltarem a funcionar. Para a maioria dos casos, Base styling only já reduz a agressividade sem quebrar o formulário.
Meu CSS aparece em janela anonima mas não na normal. O que e isso?
E cache. A janela anonima ignora o cache antigo e mostra a folha nova, enquanto a navegação normal ainda serve a versão em cache sem o seu CSS. Limpe o cache do navegador, do plugin de cache e do servidor para que o estilo apareça em todas as sessoes.
Preciso editar arquivos do tema para estilizar o WPForms?
Não para a maioria dos ajustes. Igualar a especificidade do seletor e colar o CSS em CSS adicional resolve sem tocar em arquivos. Editar o style.css do tema so faz sentido em personalizacoes amplas, e mesmo assim use sempre um tema filho para não perder as mudancas em atualizações.

Seja PRO.

Tenha acesso a snippets de código premium — PHP, JavaScript, CSS e HTML prontos para usar em seus projetos.

Conhecer o plano Pro →

Uma nova era para o WordPress.

A FULL Services redefine o CMS com uma arquitetura modular que transforma o WordPress em um motor de crescimento digital. 

Painéis personalizados

Um novo nível de controle para o WordPress. Acompanhe métricas, automações e evolução do seu site em um único painel visual.

A força por trás de grandes marcas

Para agências, estúdios e profissionais independentes que desejam oferecer soluções de alto nível com sua própria marca.

Componentes

Hero Sections

30 componentes

Seções de CTA

14 componentes

Login

14 componentes

Blog

14 componentes

Cabeçalhos

24 componentes

Seções de FAQ

53 componentes

Cadastro

53 componentes

Blog individual

53 componentes

Rodapés

28 componentes

Seções de contato

27 componentes

Seções de preços

27 componentes

Faixas

27 componentes

Portfólio

16 componentes

Seções de equipe

12 componentes

Números

12 componentes

Logotipos

12 componentes