Auf dieser Seite wird beschrieben, wie Sie ein LookML-Dashboard-Element von type: text
mit LookML-Dashboard-Parametern in einer dashboard.lkml
-Datei hinzufügen und anpassen.
Informationen zum Hinzufügen von Textkacheln 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) |
Legt die Art der im Element zu verwendenden Visualisierung fest | |
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 tile_size -Einheiten für layout: tile - und layout: static -Dashboards. |
|
top |
Definiert die oberste Position eines Elements in der Einheit tile_size für layout: static -Dashboards. |
|
left |
Definiert die Position von links nach rechts für ein Element in der Einheit tile_size für layout: static -Dashboards. |
|
row |
Definiert die oberste Position eines Elements in Zeileneinheiten für layout: newspaper -Dashboards |
|
col |
Bestimmt die Position der Elemente in layout: newspaper -Dashboards von links nach rechts |
|
Textparameter | ||
title_text |
Gibt einen Titel für ein Dashboard-Element von type: text an |
|
subtitle_text |
Gibt einen Untertitel für ein Dashboard-Element von type: text an |
|
body_text |
Gibt den Text für das Dashboard-Element type: text an |
Grundlegende Parameter
Wenn Sie ein LookML-Dashboard-Element von type: text
definieren, müssen Sie Werte für mindestens die Parameter name
und type
angeben.
name
Dieser Abschnitt bezieht sich auf den Parameter
name
, der Teil eines Dashboard-Elements ist.
name
kann auch als Teil eines Dashboard-Filters verwendet werden, der auf der Dokumentationsseite zu Dashboard-Parametern beschrieben wird.
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.
- name: orders_by_date
type
Dieser Abschnitt bezieht sich auf den Parameter
type
, der Teil eines Dashboard-Elements ist.
type
kann auch als Teil eines Dashboard-Filters verwendet werden, der auf der Dokumentationsseite zu Dashboard-Parametern beschrieben wird.
type
kann auch als Teil eines Joins verwendet werden (siehe Dokumentation zum Parametertype
(für Joins)).
type
kann auch als Teil einer Dimension verwendet werden. Weitere Informationen dazu finden Sie auf der Dokumentationsseite zu Dimensionen, Filtern und Parametertypen.
type
kann auch als Teil einer Messung verwendet werden, wie auf der Dokumentationsseite zu Messtypen beschrieben.
Der Parameter type
bestimmt die Art der Visualisierung, die 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
Auf der Dokumentationsseite zu type
(für LookML-Dashboards) finden Sie eine Übersicht über die verschiedenen Arten von LookML-Dashboard-Elementen.
height
Dieser Abschnitt bezieht sich auf den Parameter
height
, der Teil eines Dashboard-Elements ist.
height
kann auch als Teil einer Dashboard-Zeile verwendet werden, wie auf der Dokumentationsseite zu Dashboard-Parametern beschrieben.
Für Dashboards mit tile
- oder static
-Layouts
Der Parameter height
definiert die Höhe eines Elements in Dashboards von tile_size
(in Pixeln) für Dashboards layout: tile
und layout: static
.
Der folgende Code gibt beispielsweise tile_size: 100
und height: 4
an, wodurch das Element orders_by_date
400 Pixel hoch wird.
- 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 Zeilen für layout: newspaper
-Dashboards.
Ein Dashboard mit Zeitungslayout hat standardmäßig eine Elementhöhe von 6 Zeilen oder etwa 300 Pixeln. Die Mindesthöhe beträgt 1 Zeile für Dashboards, deren Parameter preferred viewer
auf dashboards-next
festgelegt ist. Die Mindesthöhe beträgt für Dashboards mit einem preferred viewer
-Parameter von dashboards
2 Zeilen.
Mit dem folgenden Code wird ein Element beispielsweise auf 12 Zeilen oder doppelt so hoch gesetzt wie andere Elemente mit dem Standardwert:
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
height: 12
...
width
Dieser Abschnitt bezieht sich auf den Parameter
width
, der Teil eines Dashboard-Elements ist.
width
kann auch als Teil eines Dashboards verwendet werden, wie auf der Dokumentationsseite zu den Dashboard-Parametern beschrieben.
Der Parameter width
definiert die Breite eines Elements in tile_size
-Einheiten für layout: tile
- und layout: static
-Dashboards.
Der folgende Code gibt beispielsweise tile_size: 100
und width: 4
an, wodurch das Element orders_by_date
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 Spaltenspalten für layout: newspaper
-Dashboards.
Ein Dashboard mit Zeitungslayout 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 oberste Position eines Elements in Einheiten von tile_size
für layout: static
-Dashboards.
Der folgende Code gibt beispielsweise tile_size: 100
und top: 4
an und positioniert den oberen Rand des orders_by_date
-Elements 400 Pixel vom oberen Rand des Dashboards.
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
top: 4
...
left
Der Parameter left
definiert die Position des Elements von links nach rechts (in Einheiten von tile_size
) für layout: static
-Dashboards.
Der folgende Code gibt beispielsweise tile_size: 100
und left: 4
an und positioniert den linken Rand des orders_by_date
-Elements 400 Pixel vom linken Rand des Dashboards.
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
left: 4
...
row
Bei layout: newspaper
-Dashboards definiert der Parameter row
die Zeile, auf der der obere Rand eines Elements platziert wird.
Ein Dashboard beginnt mit Zeile 0 oben im Dashboard. Ein Dashboard mit Zeitungslayout hat standardmäßig eine Elementhöhe von 6 Zeilen. Das bedeutet, dass die Dashboard-Elemente oben auf einem Dashboard (row: 0
) standardmäßig die Zeilen 0–5 belegen.
Jede Zeile ist 50 Pixel hoch. Die Standardhöhe für das Element beträgt also 6 Zeilen.
Mit dem folgenden Code wird beispielsweise festgelegt, dass ein Element in der zweiten Zeile von Elementen im Dashboard festgelegt wird, 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 definiert der Parameter col
die Spalte, auf der der linke Rand des Elements platziert wird.
Dashboards sind in 24 Spalten unterteilt. Ein Dashboard beginnt mit Spalte 0 links vom Dashboard. Ein Dashboard mit Zeitungslayout hat standardmäßig eine Elementbreite von 8 Spalten. Das bedeutet, dass die Dashboard-Elemente links vom Dashboard (col: 0
) standardmäßig die Spalten 0–7 belegen.
Der folgende Code legt beispielsweise ein Element fest, das in der dritten Spalte von Elementen im Dashboard festgelegt wird:
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
col: 16
...
Textparameter
Die in diesem Abschnitt beschriebenen Parameter können verwendet werden, um einem LookML-Dashboard-Element von type: text
Inhalte hinzuzufügen.
title_text
Der Parameter title_text
gibt den Text an, der auf einem type: text
-Element in der größten verfügbaren Schriftgröße erscheint. Er wird oben auf der Kachel angezeigt.
title_text: title text
subtitle_text
Der Parameter subtitle_text
gibt den Text an, der auf einem type: text
-Element in der mittleren Schriftgröße angezeigt werden soll. Wenn title_text
vorhanden ist, wird darunter subtitle_text
angezeigt.
subtitle_text: subtitle text
body_text
Der Parameter body_text
gibt den Text an, der auf einem type: text
-Element in der kleinstmöglichen Schriftgröße angezeigt wird. Dieser Parameter wird zuletzt in der Textkachel angezeigt. Die Dokumentation Markdown in Markdown-Kacheln verwenden bietet eine Übersicht über den Markdown-Text, mit dem Sie Text formatieren oder Links und Bilder zu einer Textkachel hinzufügen können.
body_text: body text