このページでは、dashboard.lkml
ファイルに LookML ダッシュボード パラメータを使用して、type: text
の LookML ダッシュボード要素を追加してカスタマイズする方法について説明します。
Looker UI を使用してダッシュボードにテキストタイルを追加する方法については、ユーザー定義ダッシュボードの作成に関するドキュメント ページをご覧ください。
使用例
## 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
パラメーター定義
パラメーター名 | 説明 | |
---|---|---|
基本パラメータ | ||
name (要素の場合) |
要素を作成する | |
type (要素の場合) |
要素で使用するビジュアリゼーションのタイプを決定します。 | |
height (要素の場合) |
layout: tile および layout: static ダッシュボードの要素の高さを tile_size の単位で定義します |
|
width (要素の場合) |
layout: tile および layout: static ダッシュボードの要素の幅を tile_size の単位で定義します |
|
top |
layout: static ダッシュボードで、要素の上から下への位置を tile_size の単位で定義します。 |
|
left |
layout: static ダッシュボードの要素の左から右への位置を tile_size の単位で定義します |
|
row |
layout: newspaper ダッシュボードの要素の上から下の位置を、行単位で定義します。 |
|
col |
layout: newspaper ダッシュボードの要素の左から右への位置を列単位で定義します |
|
テキスト パラメータ | ||
title_text |
type: text のダッシュボード要素のタイトルを指定します。 |
|
subtitle_text |
type: text のダッシュボード要素のサブタイトルを指定します。 |
|
body_text |
type: text のダッシュボード要素の本文テキストを指定します |
基本パラメータ
type: text
の LookML ダッシュボード要素を定義する場合は、少なくとも name
パラメータと type
パラメータの値を指定する必要があります。
name
このセクションでは、ダッシュボード要素の一部である
name
パラメータについて説明します。
name
はダッシュボード フィルタの一部として使用することもできます。詳しくは、ダッシュボード パラメータに関するドキュメント ページをご覧ください。
name
の宣言ごとに新しいダッシュボード要素が作成され、名前が割り当てられます。要素名は一意である必要があります。layout: grid
ダッシュボードを使用している場合、名前が elements
パラメータで参照されることがあります。
- name: orders_by_date
type
このセクションでは、ダッシュボード要素の一部である
type
パラメータについて説明します。
type
はダッシュボード フィルタの一部として使用することもできます。詳しくは、ダッシュボード パラメータに関するドキュメント ページをご覧ください。また、
type
(結合用)パラメータのドキュメント ページに記載されているように、type
を結合の一部として使用することもできます。
type
は、ディメンションの一部として使用することもできます。詳しくは、ディメンション、フィルタ、パラメータの種類に関するドキュメント ページをご覧ください。
type
は、メジャーの一部として使用することもできます。詳しくは、メジャーのタイプに関するドキュメント ページをご覧ください。
type
パラメータは、要素で使用するビジュアリゼーションのタイプを決定します。
- 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
さまざまなタイプの LookML ダッシュボード要素の概要については、type
(LookML ダッシュボード用)のドキュメントをご覧ください。
height
このセクションでは、ダッシュボード要素の一部である
height
パラメータについて説明します。
height
は、ダッシュボードの行の一部として使用することもできます。詳しくは、ダッシュボード パラメータのドキュメントをご覧ください。
tile
または static
レイアウトのダッシュボードの場合
height
パラメータは、layout: tile
ダッシュボードと layout: static
ダッシュボードの要素の高さを tile_size
(ピクセル単位で定義)単位で定義します。
たとえば、次のコードでは tile_size: 100
と height: 4
を指定して、orders_by_date
要素の高さを 400 ピクセルにしています。
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
height: 4
...
newspaper
レイアウトのダッシュボードの場合
height
パラメータは、layout: newspaper
ダッシュボードの要素の高さを行単位で定義します。
新聞レイアウトのダッシュボードのデフォルトは、6 行(およそ 300 ピクセル)の要素の高さです。preferred viewer
パラメータが dashboards-next
に設定されたダッシュボードの最小高さは 1 行です。ダッシュボードの高さの最小値は 2 行で、preferred viewer
パラメータを dashboards
に設定します。
たとえば、次のコードは、要素の高さを 12 行、またはデフォルトに設定されている他の要素の高さの 2 倍に設定します。
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
height: 12
...
width
このセクションでは、ダッシュボード要素の一部である
width
パラメータについて説明します。
width
はダッシュボードの一部として使用することもできます。詳しくは、ダッシュボード パラメータに関するドキュメント ページをご覧ください。
width
パラメータは、layout: tile
ダッシュボードと layout: static
ダッシュボードの要素の幅を tile_size
の単位で定義します。
たとえば、次のコードは tile_size: 100
と width: 4
を指定して、orders_by_date
要素の幅を 400 ピクセルにしています。
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
width: 4
...
width
パラメータは、layout: newspaper
ダッシュボードの要素の幅を列単位で定義します。
新聞レイアウトのダッシュボードのデフォルト幅は 24 列です。
次のコードは、要素をダッシュボードの幅の半分に設定します。
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
width: 12
...
top
top
パラメータは、layout: static
ダッシュボードの要素の上から下の位置を tile_size
の単位で定義します。
たとえば、次のコードでは、tile_size: 100
と top: 4
を指定して、orders_by_date
要素の上端をダッシュボードの上から 400 ピクセルの位置に配置しています。
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
top: 4
...
left
left
パラメータは、layout: static
ダッシュボードの要素の左から右への位置を tile_size
の単位で定義します。
たとえば、次のコードは tile_size: 100
と left: 4
を指定し、orders_by_date
要素の左端をダッシュボードの左端から 400 ピクセルの位置に配置します。
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
left: 4
...
row
layout: newspaper
ダッシュボードの場合、row
パラメータは、要素の上端を配置する行を定義します。
ダッシュボードの先頭は行 0 です。新聞レイアウトのダッシュボードでは、要素の高さはデフォルトで 6 行になっています。つまり、ダッシュボードの上部にあるダッシュボード要素(row: 0
)では、デフォルトで 0 ~ 5 の行が使用されます。
各行の高さは 50 ピクセルです。つまり、デフォルトの要素の高さは 6 で、300 ピクセルです。
たとえば次のコードは、要素がデフォルトの高さに設定されていると仮定して、要素を要素の 2 行目に設定します。
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
row: 6
...
col
layout: newspaper
ダッシュボードの場合、col
パラメータは、要素の左端を配置する列を定義します。
ダッシュボードは 24 列に分かれています。ダッシュボードの左側 0 から始まるダッシュボード。新聞レイアウトのダッシュボードの要素幅は、デフォルトで 8 列になります。つまり、ダッシュボードの左側にある col: 0
要素では列 0 ~ 7 がデフォルトで表示されます。
たとえば、次のコードでは、ダッシュボードの要素の 3 列目に設定する要素を設定します。
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
col: 16
...
テキスト パラメータ
このセクションで説明するパラメータを使用して、type: text
の LookML ダッシュボード要素にコンテンツを追加できます。
title_text
title_text
パラメータは、type: text
要素に表示される最大フォントサイズのテキストを指定します。タイルの上部に表示されます。
title_text: title text
subtitle_text
subtitle_text
パラメータは、利用可能な中央のフォントサイズの type: text
要素に表示されるテキストを指定します。title_text
が存在する場合、その下に subtitle_text
が表示されます。
subtitle_text: subtitle text
body_text
body_text
パラメータは、type: text
要素に表示するテキストの中で、利用可能な最小フォントサイズを指定します。このパラメータはテキストタイルの最後に表示されます。マークダウン タイルでマークダウンを使用するのドキュメントでは、テキストの書式設定や、テキストタイルへのリンクや画像の追加に使用できるマークダウンの概要について説明しています。
body_text: body text