本頁說明如何使用 dashboard.lkml 檔案中的 LookML 資訊主頁參數,新增及自訂 type: looker_boxplot 的 LookML 資訊主頁元素。
如要瞭解如何透過 Looker UI 建立盒鬚圖,請參閱「盒鬚圖選項」說明文件頁面。
應用實例
N 表示必須輸入數值。單引號表示說明文字,不應包含在實際程式碼中。
## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_boxplot
height: N
width: N
top: N
left: N
row: N
col: N
refresh: N (seconds | minutes | hours | days)
note:
text: 'note text'
state: collapsed | expanded
display: above | below | hover
## QUERY PARAMETERS
model: model_name
explore: explore_name
fields: [view_name.field_name, view_name.field_name, view_name.field_name, …]
dimensions: [view_name.field_name, view_name.field_name, …]
measures: [view_name.field_name, view_name.field_name, …]
sorts: [view_name.field_name asc | desc, view_name.field_name, …]
limit: N
filters:
view_name.field_name: 'looker filter expression'
listen:
dashboard_filter_name: view_name.field_name
query_timezone: 'specific timezone' | user_timezone
hidden_fields: [view_name.field_name, view_name.field_name, …]
## SERIES PARAMETERS
color_application:
collection_id: 'collection ID'
palette_id: 'palette ID'
options:
reverse: true | false
## STYLE PARAMETERS
show_view_names: true | false
## X-AXIS PARAMETERS
show_x_axis_label: true | false
x_axis_label: 'desired x-axis label'
show_x_axis_ticks: true | false
x_axis_gridlines: true | false
x_axis_reversed: true | false
x_axis_zoom: true | false
## Y-AXIS PARAMETERS
show_y_axis_labels: true | false
y_axis_labels: ['desired y-axis label']
show_y_axis_ticks: true | false
y_axis_gridlines: true | false
y_axis_min: ['N']
y_axis_max: ['N']
y_axis_tick_density: default | custom
y_axis_tick_density_custom: 'N'
y_axis_reversed: true | false
y_axis_value_format: ['Excel-style formatting']
y_axis_zoom: true | false
## ADVANCED VISUALIZATION CONFIGURATION PARAMETERS
advanced_vis_config: 'Highcharts JSON snippet'
參數定義
| 參數名稱 | 說明 | |
|---|---|---|
| 基本參數 | ||
name (用於元素) |
建立元素 | |
title (用於元素) |
變更元素名稱向使用者顯示的方式 | |
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 資訊主頁中元素的左右位置,單位為欄 |
|
refresh (用於元素) |
設定元素自動重新整理的間隔時間 | |
note |
啟動某一個 LookML 區塊,定義元素的附註。這個參數有子參數 text、state 和 display。 |
|
| 查詢參數 | ||
model |
定義用於元素查詢的模型 | |
explore (用於元素) |
定義要用於元素查詢的探索 | |
fields |
定義要用於元素查詢的欄位。這項功能可取代 dimensions 和 measures。 |
|
dimensions |
定義元素查詢要使用的維度 | |
measures |
定義要用於元素查詢的測量指標 | |
sorts |
定義元素查詢要使用的排序 | |
limit |
定義元素查詢的資料列數上限 | |
filters (用於元素) |
定義元素查詢無法變更的篩選器 | |
listen |
定義可變更的元素查詢篩選器 (如果已建立 filters (適用於資訊主頁)) |
|
query_timezone |
定義執行查詢時應使用的時區 | |
hidden_fields |
指定要在查詢中使用,但不在圖表中顯示的欄位 | |
| 系列參數 | ||
color_application |
將顏色集合和調色盤套用至圖表 | |
| 樣式參數 | ||
show_view_names |
顯示或隱藏圖表標籤中的檢視表名稱 | |
| X 軸參數 | ||
show_x_axis_label |
顯示或隱藏 X 軸標籤 | |
x_axis_label |
定義自訂 X 軸標籤 | |
show_x_axis_ticks |
在 X 軸上顯示值 | |
x_axis_gridlines |
從 X 軸延伸格線 | |
x_axis_reversed |
反轉 X 軸方向 | |
x_axis_zoom |
指定是否允許沿著 X 軸縮放 | |
| Y 軸參數 | ||
show_y_axis_labels |
顯示或隱藏 Y 軸標籤 | |
y_axis_labels |
定義自訂 Y 軸標籤 | |
show_y_axis_ticks |
在 Y 軸上顯示值 | |
y_axis_gridlines |
從 Y 軸延伸格線 | |
y_axis_min |
定義 Y 軸的最小值 | |
y_axis_max |
定義 Y 軸的最大值 | |
y_axis_tick_density |
啟用選項,使用 y_axis_tick_density_custom 參數設定自訂 Y 軸刻點密度 |
|
y_axis_tick_density_custom |
y_axis_tick_density 設為 custom 時,定義 Y 軸刻度的密度 |
|
y_axis_reversed |
反轉 Y 軸方向 | |
y_axis_value_format |
定義 Y 軸值的數字格式 | |
y_axis_zoom |
指定是否允許沿著 Y 軸縮放。如果 x_axis_zoom: false,則停用。 |
|
| 進階圖表設定參數 | ||
advanced_viz_config |
接受 HighCharts JSON 程式碼片段,可覆寫多項圖表設定 | |
基本參數
定義 LookML 資訊主頁元素時,您至少必須指定基本參數 name 和 type 的值。其他基本參數 (例如 title、height 和 width) 會影響資訊主頁上元素的外觀和位置。
name
本節說明資訊主頁元素中的
name參數。
name也可以做為資訊主頁篩選器的一部分,詳情請參閱「資訊主頁參數」說明文件頁面。
每個 name 宣告都會建立新的資訊主頁元素,並指派名稱。元素名稱不得重複。使用 layout: grid 資訊主頁時,名稱有時會出現在 elements 參數中;將元素整理成圖塊群組 (type: group) 時,名稱則會出現在子元素的 group 參數中。
- name: orders_by_date
title
本節說明資訊主頁元素中的
title參數。
title也可以做為資訊主頁的一部分,詳情請參閱「資訊主頁參數」說明文件頁面。
title也可以做為資訊主頁篩選器的一部分,詳情請參閱「資訊主頁參數」說明文件頁面。
title 參數可讓您變更元素名稱向使用者顯示的方式。如未指定,標題會預設為 name 元素。
請參閱以下範例:
- name: sales_overview
title: '1) Sales Overview'
如果使用這種格式,元素就不會顯示為「銷售總覽」,而是「1) 銷售總覽」。
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
...
refresh
本節說明資訊主頁元素中的
refresh參數。
refresh也可以做為資訊主頁的一部分,詳情請參閱「資訊主頁參數」說明文件頁面。
refresh 參數可讓元素定期自動重新載入,藉此擷取最新資料。如果資訊主頁會持續顯示 (例如在辦公室電視上),這項功能通常很有幫助。請注意,您必須在瀏覽器視窗中開啟資訊主頁,這個參數才會生效。這項設定不會在背景執行,以「預熱」資訊主頁快取。
重新整理頻率可以設為任何數字 (不含小數),單位為秒、分、時或天。例如:
- name: orders_by_date
refresh: 2 hours
設定較短的重新整理間隔時,請務必謹慎。如果元素背後的查詢需要大量資源,某些元素可能會對資料庫造成過大負擔。
note
您可以為元素加上說明備註,如下所示:
- name: element_name
note:
text: 'note text'
state: collapsed | expanded
display: above | below | hover
note 包含子參數 text、state 和 display。
text
text 子參數會指定附註中顯示的文字。文字可以本地化。
state
state 子參數會決定附註是否會collapsed或expanded (如果附註太大,無法在元素寬度內顯示在單一列中)。如果選擇「collapsed」,且附註過長,附註結尾會顯示可點選的刪節號 (...),點選後即可閱讀完整附註。
display
display 子參數會決定附註在元素上的顯示位置。above 會將附註放在元素頂端,below 會將附註放在元素底部,hover 則需要使用者將滑鼠游標懸停在元素上,才能看到附註。
查詢參數
定義 LookML 資訊主頁元素時,您必須至少指定 model 和 explore 查詢參數的值。
type: looker_boxplot 的元素也需要至少一個維度,以及下列兩、三或五種度量 (必須依此順序排列):
- 最小值:代表資料最小值的測量結果。在 LookML 中,這可以定義為
type: min的測量指標。 - 第 25 百分位數:代表第 25 百分位數或第一四分位數的測量值。有四分之一的資料值小於或等於這個值。這可以在 LookML 中定義為
type: percentile的測量指標,並將percentile的值設為25。 - 中位數:代表資料集中位數或中點,或第二四分位數。有一半的資料值小於或等於這個值,在 LookML 中,這可以定義為
type: median的測量指標。 - 第 75 個百分位數:代表第 75 個百分位數或第三四分位數的測量值。四分之三的資料值小於或等於這個值。這可以在 LookML 中定義為
type: percentile的測量指標,並將percentile的值設為75。 - 最大值:代表最大值的測量指標。在 LookML 中,這可以定義為
type: max的測量指標。
您可以使用 fields 參數,或同時使用 dimensions 和 measures 參數,指定盒鬚圖元素依據的維度和測量指標。如要進一步瞭解如何在 Looker UI 中建立盒鬚圖,請參閱「盒鬚圖選項」說明文件頁面的「建立盒鬚圖」一節。
您可以使用本節所述的其他查詢參數,控制資料在資訊主頁元素中的顯示方式。
model
model 參數定義了元素查詢要使用的模型。如未指定,則預設為資訊主頁所在的模型。
- name: orders_by_date
model: ecommerce
model 參數接受 LookML 常數。您可以在專案的資訊清單檔案中定義常數,然後使用 "@{constant_name}" 語法將常數設為 model 的值。使用常數可讓您在一個地方定義模型名稱,如果有多個資訊主頁元素使用同一個模型,而您要更新模型名稱,這個方法特別實用。
如需更多資訊和 LookML 資訊主頁使用常數的範例,請參閱 constant 參數說明文件頁面。
explore
本節說明資訊主頁元素中的
explore參數。
explore也可以做為模型的一部分,詳情請參閱explore參數說明文件頁面。
explore也可以做為資訊主頁篩選器的一部分,詳情請參閱「資訊主頁參數」說明文件頁面。
explore 參數定義了要用於元素查詢的探索。
- name: orders_by_date
explore: order
explore 參數接受 LookML 常數。您可以在專案的資訊清單檔案中定義常數,然後使用 "@{constant_name}" 語法將常數設為 explore 的值。使用常數可讓您在一個位置定義探索名稱,如果有多個資訊主頁元素使用同一個探索,而您要更新該探索的名稱,這個方法就特別實用。
如需更多資訊和 LookML 資訊主頁使用常數的範例,請參閱 constant 參數說明文件頁面。
fields
fields 參數定義了用於元素查詢的欄位。使用語法 view_name.dimension_name 指定欄位。
## single field example
- name: orders_by_date
fields: order.order_date
## multiple fields example
- name: orders_by_date
fields: [order.order_date, order.order_count]
如果使用 fields 參數,就不需要使用 dimensions 和 measures 參數。
dimensions
dimensions 參數定義了元素查詢要使用的維度。使用 view_name.dimension_name 語法指定維度。如果查詢沒有任何 dimensions,請勿加入。
## single dimension example
- name: orders_by_date
dimensions: order.order_date
## multiple dimension example
- name: orders_by_date
dimensions: [order.order_date, customer.name]
measures
measures 參數定義了元素查詢要使用的測量指標。請使用 view_name.measure_name 語法指定測量指標。如果查詢沒有任何 measures,請勿加入。
## single measure example
- name: orders_by_date
measures: order.count
## multiple measure example
- name: orders_by_date
measures: [order.count, order_item.count]
sorts
sorts 參數會定義元素查詢的排序行為。請先列出主要排序欄位,再列出次要排序欄位。使用 view_name.field_name 語法指定要排序的維度或測量指標。
如果省略 sorts 參數,元素會使用 Looker 的預設排列順序。遞增排序不需要後置字串,遞減排序則需要 desc 後置字串。
以下範例定義了單一排序:
- name: orders_by_date
sorts: order.order_date desc
以下範例定義了多個排序:
- name: orders_by_date
sorts: [order.order_date desc, customer.name]
如果透視維度,您可以指定指標名稱、排序方向,以及資料表中目標資料欄的 0 索引編號,藉此排序查詢結果。舉例來說,下列元素會使用索引 0,依第一個資料透視欄排序:
- name: orders_by_category
sorts: [orders.count desc 0]
如要依資料列總計排序,請指定總計欄的索引。舉例來說,下列元素會使用索引 2 依資料列總數排序,代表含有兩個資料透視欄的查詢總數欄:
- name: orders_by_cohort
sorts: [users.count desc 2]
limit
limit 參數定義了元素查詢應使用的資料列限制。這項限制適用於套用任何資料透視之前的資料列數量。
- name: orders_by_date
limit: 100
filters
本節說明資訊主頁元素中的
filters參數。
filters也可以做為資訊主頁的一部分,詳情請參閱「資訊主頁參數」說明文件頁面。
filters也可以做為測量指標的一部分,詳情請參閱filters參數說明文件頁面。
filters 參數定義了元素查詢應使用的不可變更篩選條件。如要讓使用者可以在資訊主頁中變更篩選器,請使用資訊主頁的 filters 設定篩選器,然後使用 listen 將篩選器套用至元素。
filters 的語法如下:
- name: element_name
filters:
orders.created_date: 2020/01/10 for 3 days
orders.status: Shipped
# You can create multiple filter statements
每個篩選器都能接受 Looker 篩選運算式或值常數。您也可以在篩選運算式中使用 _localization 或 _user_attributes Liquid 變數,彈性設定篩選值。
listen
檢視者可透過資訊主頁篩選器,以互動方式調整資訊主頁元素中顯示的資料。使用 LookML 資訊主頁的 filters 參數定義資訊主頁篩選器。接著,使用 listen 參數將資訊主頁元素連結至資訊主頁篩選器。
listen 的語法如下:
- name: element_name
listen:
filter_name_goes_here: dimension or measure on which to apply
the filter using view_name.field_name syntax
# You can add more than one listen statement
請在元素中加入 listen 參數,然後提供篩選器名稱,後面加上冒號,並使用 view_name.field_name 語法參照要套用篩選器的欄位。舉例來說,您可以建立名為「日期」的篩選器,要求使用者在 UI 的篩選器欄位中輸入日期。接著,您可以將使用者輸入的值套用至 orders_by_date 元素,如下所示:
- dashboard: sales_overview
...
filters:
- name: date
type: date_filter
elements:
- name: orders_by_date
listen:
date: order.order_date
...
如果監聽的篩選器已設定 vis_filter: true 參數,篩選器控制項會直接顯示在圖表圖塊頂端的篩選器列中,而非資訊主頁頂端的篩選器列。
如需更多範例,瞭解如何使用 filters 參數和 listen 參數,將資訊主頁篩選器套用至個別資訊主頁元素,請參閱「建構 LookML 資訊主頁」。
query_timezone
query_timezone 參數會指定執行查詢的時區。時區選項會顯示在「timezone 的值」說明文件頁面。如要使用檢視者的時區執行查詢,可以將值指派為 user_timezone。
- name: orders_by_date
query_timezone: America/Los Angeles
- name: orders_by_customer
query_timezone: user_timezone
hidden_fields
hidden_fields 參數會指出查詢中使用的欄位 (如有),但這些欄位不會顯示在圖表中。任何隱藏欄位都會顯示在「探索」的資料表部分。
hidden_fields: [inventory_items.count, distribution_centers.id]
系列參數
color_application
color_application 參數及其子參數 collection_id 和 palette_id 可用於將特定顏色集合和調色盤套用至資訊主頁元素。如要概略瞭解 Looker 的原生顏色集合,請參閱「顏色集合」說明文件頁面。
如果您有要使用的調色盤集合 ID 和調色盤 ID,可以在 collection_id 和 palette_id 子參數中輸入這些 ID。集合 ID 或調色盤 ID 可以是英數字元代碼,也可以根據顏色集合的名稱產生。Looker 的原生集合會使用英數字元代碼。這些網址是執行個體專屬,格式如下:
color_application:
collection_id: 1297dk12-86a7-4xe0-8dfc-82de20b3806a
palette_id: 93c8aeb7-3f8a-4ca7-6fee-88c3617516a1
自訂顏色集合會根據顏色集合的名稱使用集合和調色盤 ID,這些 ID 可在執行個體之間轉移,如下所示:
color_application:
collection_id: blue-tone-collection
palette_id: blue-tone-collection-categorical-0
您也可以透過使用者介面,找出想要的顏色、集合或調色盤,並產生 LookML,將這些項目新增至資訊主頁。前往使用者定義的內容 (例如 Look、資訊主頁或探索),並使用 UI 將所需顏色、集合或調色盤套用至該內容的圖表。完成後,請按照步驟取得資訊主頁 LookML,複製產生的 LookML,然後貼到 color_application 區段。
根據預設,指定調色盤的第一個顏色會套用至整個盒鬚圖元素。選用子參數 reverse 會將應用程式切換為調色盤中的最後一個顏色。
color_application:
collection_id: blue-tone-collection
palette_id: blue-tone-collection-categorical-0
options:
reverse: true
樣式參數
show_view_names
show_view_names 參數會決定是否在圖表標籤 (例如軸名稱和欄名稱) 中顯示檢視表名稱。
show_view_names: true | false
## default value: true
X 軸參數
show_x_axis_label
這項參數決定是否顯示 X 軸標籤。
show_x_axis_label: true | false
## default value: true
x_axis_label
這個參數會指定 X 軸的標籤。show_x_axis_label 設為 true 時,您可以使用這項參數。
x_axis_label: Order Date
show_x_axis_ticks
這個參數決定是否在 X 軸顯示值標籤。
show_x_axis_ticks: true | false
## default value: true
x_axis_gridlines
這個參數會決定是否從 X 軸延伸格線。
x_axis_gridlines: true | false
## default value: false
x_axis_reversed
這個參數會設定 X 軸的方向。x_axis_reversed 設為 false 時,值會由左至右遞增。如果設為 true,值會由左至右遞減。
x_axis_reversed: true | false
x_axis_zoom
這項參數會指定使用者能否放大圖表的 X 軸。x_axis_zoom 設為 true 時,即可縮放。x_axis_zoom 設為 false 時,無法使用縮放功能。
如果 x_axis_zoom 設為 false,系統會停用 y_axis_zoom。
x_axis_zoom: true | false
# default value: true
Y 軸參數
show_y_axis_labels
這個參數決定是否在 Y 軸上顯示標籤。
show_y_axis_labels: true | false
## default value: true
y_axis_labels
這個參數會指定 y 軸的標籤。show_y_axis_labels 設為 true 時,您可以使用這項參數。
y_axis_labels: ['label']
show_y_axis_ticks
這項參數決定是否要在 Y 軸上顯示值。
show_y_axis_ticks: true | false
## default value: true
y_axis_gridlines
這個參數會決定是否從 Y 軸延伸格線。
y_axis_gridlines: true | false
## default value: true
y_axis_min
這個參數會定義 Y 軸的最小值。
y_axis_min: ['10']
## default value: true
y_axis_max
這個參數定義了 Y 軸的最大值。
y_axis_max: ['100']
## default value: true
y_axis_tick_density
這個參數可啟用設定 Y 軸刻點密度的選項。將 y_axis_tick_density 設為 custom 即可啟用這項功能,然後使用 y_axis_tick_density_custom 參數設定密度。
y_axis_tick_density: default | custom
## default value: default
y_axis_tick_density_custom
如果 y_axis_tick_density 設為 custom,您可以使用這個參數設定 Y 軸刻度的密度。這個屬性接受整數,代表要顯示的刻度數量。
y_axis_tick_density_custom: 10
## default value: 5
y_axis_reversed
這個參數會設定 Y 軸的方向。y_axis_reversed 設為 false 時,值會沿著軸向上遞增。如果設為 true,值會沿著軸向下遞減。
## y_axis_reversed: true | false
# default value: false
y_axis_value_format
這項參數會指定 Y 軸值的數字格式,不受基礎維度或測量指標影響。這個參數接受 Excel 樣式格式設定。如未指定格式,系統會以基礎維度或測量指標的格式顯示值。
為 y_axis_value_format 參數指定的值必須用雙引號括住:
y_axis_value_format: "*00#.00"
如要瞭解如何指定這些格式,請參閱 Excel 說明文件中的完整指南。不過,Looker 目前不支援日期和顏色格式設定。
以下列出一些最常見的格式設定選項:
| 值的格式 | 意義 |
|---|---|
# |
整數 (123) |
*00# |
整數,補零至 3 位數 (001) |
0.## |
最多到小數點後 2 位的數值 (1.、1.2 或 1.23) |
0.00 |
到小數點後 2 位的數值 (1.23) |
*00#.00 |
數字補零至 3 位,且精確到小數點後 2 位 (01.23) |
#,### |
數字,千位數之間有逗號 (1,234) |
#,##0.00 |
千位數之間有逗號,且到小數點後 2 位 (1,234.00) |
0.000,," M" |
以百萬為單位的數字,精確到小數點後 3 位 (1.234 M)。系統會自動除以 100 萬。 |
$# |
美元,不含小數 ($123) |
$0.00 |
到小數點後 2 位的美元 ($123.00) |
$#,##0.00 |
美元,千位數之間有逗號,小數點後有 2 位數 ($1,234.00) |
#% |
到小數點後 0 位的百分比 (1%)。系統會自動乘以 100。 |
0.00% |
到小數點後 2 位的百分比 (1.00%)。系統會自動乘以 100。 |
0.00\% |
到小數點後 2 位的百分比 (1.00%)。系統「不會」自動乘以 100。 |
y_axis_zoom
這項參數會指定使用者能否放大圖表的 Y 軸。y_axis_zoom 設為 true 時,即可縮放。
如果 y_axis_zoom 設為 false,使用者就無法放大 Y 軸的較小部分。不過,如果 x_axis_zoom 參數設為 true,使用者仍可放大 X 軸的較小部分。
如果 x_axis_zoom 設為 false,系統會停用 y_axis_zoom。
y_axis_zoom: true | false
# default value: true
進階視覺化設定
本節說明的參數對應至選用的圖表設定覆寫值,您可以在圖表編輯器的「繪圖」部分,點選「編輯圖表設定」按鈕,將這些覆寫值套用至圖表。
advanced_vis_config
這個參數接受 HighCharts JSON 程式碼片段,可覆寫多項圖表設定,並啟用新功能。如需使用 HighCharts JSON 達成常見用途的範例,請參閱「使用圖表設定編輯器自訂圖表」說明文件頁面。
advanced_vis_config: "{ series: [{ formatters: [{ select: 'value >= 50', style: { color: 'orange' } }]}]}"
# This example changes the color to orange for any series value that is greater than or equal to 50.
# default value: null