本页为译文。如有出入,以英文页面为准。

高级参考 · 高级

外观过滤器语法

使用受支持的 CSS 和有限制的字面文本规则,隐藏匹配的页面元素。

概述

外观规则用于隐藏页面上的元素。它不会取消该元素的网络请求,不会删除底层信息,也不会在网站上做出同意选择。如果你想拦截请求,请使用网络规则。

请编写范围精确的选择器,并在你的规则中检查。针对大范围容器的规则也可能隐藏有用的控件。检查更改时,请重新加载页面。

语法

横向滚动以查看完整表格。

用途 示例 预期效果 限制
在一个主机上按 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

第一行在网站范围内隐藏指定的类。第二行在支付子域名上停止同一隐藏。它不会恢复被另一条规则拦截的网络请求。

如果内容被误隐藏,请先查看网站恢复。显示一个隐藏控件 是针对现有隐藏的定向恢复工具;它不是用来随意编写新隐藏规则的元素选择器。

仍需帮助?联系支持