Changes between Version 13 and Version 59 of Help/Action/Search


Ignore:
Timestamp:
(multiple changes)
Author:
(multiple changes)
Comment:
(multiple changes)

Legend:

Unmodified
Added
Removed
Modified
  • Help/Action/Search

    v13 v59  
    1 [[TranslatedPages(outdated=This page needs a review and more context. A screenshot and a list of expressions would be useful.)]]
     1[[TranslatedPages]]
     2[[PageOutline(2-4,Table of Content)]]
    23
    34= Search =
    45
    5 [[Image(source:trunk/images/dialogs/search.png,middle)]] ''Keyboard shortcut'': '''{{{Ctrl+F}}}'''
     6[[JOSMImage(dialogs/search,link=,48,middle,margin-right=20)]] ''Keyboard shortcut'': **`Ctrl+F`**
    67
    7 '''Search [wiki:/Help/Concepts/Object objects] in the current data layer'''
     8**Search [wikitr:/Help/Concepts/Object objects] in the current data layer using query language**. \\
     9This windows has different looks, depending on your [[JOSMImage(expert)]] [wikitr:/Help/ExpertMode Expert Mode] setting, [#ExpertMode see below]:
    810
     11* The search action will respect the current [wikitr:/Help/Dialog/Filter filters] meaning it wouldn't return any of the filtered objects.
     12* Colons (`:`) within ''keys'' and ''values'' need to be wrapped with quotation marks (`"`).
     13* Hover over a keyword in the search hints section to get a explanation and special examples.
     14* Double click on a preset listed in the search window to add the query to search for objects that match this preset.
     15
     16[[Image(Search.png,link=,70%)]]
     17
     18== Expert mode ==#ExpertMode
     19In [wikitr:/Help/ExpertMode expert mode], the following options are added:
     20* more keywords are listed (they work also in non-expert mode, but are hidden in the dialog)
     21* **standard/regular expression/MapCSS selector** radio button, see sections below for details
     22* **all objects** check box to include **''deleted''** and **''incomplete''** objects in the search
     23* **add toolbar button** see [wikitr:/Help/Action/Search#SavesearchqueryinMaintoolbar save search query in main toolbar] below.
     24
     25[[Image(Search_expert.png,link=,70%)]]
     26
     27== Examples ==#Examples
    928Some examples of queries:
     29* `type:way` selects all ways
     30* `name:Herrengasse` selects all elements with the given name
     31* `name=Herrengasse` same as above, but case sensitive
     32* `"addr:street"="Baker Street"` if special characters (in this case `:` in the key and white space in the value) are used, the key resp. the value needs to be enclosed in `""`
     33* `tag1=yes tag2=yes` is equivalent to `tag1=yes & tag2=yes`
     34* `type:way name:-` selects all ways that do not have a name
     35* `id:123465678` selects an object (way or node) with a particular id
     36* `timestamp:2010-11-01/2010-12-01` selects object with last change in November 2010
     37* `preset:"Craft/Beekeeper"` selects objects that match the beekeeper preset
     38* See also [wikitr:/Help/Dialog/Filter#Examples Examples]
    1039
    11 * type:way selects all ways
    12 * name:Herrengasse selects all elements with the given name
    13 * type:way name:- selects all ways that do not have a name
    14 * id:123465678 selects an object (way or node) with a particular id
     40== Save search query in [wikitr:/Help/MainToolbar main toolbar] ==#SavesearchqueryinMaintoolbar
     41To ''save search as a button'' if you check **add toolbar button** checkbox, as soon as you click on [[JOSMImage(dialogs/search)]] **Start Search**, a button will be added to the main toolbar. which will execute the defined search expression each time, you press the button.
    1542
    16 There is also a very under-used and under-documented feature that lets you enter a web URL (file://, http://, https://, ftp://)
    17 in the search field. JOSM will then attempt to load that URL, and select any objects that it finds referenced in that file. JOSM will
    18 look for XML tags "way", "node", and "relation" in the document, and use their id attribute. This means you can
    19 access another OSM file on your hard disk this way and have JOSM select all objects that are present in the file (provided they are present in JOSM's dataset too).
     43* [[JOSMImage(preferences/toolbar,link=,24,middle)]] [wikitr:/Help/Preferences/Toolbar#Previouslysavedsearchresults Toolbar Customization] will let you modify icon, search query and tooltip.
     44* As with any button you can always assign a shortcut to it in [[JOSMImage(preferences/shortcuts,link=,24,middle)]] [wikitr:/Help/Preferences/Shortcuts Shortcut Preferences].
    2045
    21 The special expressions "selected" and "modified" select all currently selected resp. all objects modified in the current session.
     46== Regular expressions ==
     47JOSM supports [https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html Java regex syntax].
    2248
    23 More examples are here: http://wiki.openstreetmap.org/index.php/JOSM_search_function
     49== MapCSS syntax ==
     50See [wikitr:/Help/Styles/MapCSSImplementation MapCSS implementation]
    2451
    25 === [ExpertMode Expert Mode] ===#ExpertMode
    26 Some examples are only shown in expert mode.
     52== Fetch external file and replace selection ==#Fetchexternalfileandreplaceselection
     53A very under-used feature that lets you enter a web URL (`file://`, `http://`, `https://`, `ftp://`) in the search field.
    2754
     55* JOSM will then attempt to load that URL, and select any objects that it finds referenced in that file.
     56* JOSM will look for XML tags "way", "node", and "relation" in the document (clarify? examples?), and use their id attribute .
     57* You can access another OSM file on your hard disk this way and have JOSM select all objects that are present in the file (provided they are present in JOSM's dataset too).
    2858
    29 == Regular Expressions ==
    30 JOSM supports Java Regex. For detailed Information see http://docs.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html
    31 
     59Similar thing is possible via:
     60* [wikitr:/Help/CommandLineOptions Command line parameter] during JOSM start-up
     61* [wikitr:/Help/Preferences/RemoteControl Remote control] command
    3262
    3363== See also ==
    34 * [wiki:/Help/Concepts/Object Objects]
     64* [[JOSMImage(dialogs/filter)]] [wikitr:/Help/Dialog/Filter Filters] allow you to save and combine multiple search patterns between your JOSM sessions
    3565
    3666----
    37 Back to [wiki:/Help/Menu/Edit Menu Edit][[Br]]
    38 Back to [wiki:/Help Main Help]
     67Back to [wikitr:/Help/Menu/Edit Menu Edit] \\
     68Back to [wikitr:/Help/Menu Main Menu] \\
     69Back to [wikitr:/Help Main Help]