Esta página es una traducción. Si hay alguna diferencia, prevalece la página en inglés.

Referencia avanzada · Avanzado

Sintaxis de filtros cosméticos

Oculta elementos de página con CSS compatible y reglas de texto literal con límites.

Descripción general

Una regla cosmética oculta un elemento de una página. No cancela las solicitudes de red de ese elemento, no borra la información subyacente ni establece una elección de consentimiento en el sitio. Usa una regla de red cuando lo que quieres es bloquear solicitudes.

Escribe selectores precisos y revísalos en Tus reglas. Una regla dirigida a un contenedor amplio puede ocultar también controles útiles. Recarga la página cuando compruebes un cambio.

Sintaxis

Desplázate hacia los lados para leer la tabla completa.

Propósito Ejemplo Efecto esperado Limitaciones
Ocultar por selector CSS en un host news.example##.advertisement Oculta los elementos que coinciden con .advertisement en ese host y sus subdominios. Un cambio de nombre de clase puede hacer que la regla deje de coincidir.
Ocultar en general ##.advertisement Aplica el selector en todos los sitios. Alcance mucho más amplio; la misma clase puede corresponder a contenido útil en otros sitios.
Excluir un host news.example,~pay.news.example##.advertisement Limita la ocultación al ámbito incluido y excluye el subdominio indicado. Las comas separan los ámbitos de host cosméticos; esto es distinto de $domain= en las reglas de red.
Detener una ocultación que coincide news.example#@#.advertisement Exceptúa el selector que coincide en ese sitio. No permite una solicitud de red bloqueada ni desactiva todas las reglas cosméticas.
Usar relaciones CSS nativas news.example##.card:has(.ad-label) Oculta una tarjeta que contiene el hijo o descendiente que coincide, según la semántica de CSS. :has(), :is(), :not() y :where() nativos se pasan tal cual como CSS; no activan un lenguaje procedimental de otros bloqueadores.
Coincidir con texto literal news.example##.card:has-text(Sponsored) Oculta las tarjetas que coinciden y cuyo texto contiene ese literal. Se necesitan un ámbito de host, un prefijo de selector seguro y un literal no vacío; la coincidencia distingue mayúsculas y minúsculas y tiene límites.

Los ámbitos de entidad cosméticos, como example.*##.advertisement, se admiten de forma independiente de los ámbitos de red. No copies ese comodín en una opción $domain= de red dando por hecho que funciona igual.

Coincidencia de texto literal

La forma limitada de texto literal :has-text() puede usar ## o #?#. Sus excepciones correspondientes usan #@# o #@?#. Una excepción debe coincidir con el prefijo del selector, el operador y el literal para detener esa ocultación procedimental.

En una regla sencilla, deja el operador de texto al final del selector. Una coincidencia de texto literal no es una expresión regular. Por ejemplo, /Sponsored/ no sirve aquí para pedir una coincidencia por expresión regular; :has-text con expresiones regulares se rechaza.

El evaluador limita a propósito el trabajo con candidatos y las lecturas de texto. Un elemento muy grande, un candidato que aparece tarde o una página compleja pueden seguir visibles aunque una persona vea el literal en algún lugar de su interior. Es un límite de la protección, no una prueba de que haga falta una regla de texto más amplia.

Límites

Shield rechaza las ocultaciones de texto literal sin dominio, los argumentos de texto con expresiones regulares, varios operadores de texto y funciones procedimentales como :xpath(), :upward() y :style(). Envolver un operador procedimental rechazado dentro de :has() nativo no lo hace compatible. Otras combinaciones de selectores que no se pueden representar con exactitud se omiten como línea completa.

No consideres CSS compatible el filtrado arbitrario de HTML, la inyección de estilos ni el catálogo de selectores ampliados de otro bloqueador. Un selector que supera el analizador también tiene que ser válido en el navegador y coincidir con el marcado actual del sitio. Ajustes como el ocultamiento de anuncios en pausa, una pausa del sitio o una excepción de página completa pueden impedir ocultaciones que, por lo demás, son válidas.

Ejemplos

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

La primera oculta la clase indicada en el ámbito del sitio. La segunda detiene esa misma ocultación en el subdominio de pagos. No reanuda las solicitudes de red que haya bloqueado otra regla.

Si algo se ha ocultado por error, empieza por la recuperación del sitio. Mostrar un control oculto es una ayuda de recuperación concreta para una ocultación existente; no es un selector de elementos para crear nuevas reglas de ocultación cualesquiera.

¿Aún necesitas ayuda? Contacta con nosotros