高级参考 · 高级
外观过滤器语法
使用受支持的 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
第一行在网站范围内隐藏指定的类。第二行在支付子域名上停止同一隐藏。它不会恢复被另一条规则拦截的网络请求。
如果内容被误隐藏,请先查看网站恢复。显示一个隐藏控件 是针对现有隐藏的定向恢复工具;它不是用来随意编写新隐藏规则的元素选择器。