Het gebruik van Adblock Filters nader toegelicht

Eenvoudige blokkerende regels

Blokkerende filters bepalen welke adressen Adblock Plus moet blokkeren.

Voorbeeld 1: Blokkeren op deel van adres

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

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

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.

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 (bijvoorbeeld example.com zelf of subdomain.example.com) maar niet van foo.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

Voorbeeld 2: Uitzondering voor een hele website

Opmerkingen

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.

Example 2: Exception in element hiding

We want to exclude the above hiding rule on exception.example.com.

Domein selectie

##selector wordt gebruikt ale vervanger voor element selectors.

Voorbeeld regels	Domein selectie
##selector	Actief op: Alle domeinen, inclusief: http://example.com/ https://example.net/ ftp://example.edu/ Niet actief op: Niet van toepassing
example.com##selector	Bijvoorbeeld actief op: http://example.com/ ftp://subdomain.example.com/ Niet actief op: Alle overige domeinen inclusief http://example.edu/ ftp://example.net/
~example.com##selector	Actief op: Alle overige domeinen inclusief http://example.edu/ ftp://example.net/ Niet actief op, bijvoorbeeld: http://example.com/ ftp://subdomain.example.com/
example.com,example.edu##selector	Bijvoorbeeld actief op: http://example.com/ https://subdomain.example.com/ ftp://example.edu/ Niet actief op: Alle o9verige domeinen, zoals: http://example.net/
example.com,~mail.example.com##selector	Actief op: http://example.com/ https://adverts.example.com/ Niet actief op: http://mail.example.com/ Alle overige domeinen

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.

Example 2: Exception for the element hiding

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.