diff --git a/Static-filter-syntax.md b/Static-filter-syntax.md index 3dc5b6e..43e4a6a 100644 --- a/Static-filter-syntax.md +++ b/Static-filter-syntax.md @@ -312,7 +312,7 @@ Static extended filters are all of the form: The most common type of static extended filters are cosmetic filters, also known as "element hiding filters" in Adblock Plus. -### Entity +#### Entity All static extended filters can be declared to apply to a specific _entity_. For example: @@ -324,6 +324,30 @@ Examples: `google.*` will apply to all similar Google domain names: `google.com Since the base domain name is used to derive the name of the "entity", `google.evil.biz` would **not** match `google.*`. +#### Specific-generic + +New in [1.24.5rc0](https://github.com/gorhill/uBlock/commit/3fab7bfdb4f892f3d33159fd53ccf1d5342a090a). + +A specific cosmetic filter of the following form... + + *##.selector + +... will be unconditionally injected into all web pages, whereas a cosmetic filter of the form... + + ##.selector + +... would be injected only when uBO's DOM surveyor finds at least one matching element in a web page. + +The new specific-generic form will also be disabled when a web page is subject to a `generichide` exception filter, since the filter is essentially a generic one -- the only difference from the usual generic form is that the filter is injected unconditionally instead of through the DOM surveyor. + +Specific-generic cosmetic filters will NOT be discarded when checking the "Ignore generic cosmetic filters" option in the "Filter lists" pane -- since the purpose of this option is primarily to disable the DOM surveyor. + +Specific-generic cosmetic filters should be used parcimoniously and only when using a normal specific filter is really impractical. + +Related issue: [#803](https://github.com/uBlockOrigin/uBlock-issues/issues/803). + + + ### Cosmetic filters #### Procedural cosmetic filters