Esta página é uma tradução. Em caso de divergência, vale a página em inglês.

Referência avançada · Avançado

Sintaxe de filtros cosméticos

Oculte elementos de página com CSS compatível e regras de texto literal com limites.

Visão geral

Uma regra cosmética oculta um elemento de uma página. Ela não cancela as solicitações de rede desse elemento, não apaga as informações por trás dele nem registra uma escolha de consentimento no site. Use uma regra de rede quando o efeito desejado for bloquear solicitações.

Escreva seletores específicos e revise-os em Suas regras. Uma regra voltada a um contêiner amplo também pode ocultar controles úteis. Recarregue a página ao conferir uma mudança.

Sintaxe

Role para o lado para ler a tabela inteira.

Finalidade Exemplo Efeito esperado Limitações
Ocultar por seletor CSS em um host news.example##.advertisement Oculta os elementos que correspondem a .advertisement nesse host e nos subdomínios. Uma mudança no nome da classe pode fazer a regra parar de corresponder.
Ocultar em geral ##.advertisement Aplica o seletor em todos os sites. Alcance bem maior; a mesma classe pode indicar conteúdo útil em outros sites.
Excluir um host news.example,~pay.news.example##.advertisement Limita a ocultação ao escopo incluído e exclui o subdomínio indicado. As vírgulas separam escopos de host cosméticos; isso é diferente de $domain= nas regras de rede.
Interromper uma ocultação correspondente news.example#@#.advertisement Cria uma exceção para o seletor correspondente nesse site. Não permite uma solicitação de rede bloqueada nem desativa todas as regras cosméticas.
Usar relações CSS nativas news.example##.card:has(.ad-label) Oculta um cartão que contém o filho ou descendente correspondente, segundo a semântica do CSS. :has(), :is(), :not() e :where() nativos são repassados como CSS; eles não ativam uma linguagem procedural de outros bloqueadores.
Corresponder a texto literal news.example##.card:has-text(Sponsored) Oculta os cartões correspondentes cujo texto contém esse literal. Exige escopo de host, um prefixo de seletor seguro e um literal não vazio; a correspondência diferencia maiúsculas de minúsculas e tem limites.

Escopos de entidade cosméticos, como example.*##.advertisement, são aceitos separadamente dos escopos de rede. Não copie esse curinga para uma opção de rede $domain= presumindo o mesmo suporte.

Correspondência de texto literal

A forma limitada de texto literal :has-text() pode usar ## ou #?#. As exceções correspondentes usam #@# ou #@?#. Uma exceção precisa corresponder ao prefixo do seletor, ao operador e ao literal para interromper essa ocultação procedural.

Em uma regra simples, deixe o operador de texto no fim do seletor. Uma correspondência de texto literal não é uma expressão regular. Por exemplo, /Sponsored/ não serve aqui para pedir uma correspondência por expressão regular; :has-text com expressão regular é rejeitado.

O avaliador limita de propósito o trabalho com candidatos e as leituras de texto. Um elemento muito grande, um candidato que aparece tarde ou uma página complexa podem continuar visíveis mesmo que uma pessoa veja o literal em algum lugar dentro deles. Esse é um limite da proteção, não uma prova de que é preciso uma regra de texto mais ampla.

Limites

O Shield rejeita ocultações de texto literal sem domínio, argumentos de texto com expressão regular, vários operadores de texto e recursos procedurais como :xpath(), :upward() e :style(). Colocar um operador procedural rejeitado dentro de um :has() nativo não o torna compatível. Outras combinações de seletores que não podem ser representadas com exatidão são ignoradas na linha inteira.

Não trate filtragem arbitrária de HTML, injeção de estilos ou o catálogo de seletores estendidos de outro bloqueador como CSS compatível. Um seletor aceito pelo analisador ainda precisa ser válido no navegador e corresponder à marcação atual do site. Configurações como a ocultação de anúncios pausada, uma pausa no site ou uma exceção de página inteira podem impedir ocultações que, de outro modo, seriam válidas.

Exemplos

news.example##.advertisement
pay.news.example#@#.advertisement

A primeira oculta a classe indicada no escopo do site. A segunda interrompe essa mesma ocultação no subdomínio de pagamento. Ela não retoma solicitações de rede que outra regra bloqueou.

Se algo foi ocultado por engano, comece pela recuperação do site. Mostrar um controle oculto é um recurso de recuperação específico para uma ocultação existente; não é um seletor de elementos para criar novas regras de ocultação quaisquer.

Ainda precisa de ajuda? Fale com o suporte