# Étiquettes

Les étiquettes sont des textes associés aux entités cartographiques. Elles permettent d'afficher des informations relatives à ces entités directement sur la carte. Par exemple, il est possible d'afficher les noms des villes à partir d’une couche de points représentant les centres urbains.

La section **Étiquettes**, accessible via l’icône <img src="https://1484831130-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrPLLbWoaAYyK9HykpM0p%2Fuploads%2FIMvPlPywr9BvQx2DVAd6%2Fstudio-couche-etiquette.png?alt=media&#x26;token=2a1f3b09-db35-44f6-b8e5-2b86ffc49dc2" alt="" data-size="line">, permet de configurer le contenu, le style et l’affichage des étiquettes pour les entités d’une couche.

<figure><img src="https://1484831130-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrPLLbWoaAYyK9HykpM0p%2Fuploads%2FY0oOrqnHIHDPbpbB0ElZ%2FFR-PanneauEtiquette.png?alt=media&#x26;token=f108db82-2ab6-4028-b031-439c79e08e1b" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="58" align="center"></th><th></th></tr></thead><tbody><tr><td align="center">1</td><td><strong>Activer</strong> les étiquettes<br>Cochez cette case pour afficher les étiquettes dans les applications JMap NG.</td></tr><tr><td align="center">2</td><td><strong>Police</strong><br>Cliquez sur ce bouton pour sélectionner le style du texte de l'étiquette : police, taille de la police, gras, italique, couleur de la police, contour et couleur du contour.</td></tr><tr><td align="center">3</td><td>Fenêtre pour <strong>écrire le contenu</strong> de l'étiquette.<br>La section <a href="#contenu-de-letiquette">Contenu de l'étiquette</a> offre de détails sur le sujet. </td></tr><tr><td align="center">4</td><td><strong>Attributs</strong><br>Attributs disponibles pour les étiquettes.<br>Il s'agit des attributs de la couche que vous cochez dans la section <a href="proprietes">Propriétés</a>.</td></tr><tr><td align="center">5</td><td><strong>Fonctions</strong><br>Fonctions disponibles pour les étiquettes. <br>La section <a href="#contenu-de-letiquette">Contenu de l'étiquette</a> détaille ces fonctions.</td></tr><tr><td align="center">6</td><td><strong>Niveaux de zoom</strong> <br>Plage de niveaux de zoom auquelle les étiquettes sont affichées.<br>Spécifiez la plage en glissant les indicateurs sur la barre ou en inscrivant les valeurs minimale et maximale de zoom de la plage.</td></tr><tr><td align="center">7</td><td><strong>Position</strong><br>Déterminez la position de l'étiquette par rapport à l'entité. <br>Cliquez sur <img src="https://1484831130-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrPLLbWoaAYyK9HykpM0p%2Fuploads%2FCxh7433tbfX05wKDWGTA%2Fstudio-couche-roue.png?alt=media&#x26;token=886319d5-14b7-433b-a39d-b6534fa30e55" alt=""> pour sélectionner la position parmi les positions possibles.<br><br><strong>Permettre le chevauchement</strong><br>Cochez cette case pour permettre que les étiquettes de la couche se chevauchent et qu’elles chevauchent les étiquettes d’autres couches. L'option peut s’avérer utile pour assurer que toutes les étiquettes d’une couche sont affichées.<br><br><strong>Suivre la ligne</strong><br>Pour éléments de type ligne seulement. <br>Cochez la case pour que le texte de l’étiquette suive la forme des lignes courbes.<br><br><strong>Espacement (pixel)</strong><br>Pour éléments de type ligne seulement. <br>Indiquez l'espacement (en pixels) entre les étiquettes répétées d’une même ligne.</td></tr><tr><td align="center">8</td><td>Établissez le <strong>décalage</strong> en pixels et sur les deux dimensions de la position de l'étiquette par rapport à l'élément.</td></tr><tr><td align="center">9</td><td><strong>Cadre</strong><br>Cochez la case pour ajouter un cadre au texte des étiquettes. <br>Sélectionnez la couleur de fond et du contour du cadre.</td></tr><tr><td align="center">10</td><td><strong>Rotation</strong><br>Si vous cochez l'option <strong>Rotation par attribut</strong>, sélectionnez l'attribut numérique dont les valeurs seront utilisés comme angle de rotation et la direction de la rotation. Seulement les éléments de type ligne disposent de cette option.<br>Si vous cochez <strong>Suivre la rotation de la carte</strong>, les étiquettes suivront la rotation de la carte.</td></tr><tr><td align="center">11</td><td><p><strong>Taille proportionnelle</strong></p><p>Par défaut, le texte de l'étiquette s'affiche à la taille de police spécifiée, peu importe le niveau de zoom. <br>Cochez cette option afin que la taille du texte de l’étiquette soit ajustée proportionnellement au niveau de zoom de la carte. <br>Glissez le point dans la barre pour sélectionner le niveau de zoom de référence auquel le texte s'affiche à la taille de police spécifiée. <br>Lorsque le niveau de zoom de la carte change, la taille du texte est modifiée en conséquence.</p></td></tr><tr><td align="center">12</td><td>Cliquez sur la <strong>langue</strong> de votre choix pour inscrire le contenu de l'étiquette dans la langue sélectionnée.</td></tr></tbody></table>

## Contenu de l'étiquette

L’étiquetage se fait en définissant un texte qui constitue le contenu de l’étiquette. Celui-ci peut s’étendre sur plusieurs lignes et contenir à la fois :

* du texte statique (inchangé),
* des fonctions dynamiques (variables), remplacées automatiquement par leur valeur lors de l’affichage.

Les **fonctions** disponibles sont :&#x20;

<table data-header-hidden><thead><tr><th width="255"></th><th></th></tr></thead><tbody><tr><td>ev(<em>attrib</em>)<br><em>attrib</em> : le nom d’un attribut</td><td><p>Cette fonction est remplacée par la valeur de l'attribut correspondant. <br><strong>Exemple</strong><br><code>ev(id)</code> </p><p>L'étiquette affiche la valeur de l’attribut <em>id</em> de l'entité.</p></td></tr><tr><td>ev(<em>attrib, useValueDomain</em>)<br><em>attrib</em> : le nom d’un attribut<br><em>useValueDomain</em> : le domaine de valeurs de l'attribut </td><td><p>Cette fonction est remplacée par l’étiquette du <a href="../../../integrer-les-donnees-sources-de-donnees/gerer-les-sources-de-donnees/afficher-et-editer-les-informations-de-la-source-de-donnees/attributs#domaine-de-valeurs">domaine de valeurs</a> pour la valeur de l'attribut <em>attrib</em>, pour l'entité pointée, lorsque la valeur <em>true</em> est indiquée pour <em>useValueDomain.</em> <br><strong>Exemple</strong><br><code>ev(categorie, true)</code><br>Remplacée par l'étiquette du <a href="../../../integrer-les-donnees-sources-de-donnees/gerer-les-sources-de-donnees/afficher-et-editer-les-informations-de-la-source-de-donnees/attributs#domaine-de-valeurs">domaine de valeurs</a> pour la valeur de l’attribut <em>categorie</em> de l’entité.</p><p><br>Si la valeur <em>false</em> est indiquée pour <em>useValueDomain</em>, la fonction est remplacée par la valeur de l’attribut <em>attrib</em> pour l'entité pointée. </p><p><strong>Exemple</strong><br><code>ev(categorie, false)</code> ou <code>ev(categorie)</code><br>Remplacée par la valeur de l’attribut <em>categorie</em> de l’entité.</p></td></tr><tr><td>ifNull(<em>attrib</em>, <em>value</em>)<br><em>attrib</em> : le nom de l’attribut à tester <br><em>value</em> : la valeur à afficher si attrib est nulle</td><td><p>Cette fonction est remplacée par la valeur <em>value</em> seulement si la valeur de l’attribut <em>attrib</em> est nulle. <br>Si la valeur de l’attribut est non nulle, rien n’est affiché.<br><strong>Exemple</strong></p><p><code>ifNull(temp, N/A)</code></p><p>Létiquette affiche N/A si la valeur de l’attribut <em>temp</em> est nulle.</p><p><strong>Exemple</strong></p><p><code>ifNull(attrib_a, attrib_b)</code></p><p>L'étiquette affiche la valeur de l’attribut <em>attrib_b</em> si la valeur de <em>attrib_a</em> est nulle.</p></td></tr><tr><td>ifNotNull(<em>attrib</em>, <em>value</em>)<br><em>attrib</em> : le nom de l’attribut à tester <br><em>value</em> : la valeur à afficher si attrib est non nulle</td><td><p>Cette fonction est remplacée par la valeur <em>value</em> seulement si la valeur de l’attribut <em>attrib</em> est non nulle.<br>Si la valeur de l’attribut est nulle, rien n’est affiché.<br><strong>Exemple</strong></p><p><code>ifNotNull(land_value, $)</code></p><p>Affiche $ seulement si la valeur de <em>land_value</em> est non nulle.</p></td></tr></tbody></table>

Les attributs utilisables s’affichent dans la section **Attributs**.

**Pour configurer le contenu de l'étiquette** :&#x20;

1. Saisissez le texte statique souhaité.
2. Pour ajouter du contenu dynamique, placez le curseur à l’endroit voulu dans la zone de texte.
3. Cliquez sur la fonction désirée. Elle s’insère automatiquement dans le texte, et un menu s’ouvre pour vous permettre de choisir l’attribut à utiliser.
4. Sélectionnez l’attribut et, si nécessaire, spécifiez une valeur.
5. Cliquez sur ![](https://1484831130-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrPLLbWoaAYyK9HykpM0p%2Fuploads%2Fkpr7NNixlkRVWC0veevr%2Fstudio-ok.png?alt=media\&token=07e54c32-f987-4fc1-9aff-fab58ec47141) pour enregistrer le contenu de l’étiquette.
