Référence avancée · Avancé
Syntaxe des filtres cosmétiques
Masquez des éléments de page avec le CSS pris en charge et des règles de texte littéral encadrées.
Vue d’ensemble
Une règle cosmétique masque un élément d’une page. Elle n’annule pas les requêtes réseau de cet élément, ne supprime pas les informations sous-jacentes et n’établit aucun choix de consentement sur le site. Utilisez une règle réseau lorsque l’effet voulu est de bloquer des requêtes.
Écrivez des sélecteurs précis et vérifiez-les dans Vos règles. Une règle qui vise un conteneur large peut aussi masquer des commandes utiles. Rechargez la page pour vérifier une modification.
Syntaxe
Faites défiler horizontalement pour lire tout le tableau.
| Objectif | Exemple | Effet attendu | Limites |
|---|---|---|---|
| Masquer par sélecteur CSS sur un hôte | news.example##.advertisement |
Masque les éléments correspondant à .advertisement sur cet hôte et ses sous-domaines. |
Un changement de nom de classe peut empêcher la règle de correspondre. |
| Masquer partout | ##.advertisement |
Applique le sélecteur sur tous les sites. | Portée bien plus large ; la même classe peut désigner du contenu utile ailleurs. |
| Exclure un hôte | news.example,~pay.news.example##.advertisement |
Limite le masquage au périmètre inclus en excluant le sous-domaine indiqué. | Les virgules séparent les périmètres d’hôtes cosmétiques ; c’est différent de $domain= dans les règles réseau. |
| Arrêter un masquage correspondant | news.example#@#.advertisement |
Crée une exception pour le sélecteur correspondant sur ce site. | N’autorise pas une requête réseau bloquée et ne désactive pas toutes les règles cosmétiques. |
| Utiliser les relations CSS natives | news.example##.card:has(.ad-label) |
Masque une carte contenant l’enfant ou le descendant correspondant, selon la sémantique CSS. | :has(), :is(), :not() et :where() natifs sont transmis tels quels en CSS ; ils n’activent pas un langage procédural issu d’autres bloqueurs. |
| Correspondre à un texte littéral | news.example##.card:has-text(Sponsored) |
Masque les cartes correspondantes dont le texte contient ce littéral. | Un périmètre d’hôte, un préfixe de sélecteur sûr et un littéral non vide sont requis ; la correspondance respecte la casse et est encadrée. |
Les périmètres d’entité cosmétiques comme example.*##.advertisement sont acceptés indépendamment des périmètres réseau. Ne recopiez pas ce joker dans une option réseau $domain= en supposant la même prise en charge.
Correspondance de texte littéral
La forme encadrée de texte littéral :has-text() peut utiliser ## ou #?#. Ses exceptions correspondantes utilisent #@# ou #@?#. Une exception doit correspondre au préfixe du sélecteur, à l’opérateur et au littéral pour arrêter ce masquage procédural.
Pour une règle simple, placez l’opérateur de texte à la fin du sélecteur. Une correspondance de texte littéral n’est pas une expression régulière. Par exemple, /Sponsored/ ne permet pas de demander ici une correspondance par expression régulière ; :has-text avec expression régulière est refusé.
L’évaluateur limite volontairement le travail sur les candidats et les lectures de texte. Un élément très volumineux, un candidat tardif ou une page complexe peuvent rester visibles même si l’on voit le littéral quelque part à l’intérieur. C’est une limite de la protection, pas la preuve qu’une règle de texte plus large est nécessaire.
Limites
Shield refuse les masquages de texte littéral sans domaine, les arguments de texte en expression régulière, les opérateurs de texte multiples et les fonctions procédurales comme :xpath(), :upward() et :style(). Placer un opérateur procédural refusé dans un :has() natif ne le rend pas pris en charge. Les autres combinaisons de sélecteurs impossibles à représenter exactement sont ignorées sur toute la ligne.
Ne considérez pas le filtrage HTML arbitraire, l’injection de styles ou le catalogue de sélecteurs étendus d’un autre bloqueur comme du CSS pris en charge. Un sélecteur accepté par l’analyseur doit aussi être valide dans le navigateur et correspondre au balisage actuel du site. Des réglages comme le masquage des publicités en pause, une pause du site ou une exception de page entière peuvent suspendre des masquages par ailleurs valides.
Exemples
news.example##.advertisement
pay.news.example#@#.advertisement
La première masque la classe indiquée dans le périmètre du site. La seconde arrête ce même masquage sur le sous-domaine de paiement. Elle ne rétablit pas les requêtes réseau bloquées par une autre règle.
En cas de masquage accidentel, commencez par la récupération du site. Afficher un contrôle masqué est une aide de récupération ciblée pour un masquage existant ; ce n’est pas un sélecteur d’éléments pour créer de nouvelles règles de masquage quelconques.