Important

Translation is a community effort you can join. This page is currently translated at 58.62%.

22.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 addLegend 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. 22.26) :

../../../../_images/legend_properties.png

Fig. 22.26 Panneau Propriétés d’une légende

22.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. 22.27) :

../../../../_images/legend_mainproperties.png

Fig. 22.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 checkbox 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é.

22.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. 22.28) :

../../../../_images/legend_items.png

Fig. 22.28 Propriétés des Éléments de la légende

  • La légende sera automatiquement mise à jour si checkbox 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 arrowUp et arrowDown ou avec la fonctionnalité “glisser-déposer”. L’ordre ne peut pas être changé pour les légendes WMS graphiques.

    • Utilisez le bouton addGroup pour ajouter un groupe dans la légende.

    • Utilisez le bouton symbologyAdd pour ajouter des couches et symbologyRemove pour supprimer des groupes, des couches ou des symboles.

    • Le bouton symbologyEdit 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 expression 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 sum ajoute le nombre d’entités pour chaque classe d’une couche vecteur.

    • Le bouton expressionFilter 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.

  • With the checkbox Only show items inside linked maps, only the legend items visible in the linked map will be listed in the legend. If you have more than one map you can click on and select other maps from your layout. This tool remains available when checkbox Auto-update is active.

  • 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 checkbox Ne montrer que les entités à l’intérieur de l’entité de l’atlas.

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

expression 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 :

  1. Sélectionnez la couche parmi les éléments de la légende

  2. Cliquez sur le bouton expression qui ouvre la fenêtre du Constructeur de chaîne d’expression

  3. 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 )
          )
    
  4. 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 checkbox Auto update disabled.

Double-clicking on an item or pressing symbologyEdit 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 expression 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.

22.2.5.3. Fonts and text formatting

The Fonts and text formatting group of the legend Item Properties panel provides the following functionalities:

../../../../_images/legend_fonts.png

Fig. 22.29 Propriétés des polices de la légende

  • You can change the font of the legend title, group, subgroup and item (feature) in the legend item using the font selector widget, providing all the capabilities of text formatting (font spacing control, mixed HTML formatting, coloring, blending, background, text buffer, shadow, …)

  • 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).

22.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 selectNumber. 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 checkbox Égaliser la largeur des colonnes permet d’ajuster la taille des colonnes de la légende.

  • L’option checkbox 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. 22.30 Paramètres de Colonnes de la légende

22.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.

  • checkbox 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. 22.31 Paramètres pour les Symboles dans la légende

22.2.5.6. WMS LegendGraphic

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

../../../../_images/legend_wms.png

Fig. 22.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.

22.2.5.7. Spacing

../../../../_images/legend_spacing.png

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.