17.2.4. A rotulagem de item

o item: guilabel: Label ‘é uma ferramenta que ajuda a decorar seu mapa com textos que ajudam a entendê-lo; pode ser o título, autor, fontes de dados ou qualquer outra informação…Você pode adicionar um rótulo com o | label | : guilabel: `Adicionar etiqueta ferramenta a seguir: ref:` itens instruções de criação <create_layout_item>`e manipule-a da mesma maneira como exposto em: ref:` interact_layout_item

Por padrão, o item da etiqueta fornece um texto padrão que você pode personalizar usando o seu painel: guilabel: Propriedades do item. Além de: ref: items common properties<item_common_properties>, esse recurso tem as seguintes funcionalidades (consulte figure_layout_label):

../../../../_images/label_mainproperties.png

Fig. 17.23 Painel de propriedades do item de etiqueta

17.2.4.1. Propriedades principais

O grupo: guilabel: Propriedades principais é o local para fornecer o texto (ele pode estar em HTML) ou a expressão para criar o rótulo. As expressões precisam estar entre `` [% `` e ``%] `` para serem interpretadas como tal.

  • As etiquetas podem ser interpretados como código HTML: check | caixa de seleção | : guilabel: Renderizar como HTML. Agora você pode inserir um URL, uma imagem clicável vinculada a uma página da Web ou algo mais complexo.

  • Você também pode usar: ref: expression<expression_builder>: clique em: guilabel: Inserir uma expressão`, escreva sua fórmula como de costume e quando a caixa de diálogo é aplicada, o QGIS adiciona automaticamente os caracteres ao redor.

Nota

Clicar no botão: guilabel: Inserir uma expressão quando nenhuma seleção for feita na caixa de texto anexará a nova expressão ao texto existente. Se você deseja atualizar um texto existente, é necessário selecioná-lo com antecedência.

Você pode combinar renderização e expressões HTML, levando a, por exemplo um texto como:

[% '<b>Check out the new logo for ' || '<a href="https://www.qgis.org" title="Nice logo" target="_blank">QGIS ' ||@qgis_short_version || '</a>' || ' : <img src="https://qgis.org/en/_downloads/qgis-icon128.png" alt="QGIS icon"/>' %]

que renderizará: ** Confira o novo logotipo para ** QGIS 3.0 <https://www.qgis.org> _ **: ** | logo |

17.2.4.2. Aparência

  • Define Font by clicking on the Font… button or a Font color by pushing the color widget.

  • You can specify different horizontal and vertical margins in mm. This is the margin from the edge of the layout item. The label can be positioned outside the bounds of the label e.g. to align label items with other items. In this case you have to use negative values for the margin.

  • Using the text alignment is another way to position your label. It can be:

    • Left, Center, Right or Justify for Horizontal alignment

    • and Top, Middle, Bottom for Vertical alignment.

17.2.4.3. Explorando expressões em um item de etiqueta

Below some examples of expressions you can use to populate the label item with interesting information - remember that the code, or at least the calculated part, should be surrounded by [% and %] in the Main properties frame:

  • Display a title with the current atlas feature value in “field1”:

    'This is the map for ' || "field1"
    

    or, written in the Main properties section:

    This is the map for [% "field1" %]
    
  • Adicione uma paginação para recursos de atlas processados (por exemplo, `` Página 1/10 ‘’)

    concat( 'Page ', @atlas_featurenumber, '/', @atlas_totalfeatures )
    
  • Return the lower X coordinate of the Map 1 item’s extent:

    x_min( map_get( item_variables( 'Map 1' ), 'map_extent' ) )
    
  • Retrieve the name of the layers in the current layout Map 1 item, and formats in one name by line:

    array_to_string(
     array_foreach(
      map_get( item_variables( 'Map 1' ), 'map_layers' ), -- retrieve the layers list
      layer_property( @element, 'name' ) -- retrieve each layer name
     ),
     '\n' -- converts the list to string separated by breaklines
    )