Outdated version of the documentation. Find the latest one here.

` `

L’élément Table Attributaire

It is possible to add parts of a vector attribute table to the Print Composer canvas: Click the openTable Add attribute table icon, click and drag with the left mouse button on the Print Composer canvas to place and size the item. You can better position and customize its appearance in the Item Properties panel.

The Item properties panel of an attribute table provides the following functionalities (see figure_composer_table):

../../../../_images/attribute_properties.png

Attribute table Item Properties Panel

Propriétés principales

The Main properties dialog of the attribute table provides the following functionalities (see figure_composer_table_ppt):

../../../../_images/attribute_mainproperties.png

Attribute table Main properties Dialog

  • For Source you can normally select only Layer features.
  • With Layer you can choose from the vector layers loaded in the project.
  • In case you activated the checkboxGenerate an atlas option in the Atlas generation panel, there are two additional Source possible:
    • Current atlas feature (see figure_composer_table_atlas): you won’t see any option to choose the layer, and the table item will only show a row with the attributes from the current feature of the atlas coverage layer.
    • and Relation children (see figure_composer_table_relation): an option with the relation names will show up. This feature can only be used if you have defined a relation using your atlas coverage layer as parent, and the table will show the children rows of the atlas coverage layer’s current feature (for further information about the atlas generation, see Générer un Atlas).
  • The button [Refresh table data] can be used to refresh the table when the actual contents of the table has changed.
../../../../_images/attribute_mainatlas.png

Attribute table Main properties for ‘Current atlas feature’

../../../../_images/attribute_mainrelation.png

Attribute table Main properties for ‘Relation children’

  • The button [Attributes...] starts the Select attributes menu, see figure_composer_table_select, that can be used to change the visible contents of the table. After making changes use the [OK] button to apply changes to the table. The upper part of the window shows the list of the attributes to display and the lower part helps to set the way the data is sorted.

    ../../../../_images/attribute_select.png

    Attribute table Select attributes Dialog

    Dans la section Colonnes, vous pouvez :

    • Remove an attribute, just select an attribute row by clicking anywhere in the row and press the minus button to remove the selected attribute.
    • Add a new attribute use the plus button. At the end a new empty row appears and you can select empty cell of the column Attribute. You can select a field attribute from the list or you can select to build a new attribute using a regular expression (expression button). Of course you can modify every already existing attribute by means of a regular expression.
    • Use the up and down arrows to change the order of the attributes in the table.
    • Select a cell in the Headings column and, to change the heading, just type in a new name.
    • set a precise Alignment (mixing vertical and horizontal alignment options) for each column.
    • Select a cell in the Width column and change it from Automatic to a width in mm, just type a number. When you want to change it back to Automatic, use the cross.
    • The [Reset] button can always be used to restore it to the original attribute settings.

    Dans la section Trier, vous pouvez :

    • Add an attribute to sort the table with. Select an attribute and set the sorting order to ‘Ascending’ or ‘Descending’ and press the plus button. A new line is added to the sort order list.
    • select a row in the list and use the up and down button to change the sort priority on attribute level. Selecting a cell in the Sort Order column helps you change the sorting order of the attribute field.
    • use the minus button to remove an attribute from the sort order list.

Filtrage des entités

The Feature filtering dialog of the attribute table provides the following functionalities (see figure_composer_table_filter):

../../../../_images/attribute_filter.png

Attribute table Feature filtering Dialog

Vous pouvez :

  • Définir un nombre de Lignes maximales à afficher.

  • Activer checkbox Supprimer les lignes en double de la table pour ne montrer que les enregistrements uniques.

  • Activate checkbox Show only visible features within a map and select the corresponding Composer map to display the attributes of features only visible on selected map.

  • Activate checkbox Show only features intersecting Atlas feature is only available when checkbox Generate an atlas is activated. When activated it will show a table with only the features which intersect the current atlas feature.

  • Activer checkbox Filtrer avec et fournir un filtre en tapant dans la ligne d’entrée ou insérer une expression régulière en utilisant le bouton d’expression expression. Voici quelques exemples de déclarations de filtrage que vous pouvez utiliser lorsque vous avez chargé la couche des aéroports à partir du jeu de données exemples :

    • ELEV > 500
    • NAME = 'ANIAK'
    • NAME NOT LIKE 'AN%'
    • regexp_match( attribute( $currentfeature, 'USE' )  , '[i]')

    La dernière expression régulière inclura seulement les aéroports qui ont une lettre ‘i’ dans le champ d’attribut ‘USE’.

Apparence

The Appearance dialog of the attribute table provides the following functionalities (see figure_composer_table_appearance):

../../../../_images/attribute_appearance.png

Attribute table appearance Dialog

  • Cocher checkbox Afficher des lignes vides remplira la table attributaire avec des cellules vides; cette option peut aussi être utilisée pour proposer des cellules vides supplémentaires lorsque vous avez un résultat à montrer !

  • Avec les Marges de cellule, vous pouvez définir les marges autour du texte dans chaque cellule de la table.

  • Avec Afficher l’en-tête, vous pouvez sélectionner à partir d’une liste une des options par défaut ‘Sur le premier cadre’, ‘Sur tous les cadres’, ou ‘Pas d’en-tête’.

  • L’option Tables vides contrôle ce qui sera affiché lorsque la sélection des résultats est vide.

    • N’afficher que les en-têtes affichera seulement l’en-tête, excepté si vous avez choisi ‘Pas d’en-tête’ pour Afficher l’en-tête.

    • Masquer la table entière affichera seulement le fond de la table. Vous pouvez activer checkbox Ne pas afficher le fond si le cadre est vide dans Cadres pour cacher complètement la table.

    • Afficher le message défini affichera l’en-tête et ajoutera une cellule couvrant toutes les colonnes et affichera un message comme ‘Pas de résultat’ qui peut être proposé dans l’option Message à afficher

  • L’option Message à afficher est seulement activée lorsque vous avez sélectionné Afficher le message défini pour Table vide. Le message proposé sera affiché dans la table sur la première ligne, lorsque le résultat est une table vide.

  • With Background color you can set the background color of the table. The Advanced customization option helps you define different background colors for each cell (see figure_composer_table_background)
../../../../_images/attribute_background.png

Attribute table Advanced Background Dialog

  • Avec l’option Activer le retour à la ligne après , vous pouvez indiquer un caractère qui servira de retour à la ligne pour le contenu de chaque cellule.

  • With Oversized text you define the behaviour when the width set for a column is smaller than its content’s length. It can be Wrap text or Truncate text.

Afficher les bordures

The Show grid dialog of the attribute table provides the following functionalities (see figure_composer_table_grid):

../../../../_images/attribute_grid.png

Attribute table Show grid Dialog

  • Activate checkbox Show grid when you want to display the grid, the outlines of the table cells.
  • Avec Épaisseur du trait vous pouvez définir l’épaisseur des lignes utilisées pour les bordures.

  • The Color of the grid can be set using the color selection dialog.

Styles de polices et textes

The Fonts and text styling dialog of the attribute table provides the following functionalities (see figure_composer_table_fonts):

../../../../_images/attribute_fonts.png

Attribute table Fonts and text styling Dialog

  • You can define Font and Color for Table heading and Table contents.
  • For Table heading you can additionally set the Alignment to Follow column alignment or override this setting by choosing Left, Center or Right. The column alignment is set using the Select Attributes dialog (see Figure_composer_table_select ).

Cadres

The Frames dialog of the attribute table provides the following functionalities (see figure_composer_table_frames):

../../../../_images/attribute_frame.png

Attribute table Frames Dialog

  • Avec le Mode de redimensionnement vous pouvez sélectionner la façon de rendre le contenu de la table attributaire :

    • Use existing frames displays the result in the first frame and added frames only.
    • Extend to next page will create as many frames (and corresponding pages) as necessary to display the full selection of attribute table. Each frame can be moved around on the layout. If you resize a frame, the resulting table will be divided up between the other frames. The last frame will be trimmed to fit the table.
    • Repeat until finished will also create as many frames as the Extend to next page option, except all frames will have the same size.
  • Use the [Add Frame] button to add another frame with the same size as selected frame. The result of the table that will not fit in the first frame will continue in the next frame when you use the Resize mode Use existing frames.
  • Activate checkbox Don’t export page if frame is empty prevents the page to be exported when the table frame has no contents. This means all other composer items, maps, scalebars, legends etc. will not be visible in the result.
  • Activer checkbox Ne pas afficher le fond si le cadre est vide empêche le fond d’être affiché lorsque le cadre de la table n’a pas de contenu.