Parâmetros de bloco de texto para dashboards do LookML

Nesta página, mostramos como adicionar e personalizar um elemento de dashboard do LookML de type: text com parâmetros do dashboard do LookML em um arquivo dashboard.lkml.

Para informações sobre como adicionar texto a um painel usando a interface do Looker, consulte a página de documentação Criar painéis definidos pelo usuário.

Exemplo de uso

## BASIC PARAMETERS
name: element_name
type: text
height: N
width: N
top: N
left: N
row: N
col: N

## TEXT PARAMETERS
title_text: title text
subtitle_text: subtitle text
body_text: body text

Definições de parâmetro

Nome do parâmetro	Descrição
Parâmetros básicos
name (para elementos)	Cria um elemento.
type (para elementos)	Determina o tipo de visualização a ser usado no elemento.
height (para elementos)	Define a altura de um elemento em unidades de tile_size para dashboards layout: tile e layout: static.
width (para elementos)	Define a largura de um elemento em unidades de tile_size para dashboards layout: tile e layout: static.
top	Define a posição de cima para baixo de um elemento em unidades de tile_size para dashboards layout: static.
left	Define a posição da esquerda para a direita de um elemento em unidades de tile_size para dashboards layout: static.
row	Define a posição de cima para baixo de um elemento em unidades de linhas para dashboards layout: newspaper.
col	Define a posição da esquerda para a direita de um elemento em unidades de colunas para dashboards layout: newspaper.
Parâmetros de texto
title_text	Especifica um título para um elemento de dashboard de type: text
subtitle_text	Especifica um subtítulo para um elemento de dashboard de type: text.
body_text	Especifica o texto do corpo para um elemento de dashboard de type: text.

Parâmetros básicos

Ao definir um elemento de painel do LookML de type: text, especifique valores para pelo menos os parâmetros name e type.

name

Esta seção se refere ao parâmetro name, que faz parte de um elemento do painel.

name também pode ser usado como parte de um filtro do painel, descrito na página de documentação Parâmetros do painel.

Cada declaração name cria um novo elemento de painel e atribui um nome a ele. Os nomes dos elementos precisam ser exclusivos. Às vezes, os nomes são referenciados no parâmetro elements quando você usa painéis layout: grid.

- name: orders_by_date

type

Esta seção se refere ao parâmetro type, que faz parte de um elemento do painel.

type também pode ser usado como parte de um filtro do painel, descrito na página de documentação Parâmetros do painel.

type também pode ser usado como parte de uma junção, conforme descrito na página de documentação do parâmetro type (para junções).

type também pode ser usado como parte de uma dimensão, conforme descrito na página de documentação Tipos de dimensões, filtros e parâmetros.

type também pode ser usado como parte de uma métrica, conforme descrito na página de documentação Tipos de métricas.

O parâmetro type determina o tipo de visualização a ser usado no elemento.

- name: element_name
  type: text | looker_grid | table | single_value | looker_single_record |
        looker_column | looker_bar | looker_scatter | looker_line | looker_area |
        looker_pie | looker_donut_multiples | looker_funnel | looker_timeline |
        looker_map | looker_google_map | looker_geo_coordinates | looker_geo_choropleth | looker_waterfall | looker_wordcloud | looker_boxplot

Consulte a página de documentação type (para dashboards do LookML) para uma visão geral dos diferentes tipos de elementos de dashboard do LookML.

height

Esta seção se refere ao parâmetro height, que faz parte de um elemento do painel.

height também pode ser usado como parte de uma linha do painel, conforme descrito na página de documentação Parâmetros do painel.

Para painéis com layouts tile ou static

O parâmetro height define a altura de um elemento, em unidades de tile_size (definido em pixels), para painéis layout: tile e layout: static.

Por exemplo, o código a seguir especifica tile_size: 100 e height: 4, fazendo com que o elemento orders_by_date tenha 400 pixels de altura.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    height: 4
    ...

Para painéis com layout newspaper

O parâmetro height define a altura de um elemento, em unidades de linha, para dashboards layout: newspaper.

Um dashboard com layout de jornal tem uma altura padrão de seis linhas ou cerca de 300 pixels. A altura mínima é de uma linha para painéis com um parâmetro preferred viewer definido como dashboards-next. A altura mínima é de duas linhas para painéis com um parâmetro preferred viewer definido como dashboards.

Por exemplo, o código a seguir define um elemento com 12 linhas de altura, ou seja, o dobro da altura de outros elementos definidos como padrão:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    height: 12
    ...

width

Esta seção se refere ao parâmetro width, que faz parte de um elemento do painel.

width também pode ser usado como parte de um painel, conforme descrito na página de documentação Parâmetros do painel.

O parâmetro width define a largura de um elemento, em unidades de tile_size, para painéis layout: tile e layout: static.

Por exemplo, o código a seguir especifica tile_size: 100 e width: 4, fazendo com que o elemento orders_by_date tenha 400 pixels de largura.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    width: 4
    ...

O parâmetro width define a largura de um elemento, em unidades de colunas, para painéis layout: newspaper.

Um painel com layout de jornal tem uma largura padrão de 24 colunas.

Por exemplo, o código a seguir define o elemento como metade da largura do painel:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    width: 12
    ...

top

O parâmetro top define a posição de cima para baixo de um elemento, em unidades de tile_size, para painéis layout: static.

Por exemplo, o código a seguir especifica tile_size: 100 e top: 4, posicionando a borda superior do elemento orders_by_date a 400 pixels da parte de cima do painel.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    top: 4
    ...

left

O parâmetro left define a posição da esquerda para a direita de um elemento, em unidades de tile_size, para painéis layout: static.

Por exemplo, o código a seguir especifica tile_size: 100 e left: 4, posicionando a borda esquerda do elemento orders_by_date a 400 pixels do lado esquerdo do painel.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    left: 4
    ...

row

Para painéis layout: newspaper, o parâmetro row define a linha em que a borda superior de um elemento é colocada.

Um painel começa com a linha 0 na parte superior. Um dashboard com layout de jornal tem uma altura padrão de seis linhas. Isso significa que os elementos na parte superior de um dashboard (row: 0) ocupam as linhas de 0 a 5.

Cada linha tem 50 pixels de altura, o que significa que a altura padrão do elemento de seis linhas é de 300 pixels.

Por exemplo, o código a seguir define um elemento para ser colocado na segunda linha de elementos no painel, supondo que os elementos estejam definidos na altura padrão:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    row: 6
    ...

col

Para dashboards layout: newspaper, o parâmetro col define a coluna em que a borda esquerda do elemento é colocada.

Os painéis são divididos em 24 colunas. Um painel começa com a coluna 0 à esquerda. Um painel com layout de jornal tem uma largura de elemento padrão de oito colunas. Isso significa que os elementos à esquerda de um painel (col: 0) ocupam as colunas de 0 a 7 por padrão.

Por exemplo, o código a seguir define um elemento para ser definido na terceira coluna de elementos no painel:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    col: 16
    ...

Parâmetros de texto

A LookML do painel gerada com blocos de texto criados com a opção Texto na interface do Looker não usa os parâmetros title_text ou subtitle_text.

Os parâmetros descritos nesta seção podem ser usados para adicionar conteúdo a um elemento de painel do LookML de type: text.

title_text

O parâmetro title_text especifica o texto que vai aparecer em um elemento type: text no maior tamanho de fonte disponível. Ele aparece na parte de cima do bloco.

title_text: title text

subtitle_text

O parâmetro subtitle_text especifica o texto que vai aparecer em um elemento type: text no tamanho de fonte médio disponível. Se title_text estiver presente, o subtitle_text vai aparecer abaixo dele.

subtitle_text: subtitle text

body_text

O parâmetro body_text especifica o texto que vai aparecer em um elemento type: text no menor tamanho de fonte disponível. Esse parâmetro é mostrado por último no bloco de texto. A página de documentação Como usar o Markdown em blocos do Markdown oferece uma visão geral do Markdown que você pode usar para formatar texto ou adicionar links e imagens a um bloco de texto.

body_text: body text