Esta página demonstra como adicionar e personalizar um elemento do painel LookML de type: text com parâmetros do painel LookML em um arquivo dashboard.lkml.
Para informações sobre como adicionar blocos de texto a um painel pela IU do Looker, consulte a página de documentação Como 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 painéis layout: tile e layout: static. |
|
width (para elementos) |
Define a largura de um elemento em unidades de tile_size para painéis layout: tile e layout: static. |
|
top |
Define a posição de cima para baixo de um elemento em unidades de tile_size para painéis do layout: static. |
|
left |
Define a posição da esquerda para a direita de um elemento em unidades de tile_size para painéis do layout: static. |
|
row |
Define a posição de cima para baixo de um elemento em unidades de linhas para painéis layout: newspaper. |
|
col |
Define a posição da esquerda para a direita de um elemento em unidades de colunas para painéis layout: newspaper. |
|
| Parâmetros de texto | ||
title_text |
Especifica um título para um elemento do painel de type: text. |
|
subtitle_text |
Especifica um subtítulo para um elemento do painel de type: text |
|
body_text |
Especifica o texto do corpo de um elemento do painel de type: text |
|
Parâmetros básicos
Ao definir um elemento do painel LookML de type: text, você precisa especificar valores para pelo menos os parâmetros name e type.
name
Esta seção se refere ao parâmetro
nameque faz parte de um elemento do painel.
nametambém pode ser usado como parte de um filtro do painel, descrito na página de documentação de Parâmetros do painel.
Cada declaração name cria um novo elemento do 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 do layout: grid.
- name: orders_by_date
type
Esta seção se refere ao parâmetro
typeque faz parte de um elemento do painel.
typetambém pode ser usado como parte de um filtro do painel, descrito na página de documentação de Parâmetros do painel.O
typetambém pode ser usado como parte de uma mesclagem, descrita na página de documentação do parâmetrotype(para mesclagens).
typetambém pode ser usado como parte de uma dimensão, descrita na página de documentação Tipos de dimensões, filtros e parâmetros.
typetambém pode ser usado como parte de uma medida, descrita na página de documentação Tipos de medida.
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 painéis do LookML) para ter uma visão geral dos diferentes tipos de elementos do painel do LookML.
height
Esta seção se refere ao parâmetro
heightque faz parte de um elemento do painel.
heighttambém pode ser usado como parte de uma linha do painel, descrita na página 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 (que é definida em pixels), para os 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 row, para os painéis layout: newspaper.
Um painel com layout de jornal é padronizado com uma altura de elemento de 6 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 duas vezes mais alto do que 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
widthque faz parte de um elemento do painel.
widthtambém pode ser usado como parte de um painel, 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, tornando o elemento orders_by_date com 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 os painéis layout: newspaper.
Um painel com layout de jornal tem como padrão uma largura de 24 colunas.
Por exemplo, o código abaixo 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 de cima 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 do painel. Por padrão, um painel com layout de jornal tem altura padrão de seis linhas, ou seja, os elementos da parte de cima do painel (row: 0) ocupam as linhas de 0 a 5 por padrão.
Cada linha tem 50 pixels de altura, o que significa que a altura padrão do elemento de 6 linhas é 300 pixels.
Por exemplo, o código a seguir define um elemento a ser definido na segunda linha no painel, desde que os elementos estejam na altura padrão:
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
row: 6
...
col
Nos painéis 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 do painel. Um painel com layout de jornal tem como padrão uma largura de elemento de oito colunas, ou seja, os elementos do painel à esquerda de um painel (col: 0) assumem, por padrão, as colunas de 0 a 7.
Por exemplo, o código a seguir define um elemento a ser definido na terceira coluna de elementos do painel:
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
col: 16
...
Parâmetros de texto
Os parâmetros descritos nesta seção podem ser usados para adicionar conteúdo a um elemento do 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 é mostrado 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 do meio disponível. Se title_text estiver presente, o subtitle_text 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 é exibido por último no bloco de texto. A página de documentação Como usar o Markdown em blocos de Markdown fornece uma visão geral do Markdown que pode ser usada para formatar o texto ou adicionar links e imagens a um bloco de texto.
body_text: body text