Parámetros de la tarjeta de texto para los paneles de LookML

En esta página, se muestra cómo agregar y personalizar un elemento del panel de LookML de type: text con parámetros del panel de LookML en un archivo dashboard.lkml.

Para obtener información sobre cómo agregar texto a un panel a través de la IU de Looker, consulta la página de documentación Cómo crear 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 de layout: tile y layout: static
width (para elementos) Define el ancho de un elemento en unidades de tile_size para los paneles de layout: tile y layout: static
top Define la posición de arriba hacia abajo de un elemento en unidades de tile_size para los paneles de layout: static.
left Define la posición de izquierda a derecha de un elemento en unidades de tile_size para los paneles de layout: static.
row Define la posición de arriba hacia abajo de un elemento en unidades de filas para los paneles de layout: newspaper
col Define la posición de izquierda a derecha de un elemento en unidades de columnas para los paneles de layout: newspaper
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 para un elemento del 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, como se describe en la página de documentación Parámetros del panel.

Cada declaración de name crea un nuevo elemento del panel 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 usas paneles de 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, como 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, como se describe en la página de documentación del parámetro type (para uniones).

type también se puede usar como parte de una dimensión, como se describe en la página de documentación Tipos de dimensiones, filtros y parámetros.

type también se puede usar como parte de una medida, como se describe en la página de documentación Tipos de medidas.

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 de type (para paneles de LookML) para obtener una descripción general de los diferentes tipos de elementos de paneles 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, como se describe en la página de documentación Parámetros del panel.

Para paneles con diseños 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 diseño de newspaper

El parámetro height define la altura de un elemento, en unidades de fila, para los paneles de layout: newspaper.

Un panel con diseño de periódico tiene una altura predeterminada 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 alto que otros elementos que se establecen en el valor predeterminado:

- 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, como 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 columnas, para los paneles layout: newspaper.

Un panel con diseño de periódico tiene un ancho predeterminado 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 layout: static.

Por ejemplo, el siguiente código especifica tile_size: 100 y top: 4, lo que posiciona el borde superior del elemento orders_by_date a 400 píxeles de 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 layout: static.

Por ejemplo, el siguiente código especifica tile_size: 100 y left: 4, y 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

En el caso de 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. Un panel con diseño de periódico tiene una altura predeterminada de 6 filas, lo que significa que los elementos del panel en la parte superior (row: 0) ocuparían de forma predeterminada las filas de la 0 a la 5.

Cada fila tiene 50 píxeles de alto, lo que significa que la altura predeterminada del elemento de 6 filas es de 300 píxeles.

Por ejemplo, el siguiente código establece que un elemento se coloque 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

En el caso de los paneles de layout: newspaper, el parámetro col define la columna en la que se coloca el borde izquierdo del elemento.

Los paneles se dividen en 24 columnas. Un panel comienza con la columna 0 a la izquierda del panel. Un panel con diseño de periódico tiene de forma predeterminada un ancho de elemento de 8 columnas, lo que significa que los elementos del panel a la izquierda de un panel (col: 0) ocuparían de forma predeterminada las columnas de la 0 a la 7.

Por ejemplo, el siguiente código establece que un elemento se coloque en la tercera columna de elementos del panel:

- dashboard: sales_overview
  layout: newspaper
  ...

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

Parámetros de texto

El LookML del panel que se genera a partir de los mosaicos de texto creados con la opción Texto en la IU de Looker no usará los parámetros title_text ni subtitle_text.

Los parámetros que se describen en esta sección se pueden usar para agregar contenido a un elemento del panel de LookML de type: text.

title_text

El parámetro title_text especifica el texto que aparecerá en un elemento type: text con el 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 mediano disponible. Si title_text está presente, subtitle_text aparecerá debajo.

subtitle_text: subtitle text

body_text

El parámetro body_text especifica el texto que aparecerá en un elemento type: text con el tamaño de fuente más pequeño disponible. Este parámetro se muestra al final de la tarjeta de texto. En la página de documentación Cómo usar Markdown en tarjetas de Markdown, se proporciona una descripción general del lenguaje de marcado que puedes usar para dar formato al texto o agregar vínculos e imágenes a una tarjeta de texto.

body_text: body text