[[TranslatedPages(revision=196)]]
[[PageOutline(2-10,Inhoud)]]
''Als u wilt leren hoe voorkeuzen kunnen worden geïnstalleerd, zie - [[JOSMImage(dialogs/propertiesdialog)]] [wikitr:/Help/Preferences/TaggingPresetPreference tab Vooraf ingestelde tags] in [[JOSMImage(preference)]] [wikitr:/Help/Action/Preferences Voorkeuren]''\\
''Als u voorkeuzen wilt gebruiken of een volledige verwijzing naar de voorkeuzen wilt, zie [wikitr:/Presets Voorkeuzen]''\\
----
= Voorkeuzen voor tags =
JOSM ondersteunt gedeelde voorkeuzen voor tags. Dit is een XML configuratiebestand dat een GUI beschrijft voor het invoeren van tags (of eigenschappen, opmerkingen, soms ook wel kaartobjecten genoemd).
De voorkeuzen kunnen overal op het web geplaatst worden of op het lokale bestandssysteem van de gebruiker. JOSM kan worden geconfigureerd om aangepaste lokale of Voorkeuzen van op afstand te gebruiken.
== Een nieuwe voorkeuze ontwikkelen ==
De beschrijving van een voorkeuze voor taggen staat in een zeer eenvoudige XML-indeling. Voor details zie [#XML hieronder].
Bekijk **[source:/trunk/resources/data/defaultpresets.xml defaultpresets.xml]** voor een voorbeeld dat de meeste mogelijkheden behandelt van die welke hieronder vermeld zijn.
Voorbeeld:
[[Image(TaggingPresets:Change 1 object.png,right,link=,margin-left=15)]]
{{{
#!preset
}}}
\\
== Beschrijving XML-indeling ==#XML
Het volledige XSD-schema is beschikbaar op de namespace URI (http://josm.openstreetmap.de/tagging-preset-1.0) en ook in [source:trunk/resources/data/tagging-preset.xsd de opslagplaats van de bron].
=== Tags ===
==== De proloog van het document ====
::
Moet de hoofdtag van het bestand zijn. Ondersteunt de volgende attributen
* **xmlns="http://josm.openstreetmap.de/tagging-preset-1.0"**
* **author** - de naam van de auteur van de voorkeuze
* **version** - het versienummer van het bestand. Voor geautomatiseerde versie-aanpassingen van de voorkeuzen die worden beheerd op deze wiki moet u twee interne variabelen gebruiken: `[[revision]]` (het laatste versienummer van de pagina op de wiki) en `[[date]]` (de datum van de laatste bewerking), bijv. `version="1.[[revision]]_[[date]]"`.
* **description** (i18n) - beschrijving van wat het bestand bevat
* **shortdescription** (i18n) - zeer korte overzichtsbeschrijving d.i. de "naam" van de voorkeuze
* **link** (i18n) - weblink voor meer details (optioneel)
* **icon** - pictogram voor de gehele voorkeuze.
* **baselanguage** - wanneer de basistaal niet Engels is, specificeer die dan hier (gebruiken van niet-Engelse teksten voor voorkeuze zal automatisch vertalen voorkomen, als het eenmaal is geïmplementeerd (#11392))
(i18n) betekent dat de waarden ook mogen zijn gelokaliseerd (bijv. `de.description`).
\\
==== Opmerkingen ====
::
Het document mag ingebedde opmerkingen bevatten.
\\
==== Groep voorkeuzen maken ====
::
Gebruikt om items te groeperen in submenu's. `name=""` is vereist, `icon=""` is een optioneel attribuut.
::
Elk item is één ingestelde opmerking om uit te selecteren. `name=""` is vereist, `type=""` en `preset_name_label=""` worden aanbevolen, `icon=""`, `name_template=""` en `match_expression=""` zijn optionele attributen.
::
Voegt een scheidingslijn in het menu in.
\\
==== Lay-out Venster Voorkeuze ====
::
Labels zijn statische teksten om weer te geven. `text=""` is een vereist attribuut, `icon=""` en `icon_size=""` zijn optioneel.
::
Voeg enkele spaties in (d.i. een newline).
::
Gebruikt om enkele optionele elementen van een item te groeperen. Het attribuut `text=""` is optioneel. Indien gebruikt zonder `text=""` dan is dit equivalent aan ``
::
Voegt een horizontale scheidingslijn tussen de items in.
::
Specificeer een weblink voor dit object of voor iets anders. Ofwel de attributen `wiki=""` (verwijzend naar een pagina van de wiki van OSM, bijv. `"Tag:leisure=park"`) of `href=""` (volledige URL) zijn vereist. Als het attribuut `wiki=""` wordt gebruikt verwijst de link naar de pagina van de wiki van de taal waarin JOSM is ingesteld. Als die niet bestaat wordt de Engelse pagina weergegeven. Bij het gebruiken van `wiki=""`moet de pagina van de OSM-wiki niet worden URL-gecodeerd, bijv., het mag niet `"Tag:leisure%3Dpark"` zijn, maar moet in plaats daarvan `"Tag:leisure=park"`zijn.
::
Om keuzevakken te groeperen. Het attribuut `columns=""` is vereist.
::
Dit wordt vereist rondom `` en voegt de kop ("Available roles role count elements") toe aan de tabel die wordt gegenereerd bij verscheidene ``'s.
::
Specificeert mogelijke rollen van leden van de relatie. Het attribuut `key=""` is vereist, `text=""`, `requisite=""`, `count=""`, `type=""`, `member_expression=""` en `regexp=""` zijn optioneel.
::
Voegt een a link toe naar een andere voorkeuze met een label erboven. Het attribuut `preset_name=""` is vereist, `text=""` om het label te overschrijven (standaard is `"Bewerk ook …"`) en `text_context=""` zijn optioneel. Een reeks van `` zonder `text=""` of een identieke waarde `text=""` worden gegroepeerd onder één label. \\
**Pas op voor voorkeuzen met een identieke `name=""`** omdat niet voorspelbaar is naar welke voorkeuze de koppeling zal leiden, zie #12716. \\
Dezefde tag hebben in beide voorkeuzen werkt niet, zie #18992. \\
Gebruiken van `` in voorkeuzen geopend vanuit de [wikitr:/Help/Dialog/RelationEditor Relatiebewerker] produceert uitzonderingen, zie #20044.
\\
==== Een vast paar sleutel/waarde instellen ====
::
Deze tag zal altijd een sleutel instellen op één specifieke waarde. `key=""` is vereist en als `value=""` aanwezig is, zal de sleutel worden ingesteld. Indien het attribuut `value=""` wordt weggelaten, wordt de sleutel verwijderd. Het attribuut `match=""` is optioneel.
\\
==== Dialoogvensters voor item Attribuut en selectie ====#EntrySelectionBoxes
::
Een tekstbewerkingsveld om door de gebruiker een tekenreeks in te laten voeren. `key=""` is verplicht, `text=""`, `default=""`, `use_last_as_default=""`, `auto_increment=""`, `length=""`, `alternative_autocomplete_keys=""`, `match=""`, `icon=""` en `icon_size=""` (beide vanaf r17605) zijn optioneel
::
Geeft een combinatievak voor meerdere keuzes weer. `key=""` en `values=""` zijn verplicht, `text=""`, `default=""`, `editable=""`, `delimiter=""`, `values_from=""`, `display_values=""`, `short_descriptions=""`, `use_last_as_default=""`, `values_searchable=""`, `length=""`, `values_no_i18n=""`, `values_sort=""`, `match=""`, `icon=""` en `icon_size=""` (beide vanaf r17605) zijn optioneel.\\
Als `editable=""` is `"true"` (standaard), kunnen combinatievakken worden bewerkt alsof zij tekstvelden waren (aanvullend aan het keuzemenu). Niet bewerkbare combinatievakken kunnen alleen één van de gespecificeerde waarden bevatten.\\
Als de sleutel `colour` of `colour:*` of `*:colour` is, worden een voorbeeldkleur en een kleurkiezer toegevoegd aan de rechterkant (zie #8352).
[=#multiselect]
::
Geeft een lijst weer waaruit nul of meer items kunnen worden gekozen. `key=""` en `values=""` zijn verplicht, en `text=""`, `default=""`, `delimiter=""`, `values_from=""`, `rows=""`, `display_values=""`, `short_descriptions=""`, `use_last_as_default=""`, `values_searchable=""`, `values_no_i18n=""`, `values_sort=""`, `match=""`, `icon=""` en `icon_size=""` (beide vanaf r17605) zijn optioneel. De geselecteerde waarden zullen worden samengevoegd door middel van de het gespecificeerde scheidingsteken (standaard: puntkomma `;`) en worden geschreven naar de waarde van de tag. Als al een waarde voor de tag is ingesteld bij het openen van het dialoogvenster, zal `` proberen de toepasselijke items in de lijst als geselecteerd te markeren. Als de waarde van de tag niet kan worden weergegeven door een combinatie van keuzes in de lijst, dan zal de lijst worden uitgeschakeld zodat de gebruiker niet per ongeluk een aangepaste waarde kan overschrijven. In tegenstelling tot het element "combo" element, verwacht `` dat de lijst met waarden, beschrijvingen etc. het gespecificeerde scheidingsteken gebruikt, d.i. standaard zult u een puntkomma moeten gebruiken. U kunt `delimiter=","` specificeren, maar dan zal een komma ook worden gebruikt in de waarde van de tag.
::
Gebruikt in `` en ``. Voor meer informatie, zie `short_descriptions=""` [#short_description hieronder]. De attributen zijn `value=""`, `display_value=""`, `short_description=""`, `icon=""` en `icon_size=""`.
::
Een keuzevak dat de gebruiker kan selecteren, deselecteren of instellen als niet ingesteld. Het attribuut `key=""` is verplicht. `text=""`, `default=""`, `match=""`, `value_on=""` , `value_off=""`, `disable_off=""`, `icon=""` en `icon_size=""` (beide sinds r15437) zijn optioneel.
\\
==== Sjablonen ====
::
Definieert een sjabloon met elementen voor later gebruik. Het attribuut `id=""` is verplicht.
::
Neemt een eerder gedefinieerd sjabloon op. Het attribuut `ref=""` is verplicht.
\\
=== Attributen ===
De attributen van de tags hebben de volgende betekenis:
name="een_naam"::
Specificeer een naam voor een item. Deze naam zal in de GUI worden gebruikt om de voorkeuze voor het taggen weer te geven.
name_context="context"::
Vertaalde context voor attribuut name om gelijke woorden met een verschillende betekenis te onderscheiden (niet vereist voor vertalingen binnen bestanden).
type="data_type"::
Indien gespecificeerd, zullen alleen objecten van het opgegeven type werken met deze voorkeuze voor taggen. Mag niet zijn `"node"`, `"way"`, `"closedway"`, `"multipolygon"`, `"relation"` of enige andere kommagescheiden combinatie daarvan. Onthoud dat `"multipolygon"` niet is opgenomen in `"relation"`, dus als de voorkeuze van toepassing zou zijn voor multipolygonen en andere typen relatie, dient u beide te specificeren: `"multipolygon,relation"`. Ook gebruikt in de tag `` om te specificeren welke typen object zijn toegestaan voor een specifiek lid van een relatie.
icon="pictogramnaam"::
Een naam van of link naar een pictogram. De afbeelding zal als pictogram worden gebruikt om te worden weergegeven in de selectielijst en bij het toevoegen van de voorkeuze aan de werkbalk. Pictogrammen kunnen ook worden gebruikt in ``, ``, plus alle [#EntrySelectionBoxes dialoogvakken voor invoer en selectie] (vanaf r17605, daarvoor waren het alleen `` en ``). Het wordt geplaatst voor ``. Het pictogram zou kwadratisch in grootte moeten zijn. Bekijk [wikitr:/Styles#Iconhandling Afhandeling pictogrammen] om te zien hoe pictogrammen kunnen worden gespecificeerd.
icon_size="een getal"::
De maximale grootte van een pictogram px. Indien geen waarde wordt opgegeven, is 16 standaard voor en de standaardgrootte van een pictogram voor `` (in `` en ``).
key="een_sleutel"::
Dit specificeert de sleutel voor de eigenschap die zal worden aangepast door het item. In het geval van `` is het de naam van de rol die wordt gebruikt in een relatie.
text="Enige tekst"::
De beschrijving die zal worden weergegeven vóór het element van de GUI, (in het geval van `` na het element van de GUI en het optionele pictogram). Ook gebruikt voor `