Parameter für Text-Tiles für LookML-Dashboards

Auf dieser Seite wird gezeigt, wie Sie ein LookML-Dashboard-Element vom Typ type: text mit LookML-Dashboard-Parametern in einer dashboard.lkml-Datei hinzufügen und anpassen.

Informationen zum Hinzufügen von Text zu einem Dashboard über die Looker-Benutzeroberfläche finden Sie auf der Dokumentationsseite Benutzerdefinierte Dashboards erstellen.

Nutzungsbeispiel


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

Parameterdefinitionen

Parametername Beschreibung
Grundlegende Parameter
name (für Elemente) Erstellt ein Element
type (für Elemente) Bestimmt den Visualisierungstyp, der im Element verwendet werden soll.
height (für Elemente) Definiert die Höhe eines Elements in Einheiten von tile_size für layout: tile- und layout: static-Dashboards
width (für Elemente) Definiert die Breite eines Elements in Einheiten von tile_size für layout: tile- und layout: static-Dashboards
top Definiert die Position eines Elements von oben nach unten in Einheiten von tile_size für layout: static-Dashboards.
left Definiert die Position eines Elements von links nach rechts in Einheiten von tile_size für layout: static-Dashboards.
row Definiert die Position eines Elements von oben nach unten in Zeileneinheiten für layout: newspaper-Dashboards
col Definiert die Position eines Elements von links nach rechts in Spalteneinheiten für layout: newspaper-Dashboards
Textparameter
title_text Gibt einen Titel für ein Dashboard-Element vom Typ type: text an.
subtitle_text Gibt einen Untertitel für ein Dashboard-Element vom Typ type: text an.
body_text Gibt den Text für ein Dashboard-Element vom Typ type: text an.

Grundlegende Parameter

Wenn Sie ein LookML-Dashboardelement vom Typ type: text definieren, müssen Sie mindestens Werte für die Parameter name und type angeben.

name

In diesem Abschnitt wird auf den Parameter name verwiesen, der Teil eines Dashboard-Elements ist.

name kann auch als Teil eines Dashboardfilters verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

Mit jeder name-Deklaration wird ein neues Dashboard-Element erstellt und ihm ein Name zugewiesen. Elementnamen müssen eindeutig sein. Namen werden manchmal im Parameter elements angegeben, wenn Sie layout: grid-Dashboards verwenden.

- name: orders_by_date

type

In diesem Abschnitt wird auf den Parameter type verwiesen, der Teil eines Dashboard-Elements ist.

type kann auch als Teil eines Dashboardfilters verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

type kann auch als Teil eines Joins verwendet werden. Dies wird auf der Dokumentationsseite zum Parameter type (für Joins) beschrieben.

type kann auch als Teil einer Dimension verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dimensionen, Filter und Parametertypen.

type kann auch als Teil eines Messwerts verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Messwerttypen.

Der Parameter type bestimmt den Visualisierungstyp, der im Element verwendet werden soll.

- 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

Eine Übersicht über die verschiedenen Arten von LookML-Dashboard-Elementen finden Sie auf der Dokumentationsseite type (für LookML-Dashboards).

height

In diesem Abschnitt wird auf den Parameter height verwiesen, der Teil eines Dashboard-Elements ist.

height kann auch als Teil einer Dashboard-Zeile verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

Für Dashboards mit tile- oder static-Layouts

Mit dem Parameter height wird die Höhe eines Elements in Einheiten von tile_size (in Pixeln) für layout: tile- und layout: static-Dashboards definiert.

Im folgenden Code werden beispielsweise tile_size: 100 und height: 4 angegeben, wodurch das Element orders_by_date eine Höhe von 400 Pixeln erhält.

- dashboard: sales_overview
  tile_size: 100
  ...

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

Für Dashboards mit newspaper-Layout

Mit dem Parameter height wird die Höhe eines Elements in Einheiten von Zeile für layout: newspaper-Dashboards definiert.

Bei einem Dashboard mit Zeitungs-Layout ist die Standardhöhe eines Elements 6 Zeilen oder etwa 300 Pixel. Die Mindesthöhe beträgt eine Zeile für Dashboards, bei denen der Parameter preferred viewer auf dashboards-next festgelegt ist. Die Mindesthöhe beträgt 2 Zeilen für Dashboards, bei denen der Parameter preferred viewer auf dashboards festgelegt ist.

Im folgenden Code wird beispielsweise ein Element auf 12 Zeilen festgelegt, also doppelt so hoch wie andere Elemente, für die der Standardwert festgelegt ist:

- dashboard: sales_overview
  layout: newspaper
  ...

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

width

In diesem Abschnitt wird auf den Parameter width verwiesen, der Teil eines Dashboard-Elements ist.

width kann auch als Teil eines Dashboards verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

Der Parameter width definiert die Breite eines Elements in Einheiten von tile_size für layout: tile- und layout: static-Dashboards.

Im folgenden Code werden beispielsweise tile_size: 100 und width: 4 angegeben, wodurch das orders_by_date-Element eine Breite von 400 Pixeln erhält.

- dashboard: sales_overview
  tile_size: 100
  ...

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

Der Parameter width definiert die Breite eines Elements in Spalteneinheiten für layout: newspaper-Dashboards.

Ein Dashboard mit Zeitungs-Layout hat standardmäßig eine Breite von 24 Spalten.

Mit dem folgenden Code wird die Breite des Elements beispielsweise auf die Hälfte der Breite des Dashboards festgelegt:

- dashboard: sales_overview
  layout: newspaper
  ...

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

top

Mit dem Parameter top wird die Position eines Elements von oben nach unten in Einheiten von tile_size für layout: static-Dashboards definiert.

Im folgenden Code werden beispielsweise tile_size: 100 und top: 4 angegeben. Dadurch wird der obere Rand des Elements orders_by_date 400 Pixel vom oberen Rand des Dashboards entfernt positioniert.

- dashboard: sales_overview
  tile_size: 100
  ...

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

left

Der Parameter left definiert die Position eines Elements von links nach rechts in Einheiten von tile_size für layout: static-Dashboards.

Im folgenden Code wird beispielsweise tile_size: 100 und left: 4 angegeben. Dadurch wird der linke Rand des Elements orders_by_date 400 Pixel vom linken Rand des Dashboards entfernt positioniert.

- dashboard: sales_overview
  tile_size: 100
  ...

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

row

Bei layout: newspaper-Dashboards wird mit dem Parameter row die Zeile definiert, in der die obere Kante eines Elements platziert wird.

Ein Dashboard beginnt mit Zeile 0 oben im Dashboard. Bei einem Dashboard mit Zeitungs-Layout ist die Standardhöhe eines Elements 6 Zeilen. Die Dashboard-Elemente oben auf einem Dashboard (row: 0) würden also standardmäßig die Zeilen 0 bis 5 einnehmen.

Jede Zeile ist 50 Pixel hoch. Die Standardhöhe des Elements von 6 Zeilen beträgt also 300 Pixel.

Mit dem folgenden Code wird beispielsweise ein Element in der zweiten Zeile der Elemente im Dashboard platziert, sofern die Elemente auf der Standardhöhe festgelegt sind:

- dashboard: sales_overview
  layout: newspaper
  ...

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

col

Bei layout: newspaper-Dashboards wird mit dem Parameter col die Spalte definiert, an der der linke Rand des Elements platziert wird.

Dashboards sind in 24 Spalten unterteilt. Ein Dashboard beginnt mit Spalte 0 links im Dashboard. Bei einem Dashboard mit Zeitungs-Layout wird standardmäßig eine Elementbreite von 8 Spalten verwendet. Die Dashboard-Elemente auf der linken Seite eines Dashboards (col: 0) belegen also standardmäßig die Spalten 0 bis 7.

Mit dem folgenden Code wird beispielsweise festgelegt, dass ein Element in der dritten Spalte der Elemente im Dashboard platziert werden soll:

- dashboard: sales_overview
  layout: newspaper
  ...

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

Textparameter

Für Dashboard-LookML, die aus Textkacheln generiert wird, die mit der Option Text in der Looker-Benutzeroberfläche erstellt wurden, werden die Parameter title_text oder subtitle_text nicht verwendet.

Mit den in diesem Abschnitt beschriebenen Parametern können Sie einem LookML-Dashboard-Element vom Typ type: text Inhalte hinzufügen.

title_text

Der Parameter title_text gibt den Text an, der in einem type: text-Element in der größten verfügbaren Schriftgröße angezeigt wird. Sie wird oben auf der Kachel angezeigt.

title_text: title text

subtitle_text

Der Parameter subtitle_text gibt den Text an, der in einem type: text-Element in der mittleren verfügbaren Schriftgröße angezeigt wird. Wenn title_text vorhanden ist, wird subtitle_text darunter angezeigt.

subtitle_text: subtitle text

body_text

Der Parameter body_text gibt den Text an, der auf einem type: text-Element in der kleinsten verfügbaren Schriftgröße angezeigt wird. Dieser Parameter wird in der Textkachel zuletzt angezeigt. Auf der Dokumentationsseite Markdown in Markdown-Kacheln verwenden finden Sie eine Übersicht über die Markdown-Elemente, mit denen Sie Text formatieren oder Links und Bilder in eine Textkachel einfügen können.

body_text: body text