En esta página, se muestra cómo agregar y personalizar un elemento del panel de LookML de type: text
con los parámetros del panel de LookML en un archivo dashboard.lkml
.
Para obtener información sobre cómo agregar mosaicos de texto a un panel a través de la IU de Looker, consulta la página de documentación Crea paneles definidos por el usuario.
Ejemplo 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
Definiciones de los parámetros
Nombre del parámetro | Descripción | |
---|---|---|
Parámetros básicos | ||
name (para elementos) |
Crea un elemento | |
type (para elementos) |
Determina el tipo de visualización que se usará en el elemento. | |
height (para elementos) |
Define la altura de un elemento en unidades de tile_size para los paneles layout: tile y layout: static |
|
width (para elementos) |
Define el ancho de un elemento en unidades de tile_size para los paneles layout: tile y layout: static |
|
top |
Define la posición de arriba hacia abajo de un elemento en unidades de tile_size para paneles de layout: static |
|
left |
Define la posición de izquierda a derecha de un elemento en unidades de tile_size para paneles de layout: static |
|
row |
Define la posición de arriba hacia abajo de un elemento en unidades de fila para los paneles de layout: newspaper |
|
col |
Define la posición de izquierda a derecha de un elemento en unidades de columnas para layout: newspaper paneles |
|
Parámetros de texto | ||
title_text |
Especifica un título para un elemento del panel de type: text |
|
subtitle_text |
Especifica un subtítulo para un elemento del panel de type: text |
|
body_text |
Especifica el texto del cuerpo de un elemento de panel de type: text |
Parámetros básicos
Cuando defines un elemento del panel de LookML de type: text
, debes especificar valores para al menos los parámetros name
y type
.
name
En esta sección, se hace referencia al parámetro
name
que forma parte de un elemento del panel.
name
también se puede usar como parte de un filtro del panel, que se describe en la página de documentación Parámetros del panel.
Cada declaración name
crea un elemento de panel nuevo y le asigna un nombre. Los nombres de los elementos deben ser únicos. A veces, se hace referencia a los nombres en el parámetro elements
cuando se usan los paneles layout: grid
.
- name: orders_by_date
type
En esta sección, se hace referencia al parámetro
type
que forma parte de un elemento del panel.
type
también se puede usar como parte de un filtro del panel, que se describe en la página de documentación Parámetros del panel.
type
también se puede usar como parte de una unión, que se describe en la página de documentación del parámetrotype
(para combinaciones).
type
también se puede usar como parte de una dimensión, que se describe en la página de documentación Dimensión, filtro y tipos de parámetros.
type
también se puede usar como parte de una medida, que se describe en la página de documentación Tipos de medición.
El parámetro type
determina el tipo de visualización que se usará en el 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
Consulta la página de documentación type
(para paneles de LookML) a fin de obtener una descripción general de los diferentes tipos de elementos del panel de LookML.
height
En esta sección, se hace referencia al parámetro
height
que forma parte de un elemento del panel.
height
también se puede usar como parte de una fila del panel, descrita en la página de documentación Parámetros del panel.
Para paneles con diseños de tile
o static
El parámetro height
define la altura de un elemento en unidades de tile_size
(que se define en píxeles) para los paneles layout: tile
y layout: static
.
Por ejemplo, el siguiente código especifica tile_size: 100
y height: 4
, lo que hace que el elemento orders_by_date
tenga 400 píxeles de altura.
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
height: 4
...
Para paneles con el diseño newspaper
El parámetro height
define la altura de un elemento, en unidades de fila, para los paneles layout: newspaper
.
De forma predeterminada, un panel con diseño de periódico tiene una altura de 6 filas o alrededor de 300 píxeles. La altura mínima es de 1 fila para los paneles con un parámetro preferred viewer
establecido en dashboards-next
. La altura mínima es de 2 filas para los paneles con un parámetro preferred viewer
establecido en dashboards
.
Por ejemplo, el siguiente código establece que un elemento tenga 12 filas de alto o el doble de altura que otros elementos que tienen la configuración predeterminada:
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
height: 12
...
width
En esta sección, se hace referencia al parámetro
width
que forma parte de un elemento del panel.
width
también se puede usar como parte de un panel, que se describe en la página de documentación Parámetros del panel.
El parámetro width
define el ancho de un elemento, en unidades de tile_size
, para los paneles layout: tile
y layout: static
.
Por ejemplo, el siguiente código especifica tile_size: 100
y width: 4
, lo que hace que el elemento orders_by_date
tenga 400 píxeles de ancho.
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
width: 4
...
El parámetro width
define el ancho de un elemento, en unidades de columna, para los paneles de layout: newspaper
.
De forma predeterminada, el panel tiene un ancho de 24 columnas.
Por ejemplo, el siguiente código establece el elemento en la mitad del ancho del panel:
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
width: 12
...
top
El parámetro top
define la posición de arriba hacia abajo de un elemento, en unidades de tile_size
, para los paneles de layout: static
.
Por ejemplo, el siguiente código especifica tile_size: 100
y top: 4
, y coloca el borde superior del elemento orders_by_date
400 píxeles desde la parte superior del panel.
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
top: 4
...
left
El parámetro left
define la posición de izquierda a derecha de un elemento, en unidades de tile_size
, para los paneles de layout: static
.
Por ejemplo, el siguiente código especifica tile_size: 100
y left: 4
, lo que posiciona el borde izquierdo del elemento orders_by_date
a 400 píxeles del lado izquierdo del panel.
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
left: 4
...
row
Para los paneles de layout: newspaper
, el parámetro row
define la fila en la que se coloca el borde superior de un elemento.
Un panel comienza con la fila 0 en la parte superior del panel. De forma predeterminada, un panel con diseño de periódico tiene una altura de 6 filas, lo que significa que los elementos de panel en la parte superior de un panel (row: 0
) ocuparán de forma predeterminada las filas 0-5.
Cada fila tiene 50 píxeles de alto, lo que significa que la altura predeterminada de 6 filas es de 300 píxeles.
Por ejemplo, en el siguiente código, se configura un elemento que se establecerá en la segunda fila de elementos del panel, suponiendo que los elementos se establecen en la altura predeterminada:
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
row: 6
...
col
Para los paneles de layout: newspaper
, el parámetro col
define la columna en la que se coloca el borde izquierdo del elemento.
Los paneles de control se dividen en 24 columnas. Un panel comienza con la columna 0 a la izquierda del panel. De manera predeterminada, un panel con diseño de periódico tiene un ancho de 8 columnas, lo que significa que los elementos del panel a la izquierda de un panel (col: 0
) usarán las columnas 0 a 7 de forma predeterminada.
Por ejemplo, el siguiente código establece un elemento que se establecerá en la tercera columna de elementos en el panel:
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
col: 16
...
Parámetros de texto
Los parámetros que se describen en esta sección se pueden usar para agregar contenido a un elemento de panel de LookML de type: text
.
title_text
El parámetro title_text
especifica el texto que aparecerá en un elemento type: text
del tamaño de fuente más grande disponible. Se muestra en la parte superior de la tarjeta.
title_text: title text
subtitle_text
El parámetro subtitle_text
especifica el texto que aparecerá en un elemento type: text
con el tamaño de fuente medio disponible. Si title_text
está presente, el elemento subtitle_text
aparecerá debajo de este.
subtitle_text: subtitle text
body_text
El parámetro body_text
especifica el texto que aparecerá en un elemento type: text
del tamaño de fuente más pequeño disponible. Este parámetro se muestra al final del mosaico de texto. La página de documentación Cómo usar Markdown en mosaicos de Markdown proporciona una descripción general de Markdown que puedes usar para dar formato al texto o para agregar imágenes y vínculos a un mosaico de texto.
body_text: body text