From 07a9b8038c94d18827a1bb52d81d1be7ab426d64 Mon Sep 17 00:00:00 2001 From: Raymond Hill Date: Sat, 12 Jul 2014 18:34:56 -0700 Subject: [PATCH] Created Element picker (markdown) --- Element-picker.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 Element-picker.md diff --git a/Element-picker.md b/Element-picker.md new file mode 100644 index 0000000..683e307 --- /dev/null +++ b/Element-picker.md @@ -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. \ No newline at end of file