本頁說明如何使用 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 參數中；將元素整理成圖塊群組 (type: group) 時，名稱則會出現在子元素的 group 參數中。
- 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 | button | group
如要概略瞭解不同類型的 LookML 資訊主頁元素，請參閱 type (適用於 LookML 資訊主頁) 說明文件頁面。
height
本節說明資訊主頁元素中的
height參數。
height也可以做為資訊主頁資料列的一部分，詳情請參閱資訊主頁參數說明文件頁面。
適用於採用 tile 或 static 版面配置的資訊主頁
height 參數定義元素的高度，單位為 tile_size (以像素定義)，適用於 layout: tile 和 layout: static 資訊主頁。
舉例來說，下列程式碼指定 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 列。如果資訊主頁的 preferred viewer 參數設為 dashboards，則高度下限為 2 列。
舉例來說，下列程式碼會將元素設為 12 列高，或設為預設值的其他元素高度的兩倍：
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
height: 12
...
width
本節說明資訊主頁元素中的
width參數。
width也可以做為資訊主頁的一部分，詳情請參閱「資訊主頁參數」說明文件頁面。
width 參數定義元素的寬度，單位為 tile_size，適用於 layout: tile 和 layout: static 資訊主頁。
舉例來說，下列程式碼指定 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 參數定義元素由上至下的位置，單位為 tile_size，適用於 layout: static 資訊主頁。
舉例來說，下列程式碼指定 tile_size: 100 和 top: 4，將 orders_by_date 元素的頂端邊緣定位在距離資訊主頁頂端 400 像素的位置。
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
top: 4
...
left
left 參數定義元素由左至右的位置，單位為 tile_size，適用於 layout: static 資訊主頁。
舉例來說，下列程式碼指定 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 參數會定義元素頂端邊緣所在的列。如果使用 group 參數將元素放置在圖塊群組中，row 會定義元素相對於群組容器頂端 (row: 0) 的列位置。
資訊主頁頂端為第 0 列。新聞版面配置資訊主頁的預設元素高度為 6 列，也就是說，資訊主頁頂端的資訊主頁元素 (row: 0) 預設會占用第 0 到 5 列。
每列高 50 像素，因此預設元素高度為 6 列，即 300 像素。
舉例來說，假設元素設為預設高度，下列程式碼會將元素設在資訊主頁的第二列元素：
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
row: 6
...
col
如果是 layout: newspaper 資訊主頁，col 參數會定義元素左側邊緣所在的資料欄。如果使用 group 參數將元素放在圖塊群組中，col 會定義元素相對於群組容器左側邊緣 (col: 0) 的欄位置。
資訊主頁分為 24 欄。資訊主頁從左側的第 0 欄開始。報紙版面配置的資訊主頁預設元素寬度為 8 欄，也就是說，資訊主頁左側的資訊主頁元素 (col: 0) 預設會占用第 0 到 7 欄。
舉例來說，下列程式碼會將元素設為資訊主頁中第三欄的元素：
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
col: 16
...
文字參數
如果資訊主頁 LookML 是透過 Looker UI 的「文字」選項建立的文字圖塊生成，就不會使用
title_text或subtitle_text參數。
本節說明的參數可用於將內容新增至 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 元素上顯示的文字，並使用最小的可用字型大小。這個參數會顯示在文字圖塊的最後。「在 Markdown 圖塊中使用 Markdown」說明文件頁面提供 Markdown 總覽，說明如何使用 Markdown 設定文字格式，或在文字圖塊中加入連結和圖片。
body_text: body text