1
0
mirror of https://github.com/gorhill/uBlock.git synced 2024-07-03 02:37:21 +02:00

Created Element picker (markdown)

Raymond Hill 2014-07-12 18:34:56 -07:00
parent 3f8da6f997
commit 07a9b8038c

17
Element-picker.md Normal file

@ -0,0 +1,17 @@
The element picker's purpose is to assist the user in the creation of network or cosmetic filters.
If there is an element on a web page you wish to remove forever, open the extension's popup menu, and click the small ["eye-slash" icon](http://fontawesome.io/icon/eye-slash/). You will enter the interactive element picker-mode.
Once in element-picker mode, you have to point and click on the element you wish to remove.
Once you click on the element, you will be presented with a modal dialog box which allows you to select, and optionally edit the filter which will be create in order to remove the element you wish to remove from the web page.
If possible, a network filter will be offered, and a list of CSS selector which have been derived from the element you clicked. These CSS selectors are to be used as cosmetic filters. The top most CSS selector is the closest to the element you clicked. The bottom-most is the farthest.
When you click on one of the pre-computed CSS selector, you will be shown what effect it will have on the page. You may want to ensure a CSS selector will not also get rid of useful items on the page.
You may manually edit the selector. However the result needs to be a valid filter, otherwise you won't be allowed to create a filter out of it.
You may quit the interactive element picker by clicking the _Quit_ button. You may close the modal dialog and go pick an element again by clicking the _Pick_ button.
The _Create_ button will be enabled only if a proper filter can be create from the content of the text area. On you click the _Create_ button, the element picker will add the necessary tokens to ensure the filter apply **only** to the current web site.