Paramètres de tuiles de texte pour les tableaux de bord LookML

Cette page explique comment ajouter et personnaliser un élément de tableau de bord LookML de type: text avec des paramètres de tableau de bord LookML dans un fichier dashboard.lkml.

Pour en savoir plus sur l'ajout de tuiles de texte à un tableau de bord via l'interface utilisateur de Looker, consultez la page Créer des tableaux de bord définis par l'utilisateur.

Exemple d'utilisation

## 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

Définitions des paramètres

Nom du paramètre	Description
Paramètres de base
name (pour les éléments)	Crée un élément
type (pour les éléments)	Détermine le type de visualisation à utiliser dans l'élément
height (pour les éléments)	Définit la hauteur d'un élément en unités de tile_size pour les tableaux de bord layout: tile et layout: static.
width (pour les éléments)	Définit la largeur d'un élément en unités de tile_size pour les tableaux de bord layout: tile et layout: static.
top	Définit la position du haut vers le bas d'un élément dans les unités tile_size des tableaux de bord layout: static.
left	Définit la position d'un élément de gauche à droite en unités de tile_size pour les tableaux de bord layout: static.
row	Définit la position du haut vers le bas d'un élément en unités de lignes pour les tableaux de bord layout: newspaper.
col	Définit la position d'un élément de gauche à droite en unités de colonnes pour les tableaux de bord layout: newspaper.
Paramètres textuels
title_text	Spécifie un titre pour un élément du tableau de bord de type: text
subtitle_text	Spécifie un sous-titre pour un élément du tableau de bord de type: text
body_text	Spécifie le corps du texte d'un élément du tableau de bord de type: text

Paramètres de base

Lorsque vous définissez un élément du tableau de bord LookML de type: text, vous devez spécifier au moins les valeurs des paramètres name et type.

name

Cette section fait référence au paramètre name qui fait partie d'un élément de tableau de bord.

name peut également être utilisé dans le cadre d'un filtre de tableau de bord, décrit sur la page de documentation des paramètres du tableau de bord.

Chaque déclaration name crée un élément de tableau de bord et lui attribue un nom. Les noms d'élément doivent être uniques. Les noms sont parfois référencés dans le paramètre elements lorsque vous utilisez des tableaux de bord layout: grid.

- name: orders_by_date

type

Cette section fait référence au paramètre type qui fait partie d'un élément de tableau de bord.

type peut également être utilisé dans le cadre d'un filtre de tableau de bord, décrit sur la page de documentation des paramètres du tableau de bord.

type peut également être utilisé dans le cadre d'une jointure, décrite sur la page de documentation du paramètre type (pour les jointures).

type peut également être utilisé dans une dimension, décrite sur la page de documentation sur la dimension, le filtre et les types de paramètres.

type peut également être utilisé dans une mesure, décrite sur la page de documentation Types de mesures.

Le paramètre type détermine le type de visualisation à utiliser dans l'élément.

- 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

Consultez la page de documentation type (pour les tableaux de bord LookML) pour obtenir un aperçu des différents types d'éléments du tableau de bord LookML.

height

Cette section fait référence au paramètre height qui fait partie d'un élément de tableau de bord.

height peut également être utilisé dans le cadre d'une ligne de tableau de bord, comme décrit sur la page de documentation des paramètres du tableau de bord.

Pour les tableaux de bord avec des mises en page tile ou static

Le paramètre height définit la hauteur d'un élément, en unités de tile_size (définie en pixels), pour les tableaux de bord layout: tile et layout: static.

Par exemple, le code suivant spécifie tile_size: 100 et height: 4, la hauteur de l'élément orders_by_date étant de 400 pixels.

- dashboard: sales_overview
  tile_size: 100
  ...

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

Pour les tableaux de bord avec la mise en page newspaper

Le paramètre height définit la hauteur d'un élément, en unités de ligne, pour les tableaux de bord layout: newspaper.

Par défaut, la hauteur du tableau de bord d'un journal est de six lignes, soit environ 300 pixels. La hauteur minimale est d'une ligne pour les tableaux de bord dont le paramètre preferred viewer est défini sur dashboards-next. La hauteur minimale est de deux lignes pour les tableaux de bord avec un paramètre preferred viewer défini sur dashboards.

Par exemple, le code suivant définit un élément sur 12 lignes de hauteur ou deux fois plus de hauteur que les autres éléments qui sont définis sur la valeur par défaut:

- dashboard: sales_overview
  layout: newspaper
  ...

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

width

Cette section fait référence au paramètre width qui fait partie d'un élément de tableau de bord.

width peut également être utilisé dans un tableau de bord, comme décrit sur la page de documentation des paramètres du tableau de bord.

Le paramètre width définit la largeur d'un élément, en unités de tile_size, pour les tableaux de bord layout: tile et layout: static.

Par exemple, le code suivant spécifie tile_size: 100 et width: 4, ce qui fait que l'élément orders_by_date fait 400 pixels de largeur.

- dashboard: sales_overview
  tile_size: 100
  ...

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

Le paramètre width définit la largeur d'un élément, en unités de colonnes, pour les tableaux de bord layout: newspaper.

Par défaut, la largeur du tableau de bord est de 24 colonnes.

Par exemple, le code suivant définit l'élément sur la moitié de la largeur du tableau de bord:

- dashboard: sales_overview
  layout: newspaper
  ...

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

top

Le paramètre top définit la position d'un élément de haut en bas, en unités de tile_size, pour les tableaux de bord layout: static.

Par exemple, le code suivant spécifie tile_size: 100 et top: 4, et positionne le bord supérieur de l'élément orders_by_date à 400 pixels du bord du tableau de bord.

- dashboard: sales_overview
  tile_size: 100
  ...

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

left

Le paramètre left définit la position d'un élément de gauche à droite, en unités de tile_size, pour les tableaux de bord layout: static.

Par exemple, le code suivant spécifie tile_size: 100 et left: 4, en positionnant le bord gauche de l'élément orders_by_date à 400 pixels du bord gauche du tableau de bord.

- dashboard: sales_overview
  tile_size: 100
  ...

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

row

Pour les tableaux de bord layout: newspaper, le paramètre row définit la ligne sur laquelle le bord supérieur d'un élément est placé.

Un tableau de bord commence par la ligne 0 en haut du tableau de bord. Par défaut, la hauteur d'un tableau de bord avec un journal est de six lignes, ce qui signifie que les éléments situés en haut d'un tableau de bord (row: 0) occupent par défaut les lignes 0 à 5.

Chaque ligne mesure 50 pixels de haut, ce qui signifie que la hauteur de l'élément par défaut de six lignes est de 300 pixels.

Par exemple, le code suivant définit un élément à définir sur la deuxième ligne d'éléments du tableau de bord, en supposant que les éléments soient définis à la hauteur par défaut:

- dashboard: sales_overview
  layout: newspaper
  ...

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

col

Pour les tableaux de bord layout: newspaper, le paramètre col définit la colonne sur laquelle le bord gauche de l'élément est placé.

Les tableaux de bord sont divisés en 24 colonnes. Un tableau de bord commence par la colonne 0 à gauche du tableau de bord. Par défaut, la largeur d'un tableau de bord avec une mise en page de journal est de 8 colonnes, ce qui signifie que les éléments situés à gauche d'un tableau de bord (col: 0) occupent par défaut les colonnes 0 à 7.

Par exemple, le code suivant définit un élément à définir dans la troisième colonne d'éléments du tableau de bord:

- dashboard: sales_overview
  layout: newspaper
  ...

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

Paramètres textuels

Les paramètres décrits dans cette section peuvent être utilisés pour ajouter du contenu à un élément du tableau de bord LookML de type: text.

title_text

Le paramètre title_text spécifie le texte qui s'affichera sur un élément type: text avec la plus grande taille de police disponible. Il est affiché en haut de la tuile.

title_text: title text

subtitle_text

Le paramètre subtitle_text spécifie le texte qui s'affichera sur un élément type: text avec la taille de police moyenne disponible. Si title_text est présent, subtitle_text apparaît en dessous.

subtitle_text: subtitle text

body_text

Le paramètre body_text spécifie le texte qui s'affichera sur un élément type: text dans la plus petite taille de police disponible. Ce paramètre est le dernier de la tuile de texte. La page Utiliser le format Markdown dans les tuiles Markdown offre un aperçu du format Markdown que vous pouvez utiliser pour mettre en forme du texte, ou pour ajouter des liens et des images à une vignette.

body_text: body text