Het gebruik van Adblock Filters nader toegelicht
Please note: This cheatsheet is outdated. Please read the current documentation in our Help Center here.
Eenvoudige blokkerende regels
Blokkerende filters bepalen welke adressen Adblock Plus moet blokkeren.
Voorbeeld 1: Blokkeren op deel van adres
Letterlijke tekst
Deze tekst moet voorkomen in het adres dat geblokkeerd moet worden.
Jokerteken
Dit staat voor elk willekeurig aantal karakters.
Scheidingsteken
Het adres moet of hier eindigen of er moet een scheidingsteken zoals ? of / volgen.
Deze regel blokkeert:
http://example.com/banner/foo/img
http://example.com/banner/foo/bar/img?param
http://example.com/banner//img/foo
Deze regel blokkeert niet:
http://example.com/banner/img
http://example.com/banner/foo/imgraph
http://example.com/banner/foo/img.gif
Voorbeeld 2: Blokkeren op adresnaam
Domeinnaam anker
De volgende tekst moet de domeinnaam van het adres zijn.
Letterlijke tekst
Deze tekst moet voorkomen in het adres dat geblokkeerd moet worden.
Scheidingsteken
Een scheidingsteken moet volgen om het eind van de domeinnaam aan te geven, bijvoorbeeld / of :.
Deze regel blokkeert:
http://ads.example.com/foo.gif
http://server1.ads.example.com/foo.gif
https://ads.example.com:8000/
Deze regel blokkeert niet:
http://ads.example.com.ua/foo.gif
http://example.com/redirect/http://ads.example.com/
Voorbeeld 3: Blokkeer exact adres
Start anker
De volgende tekst moet het begin van het adres zijn.
Letterlijke tekst
Deze tekst moet voorkomen in het adres dat geblokkeerd moet worden.
Einde anker
De voorafgaande tekst moet het eind van het adres zijn.
Deze regel blokkeert:
http://example.com/
Deze regel blokkeert niet:
http://example.com/foo.gif
http://example.info/redirect/http://example.com/
Opties in blokkerende regels
Blokkerende regels kunnen een aantal opties hebben om hun gedrag te beïnvloeden.
Adres dat geblokkeerd moet worden
Dit deel van de regel definieert het adres waarop het toegepast wordt.
Optie scheidingsteken
Dit karakter geeft aan dat de volgende tekst de filter opties bepalen.
Type optie
Type opties definiëren verzoektypes die geblokkeerd moeten worden. Veel voorkomende type opties zijn script
of image
die aangeven dat alleen scripts/afbeeldingen geblokkeerd moeten worden. De omgekeerde type optie ~script
betekent dat het filter niet op scripts moet worden toegepast.
Domein optie
Domein opties beperken het filter tot een aantal domeinen (hier example.com
).
Het maakt het ook mogelijk om de regel op sommige domeinen uit te schakelen (hier op foo.example.com
).
Deze regel blokkeert http://ads.example.com/foo.gif
alleen als de volgende condities waar zijn:
- Het adres wordt geladen als een script of afbeelding.
-
De pagina die geladen wordt komt van het domein
example.com
(bijvoorbeeldexample.com
zelf ofsubdomain.example.com
) maar niet vanfoo.example.com
of zijn subdomeinen.
Uitzonderingsregels
Uitzonderingsregels zijn op dezelfde manier opgebouwd als blokkerende regels, ze definiëren welke adressen toegestaan moeten worden, zelfs als er een overeenkomende blokkerende regel bestaat.
Voorbeeld 1: Uitzondering voor bepaalde verzoeken
Uitzonderingsregel
Regels die zo beginnen zijn uitzonderingen, ze overschrijven blokkerende regels.
Adres dat toegestaan moet worden
Dit deel van de regel definieert op welke adressen het van toepassing is, het is op dezelfde manier opgebouwd als voor blokkerende regels.
Type optie
Dit type optie voorkomt dat de uitzondering wordt toegepast op scripts.
Voorbeeld 2: Uitzondering voor een hele website
Uitzonderingsregel
Regels die zo beginnen zijn uitzonderingen, ze overschrijven blokkerende regels.
Adres dat toegestaan moet worden
Dit deel van de regel definieert op welke adressen het van toepassing is, het is op dezelfde manier opgebouwd als voor blokkerende regels.
Type optie
Dit speciale type optie geeft aan de Adblock Plus volledig uitgeschakeld moet worden op pagina's die aan deze regel voldoen.
Opmerkingen
Commentaar tekst
Deze tekst wordt niet gebruikt om te blokkeren, je kan alles schrijven wat je wilt.
Filter opties
Optie | Doel |
---|---|
Types | |
script ~script |
Bevat of schakel javascript bestanden uit |
image ~image |
Bevat of schakel afbeeldingen uit |
stylesheet ~stylesheet |
Bevat of schakel stylesheets (CSS bestanden) uit |
object ~object |
Bevat of schakel inhoud die door browser plug-ins zoals Flash of Java wordt afgehandeld uit |
subdocument ~subdocument |
Bevat of schakel pagina's in pagina's (frames) uit |
xmlhttprequest ~xmlhttprequest |
Include or exclude requests started using the XMLHttpRequest object or fetch API |
websocket ~websocket |
Include or exclude requests initiated via WebSocket object |
webrtc ~webrtc |
Include or exclude connections opened via RTCPeerConnection instances to ICE servers |
popup |
Include pages opened in a new tab or window |
generichide |
Used to prevent applying global element rules on a page (e.g. @@||example.com^$generichide ) |
genericblock |
Used to prevent applying global blocking rules on a page (e.g. @@||example.com^$genericblock ) |
Uitzonderingen | |
document |
Wordt gebruikt om de pagina zelf toe te staan (bijvoorbeeld @@||example.com^$document ) |
elemhide |
Wordt gebruikt om te voorkomen dat een regel op een pagina wordt toegepast (bijvoorbeeld @@||example.com^$elemhide ) |
Domeinen | |
domain= |
Geef een lijst van domeinen op, gescheiden door pipe symbolen (|), waarop een filter actief zou moeten zijn. Een filter kan worden uitgeschakeld op een domein door de domeinnaam door een tilde (~) vooraf te laten gaan. |
third-party ~third-party |
Geef aan of een filter actief moet zijn op |
Misc |
Minder vaak gebruikte opties, zoals bijvoorbeeld ping
, other
, match-case
, {4}
, {5}
, {6}
, {7}
en {8}
worden in de volledige documentatie.
Element verbergen
Example 1: Hiding elements
We want to hide elements with class the advert
on example.net
, example.com
and subdomains.
Domains
An optional comma separated list of domains this filter applies to. If ommitted, it applies everywhere.
Separator
For an element hiding filter using standard CSS selectors, the separator is ##
.
Selector
The CSS selector for the elements to hide.
Example 2: Exception in element hiding
We want to exclude the above hiding rule on exception.example.com
.
Domains
Comma separated list of domains this exception applies to. This can be ommitted.
Exception separator
For an element hiding filter exception using CSS selectors, the separator is #@#
.
Selector
The CSS selector matching the rule we want to create an exception for.
Domein selectie
##selector
wordt gebruikt ale vervanger voor element selectors.
Voorbeeld regels | Domein selectie |
---|---|
##selector |
Actief op:
Niet actief op:
|
example.com##selector |
Bijvoorbeeld actief op:
Niet actief op:
|
~example.com##selector |
Actief op:
Niet actief op, bijvoorbeeld:
|
example.com,example.edu##selector |
Bijvoorbeeld actief op:
Niet actief op:
|
example.com,~mail.example.com##selector |
Actief op:
Niet actief op:
|
Element selection
Selector | Doel |
---|---|
###advert |
Komt overeen met het element met de unieke id "adsvert" |
##.advert |
Komt overeen met elementen met de klasse "advert" |
##table[height="100"][width="100"] |
Komt overeen met een tabel met hoogte 100 en breedte 100 |
##a[href="http://example.com/"] |
Komt overeen met snelkoppelingen naar http://example.com/ |
##div[style="width:300px;height:250px;"] |
Komt overeen met div elementen die precies de opgegeven stijl hebben |
###advert > .link |
Komt overeen met elementen met de klasse "link" die omvat worden door elemten met de id "advert" |
###advert + .link |
Komt overeen met elementen met de klasse "link: die direct worden voorafgegaan door elementen met de id "advert" |
##a[href^="http://example.com/"] |
Komt overeen met snelkoppelingen naar alle pagina's van de website http://example.com/ |
##div[style^="width:300px;height:250px;"] |
Komt overeen met div elementen die beginnen met de opgegeven stijl |
##div[style$="width:300px;height:250px;"] |
Komt overeen met div elementen die eindigen met de opgegeven stijl |
##div[style*="width:300px;height:250px;"] |
Komt overeen met div elementen die de opgegeven stijl bevatten |
Bovenstaande filters zijn slechts voorbeelden van geldige element verbergende regels. Elke CSS selector die door Firefox wordt ondersteund kan worden gebruikt om elementen te verbergen.
Extended CSS selectors (Adblock Plus specific)
In some situations standard CSS selectors are not sufficient. For those cases there are extended CSS pseudo-selectors, and the filter syntax differs from the element hiding by using an alternate separator.
Example 1: Hiding element based on their content
Hide div
elements that contain a div
that contain an image with CSS class advert
.
Domains
Comma separated list of domains this filter applies to. This is mandatory.
Separator
For an element hiding filter using extended CSS pseudo-selectors, the separator is #?#
.
Selector
The CSS selector to select the elements to hide. It can use the extended selectors syntax.
Example 2: Exception for the element hiding
Domains
Comma separated list of domains this exception applies to.
Exception Separator
Like for an element hiding filter, the separator for an exception is #@#
.
Selector
The CSS selector matching the rule we want to create an exception for.
Adblock Plus specific pseudo-selectors
You can use the following Adblock Plus specific pseudo-selectors:
Pseudo-class | Doel |
---|---|
:-abp-properties() |
Select an element if its CSS style properties match what's specified. You can pass a regular expression by surrounding it with "/". |
:-abp-has() |
Select an element if its content subtree match the selector specified |
:-abp-contains() |
Select an element if its text content contains the specified string |
When writing element hiding filters that make use those you must use the #?#
syntax (replace ##
with #?#
) and take care to specify one or more domains. Some examples:
Selector | Doel |
---|---|
example.com#?#div:-abp-properties(width:300px;height:250px;) |
Matches div elements whose style contain the specified properties |
example.com#?#div:-abp-has(> div > img.advert) |
Matches div elements that contain as a direct descendant a div element whose direct descendant is an img with the class "advert" |
example.com#?#div:-abp-has(> div > img:-abp-properties(width:300px;height:250px;)) |
Matches div elements that contain as a direct descendant a div element whose direct descendant is an img element whose style properties contain the specified properties, a width of 300 pixels and an height of 250 pixels |
example.com#?#div:-abp-has(> div > img:-abp-properties(WidTh:300px;hEigHt:250px;)) |
Since the CSS properties are matched case-insensitively, this filter matches the same thing as above |
example.com#?#div:-abp-has(> span:-abp-contains(Advertisment)) |
Matches div elements that have a direct descendent span element containing the text "Advertisment" |
example.com#?#div > img:-abp-properties(width:*px;height:250px;) |
By using a wildcard * , this filter matches an img whose CSS style properties have a width specified in pixels and a height of 250 pixels |
example.com#?#div > img:-abp-properties(/width: 3[2-8]px;/) |
By using a regular expression, this filter matches an img whose CSS style properties have a width between 32 and 38 pixels |
Snippet filters
Snippet filters allow executing snippet scripts.
Domains
Comma separated list of domains this filter applies to.
Separator
For a snipet filter, the separator is #$#
.
Script
The snippet script.
Commentaar
Een uitroepteken aan het begin van de regel geeft een commentaar aan.