LookML 資訊主頁的箱形圖表參數

本頁說明如何在 dashboard.lkml 檔案中,使用 LookML 資訊主頁參數新增及自訂 type: looker_boxplot 的 LookML 資訊主頁元素。

如要瞭解如何透過 Looker 使用者介面建立盒鬚圖,請參閱「盒鬚圖選項」說明文件頁面。

應用實例

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 (適用於元素) 以 tile_size 為單位,定義 layout: tile 和 layout: static 資訊主頁的元素寬度
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 參數中的名稱。

- 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

如要瞭解不同類型的 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 參數會以 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 像素。

舉例來說,假設元素的高度設為預設值,以下程式碼會將元素設在資訊主頁的第二列元素上:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    row: 6
    ...

col

如果是 layout: newspaper 資訊主頁,col 參數會定義元素左側邊緣所在的資料欄。

資訊主頁會分成 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,依據第一個樞紐分析表欄排序:

- 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

資訊主頁篩選器可讓檢視者互動式地篩選資訊主頁元素中顯示的資料。使用 filters 參數定義 LookML 資訊主頁的資訊主頁篩選條件。接著,使用 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,可以將這些 ID 輸入 collection_id 和 palette_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

您也可以使用 UI 尋找所需顏色、集合或調色盤,並產生 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 萬。
$# 美元 (小數位數為 0,例如 $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