Mirrors/uBlock
1
0
Fork 0
mirror of https://github.com/gorhill/uBlock.git synced 2024-11-16 23:42:39 +01:00
Code Issues Releases Wiki Activity

Cosmetic filtering

gwarser 2019-08-15 18:46:14 +02:00
parent a3542ed4f2
commit 8ee98b125f
1 changed files with 23 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
Introduction-to-basic-filtering-syntax.md Normal file

@ -0,0 +1,23 @@
## Cosmetic filtering
Example DOM tree:
<div id="unique-identifier" class="first-class second-class" data-storage="123-456">
<div class="first-class">
- `##` - this is always present in cosmetic filters - this means this is cosmetic filter
- `##div` - selecting by element type
- `###unique-identifier` - selecting by `id`, `##` + `#` - this should be very efficient, because there should be only one unique identifier for page
- `##.first-class` - selecting by `class`, `##` + `.` - will match other elements with same class, so:
- `##.first-class.second-class` - use both classes to select only first line from example DOM.
Using dot for classes automatically split value of the class attribute on space characters.
Selecting by attribute:
- `##[data-storage="123-456"]` - will match exactly
- `##[data-storage^="123-"]` - will match from the beginning
- `##[data-storage$="-456"]` - will match from the end
- `##[data-storage*="3-4"]` - will match in the middle
- `##[id="unique-identifier"]` equivalent of `###unique-identifier`
- `##[class="first-class"]` equivalent of `##.first-class`, but will match only second line from example DOM - class attribute is compared literally, no splitting on space characters.