| 5 | | [[Image(source:trunk/images/dialogs/propertiesdialog.svg,30,middle,margin-right=20)]] ''Keyboard shortcut'': **`Alt+Shift+P`** — one of the [wikitr:/Help/ToggleDialogs#Toactivateawindow JOSM windows] |
| | 6 | [[JOSMImage(dialogs/propertiesdialog,48,link=,middle,margin-right=20)]] ''Keyboard shortcut'': **`Alt+Shift+P`** — one of the [wikitr:/Help/ToggleDialogs#Toactivateawindow JOSM panels] |
| | 7 | |
| | 8 | |
| | 9 | == Usage ==#Usage |
| | 10 | This panel shows the existing tags for the selected objects in [wikitr:/Help/MapView Map view], and allows you to add, edit, or delete tags. |
| | 11 | |
| | 12 | The keys and values in use in OpenStreetMap can be found using [wikitr:/Help/Concepts/Object#Tags multiple ways]. |
| | 13 | |
| | 14 | Note: You can also add tags to selected object using presets, it is covered in [wikitr:/Introduction#Presets presets introduction]. |
| | 15 | |
| 13 | | From the top: |
| 14 | | 1. current counts for currently selected objects in the header: objects, tags, memberships |
| 15 | | 2. [wikitr:/Help/Concepts/Object#presets presets], namely: |
| | 24 | === Counts === |
| | 25 | In the header, the counts for currently selected objects in [wikitr:/Help/MapView Map view] are shown - objects, tags and memberships, if selection includes at least one objects with tag or membership. |
| | 26 | |
| | 27 | === Presets Links === |
| | 28 | [[Image(josm_TagsMembership_ToggleDialog.png,right,link=,margin-left=10,margin-bottom=10)]] |
| | 29 | Icons and the names of [wikitr:/Presets presets], namely: |
| 20 | | Possible activation: left mouse click on the preset will open complete view of this preset, as [wikitr:/Introduction#Leftmouseclickonrespectivepresetheadingwillopencompletepresetview was shown in "Introduction"] |
| 21 | | 3. Tag filter ([wikitr:/Help/Action/Search any search string]) |
| 22 | | * Simple string (such as {{{Rome}}} will searched both in values and in keys (i.e. if you add tag "Rome"=yes it will be matched against "Rome" search) |
| 23 | | * {{{"addr:city":ome}}} or {{{"addr:city":Rome}}}) will match addr:city=Rome tag |
| 24 | | 4. table of: |
| | 34 | **Possible activation**: Left mouse click on the preset will open the preset, as is shown in [wikitr:/Introduction#Leftmouseclickonrespectivepresetheadingwillopencompletepresetview "Introduction"]. |
| | 35 | |
| | 36 | === Filter Tags ===#FilterTags |
| | 37 | Tag filter with same syntax as [wikitr:/Help/Action/Search Search]: |
| | 38 | * Simple string (such as `Rome` will searched both in values and in keys (i.e. if you add tag "Rome"=yes it will be matched against "Rome" search) |
| | 39 | * `"addr:city":ome` or `"addr:city":Rome` will match `addr:city=Rome` tag |
| | 40 | All tags not matching the filter are omitted from Tags Table below. |
| | 41 | |
| | 42 | === Tags Table === |
| | 43 | The table shows the tags as key/value pairs and, additionally, some empty space below. Depending on Filter Tags above some or all tags may be omitted. |
| | 44 | |
| 26 | | * complete list of tags if ''filter'' was empty |
| 27 | | * empty if filter from 3 matches no tags |
| 28 | | * only matched tags if there matching tags |
| 29 | | * annotated summary for multiple selected objects (select shop=pet together with shop=computer to see what it means) |
| 30 | | * empty space (below all items). |
| | 46 | * annotated summary for multiple selected objects where the values are: |
| | 47 | * **`value`**, if all objects have the tag |
| | 48 | * ''`<number 'value', number unset>`'', if a number of objects have the tag and the other number of object do not have the tag |
| | 49 | * ''`<number different>`'', if all objects have the tag but with the number of different values |
| | 50 | * ''`<number different, number unset>`'', if some objects have the tag but with the number of different values and the other number of object do not have the tag |
| 35 | | 5. membership information (is about [wikitr:/Help/Concepts/Object#Relations relations]) |
| 36 | | * no matching applied for parent relations; this result in union of all involved parent relations for the selected objects |
| 37 | | * displayed only for objects that have parent relations in [wikitr:/Help/Dialog/LayerList#ActivateLayer the current data layer] |
| 38 | | * objects without parent relations in local [wikitr:/Help/Dialog/LayerList#Layertypes data layer] can have parent relations on the server |
| | 57 | === Membership Table === |
| | 58 | The table shows information about memberships of selected objects in [wikitr:/Help/Concepts/Object#Relations relations]. The table is only shown if at least one selected object is a member of a relation, and it includes every relation that contains at least one selected object, even if other selected objects do not belong to the relation. |
| | 59 | Member of:: |
| | 60 | Shows the type of relation, its name (value of `name=*` tag), the total number of members and its state - ''incomplete'' if the relation is not downloaded completely. |
| | 61 | Role:: |
| | 62 | Shows the roles of the selected objects that belong to the relation as: |
| | 63 | * **''empty''** or **`role`**, if all object have no role or all have the same role |
| | 64 | * `<different>`, if objects have different roles or some objects have a role and some have not. |
| | 83 | [[JOSMImage(dialogs/add,bottom,margin-right=10,inline,link=)]] **Add** (''`Alt+A`'') [=#Add] |
| | 84 | |
| | 85 | * Adds key/value pairs to selected objects using the [wikitr:/Help/Dialog/AddValue Add tag dialog]. |
| | 86 | |
| | 87 | Alternative activation steps covered in overview section above. |
| | 88 | |
| | 89 | [[JOSMImage(dialogs/edit,link=,bottom,margin-right=10,inline)]] **Edit** (''`Alt+S`'') [=#Edit] |
| | 90 | * Change selected key/value pair using the [wikitr:/Help/Dialog/EditValue Change value dialog] - if tag was selected. |
| | 91 | * Open relation editor - if relationship was selected. |
| | 92 | |
| | 93 | Alternative activation steps covered in overview section above. |
| | 94 | |
| | 95 | [[JOSMImage(dialogs/delete,24,link=,bottom,margin-right=10,inline)]] Delete (''`Ctrl+Alt+Shift+D`'' or ''`Del`'') [=#Delete] |
| | 96 | * Delete selected key/value pairs. |
| | 97 | |
| | 98 | If you select one or several key/value pair in the tags table, and then click the **Delete** button they will be immediately deleted. |
| | 99 | |
| | 100 | |
| | 101 | == Examples ==#Examples |
| 71 | | Note: You can also add tags to selected object using presets, it was covered in [[wikitr:/Introduction#Presets|presets introduction]]. |
| 72 | | |
| 73 | | == Buttons == |
| 74 | | Basic usage was covered in [[wikitr:/Introduction#AddingTags|adding tags introduction]]. |
| 75 | | |
| 76 | | === [[Image(source:trunk/images/dialogs/add.png,bottom,margin-right=10,inline)]] Add (''`Alt+A`'') === #Add |
| 77 | | |
| 78 | | Adds key/value pairs to selected objects using [wikitr:/Help/Dialog/AddValue add value window] |
| 79 | | |
| 80 | | Alternative activation steps covered in overview section above. |
| 81 | | |
| 82 | | === [[Image(source:trunk/images/dialogs/edit.png,bottom,margin-right=10,inline)]] Edit (''`Alt+S`'') === #Edit |
| 83 | | * Change selected key/value pair using [wikitr:/Help/Dialog/EditValue change value window] - if tag was selected |
| 84 | | * Open relation editor - if relationship was selected |
| 85 | | |
| 86 | | Alternative activation steps covered in overview section above. |
| 87 | | |
| 88 | | === [[Image(source:trunk/images/dialogs/delete.svg,24,bottom,margin-right=10,inline)]] Delete (''`Ctrl+Alt+Shift+D`'') === #Delete |
| 89 | | Delete selected key/value pairs. |
| 90 | | |
| 91 | | If you select one or several key/value pair in the tags window, and then click the **Delete** button they will be immediately deleted. |
| 92 | | |
| 93 | | == Advanced Preferences == |
| | 119 | == Advanced Preferences ==#AdvancedPreferences |
| 95 | | || {{{properties.presets.visible}}} || {{{true}}} || If set to {{{true}}}, displays the list of presets matching the current tags. |
| 96 | | || {{{properties.presets.top}}} || {{{true}}} || If set to {{{true}}}, displays the list of presets matching the current tags above the list of tags, else below. |
| 97 | | || {{{url.openstreetmap-wiki}}} || {{{https://wiki.openstreetmap.org/wiki/}}} || The address of the OSM wiki used to see the documentation of a tag. |
| | 121 | || **`properties.presets.visible`** || `true` || If set to `true`, displays the list of presets matching the current tags. |
| | 122 | || **`properties.presets.top`** || `true` || If set to `true`, displays the list of presets matching the current tags above the list of tags, else below. |
| | 123 | || **`url.openstreetmap-wiki`** || `https://wiki.openstreetmap.org/wiki/` || The address of the OSM wiki used to see the documentation of a tag. |