Ir para o conteúdo
Converto Ajuda
Páginas e construtor

CSS e JS personalizado

Como escrever CSS e JavaScript em qualquer elemento ou página do Converto, incluindo a sintaxe curta de media queries por breakpoint.

Avançado4 min de leitura
Nesta página

Quando as opções de Estilo de um widget não bastam, o Converto permite acrescentar CSS e JavaScript em qualquer elemento do editor e também na página inteira.

Onde ficam os campos

  • Em um elemento (widget, container…): aba Avançado, seções CSS e JS.
  • Na página: Configurações da página, campo de CSS personalizado da página (e os códigos de topo, conteúdo e rodapé para outros tipos de código; veja Configurações da página).

O CSS do Kit (Configurações do site → CSS personalizado) não passa por este recurso: ele continua sendo tratado pelo Elementor.

Na página, os campos ficam em Configurações da página: o CSS (com a explicação da palavra selector e das media queries em linha) e o JS (que lembra que o código precisa ser jQuery).

Seção CSS das configurações da página, com o editor de código e a explicação de selector e media queries.
Seção CSS das configurações da página, com o editor de código e a explicação de selector e media queries.
Seção JS das configurações da página, com o editor de código e o exemplo de selector.css.
Seção JS das configurações da página, com o editor de código e o exemplo de selector.css.

A palavra selector

Use selector para se referir ao próprio elemento (ou ao wrapper da página). Para estilizar elementos internos, escreva o seletor logo depois:

css
selector { background: #f6f8fc; }
selector a { color: #2156F0; }
selector .btn:hover { opacity: .9; }

Media queries com sintaxe curta (breakpoints)

Em vez de escrever @media, escreva a condição entre parênteses seguida do bloco entre chaves:

Você escreveVira
(<=768){ ... }@media only screen and (max-width:768px)
(>=1024){ ... }@media only screen and (min-width:1024px)
(768-1024){ ... }@media only screen and (min-width:768px) and (max-width:1024px)
(=500){ ... }@media only screen and (width:500px)

A unidade é opcional (padrão px); se você escrever em, rem ou %, ela é respeitada. Dentro do bloco não é necessário escrever selector:

css
(<=768){
  font-size: 14px;
  a { color: red; }
  .btn { display: none; }
}

Resultado equivalente:

css
@media only screen and (max-width:768px){
  selector{ font-size: 14px; }
  selector a{ color: red; }
  selector .btn{ display: none; }
}

Propriedades soltas viram regras do próprio selector; regras aninhadas recebem selector na frente automaticamente. Se você já escrever selector na regra, ele não é duplicado.

Misturando com CSS normal

Blocos de media query e CSS comum podem conviver no mesmo campo, em qualquer ordem:

css
selector { padding: 40px 0; }
(<=768){ padding: 20px 0; }
selector .titulo { letter-spacing: -.01em; }

Quando o bloco não é convertido

O cabeçalho ( … ) só é tratado como media query quando vem no início do campo ou logo depois de um } ou ;. Assim, CSS normal como :nth-child(2n-1) não é confundido. Um bloco malformado (chave sem fechar ou condição que não segue os quatro formatos) passa sem conversão: só aquele trecho vira CSS inválido, o restante do campo continua funcionando.

JavaScript personalizado

O campo JS aceita código jQuery. selector vira o objeto jQuery do elemento:

js
selector.css('background', 'red');
selector.find('.btn').on('click', function () {
  console.log('clicou');
});
  • No elemento, selector equivale a jQuery('.elementor-element.elementor-element-ID').
  • Na página, equivale ao wrapper do documento.
  • Cada trecho roda dentro de try/catch; erros aparecem no console do navegador como Custom JS Error.

Boas práticas

  • Prefira as opções nativas de Estilo e use CSS apenas para ajustes finos.
  • Use (<=768){} para ajustes de celular em vez de duplicar widgets.
  • Teste o JS no preview e em aba anônima; não dependa de variáveis globais do tema.

Este artigo foi útil?

Artigos relacionados