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: tilelayout: static 信息中心中元素的高度(以 tile_size 为单位)
width(适用于元素) 针对 layout: tilelayout: static 信息中心,以 tile_size 为单位定义元素的宽度
top 针对 layout: static 信息中心,以 tile_size 为单位定义元素的自上而下位置
left 针对 layout: static 信息中心,以 tile_size 为单位定义元素的从左到右位置
row 针对 layout: newspaper 信息中心,以行数单位定义元素的自上而下位置
col 定义元素在 layout: newspaper 信息中心中的从左到右位置(以列为单位)
refresh(适用于元素) 设置元素自动刷新的间隔
note 开始 LookML 部分,以定义元素的注释。此参数具有子参数 textstatedisplay
查询参数
model 定义要用于元素查询的模型
explore(适用于元素) 定义要用于元素查询的探索
fields 定义要用于元素查询的字段。此值可代替 dimensionsmeasures 使用。
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 信息中心元素时,您必须至少为基本参数 nametype 指定值。其他基本参数(例如 titleheightwidth)会影响元素在信息中心内的外观和位置。

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 还可以用作信息中心行的一部分,如信息中心参数文档页面中所述。

对于采用 tilestatic 布局的信息中心

对于 layout: tilelayout: static 信息中心,height 参数用于定义元素的高度,单位为 tile_size(以像素为单位)。

例如,以下代码指定了 tile_size: 100height: 4,使 orders_by_date 元素的高度为 400 像素。

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    height: 4
    ...

对于采用 newspaper 布局的信息中心

对于 layout: newspaper 信息中心,height 参数用于定义元素的高度(以为单位)。

采用报纸布局的信息中心默认将元素高度设为 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 还可以用作信息中心的一部分,如信息中心参数文档页面中所述。

对于 layout: tilelayout: static 信息中心,width 参数用于定义元素的宽度(以 tile_size 为单位)。

例如,以下代码指定了 tile_size: 100width: 4,使 orders_by_date 元素的宽度为 400 像素。

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    width: 4
    ...

对于 layout: newspaper 信息中心,width 参数用于定义元素的宽度(以列为单位)。

采用报纸布局的信息中心默认宽度为 24 列。

例如,以下代码将元素设置为信息中心宽度的一半:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    width: 12
    ...

top

对于 layout: static 信息中心,top 参数用于定义元素从上到下的位置,单位为 tile_size

例如,以下代码指定了 tile_size: 100top: 4,将 orders_by_date 元素的顶部边缘定位在距离信息中心顶部 400 像素的位置。

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    top: 4
    ...

left

对于 layout: static 信息中心,left 参数用于定义元素的从左到右位置,单位为 tile_size

例如,以下代码指定了 tile_size: 100left: 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 具有子参数 textstatedisplay

text

text 子参数用于指定注释中显示的文本。文本可以本地化

state

state 子形参用于确定当注释过大而无法显示在元素宽度内的单行中时,该注释是会显示为 collapsed 还是 expanded。如果您选择 collapsed,但注释过长,则注释将以可点击的省略号 (...) 结尾,您可以使用该省略号来阅读完整注释。

display

display 子参数用于确定注释在元素上的显示位置。above 会将注释放置在元素的顶部,below 会将注释放置在元素的底部,而 hover 则要求用户将鼠标悬停在元素上才能看到注释。

查询参数

定义 LookML 信息中心元素时,您必须至少为 modelexplore 查询参数指定值。

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 参数,也可以同时使用 dimensionsmeasures 这两个参数,来指定箱线图元素所依据的维度和度量。如需详细了解如何在 Looker 界面中构建箱线图,请参阅箱线图选项文档页面的构建箱线图部分。

您可以使用本部分中介绍的其他查询参数来控制数据在信息中心元素中的显示方式。

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 参数,则无需使用 dimensionsmeasures 参数。

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 语法指定维度或衡量指标。如果您想使用 Looker 的默认排序顺序,请勿添加 sorts。降序排序的后缀为 desc;升序排序不需要后缀。

## single sort example
- name: orders_by_date
  sorts: order.order_date desc

## multiple sort example
- name: orders_by_date
  sorts: [order.order_date desc, customer.name]

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 语法)。例如,您可以创建一个名为 Date 的过滤条件,要求用户在界面中的过滤条件字段中输入日期。然后,您可以将用户输入的值应用于 orders_by_date 元素,如下所示:

- dashboard: sales_overview
  ...

  filters:
  - name: date
    type: date_filter

  elements:
 - name: orders_by_date
    listen:
      date: order.order_date
    ...

如需查看有关如何使用 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_idpalette_id 可用于向信息中心元素应用特定的颜色集合和调色板。如需大致了解 Looker 的原生颜色集合,请参阅颜色集合文档页面。

如果您知道要使用的调色板的集合 ID 和调色板 ID,则可以将这些 ID 输入到 collection_idpalette_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、信息中心或探索),然后使用界面将所需的颜色、集合或调色板应用到相应内容的可视化图表中。完成上述操作后,您可以按照获取信息中心 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