Справочник для опытных · Для опытных
Синтаксис косметических фильтров
Скрывайте элементы страниц с помощью поддерживаемого 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(), он не станет поддерживаемым. Другие сочетания селекторов, которые нельзя точно представить, пропускаются целой строкой.
Не считайте поддерживаемым CSS произвольную фильтрацию HTML, внедрение стилей или каталог расширенных селекторов другого блокировщика. Селектор, прошедший парсер, всё равно должен быть допустим в браузере и соответствовать текущей разметке сайта. Такие настройки, как приостановленное скрытие рекламы, пауза на сайте или исключение для всей страницы, могут не применять скрытия, которые в остальном допустимы.
Примеры
news.example##.advertisement
pay.news.example#@#.advertisement
Первая строка скрывает указанный класс в пределах сайта. Вторая отменяет то же скрытие на платёжном поддомене. Она не возобновляет сетевые запросы, заблокированные отдельным правилом.
Если что-то скрылось по ошибке, начните с восстановления работы сайта. Показать один скрытый элемент управления — точечное средство восстановления для уже существующего скрытия; это не инструмент выбора элементов для создания новых произвольных правил скрытия.