21.2.5. Légende

Un objet de type Légende correspond à un cadre ou une table où est expliquée la signification des symboles utilisés sur la carte. Une légende est donc liée à un objet carte. Vous pouvez ajouter une légende avec l’outil Ajouter une légende en suivant les instructions de création d’objets que vous pourrez ensuite manipuler comme expliqué dans Interaction avec les objets de la mise en page.

Par défaut, la légende affiche toutes les couches disponibles et peut être affinée via le panneau des Propriétés de l’objet. En plus des propriétés communes, cet objet propose les fonctionnalités suivantes (voir Fig. 21.26) :

../../../../_images/legend_properties.png — Fig. 21.26 Panneau Propriétés d’une légende

21.2.5.1. Propriétés principales 

La zone Propriétés principales du panneau Propriétés de l’objet de la légende propose les fonctionnalités suivantes (voir Fig. 21.27) :

../../../../_images/legend_mainproperties.png — Fig. 21.27 Propriétés principales d’une légende

Dans les Propriétés Principales vous pouvez :

Changer le Titre de la légende. Il peut être dynamique en utilisant une valeur définie par les données , ce qui est utile lorsque vous générez un atlas.
Choisissez à quelle Carte la légende se réfère. Par défaut, il s’agit de la carte sur laquelle la légende est ajoutée. S’il n’y en a pas, il s’agit de la carte de référence.

Note

Variables de l’élément cartographique lié (@map_id, @map_scale, @map_extent…) sont également accessibles à partir des propriétés de la légende définies par les données.
Précisez le caractère de retour à ligne : chaque fois que ce caractère est rencontré, il est remplacé par un saut de ligne ;
Définissez la position des symboles et du texte dans la légende avec une Disposition qui peut être Symboles à gauche ou Symboles à droite. La valeur par défaut dépend de la langue de l’interface (lecture de gauche à droite ou pas).
L’option Ajuster au contenu contrôle si la légende doit être redimensionnée automatiquement pour coller au contenu ou pas. Si elle est décochée, la légende ne sera pas redimensionnée et gardera la taille définie par l’utilisateur. Le contenu qui dépasse sera coupé.

21.2.5.2. Éléments de la légende 

La zone Éléments de la légende du panneau Propriétés de l’objet de la légende propose les fonctionnalités suivantes (voir Fig. 21.28) :

../../../../_images/legend_items.png — Fig. 21.28 Propriétés des Éléments de la légende

La légende sera automatiquement mise à jour si Mise à jour auto est cochée. Lorsque Mise à jour auto n’est pas cochée, cela vous donnera plus de contrôle sur les éléments de la légende. Tous les boutons situés sous la liste des éléments de la légende seront activés.
The legend items window lists all legend items and allows you to change item order, group layers, remove and restore items in the list, edit layer names and symbology and add a filter.
- L’ordre des éléments peut être changé en utilisant les boutons et ou avec la fonctionnalité “glisser-déposer”. L’ordre ne peut pas être changé pour les légendes WMS graphiques.
- Utilisez le bouton pour ajouter un groupe dans la légende.
- Utilisez le bouton pour ajouter des couches et pour supprimer des groupes, des couches ou des symboles.
- Le bouton est utilisé pour modifier le nom de la couche ou du groupe. Vous devez d’abord sélectionner l’élément de la légende. Double-cliquer sur un élément ouvre une fenêtre d’édition pour le renommer.
- Le bouton utilise les expressions pour personnaliser chaque étiquette de symbole dans la couche sélectionnée (voir Étiquettes de légende définies par des valeurs)
- Le bouton ajoute le nombre d’entités pour chaque classe d’une couche vecteur.
- Le bouton ^{Filtrer la légende avec une expression} permet de filtrer quels éléments d’une couche seront affichés, c’est-à-dire, lorsque vous utilisez une couche qui est subdivisée en plusieurs éléments de légende (par ex. via un rendu catégorisé ou basé sur des règles), vous pouvez définir une expression booléenne pour supprimer de la légende les éléments dont les entités ne satisfont pas la condition. Notez que les entités sont tout de même conservées et affichées sur l’objet carte de la mise en page.
Le comportement par défaut est de reproduire l’arborescence du panneau Couches, affichant les mêmes groupes, couches, classes de symboles. Un clic-droit sur n’importe lequel de ces éléments permet de masquer le nom de la couche ou de le transformer en groupe ou sous-groupe. Si vous avez fait des modifications à une couche, vous pouvez les annuler en cliquant sur Réinitialiser les paramètres par défaut depuis le menu contextuel de l’entrée de légende.

Après avoir changé la symbologie dans la fenêtre principale QGIS, vous pouvez cliquer sur Tout mettre à jour pour appliquer les changements sur les éléments de la légende.
Avec l’option Ne montrer que les entités à l’intérieur de la carte liée, seuls les éléments de légende correspondant à des objets visibles sur la carte associée seront listés. Cet outil reste disponible lorsque la Mise à jour auto est activée.
Lorsqu’un atlas est généré avec des entités polygones, vous pouvez supprimer les éléments de légende qui sont extérieurs à l’entité de l’atlas en cours. Pour se faire, cochez l’option Ne montrer que les entités à l’intérieur de l’entité de l’atlas.

Étiquettes de légende définies par des valeurs 

vous permet d’ajouter une expression pour chaque étiquette de symbole d’une couche. De nouvelles variables (@symbol_label, @symbol_id et @symbol_count) vous permettent d’interagir avec les entrées de légende.

Par exemple pour une couche regions catégorisée selon le champ type, il est possible d’afficher dans l’étiquette de chaque classe, le nombre d’entités et la surface totale concernée, du genre Arrondissement (3) - 850ha :

Sélectionnez la couche parmi les éléments de la légende
Cliquez sur le bouton qui ouvre la fenêtre du Constructeur de chaîne d’expression
Entrez l’expression ci-après (on suppose que les étiquettes de symbole n’ont pas été modifiées dans l’interface de légende, et sont donc identiques à celles générées par la classification)
```
format( '%1 (%2) - %3ha',
        @symbol_label,
        @symbol_count,
        round( aggregate(@layer, 'sum', $area, filter:= "type"=@symbol_label)/10000 )
      )
```
Cliquez sur OK

Customizing legend items 

../../../../_images/legend_item_properties.png

Legend items can also be customized individually in the Legend Items Properties. But these customization can only be done with Auto update disabled.

Double-clicking on an item or pressing ^{Edit selected item properties} allows for futher customization.

Étiquette

For all item types it allows to modify the label text by typing in or by inserting expressions using the Insert or Edit an Expression. Expressions can also be added directly anywhere in the item’s label by using the [% expression %] notation.

Columns

The Legend Item Property also allows you to control the column splitting behaviour by forcing the column split to occur after a specific item or all symbols of a layer. Automatic splitting of a layer and its child can also be allowed or blocked on a layer-basis in this widget.

Patch

For items with a symbol, the Legend Item Property allows you to specify the maximum height and width that a symbol can occupy.

For vector symbols, you can specify a custom shape for the symbol. The shapes are usually defined by an expression to represent the geometry in a simple plane, but those symbols can also be saved in the style manager and imported later. The default symbol for each geometry type can also be controlled via the style manager.

Custom Symbol

A custom symbol can also be specified for vector symbols. This can be useful to tweak the render of a specific symbol, to enhance it in the legend or have a symbol independent from its true symbol preview. This custom symbol will override the legend symbol, but will take into account the symbol Patch specified.

21.2.5.3. Polices 

Les paramètres de Polices dans le panneau Propriétés de l’objet de la légende fournissent les fonctionnalités suivantes :

../../../../_images/legend_fonts.png — Fig. 21.29 Propriétés des polices de la légende

Vous pouvez changer la police du titre de la légende, des groupes, des sous-groupes et des éléments (de couche) dans la légende en utilisant l’outil de sélection de police.
Pour chacun de ces niveaux, vous pouvez définir un Alignement : Gauche (par défaut pour les langues qui se lisent de gauche à droite), Centré ou Droite (par défaut pour les langues de droite à gauche).
Vous pouvez choisir une Couleur pour les étiquettes avec l’outil de sélection de la couleur La couleur sélectionnée sera appliquée à tous les éléments de police dans la légende.

21.2.5.4. Colonnes 

Dans les paramètres de Colonnes dans le panneau Propriétés de l’objet de la légende, les éléments de légende peuvent être organisés sur plusieurs colonnes :

Configurez le nombre de colonnes dans le champ Nombre . Cette valeur peut être dynamique par exemple selon les entités de l’atlas, le contenu de la légende, la taille du cadre…
La case Égaliser la largeur des colonnes permet d’ajuster la taille des colonnes de la légende.
L’option Séparer les couches permet de présenter sur plusieurs colonnes les éléments de légende d’une couche ayant un style catégorisé ou gradué.

../../../../_images/legend_columns.png — Fig. 21.30 Paramètres de Colonnes de la légende

21.2.5.5. Symboles 

Les paramètres de Symboles dans le panneau Propriétés de l’objet de la légende permettent de configurer la taille des symboles affichés à côté des étiquettes de légende. Vous pouvez :

définir la Largeur des symboles et la Hauteur des symboles
Set the markers” Min symbol size and Max symbol size: 0.00mm means there is no value set.
Dessiner le trait pour les symboles raster : ajoute un contour aux symboles représentant la couleur de la bande raster. Vous pouvez paramétrer à la fois la Couleur du trait et l”Épaisseur.

../../../../_images/legend_symbol.png — Fig. 21.31 Paramètres pour les Symboles dans la légende

21.2.5.6. WMS LegendGraphic 

The WMS LegendGraphic section of the legend Item Properties panel provide the following functionalities (see Fig. 21.32):

../../../../_images/legend_wms.png — Fig. 21.32 WMS LegendGraphic

Lorsque vous avez ajouté une couche WMS et que vous insérez un élément de légende, une requête sera envoyée au serveur WMS pour fournir une légende WMS. Cette légende sera uniquement affichée si le serveur WMS fournit la capacité GetLegendGraphic. Le contenu de la légende WMS sera fourni comme une image raster.

La Légende WMS est utilisée pour ajuster la Largeur de la légende et la Hauteur de la légende pour la légende WMS des images raster.

21.2.5.7. Spacing 

The Spacing section allows you to customize the spacing within the legend. Spacing can greatly help denote the groupement of items in the legend and their relation.

Spacing around and before title, groups, subgroups, symbols, labels, boxes, columns and lines can be customized through this dialog.