上級者向けリファレンス · 上級者向け
コスメティックフィルターの構文
対応する CSS と、範囲を限定したリテラルテキストのルールで、ページ上の要素を非表示にします。
概要
コスメティックルールは、ページ上の要素を非表示にします。その要素のネットワークリクエストを取り消したり、元の情報を削除したり、ウェブサイトでの同意の選択を確定したりするものではありません。リクエストをブロックしたい場合は、ネットワークルールを使ってください。
セレクターは対象を絞って書き、自分のルールで確認してください。広い範囲のコンテナを対象にしたルールは、便利な操作部分まで非表示にすることがあります。変更を確認するときは、ページを再読み込みしてください。
構文
表全体を見るには横にスクロールしてください。
| 目的 | 例 | 想定される効果 | 制限 |
|---|---|---|---|
| 1 つのホストで CSS セレクターにより非表示にする | news.example##.advertisement |
そのホストとサブドメインで、.advertisement に一致する要素を非表示にします。 |
クラス名が変わると、ルールが一致しなくなることがあります。 |
| 全体で非表示にする | ##.advertisement |
すべてのウェブサイトでセレクターを適用します。 | 範囲がかなり広くなります。同じクラスが、ほかのサイトでは役立つコンテンツを指していることもあります。 |
| ホストを除外する | news.example,~pay.news.example##.advertisement |
指定したサブドメインを除外し、含める範囲だけで非表示にします。 | コスメティックのホスト範囲はカンマで区切ります。ネットワークルールの $domain= とは異なります。 |
| 一致する非表示を止める | news.example#@#.advertisement |
そのサイトで、一致するセレクターを例外にします。 | ブロックされたネットワークリクエストを許可したり、すべてのコスメティックルールを無効にしたりはしません。 |
| ネイティブの CSS の関係を使う | news.example##.card:has(.ad-label) |
CSS の仕様に従い、一致する子要素または子孫要素を含むカードを非表示にします。 | ネイティブの :has()、:is()、:not()、:where() は CSS としてそのまま渡されます。ほかのブロッカーの手続き型の言語を有効にするものではありません。 |
| リテラルテキストに一致させる | news.example##.card:has-text(Sponsored) |
テキストにそのリテラルを含む、一致するカードを非表示にします。 | ホスト範囲、安全なセレクターの前置部分、空でないリテラルが必要です。大文字と小文字は区別され、照合には上限があります。 |
example.*##.advertisement のようなコスメティックのエンティティ範囲は、ネットワークの範囲とは別に扱われます。このワイルドカードをネットワークの $domain= オプションにそのままコピーして、同じように使えると考えないでください。
リテラルテキストの照合
範囲を限定したリテラルテキストの :has-text() 形式では、## または #?# を使えます。対応する例外では #@# または #@?# を使います。この手続き型の非表示を止めるには、例外がセレクターの前置部分、演算子、リテラルのすべてに一致している必要があります。
シンプルなルールでは、テキスト演算子をセレクターの最後に置いてください。リテラルテキストの照合は正規表現ではありません。たとえば、ここで /Sponsored/ と書いても正規表現での照合にはなりません。正規表現を使った :has-text は拒否されます。
評価処理では、候補の処理量とテキストの読み取りに意図的に上限を設けています。非常に大きな要素、後から現れる候補、複雑なページでは、内部のどこかにリテラルが見えていても、要素が表示されたままになることがあります。これは保護のための制限であり、より広いテキストルールが必要だという意味ではありません。
制限
Shield は、ドメインを指定しないリテラルテキストの非表示、正規表現のテキスト引数、複数のテキスト演算子、そして :xpath()、:upward()、:style() などの手続き型の機能を拒否します。拒否される手続き型の演算子をネイティブの :has() で囲んでも、対応するようにはなりません。正確に表現できないそのほかのセレクターの組み合わせは、行全体がスキップされます。
任意の HTML フィルタリング、スタイルの挿入、ほかのブロッカーの拡張セレクター一覧を、対応している CSS とみなさないでください。パーサーを通過したセレクターでも、ブラウザーで有効であり、サイトの現在のマークアップに一致する必要があります。広告の非表示の一時停止、サイトの一時停止、ページ全体の例外などの設定によって、本来は有効な非表示が適用されないことがあります。
例
news.example##.advertisement
pay.news.example#@#.advertisement
1 行目は、ウェブサイトの範囲で指定したクラスを非表示にします。2 行目は、支払い用のサブドメインで同じ非表示を止めます。別のルールがブロックしたネットワークリクエストが再開されるわけではありません。
意図せず非表示になった場合は、まずウェブサイトの復旧から始めてください。非表示のコントロールを 1 つ表示 は、既存の非表示に対する限定的な復旧手段です。新しい非表示ルールを自由に作るための要素ピッカーではありません。