Si vous souhaitez connaître les étapes d'installation des préréglages, consultez la section Enregistrement des Modèles d’attributs dans les Préférences
Si vous voulez utiliser des préréglages ou si vous avez besoin d'une référence complète sur les préréglages, voir les Préréglages

---

Modèles d’attributs

JOSM prend en charge les modèles d'attributs distribués. Il s'agit d'un fichier de configuration XML qui décrit une interface graphique permettant de saisir des attributs (ou des propriétés, des annotations, parfois appelés éléments cartographiques).

Les préréglages peuvent être placés n'importe où sur le Web ou dans le système de fichiers local de l'utilisateur. JOSM peut être configuré pour utiliser des préréglages personnalisés locaux ou distants.

Développer un nouveau préréglage

La description des modèles d'attributs est dans un format XML très simple. Voir les détails ci-dessous ci-dessous.

Voir le fichier defaultpresets.xml​ pour un exemple couvrant la plupart des possibilités énumérées ci-dessous.

Exemple:

<?xml version="1.0" encoding="UTF-8"?>
<presets xmlns="http://josm.openstreetmap.de/tagging-preset-1.0">
  <item name="Oneway highway" type="way">
    <label text="Inserting a unidirectional highway" />

    <combo key="highway" text="Type" values="trunk,motorway" />
    <text key="name" text="Name (e.g. Angel Road)" />
    <text key="ref" text="Ref (e.g. A406)" />

    <!-- Il s'agit d'un préréglage pour un sens unique, donc faites un sens unique par défaut. -->
    <check key="oneway" text="Oneway" default="on" />

    <!-- Toujours mettre la surface en bitume -->
    <key key="surface" value="asphalt" />
  </item>
</presets>

Fr:TaggingPresets-preset.xml, Fr:TaggingPresets.zip

Description du format XML

Le schéma XSD complet est disponible dans l'espace de noms URI (https://josm.openstreetmap.de/tagging-preset-1.0) ainsi que dans le dépôt des sources​.

Attributs

Préambule du document

<presets>

Doit être l'attribut principal du fichier. Prend en charge les attributs suivants :

• xmlns="​http://josm.openstreetmap.de/tagging-preset-1.0"
• author - le nom de l'auteur du préréglage
• version - le numéro de version du fichier. Pour le réglage automatique de la version des préréglages gérés dans ce wiki, vous devez utiliser deux variables internes : [[revision]] (le numéro de la version en développement de la page wiki) et [[date]] (la date de la dernière modification), par exemple version="1.[[revision]]_[[date]]".
• description (i18n) - description de ce que contient le fichier
• shortdescription (i18n) - une très courte description générale, c'est-à-dire le "nom" du préréglage.
• link (i18n) - lien internet pour plus de détails (facultatif)
• icon - icône pour l'ensemble du préréglage
• baselanguage - si la langue de base n'est pas l'anglais, spécifiez-la ici (l'utilisation de textes du préréglage non anglais empêchera la traduction automatique, une fois qu'elle sera mise en œuvre) (#11392))

(i18n) signifie que les valeurs peuvent également être localisées (par ex. de.description).

Commentaires

<!-- Voici un exemple de commentaire -->

Le document peut contenir des commentaires intégrés.

Création d'un groupe de préréglages

<group>

Utilisé pour regrouper les éléments dans les sous-menus. name="" est obligatoire, icon="" est un attribut facultatif.

<item>

Chaque élément (item) est un ensemble d'annotations à sélectionner. name="" est obligatoire, type="" et preset_name_label="" sont recommandés, icon="", name_template="" et match_expression="" sont des attributs facultatifs.

<separator />

Insére un séparateur de ligne dans le menu.

Configuration des fenêtres de préréglage

<label />

Les libellés sont des textes statiques à afficher. text="" est un attribut obligatoire, icon="" et icon_size="" sont facultatifs.

<space />

Ajoute un espace (c'est-à-dire une nouvelle ligne).

<optional>

Utilisé pour regrouper certains éléments facultatifs d'un item. L'attribut text="" est facultatif. S'il est utilisé sans text="", il est équivalent à <space /><label text="Optional Attributes:" /><space />

<item_separator />

Ajoute une ligne de séparation horizontale entre les items.

<link />

Indique un lien Web pour cette fonctionnalité ou pour tout autre élément utile. L'attribut wiki="" (faisant référence à une page wiki OSM, par exemple "Tag:leisure=park") ou href="" (URL complète) est requis. Lorsque l'attribut wiki="" est utilisé, le lien pointe vers la page wiki de la langue choisie par JOSM. Si elle n'existe pas, la page anglaise est affichée. Si vous utilisez wiki="", la page wiki d'OSM ne doit pas être codée en URL, par exemple : ne pas mettre "Tag:leisure%3Dpark" mais plutôt "Tag:leisure=park".

<checkgroup>

Pour regrouper les contrôles. L'attribut columns="" est obligatoire.

<roles>

Ceci est nécessaire autour de <role /> et ajoute le titre ("Available roles role count elements") au tableau qui est généré par plusieurs <role />.

<role />

Pour spécifier les rôles possibles des membres dans les relations. L'attribut key="" est obligatoire, text="", requisite="", count="", type="", member_expression="" et regexp="" sont facultatifs.

<preset_link />

Ajoute un lien vers un autre préréglage avec une étiquette en haut. L'attribut preset_name="" est obligatoire, text="" pour remplacer l'étiquette (la valeur par défaut est "Edit also …") et text_context="" sont facultatifs. Une séquence de <preset_link /> sans text="" ou avec une valeur text="" identique est regroupée sous une étiquette.
Faites attention aux préréglages ayant un name="" identique, car il n'est pas possible de prévoir vers quel préréglage le lien mènera, voir #12716.
Le fait d'avoir le même attribut dans les deux préréglages ne fonctionne pas, voir #18992.
L'utilisation de <preset_link /> dans les préréglages ouverts depuis l'Éditeur de relations produit des exceptions, voir #20044.

Définir une paire clé-valeur fixe

<key />

Cet attribut définira toujours une clé à une valeur spécifique. key="" est obligatoire et si value="" est présent, la clé sera définie. Si l'attribut value="" est omis, la clé est supprimée. L'attribut match="" est facultatif.

Fenêtres de saisie et de sélection d'attributs

<text />

Un champ d'édition de texte pour entrer n'importe quelle chaîne arbitraire de l'utilisateur. key="" est obligatoire, text="", default="", use_last_as_default="", auto_increment="", length="", alternative_autocomplete_keys="", match="", icon="" et icon_size="" (les deux depuis r17605) sont facultatifs.

<combo />

Affiche une boîte combo à choix multiples. key="" et values="" sont obligatoires, text="", default="", editable="", delimiter="", values_from="", display_values="", short_descriptions="", use_last_as_default="", values_searchable="", length="", values_no_i18n="", values_sort="", match="", icon="" et icon_size="" (les deux depuis r17605) sont facultatifs.
Si la valeur de editable="" est true (par défaut), les combo boxes peuvent être éditées comme s'il s'agissait de champs texte (en plus du menu déroulant). Les boîtes combo non modifiables ne peuvent contenir qu'une des valeurs spécifiées.
Si la clé est colour ou colour:* ou *:colour, a un aperçu et un sélecteur de couleur sont ajoutés à droite (voir #8352).

<multiselect />

Affiche une liste dans laquelle on peut choisir zéro ou plusieurs éléments. key="" et values="" sont obligatoires, et text="", default="", delimiter="", values_from="", rows="", display_values="", short_descriptions="", use_last_as_default="", values_searchable="", values_no_i18n="", values_sort="", match="", icon="" et icon_size="" (les deux depuis r17605) sont optionnels. Les valeurs sélectionnées seront concaténées avec le délimiteur spécifié (par défaut : point-virgule, ;) et écrites dans la valeur de l'attribut. Si une valeur d'attribut a déjà été définie lorsque la fenêtre de préréglage est ouverte, le <multiselect /> tentera de marquer les éléments appropriés de la liste comme étant sélectionnés. Si la valeur de l'attribut ne peut pas être représentée par une combinaison de choix dans la liste, alors la liste sera désactivée afin que l'utilisateur ne puisse pas accidentellement écraser une valeur personnalisée. Contrairement à l'élément <combo /> l'élément <multiselect /> attend de la liste des valeurs, des descriptions, etc. qu'elle utilise le délimiteur spécifié, c'est-à-dire que par défaut, vous devrez utiliser un point-virgule. Vous pouvez spécifier delimiter="," mais alors une virgule sera également utilisée dans la valeur de l'attribut.

<list_entry />

Utilisé dans <combo> et <multiselect>. Pour plus d'informations, voir short_descriptions="", ci-dessous. Les attributs sont value="", display_value="", short_description="", icon="" et icon_size="".

<check />

Une case à cocher que l'utilisateur peut sélectionner, désélectionner ou définir comme non définie. L'attribut key="" est obligatoire. Les attributs text="", default="", match="", value_on="" , value_off="", disable_off="", icon="" et icon_size="" ( les deux depuis r15437) sont facultatifs.

Modèles (Templates)

<chunk>

Pour définir un modèle d'éléments pour une utilisation (répétée) ultérieure. L'attribut id="" est obligatoire.

<reference>

Pour inclure un modèle défini précédemment. L'attribut ref="" est obligatoire.

Attributs

Les attributs des balises (tags) ont la signification suivante :

name="a_name"

Spécifiez un nom pour un élément. Ce nom sera utilisé dans l'interface graphique pour afficher le modèle d'attributs.

name_context="context"

Contexte de traduction pour l'attribut de nom afin de séparer les mots égaux ayant une signification différente (non requis pour les traductions en fichier).

type="data_type"

Lorsqu'il est spécifié, seuls les objets du type donné fonctionneront avec ce modèle d'attributs. Peut être "node", "way", "closedway", "multipolygon", "relation" ou toute combinaison séparée par des virgules. Notez que "multipolygon" n'est pas inclus dans "relation", donc si le préréglage doit s'appliquer aux multipolygones et aux autres types de relation, vous devez spécifier les deux : "multipolygon,relation". . Également utilisé dans l'attribut <role> pour spécifier les types d'objets autorisés pour un membre de relation spécifique.

icon="iconname"

Un nom ou un lien vers une icône. L'image sera utilisée comme icône à afficher dans la liste de sélection et lors de l'ajout du préréglage à la barre d'outils. Les icônes peuvent également être utilisées dans <item>, <label />, plus toutes les Fenêtres de saisie et de sélection d'attributs (depuis la r17605, avant c'était seulement <list_entry /> et <check />). Elle est placée devant <text /> L'icône doit être de taille quadratique. Voir Gestion des icônes pour savoir comment les icônes peuvent être spécifiées.

icon_size="a number"

La taille maximale d'une icône en px. Si aucune valeur n'est donnée, la valeur par défaut est 16 pour <label /> et la taille par défaut de l'icône pour <list_entry /> (dans <combo> et <multiselect>).

key="some_key"

Ceci spécifie la clé de la propriété qui sera modifiée par l'élément. Dans le cas de <role> c'est le nom du rôle utilisé dans une relation.

text="Any text"

La description, qui sera affichée avant l'élément * (gui element), (dans le cas de <check /> après l'élément gui element et l'icône optionnelle). Également utilisé pour <label> et <optional>.

text_context="context"

Contexte de traduction pour l'attribut texte afin de séparer les mots égaux ayant une signification différente (non requis pour les traductions en fichier).

default="default_value"

Une valeur par défaut explicitement déclarée pour l'objet. Cette valeur est only (seulement) appliquée par un préréglage lorsque l'objet auquel le préréglage est appliqué to has zero keys. Si aucune valeur n'est spécifiée pour default, aucune valeur n'est attribuée à la clé. Utilisé dans <check />, <text />, <combo /> et <multiselect />. Pour <check /> seules les valeurs "on" et "off" sont valides.

values="entry1,entry2,entry3"

Une liste d'entrées (pour la boîte <combo /> et <multiselect />). La liste doit être séparée par des virgules (pour la boîte combo) ou par le délimiteur spécifié (pour le multi-sélection). Si une valeur contient le délimiteur, celui-ci peut être échappé par une barre oblique inverse. Si une valeur contient une barre oblique inverse, elle doit également être échappée par une barre oblique inverse.

values_from="JAVA code"

À utiliser à la place de values="" si la liste des valeurs doit être obtenue avec une méthode Java de cette forme : public static String[] getValues(); La valeur doit être : "full.package.name.ClassName#methodName".

values_no_i18n="true|false"

Désactive l'internationalisation des valeurs pour éviter les erreurs, voir #11696. La valeur par défaut est "false". Utilisé dans <combo /> et <multiselect />. (Utile par exemple pour les clés opening hours ou brand.) Inutile avec les clés ayant uniquement des nombres comme valeurs comme layer ou level qui sont déjà exclus de la traduction.

values_sort="true|false"

Les valeurs de <combo /> et <multiselect /> sont triées par ordre alphabétique dans toutes les langues. Avec cet attribut, vous pouvez désactiver le tri alphabétique si les valeurs doivent conserver l'ordre donné, voir #5509 et #11926. (Dans le préréglage interne de JOSM, ceci est utilisé par exemple pour les clés tracktype, direction, network, smoothness, visibility ou trail_visibility.) La valeur par défaut est "true".
Les utilisateurs peuvent désactiver globalement le tri avec la clé des préférences taggingpreset.sortvalues.

values_context="context"

Contexte de traduction pour l'attribut "values" afin de séparer les mots égaux ayant une signification différente (non requis pour les traductions en fichier).

display_values="Entry1,Entry2,Entry3"

Une liste d'entrées qui est affichée à l'utilisateur. Le nombre et l'ordre des entrées doivent être identiques à ceux de values="" et editable="" doit être "false" ou ne pas être spécifié. Pour le caractère de délimitation et l'échappement, voir les remarques sur values="". Utilisé dans <combo /> et <multiselect />.

value="foobar"

Spécifiez une valeur à saisir dans l'attribut <key>.

value_on="foobar"

Spécifiez la valeur réelle à saisir dans l'attribut <key> d'un <check /> coché (la valeur par défaut est "yes").

value_off="foobar"

Spécifiez la valeur fausse à saisir dans l'attribut <key> d'un <check /> non coché (la valeur par défaut est "no").

disable_off="true"

Indique si la valeur désactivée d'un <check /> est désactivée dans la fenêtre, c'est-à-dire que seules les valeurs "unset" ou "yes" sont fournies.

editable="false"

La combo box est en lecture seule, ce qui signifie que l'utilisateur ne peut sélectionner qu'un élément de la liste. La valeur par défaut est "true", ce qui signifie que l'utilisateur peut ajouter d'autres valeurs en tant que texte. (La fonctionnalité ne fonctionnait pas correctement depuis longtemps mais devrait fonctionner à nouveau depuis la r18221, voir #6157).

use_last_as_default="true|false|force"

Pour les champs <combo />, <multiselect /> ou <text /> la dernière valeur utilisée est utilisée par défaut. L'utilisation de "force" impose ce comportement également pour les objets déjà étiquetés. La valeur par défaut est "false".

rows="count"

Spécifiez le nombre de lignes à afficher dans l'entrée <multiselect /> (s'il n'est pas défini, il est déterminé automatiquement par java ou le "look and feel" et donne par exemple 8).

name_template="template", name_template_filter="search expression"

Formateur de nom personnalisé pour les primitives osm correspondant à ce préréglage. Voir ci-dessous détails du modèle de nom.

match="none|key|key!|keyvalue|keyvalue!"

Permet de modifier le processus de correspondance, c'est-à-dire de déterminer si les attributs d'un objet OSM correspondent à ce préréglage. Si un préréglage correspond, il est lié dans la Fenêtre latérale Attributs/Appartenance.

• none: neutre, c'est-à-dire qu'il ne faut pas considérer cet élément pour la correspondance
• key: positif si la clé correspond, neutre sinon
• key!: positif si la clé correspond, négatif sinon
• keyvalue: positif si la clé et la valeur correspondent, neutre sinon
• keyvalue!: positif si la clé et la valeur correspondent, négatif sinon
  

Note : Pour une correspondance, il devrait y avoir au moins un positif et aucun négatif sont requis. La valeur par défaut est "keyvalue!" pour <key> et "none" pour <text />, <combo />, <multiselect /> et <check />.

match_expression="search expression"

critères supplémentaires pour la correspondance des primitives, spécifiés dans la syntaxe de recherche JOSM. (depuis r17662)
Les guillemets (") doivent être écrits sous la forme ".
Par exemple, un préréglage avec match_expression="foo=bar" nécessite que les objets OSM aient l'attribut foo=bar. Vous pouvez utiliser l'expression match_expression="" pour exclure certains objets OSM, par exemple lorsqu'un préréglage plus spécifique est présent.

id="unique_identifier"

l'identifiant unique pour ce <chunk>

ref="unique_identifier"

l'identifiant unique du modèle (déjà défini) à inclure

columns="a number"

le nombre de colonnes de <check /> groupé

requisite="optional|required"

Si un membre de la relation est facultatif ou obligatoire. La valeur par défaut est "optional"

count="a number"

Combien de fois un rôle peut-il se produire (si le nombre n'est pas donné, on suppose qu'il est illimité)

member_expression="search expression"

une expression, dans la syntaxe de recherche JOSM pour les objets de ce rôle
Les guillemets (") doivent être écrits sous la forme ".

regexp="true"

défini à "true" si la clé d'un rôle est une expression régulière.
Cela permet des rôles variables, par exemple <role key="level_-?\d+" text="Building level" regexp="true" requisite="optional" type="relation" /> permet les rôles level_0, level_1,...

preset_name="exact_name"

Le nom exact du préréglage à rattacher.

preset_name_label="false|true"

Insertion ou non de l'étiquette "[preset name]" dans la fenêtre (la valeur par défaut est "false" pour la compatibilité avec les préréglages externes).

length="a number"

La longueur d'une boîte <text /> ou <combo /> (number of characters allowed).

alternative_autocomplete_keys="some_key(s)"

Une liste, séparée par des virgules, de clés alternatives à utiliser pour l'auto-complétion de <text>.

auto_increment="-2,-1,+1,+2"

Peut contenir une liste d'incréments ou de décréments entiers séparés par des virgules, par exemple "-2,-1,+1,+2". Un bouton sera affiché à côté du champ <text /> pour chaque valeur, permettant à l'utilisateur de sélectionner l'auto-incrémentation avec l'incrément donné. L'auto-incrémentation ne se produit que si l'utilisateur la sélectionne. Il existe également un bouton pour désélectionner l'auto-incrémentation. Par défaut, il n'y a pas d'auto-incrémentation. Mutuellement exclusif avec use_last_as_default="".

delimiter="special character"

Le caractère qui sépare les valeurs. Dans le cas de <combo /> la valeur par défaut est la virgule (,). Dans le cas de <multiselect /> la valeur par défaut est le point-virgule (;) et il sera également utilisé pour séparer les valeurs sélectionnées dans l'attribut. Pour plus d'informations, voir <multiselect />, ci-dessus.

short_descriptions="Entry1,Entry2,Entry3"

Une liste de textes, séparés par des délimiteurs, à afficher sous chaque display_value="". (Seulement s'il n'est pas possible de décrire l'entrée en 2 ou 3 mots.) Au lieu d'une liste séparée par des virgules utilisant values="", display_values="" et short_descriptions="", la forme suivante est également prise en charge :
<list_entry value="" display_value="" short_description="" icon="" icon_size="" />

values_searchable="true|false"

S'il faut rechercher dans values="" et display_values="", respectivement, value="" et display_value="" de <combo /> ou <multiselect /> à la recherche de préréglages.

value_template="template"

Un modèle pour générer automatiquement la valeur en fonction des autres valeurs d'attribut de l'objet. La même syntaxe que dans name_template="" est utilisée, voir ci-dessous. (depuis r17639)
Par exemple, "Bus {ref}: {from} → {to}" peut être utilisé pour générer le nom d'une relation de ligne de bus.
Note : Il existe quelques problèmes mineurs avec cet attribut, voir #20851 et #20861.

détails des modèles name_template et value_template

Les modèles de noms peuvent être utilisés pour définir un formatage personnalisé des primitives OSM ou des points de passage (waypoints) GPX (par exemple dans les Relations ou les panneaux (fenêtres déroulantes) de Sélection).

<?xml version="1.0" encoding="UTF-8"?>
<presets>
        <item name="Public transportation" type="relation"
                name_template="Bus({operator} {ref} ?{'{from} - {via} - {to}' | '{from} - {to}' | '{from}' | '{to}'})"
                name_template_filter="type=route route=bus">
        </item>
</presets>

Exemples

Modèle	Attributs	Résultat
House number {addr:housenumber}	addr:housenumber=10	Maison numéro 10
?{ 'House number {addr:housenumber} at {addr:street}' | 'House number {addr:housenumber}' }	addr:housenumber=10	Maison numéro 10
	addr:housenumber=10 addr:street=Abbey road	House number 10 at Abbey road
?{ admin_level = 2 'NUTS 1' | admin_level = 4 'NUTS 2' | admin_level = 6 'NUTS 3' | 'Admin level {admin_level}'}	admin_level=4	NUTS 2
{admin_level} - {name} !{parent() type=boundary '?{'(part of {admin_level} - {name})' | ''}'}	admin_level=6 name=Vysocina, member of relation admin_level=4 name=Jihovychod	6 - Vysocina (part of 4 - Jihovychod)
	admin_level=2 name=Czech republic (pas de parents)	2 - Czech republic

Syntaxe

• * {tag} - insère la valeur de l'attribut.
• ?{condition1 'value1' | condition2 'value2' | 'value3'} - utiliser value1 si la condition1 est satisfaite, , sinon utiliser value2 si la condition2 est satisfaite, enfin utiliser value3 si aucune condition n'est satisfaite. La condition peut être explicite - dans la syntaxe de la Recherche JOSM ou implicite ; la valeur est utilisée lorsque toutes les attributs utilisées à l'intérieur existent.
• !{search_expression 'template'} - search_expression est évaluée et la première primitive correspondante est utilisée comme contexte pour le modèle. Utile par exemple pour obtenir les attributs de la relation parent.
• \ - utiliser une barre oblique inverse pour échapper les caractères spéciaux {, }, ?, !. Par exemple : Qu'est-ce que ceci \? C'est un {type}\!.

Valeurs disponibles

Pour le formatage des primitives OSM, la valeur de n'importe quel attribut peut être utilisée. Utiliser l'attribut {special:everything} pour afficher toutes les attributs disponibles, par exemple sur vos points de passage (waypoints) gpx.

Vous pouvez également utiliser ces attributs virtuels :

• {special:everything} affiche toutes les valeurs disponibles, disponibles pour le formatage des primitives et des points de passage.
• {special:id} affiche l'ID de la primitive osm
• {special:localName} affiche le nom localisé, c'est-à-dire la valeur de name:lang pour votre langue si elle est disponible ou la valeur de name si elle ne l'est pas.

Attributs obsolètes

Les attributs suivants sont obsolètes et ne sont plus pris en charge par JOSM :

delete_if_empty="true"

a été supprimé dans la r5155. Vous pouvez simplement supprimer cet attribut s'il est toujours utilisé dans votre préréglage.

required="true"

remplacé par match="" depuis r5155

Traduction

Pour prendre en charge les traductions, tous les éléments textuels (name="", text="", display_values="") peuvent être localisés. Par exemple, de.name="" représente le nom lorsque le support de la langue allemande est chargé. Dans le code XML du préréglage, le terme anglais doit être le premier, avant que les traductions éventuelles puissent être ajoutées.

Préréglage interne

La traduction pour le préréglage interne est faite avec ​Launchpad (et sera probablement changée pour un autre service dans le futur, puisque l'interface web de Launchpad produit souvent des erreurs de timeout, voir #8645).

Dans le (préréglage interne​) tous les name="", text="" et display_values="" sont traduits via le service ci-dessus, pour autant qu'aucune traduction spécifique n'ait été donnée dans le fichier XML. Si aucun display_values="" n'est fourni, alors values="" sera traité comme display_values="" et traduit à la place.

Lorsqu'un même mot anglais a des traductions différentes dans des contextes différents, le contexte de traduction spécifique doit être précisé. Utilisez name_context="", text_context="" ou values_context="" pour cette raison. Le contexte doit être une courte description significative pour aider les traducteurs.

Préréglages externes

La traduction de préréglages externes sur ce site est, jusqu'à présent, uniquement possible en ligne dans le code source XML du préréglage, voir #11392.

Toutefois, lorsque des mots sont utilisés dans le préréglage externe qui existent déjà dans le préréglage interne, la traduction à partir du préréglage interne s'applique également à l'externe. Cela est utile tant que le contexte est le même. Lorsque le contexte dans le préréglage externe est différent, il faut le distinguer en ajoutant name_context="", text_context="" ou values_context="".

Gestion des icônes

Voir Styles.

Voir également

• Menu Préréglages
• La version originale de cette page en anglais