mirror of
https://github.com/gorhill/uBlock.git
synced 2024-09-05 18:49:39 +02:00
Specific-generic
parent
43b36dbf75
commit
6a9021bed0
@ -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.
|
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:
|
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.*`.
|
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
|
### Cosmetic filters
|
||||||
|
|
||||||
#### Procedural cosmetic filters
|
#### Procedural cosmetic filters
|
||||||
|
Loading…
Reference in New Issue
Block a user