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.
namekann 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.
typekann auch als Teil eines Dashboard-Filters verwendet werden, der auf der Dokumentationsseite zu Dashboard-Parametern beschrieben wird.
typekann auch als Teil eines Joins verwendet werden (siehe Dokumentation zum Parametertype(für Joins)).
typekann auch als Teil einer Dimension verwendet werden. Weitere Informationen dazu finden Sie auf der Dokumentationsseite zu Dimensionen, Filtern und Parametertypen.
typekann 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.
heightkann 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.
widthkann 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