From e7cfaa769d53e351700b89770ccca6f56fe34f28 Mon Sep 17 00:00:00 2001 From: gwarser Date: Mon, 7 Sep 2020 17:43:11 +0200 Subject: [PATCH] Procedural selectors in `:style()` --- Static-filter-syntax.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/Static-filter-syntax.md b/Static-filter-syntax.md index cbe69e5..eecf4c3 100644 --- a/Static-filter-syntax.md +++ b/Static-filter-syntax.md @@ -552,12 +552,14 @@ AdGuard's cosmetic filter syntax `{ remove: true; }` will be converted to uBO's - Description: _action operator_, applies specified style to selected elements in DOM tree. - Chainable: No, _action operator_ can only be used at the end of the root chain. -- _subject_: only native, plain CSS selectors are supported, see [#382](https://github.com/uBlockOrigin/uBlock-issues/issues/382). +- _subject_: Can be a plain CSS selector, or a procedural cosmetic filter after [1.29.3b10](https://github.com/gorhill/uBlock/commit/35aefed92616cbfb75f12f37c7ea7fb3a3cc3369). Before, only native, plain CSS selectors were supported, see [#382](https://github.com/uBlockOrigin/uBlock-issues/issues/382). - _arg_: one or more [CSS property declarations](https://developer.mozilla.org/en-US/docs/Web/CSS/Syntax), separated by the standard `;`. Property values with `url(...)` are forbidden. - Examples: - `example.com##h1:style(background-color: blue !important)` - `motobanda.pl###mvideo:style(z-index: 1!important)` +After [1.29.3b10](https://github.com/gorhill/uBlock/commit/35aefed92616cbfb75f12f37c7ea7fb3a3cc3369) procedural selectors are also supported. + Related issue [Support cosmetic filters with explicit style properties](https://github.com/gorhill/uBlock/issues/781) and [example](https://github.com/uBlockOrigin/uAssets/issues/71#issuecomment-229503444) where it's useful. It's exactly the same syntax of plain cosmetic filters (i.e. must be a valid CSS selector), except that the `:style(...)` suffix is appended at the end. The content in the parentheses must be one or more [CSS property declarations](https://developer.mozilla.org/en-US/docs/Web/CSS/Syntax) (separated by the standard `;`). It is not allowed to use property values with `url(...)`, such `style`-based cosmetic filters will be discarded.