您正在查看 Looker 26.20 的說明文件。請按一下這個連結，查看最新說明文件。

Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

LookML 資訊主頁的面積圖參數

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

如要瞭解如何透過 Looker UI 建立面積圖，請參閱「面積圖選項」說明文件頁面。

應用實例


## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_area
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
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, …]
pivots: [view_name.field_name, view_name.field_name, …]
limit: N
column_limit: N
filters:
  view_name.field_name: 'Looker filter expression' | 'filter value'
listen:
  dashboard_filter_name: dimension_or_measure_name
query_timezone: 'specific timezone' | user_timezone
merged_queries:
- 'primary query definition'
- 'next source query definition'
  join_fields:
  - field_name: view_name.field_name
    source_field_name: view_name.field_name

## PLOT PARAMETERS
stacking: normal | percent | ''
interpolation: linear | monotone | step | step-before | step-after
show_null_points: true | false
discontinuous_nulls: true | false
swap_axes: true | false
hide_legend: true | false
legend_position: center | left | right
hidden_fields: [view_name.field_name, view_name.field_name, …]
limit_displayed_rows: true | false
limit_displayed_rows_values:
  show_hide: show | hide
  first_last: first | last
  num_rows: 'N'

## SERIES PARAMETERS
colors: [css_color, css_color, …]
show_view_names: true | false
point_style: none | circle | circle_outline
series_colors:
  series_name: css_color
  # Possibly more series color assignments

series_labels:
  'Series Name': desired series label
  # Possibly more series label assignments
series_types:
  series_name: column | line | area | scatter
  # Possibly more series visualization assignments
series_point_styles:
  series_name: square | diamond | triangle | triangle-down | auto

## VALUE PARAMETERS
show_value_labels: true | false
label_color: [css_color, css_color, …]
font_size: Npx
label_value_format: 'value formatting string'
hidden_series: [series_name, series_name, …]
show_silhouette: true | false

## X-AXIS PARAMETERS
x_axis_scale: auto | linear | ordinal | time
x_axis_reversed: true | false
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_label_rotation: N
x_axis_datetime_label: 'time formatting string'
x_axis_zoom: true | false

## Y-AXIS PARAMETERS
y_axis_gridlines: true | false
y_axis_reversed: true | false
reference_lines:
  # reference line options
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` 子參數
`row`	定義 `layout: newspaper` 資訊主頁中元素的由上至下位置 (以列為單位)
`col`	定義 `layout: newspaper` 資訊主頁中元素的左右位置 (以欄為單位)
查詢參數
`model`	定義用於元素查詢的模型
`explore` (用於元素)	定義要用於元素查詢的探索
`dimensions`	定義元素查詢要使用的維度
`measures`	定義要用於元素查詢的測量指標
`sorts`	定義元素查詢要使用的排序
`pivots`	定義應透視並用於元素查詢的維度
`limit`	定義元素查詢的資料列數上限
`filters` (用於元素)	定義元素查詢無法變更的篩選器
`listen`	定義可變更的元素查詢篩選器 (如果已建立 `filters` (適用於資訊主頁))
`query_timezone`	定義執行查詢時應使用的時區
`merged_queries`	定義合併結果查詢
圖表參數
`stacking`	將序列相疊，建立堆疊圖表
`interpolation`	指定要新增至線條的內插類型
`show_null_points`	指定是否要繪製空值資料點
`discontinuous_nulls`	在圖表中將空值視為空白，而非零
`swap_axes`	反轉圖表的 X 軸和 Y 軸
`hide_legend`	隱藏圖表圖例
`legend_position`	指定圖例要顯示在圖表的左側、中央或右側
`hidden_fields`	指定要在查詢中使用，但不在圖表中顯示的欄位
`limit_displayed_rows`	根據資料列在結果中的位置，顯示或隱藏圖表中的資料列
`limit_displayed_rows_values`	指定要在圖表中顯示或隱藏哪些資料列。這個參數有 `show_hide`、`first_last` 和 `num_rows` 子參數。
系列參數
`colors`	根據圖表系列顯示的順序，設定系列顏色
`show_view_names`	隱藏圖表標籤中的檢視表名稱
`point_style`	指定資料點的顯示方式
`series_colors`	根據系列名稱設定圖表系列的顏色
`series_labels`	變更系列名稱向使用者顯示的方式
`series_types`	定義各個序列的類型，混合使用圖表類型
`series_point_styles`	指定圖表資料點的形狀
值參數
`show_value_labels`	在資料點旁顯示標籤
`label_color`	指定以逗號分隔的清單，其中包含顏色值
`font_size`	設定值標籤的字型大小
`label_value_format`	指定值標籤的 Excel 樣式格式
`hidden_series`	元素載入時隱藏圖表系列
`show_silhouette`	`stacking` 設為 `normal` 時，以淺色陰影顯示已停用的序列
X 軸參數
`x_axis_scale`	指定 X 軸刻度的計算方式
`x_axis_reversed`	指定 X 軸的方向
`show_x_axis_label`	隱藏 X 軸標籤
`x_axis_label`	定義自訂 X 軸標籤
`show_x_axis_ticks`	在 X 軸上顯示刻度
`x_axis_gridlines`	從 X 軸延伸格線
`x_axis_label_rotation`	將 X 軸標籤旋轉特定角度
`x_axis_datetime_label`	如果 X 軸標籤是日期，則指定標籤的格式字串
`x_axis_zoom`	指定是否允許沿著 X 軸縮放
Y 軸參數
`y_axis_gridlines`	從 Y 軸延伸格線
`y_axis_reversed`	設定 X 軸的方向
`reference_lines`	在圖表中加入參考線
`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 查詢參數的值，且至少須使用 dimensions 參數或 measures 參數指定一個欄位。您也可以使用其他查詢參數，控管資訊主頁元素中的資料顯示方式。

`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 參數說明文件頁面。

`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]

`pivots`

pivots 參數定義了應為元素查詢透視的維度。使用 view_name.dimension_name 語法指定維度。如果查詢沒有任何 pivots，請勿加入。

## single pivot example
- name: orders_by_date
  pivots: customer.gender

## multiple pivot example
- name: orders_by_date
  pivots: [customer.gender, customer.age_tier]

`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

`merged_queries`

merged_queries 參數可讓您將多個查詢的結果合併為單一資訊主頁元素。在元素的 merged_queries 參數中定義每個來源查詢，並使用 join_fields 子參數指定結果合併方式。

以下 LookML 程式碼範例會建立type: looker_grid 的合併結果元素。在這個範例中，merged_queries 參數用於建立資訊主頁元素，將兩項獨立查詢的資料合併為單一表格圖表：

- name: merged_results_element
  title: Merged Results Tile
  type: looker_grid
  merged_queries:
  - model: ecommerce
    explore: users
    type: table
    fields: [users.state, users.count, users.city]
    sorts: [users.count desc 0]
    limit: 5000
    column_limit: 50
    query_timezone: UTC
    listen:
    - State: users.state
  - model: ecommerce
    explore: users
    type: table
    fields: [users.state, users.city]
    sorts: [users.state]
    limit: 500
    column_limit: 50
    query_timezone: UTC
    join_fields:
    - field_name: users.state
      source_field_name: users.state
    - field_name: users.city
      source_field_name: users.city
    listen:
    - State: users.state

在這個範例中，資訊主頁元素會合併兩個來源查詢的資料，這些查詢是以 ecommerce 模型中的 users 探索為基礎。主要查詢包含 users.state、users.count 和 users.city 欄位，並依 users.count 欄位排序結果。第二個來源查詢包含 users.state 和 users.city 欄位，並依 users.state 欄位排序結果。

join_field 參數會根據 users.state 和 users.city 欄位中的相符值，合併來源查詢。

listen 參數會將 State 篩選器套用至兩項查詢，讓資訊主頁檢視者選取特定州別，精細調整資訊主頁圖塊中顯示的查詢結果。

範例：合併公司資料

假設您想建立合併查詢，整合來自兩個不同探索 (company_info 和 companies) 的公司資訊。您想在每個探索的 ipo.stock_symbol、companies.name 和 companies.contact_email 欄位上彙整查詢，建立可傳回公司名稱、公司聯絡電子郵件、IPO 年份、股票代號、員工數量和職缺數量的查詢。您可以在 LookML 中定義合併查詢元素，如下所示：

- name: merged_results_element
  title: Merged Results Tile
  merged_queries:
  - model: market_research
    explore: company_info
    fields: [companies.name, companies.contact_email, ipo.public_year, ipo.stock_symbol]
    filters:
      companies.contact_email: "-NULL"
      ipo.valuation_amount: NOT NULL
    sorts: [ipo.public_year desc]
  - model: company_data
    explore: companies
    fields: [companies.name, ipo.stock_symbol, companies.contact_email,
      companies.number_of_employees, jobs.job_count]
    filters:
      companies.number_of_employees: NOT NULL
      ipo.stock_symbol: "-NULL"
      companies.contact_email: "-NULL"
    sorts: [jobs.job_count desc]
    join_fields:
    - field_name: ipo.stock_symbol
      source_field_name: ipo.stock_symbol
    - field_name: companies.name
      source_field_name: companies.name
    - field_name: companies.contact_email
      source_field_name: companies.contact_email

將篩選器套用至合併查詢元素

先前的合併查詢元素範例示範了如何使用 filters 參數，直接在每個來源查詢中套用硬式編碼篩選器。舉例來說，主要查詢中的篩選器 companies.contact_email: "-NULL" 和 ipo.valuation_amount: NOT NULL 會將結果限制為具有有效聯絡電子郵件和估值的公司。這些查詢層級篩選器會在合併查詢前預先篩選資料，使用者無法變更。

您也可以在每個來源查詢的定義中使用 listen 參數，將資訊主頁篩選器套用至合併查詢元素。舉例來說，假設您在資訊主頁層級，使用 LookML 資訊主頁的 filters 參數定義了名為 Industry 的資訊主頁篩選器：

filters:
- name: Industry
  title: Industry
  type: field_filter
  ui_config:
    type: dropdown_menu
    display: inline
  model: market_research
  explore: company_info
  field: companies.industry

如要將 Industry 篩選器套用至兩個來源查詢中的 companies.industry 欄位，請在每個合併查詢的來源查詢定義中加入 listen 參數，如下所示：

listen:
  Industry: companies.industry

舉例來說，下列程式碼範例會將 Industry 篩選器，新增至上一個範例中合併結果元素的兩個來源查詢。

- name: merged_results_element
  title: Merged Results Tile
  merged_queries:
  - model: market_research
    explore: company_info
    fields: [companies.name, companies.contact_email, ipo.public_year, ipo.stock_symbol]
    filters:
      companies.contact_email: "-NULL"
      ipo.valuation_amount: NOT NULL
    sorts: [ipo.public_year desc]
    listen:
      Industry: companies.industry
  - model: company_data
    explore: companies
    fields: [companies.name, ipo.stock_symbol, companies.contact_email,
      companies.number_of_employees, jobs.job_count]
    filters:
      companies.number_of_employees: NOT NULL
      ipo.stock_symbol: "-NULL"
      companies.contact_email: "-NULL"
    sorts: [jobs.job_count desc]
    join_fields:
    - field_name: ipo.stock_symbol
      source_field_name: ipo.stock_symbol
    - field_name: companies.name
      source_field_name: companies.name
    - field_name: companies.contact_email
      source_field_name: companies.contact_email
    listen:
      Industry: companies.industry

新增這項設定後，當使用者與「Industry」資訊主頁篩選器互動時，合併查詢元素中對應的來源查詢也會一併篩選。

繪圖參數

本節說明的大多數參數，都對應到面積圖圖表編輯器中「繪圖」部分的選項。

`stacking`

stacking 參數會指定系列在圖表上的視覺化分群方式。

normal：將長條、線條和資料點堆疊在一起，就像一般的堆疊柱狀圖。
percent：堆疊長條、線條和資料點，填滿圖表的 100%，並將 Y 軸值設為百分比。
''：長條、線條和點不會堆疊，而是分組。

stacking: normal | percent | ''

## default value: ''

`interpolation`

interpolation 參數會指定要顯示的內插線類型。

linear：在資料點間繪製直線。
monotone：在資料點之間顯示平滑曲線。
step、step_before 或 step_after：顯示以階梯連接的資料點，資料點位於階梯的中間、開頭或結尾。

interpolation: linear | monotone | step | step-before | step-after

## default value: linear

`show_null_points`

show_null_points 參數會決定是否要繪製具有空值的點。如果設為 true，空值會繪製在 Y 軸的零點。如果設為 false，系統完全不會繪製空值，圖表會在空值點前後的資料點之間繪製一條直線。如果想讓圖表顯示空值，請考慮使用 discontinuous_nulls: true。

show_null_points: true | false

## default value: true

`discontinuous_nulls`

這個參數可讓您將空值視為圖表上的空白空間，而不是零 (如要將空值顯示為零或忽略，請使用 show_null_points)。

discontinuous_nulls: true | false

## default value: false

如果 stacking 設為 normal 或 percent，這項參數就不會生效。此外，由於 show_null_points 與 discontinuous_nulls 互斥，因此也無法與 show_null_points: true 搭配使用。

`swap_axes`

交換一般設定的 X 軸和 Y 軸。交換軸後，維度會繪製在 Y 軸上，測量指標則會繪製在 X 軸上。

swap_axes: true | false

## default value: false

`hide_legend`

這個宣告會隱藏圖表中的圖例。

hide_legend: true | false

## default value: false

`legend_position`

如果 hide_legend 設為 false (且有多個系列)，您可以使用 legend_position 參數，指定系列圖例要顯示在圖表的左側、中央或右側。

legend_position: center | left | right

## default value: false

`hidden_fields`

hidden_fields 參數會指出查詢中使用的欄位 (如有)，但這些欄位不會顯示在圖表中。任何隱藏欄位都會顯示在「探索」的資料表部分。

hidden_fields: [inventory_items.count, distribution_centers.id]

`limit_displayed_rows`

limit_displayed_rows 參數可讓您根據資料列在結果中的位置，在圖表中顯示或隱藏資料列。舉例來說，如果圖表顯示 7 天累計平均，您可能需要隱藏前 6 列。如果將這個參數設為 true，您就能使用 limit_displays_rows_values 參數及其子參數，指定圖表中要套用這項設定的值和位置。

limit_displayed_rows: true
limit_displayed_rows_values:
  show_hide: hide | show
  first_last: first | last
  num_rows: '10'

`limit_displayed_rows_values`

使用 limit_displayed_rows_values 參數及其子參數 show_hide、first_last 和 num_rows，搭配 limit_displayed_rows 指定要在圖表中顯示或隱藏哪些資料列。如需使用範例，請參閱「limit_displayed_rows」一節。

`show_hide`

show_hide 子參數可設定是否在圖表中隱藏特定資料列。將 show_hide 設為 show，圖表就只會顯示部分資料列；將 show_hide 設為 hide，則可從圖表中排除特定資料列。

`first_last`

first_last 子參數會設定要隱藏或顯示的資料列，是結果集中的第一列或最後一列。將 first_last 設為 first 會顯示或隱藏前幾列，first_last設為 last 則會顯示或隱藏後幾列。

`num_rows`

num_rows 子參數會設定要隱藏或顯示的列數。舉例來說，num_rows: '10' 會顯示或隱藏圖表結果集的前 10 列或後 10 列。

系列參數

本節所述參數對應至面積圖圖表編輯器中「序列」部分的選項。

`colors`

colors 參數會指定數列的顏色清單。清單中的第一個顏色對應第一個資料序列。如果系列數量超過列出的顏色數量，系統會從頭開始重複使用顏色。


colors: [blue, orange, yellow, red, purple]

對於所有指定顏色的圖表屬性，顏色值可以採用十六進位字串 (例如 #2ca6cd) 或 CSS 具名顏色字串 (例如 mediumblue)。

`show_view_names`

show_view_names 參數會決定是否在圖表標籤 (例如軸名稱和欄名稱) 中顯示檢視表名稱。

show_view_names: true | false

## default value: true

`point_style`

point_style 參數會指定資料點的顯示方式。可用選項如下：

none：適用於折線圖和面積圖。不顯示點數。
circle：顯示實心圓。
circle_outline：顯示外框圓圈。

`series_colors`

使用 name: value 組合，根據系列名稱設定系列顏色。

如果是透視圖表，系列名稱就是透視名稱。

series_colors:
  'Yes': skyblue
  'No': '#000000'

如果圖表有多個測量指標，系列名稱就是測量指標欄位名稱。

series_colors:
  inventory_items.count: crimson
  orders.count: green

如果 series_colors 中未列出系列名稱，圖表會預設為 colors 中提供的顏色清單。如未設定 colors，圖表會改用預設色彩配置。

`series_labels`

使用 name: label 配對，根據系列名稱設定一或多個系列的標籤。

如果是透視圖表，系列名稱就是透視名稱。

series_labels:
  'Yes': iOS Users
  'No': Android Users

如果圖表有多個測量指標，系列名稱就是測量指標欄位名稱。

series_labels:
  inventory_items.count: Inventory
  orders.count: Orders

`series_types`

series_type 參數可讓您在同一個圖表中使用不同的笛卡兒圖表類型。使用這個參數，為要變更的每個序列指派圖表類型。類型選項包括 line、column、bar、area 和 scatter。

series_types:
  series_a_name: column
  series_b_name: line

所有序列都會預設為你選擇的初始圖表類型，你可以視需要修改個別序列。

`series_point_styles`

指定折線、面積或散布系列類型的圖表點形狀。series_point_styles 可設為 square、diamond、triangle、triangle-down 或 auto。


series_point_styles:
  users.count: triangle

值參數

本節說明的參數，對應到面積圖圖表編輯器中「值」部分的選項。

`show_value_labels`

在資料點旁顯示長條、線條或點的值。

show_value_labels: true | false

## default value: false

`labelColor`

如果 labelColorEnabled 設為 true，請使用 labelColor 參數指定標籤和百分比的自訂顏色。labelPosition 設為 inline 的標籤會以所選顏色顯示，圖表兩側的標籤則會比所選顏色深約 40%。


labelColor: "#4FBC89"

`font_size`

使用任何有效的 CSS 大小 (例如 10px 或 12px) 設定值標籤的字型大小。


font_size: 14px

`label_value_format`

label_value_format 參數會指定要套用至值的格式，與套用至基礎維度或測量指標的任何格式無關。這個欄位接受 Excel 樣式格式設定。如未指定 label_value_format，系統會以基礎維度或測量指標的格式顯示值。

如要瞭解如何指定這些格式，請參閱這個說明文件頁面。不過，Looker 不支援顏色格式設定。

label_value_format LookML 資訊主頁參數使用的格式與 value_format LookML 參數使用的格式相同，但 value_format LookML 參數需要將格式字串括在雙引號中。


label_value_format: '0.00'

`hidden_series`

hidden_series 參數指定圖表中要停用的序列，也就是說，該序列會顯示在圖表圖例中，但會呈現灰色。使用者只要在圖表圖例中點選已停用的系列，即可啟用。因此，hidden_series 可能無法與 hide_legend: true 搭配運作。

如果是透視圖表，系列名稱就是透視名稱：

hidden_series: ['Yes', 'No']

如果圖表有多個測量指標，系列名稱就是測量指標欄位名稱：

hidden_series: [inventory_items.count, orders.count]

與 show_silhouette 參數搭配使用時，您可以指定是否要在圖表中以淺色陰影顯示停用的序列。

`show_silhouette`

如果 show_silhouette 參數設為 true，且 stacking 設為 normal，停用的序列會顯示為淺色陰影輪廓。


show_silhouette: true | false

X 軸參數

本節所述參數對應至面積圖圖表編輯器中「X 區段」的選項。

`x_axis_scale`

這項參數會決定 X 軸刻度的計算方式。

auto：系統會根據基礎資料推論尺度。這是預設設定。
linear：尺度會繪製為線性數值資料。如果基礎資料無法轉換成數字，就無法使用這項功能。
ordinal：資料會以間隔平均的離散項目繪製。
time：資料會以時間形式繪製，且軸會加上適當標籤。如果基礎資料無法轉換為日期，則無法使用這項功能。

x_axis_scale: auto | linear | ordinal | time

## default value: auto

`x_axis_reversed`

這個參數會設定 X 軸的方向。x_axis_reversed 設為 false 時，值會由左至右遞增。如果設為 true，值會由左至右遞減。


x_axis_reversed: true | false

`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_label_rotation`

x_axis_label_rotation 參數會定義 X 軸標籤的旋轉角度。這項參數可設為 -360 到 360 之間的值，代表標籤旋轉的角度。

x_axis_label_rotation: -45

`x_axis_datetime_label`

如果 X 軸標籤是日期，這個參數會指定 X 軸標籤的格式字串。如果 x_axis_scale 未設為 time，則不會執行任何操作。


x_axis_datetime_label: '%b %d'

如要瞭解如何設定時間格式，請參閱「圖表的時間格式」說明文件頁面。

`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 軸參數

施工中：我們正在更新這個頁面部分。同時，您可以查看面積圖選項說明文件頁面，瞭解 Y 軸的對等圖表選單選項。

本節所述參數對應至面積圖圖表編輯器中「Y 區段」的選項。

`y_axis_gridlines`

這個參數會決定是否從 Y 軸延伸格線。

y_axis_gridlines: true | false

## default value: true

`y_axis_reversed`

這個參數會設定 Y 軸的方向。y_axis_reversed 設為 false 時，值會沿著軸向上遞增。如果設為 true，值會沿著軸向下遞減。


## y_axis_reversed: true | false

# default value: false

`reference_lines`

這個參數會指定一組值，用於指定參考線和區域。

如要瞭解如何設定參考線，請參閱「資訊主頁參考線參數」說明文件頁面。


reference_lines:
   # reference line options

`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

LookML 資訊主頁的面積圖參數 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

應用實例

參數定義

基本參數

name

title

type

height

適用於採用 tile 或 static 版面配置的資訊主頁

適用於採用newspaper版面配置的資訊主頁

width

top

left

row

col

refresh

note

text

state

display

查詢參數

model

explore

dimensions

measures

sorts

pivots

limit

filters

listen

query_timezone

merged_queries

範例：合併公司資料

將篩選器套用至合併查詢元素

繪圖參數

stacking

interpolation

show_null_points

discontinuous_nulls

swap_axes

hide_legend

legend_position

hidden_fields

limit_displayed_rows

limit_displayed_rows_values

show_hide

first_last

num_rows