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

Auf dieser Seite wird beschrieben, 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 Typ der Visualisierung, die 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-Dashboard-Element vom Typ type: text definieren, müssen Sie mindestens Werte für die Parameter name und type angeben.

name

In diesem Abschnitt geht es um den Parameter name, der Teil eines Dashboard-Elements ist.

name kann auch als Teil eines Dashboard-Filters verwendet werden, wie auf der Dokumentationsseite Dashboard-Parameter beschrieben.

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 referenziert, wenn Sie layout: grid-Dashboards verwenden, oder im Parameter group von untergeordneten Elementen, wenn Sie Elemente in einer Kachelgruppe (type: group) organisieren.

- name: orders_by_date

type

In diesem Abschnitt geht es um den Parameter type, der Teil eines Dashboard-Elements ist.

type kann auch als Teil eines Dashboard-Filters verwendet werden, wie auf der Dokumentationsseite Dashboard-Parameter beschrieben.

type kann auch als Teil eines Joins verwendet werden, wie auf der Dokumentationsseite für den Parameter type (für Joins) beschrieben.

type kann auch als Teil einer Dimension verwendet werden, wie auf der Dokumentationsseite Dimensionen, Filter und Parametertypen beschrieben.

type kann auch als Teil einer Measure verwendet werden, wie auf der Dokumentationsseite Measure-Typen beschrieben.

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 | button | group

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

height

In diesem Abschnitt geht es um den Parameter height, der Teil eines Dashboard-Elements ist.

height kann auch als Teil einer Dashboard-Zeile verwendet werden, wie auf der Dokumentationsseite Dashboard-Parameter beschrieben.

Für Dashboards mit tile- oder static-Layouts

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

Im folgenden Code werden beispielsweise tile_size: 100 und height: 4 angegeben, sodass das orders_by_date-Element 400 Pixel hoch ist.

- dashboard: sales_overview
  tile_size: 100
  ...

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

Für Dashboards mit newspaper-Layout

Der Parameter height definiert die Höhe eines Elements in Einheiten von row für layout: newspaper-Dashboards.

Bei einem Dashboard mit Zeitungslayout beträgt die Standardhöhe eines Elements 6 Zeilen oder etwa 300 Pixel. Die Mindesthöhe beträgt 1 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.

Mit dem folgenden Code wird beispielsweise ein Element auf eine Höhe von 12 Zeilen festgelegt, also doppelt so hoch wie andere Elemente, für die die Standardeinstellung gilt:

- dashboard: sales_overview
  layout: newspaper
  ...

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

width

In diesem Abschnitt geht es um den Parameter width, der Teil eines Dashboard-Elements ist.

width kann auch als Teil eines Dashboards verwendet werden, wie auf der Dokumentationsseite Dashboard-Parameter beschrieben.

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, sodass das orders_by_date-Element 400 Pixel breit ist.

- 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 Zeitungsformat hat standardmäßig eine Breite von 24 Spalten.

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

- dashboard: sales_overview
  layout: newspaper
  ...

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

top

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

Im folgenden Code werden beispielsweise tile_size: 100 und top: 4 angegeben, wodurch die Oberkante des orders_by_date-Elements 400 Pixel vom oberen Rand des Dashboards entfernt positioniert wird.

- 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 werden beispielsweise tile_size: 100 und left: 4 angegeben, wodurch der linke Rand des orders_by_date-Elements 400 Pixel von der linken Seite des Dashboards entfernt positioniert wird.

- dashboard: sales_overview
  tile_size: 100
  ...

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

row

Bei layout: newspaper-Dashboards definiert der Parameter row die Zeile, in der sich der obere Rand eines Elements befindet. Wenn das Element mithilfe des Parameters group in einer Kachelgruppe platziert wird, definiert row die Zeilenposition des Elements relativ zum oberen Rand des Gruppencontainers (row: 0).

Ein Dashboard beginnt mit Zeile 0 oben im Dashboard. Bei einem Dashboard mit Zeitungslayout beträgt die Standardhöhe eines Elements 6 Zeilen. Das bedeutet, dass die Dashboard-Elemente oben im Dashboard (row: 0) 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 festgelegt, vorausgesetzt, die Elemente sind auf die Standardhöhe eingestellt:

- dashboard: sales_overview
  layout: newspaper
  ...

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

col

Bei layout: newspaper-Dashboards definiert der Parameter col die Spalte, in der sich der linke Rand des Elements befindet. Wenn das Element mit dem Parameter group in einer Kachelgruppe platziert wird, definiert col die Spaltenposition des Elements relativ zum linken Rand des Gruppencontainers (col: 0).

Dashboards sind in 24 Spalten unterteilt. Ein Dashboard beginnt mit Spalte 0 auf der linken Seite des Dashboards. Ein Dashboard mit Zeitungs-Layout hat standardmäßig eine Elementbreite von 8 Spalten. Das bedeutet, dass die Dashboard-Elemente links im Dashboard (col: 0) standardmäßig die Spalten 0–7 einnehmen.

Mit dem folgenden Code wird beispielsweise ein Element in der dritten Spalte der Elemente im Dashboard festgelegt:

- dashboard: sales_overview
  layout: newspaper
  ...

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

Textparameter

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

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. Er 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 in der kleinsten verfügbaren Schriftgröße auf einem type: text-Element angezeigt wird. Dieser Parameter wird zuletzt in der Text-Tile angezeigt. Auf der Dokumentationsseite Markdown in Markdown-Tiles verwenden finden Sie eine Übersicht über das Markdown, mit dem Sie Text formatieren oder Links und Bilder zu einer Text-Tile hinzufügen können.

body_text: body text