可视化图表提示默认显示所选维度和测量的值,可帮助用户了解单点数据的重要性。
例如,如果地图可视化图表基于总毛利润按州分组,则当用户将鼠标悬停在加利福尼亚州上时,该图表的提示将显示这两个字段的值。
但是,如果您想在提示中添加默认值以外的字段,以便用户无需查看其他位置即可获取有关数据点的更多信息或上下文,该怎么办?
您可以自定义提示,以显示多个指定字段(包括“探索”查询中不包含的字段)中的值。
原料
- 液态变量 - 液态变量可结合现有的“探索”查询来呈现其他字段的值。
html
参数 - 当用户将鼠标悬停在可视化图表上时,在测量的html
参数中定义的字段将显示在提示中。- 可视化 - 在某些可视化类型中,当用户将光标悬停在数据点上时,就会显示提示。
前提条件
自定义提示需要满足以下要求:
- 拥有创建探索的权限以及开发 LookML 的权限。
- 了解 SQL 和 LookML 开发。
- 具备在 Looker 和 HTML 编码中使用 Liquid 的基础知识。如需了解必要的背景信息,请访问
html
文档页面的在html
参数中使用 Liquid 变量部分。 - 拥有保存内容的权限(如果您想将可视化图表保存为 Look 或信息中心)
提示自定义的注意事项
自定义提示时,请务必考虑以下事项:
html
参数的值将成为可视化图表的 y 轴。- 您希望在 y 轴上显示的值应该是测量的
sql
参数的值。 - 当您使用任何格式化的测量(
type: percent_of_total
的测量或带有value_format_name
或value_format
参数的测量)时,请务必对呈现的值{{ field_name._rendered_value }}
使用 Liquid 语法(其中field_name
是测量或维度的实际名称)。
示例
默认情况下,可视化数据点的提示将包含总毛利润和州的值。不过,如果您想向用户提供地图上未显示或“探索”查询中未包含的其他信息,该怎么办?如果您想包含“总毛利润百分比”(而不是“状态”)字段的值,该怎么办?添加占总毛利润百分比有助于用户了解单个数据点的总毛利润值与整个数据集的总毛利润相比如何。
如需自定义提示,请按以下步骤操作:
measure: total_gross_margin {
type: sum
value_format_name: decimal_2
sql: ${gross_margin} ;;
html: {{ rendered_value }} | {{percent_of_gross_margin._rendered_value }} of total ;;
}
在开发模式下,前往要自定义的字段的 LookML 定义。
您可以从“探索”直接导航到字段的 LookML 定义。
除了原始字段之外,确定您希望在提示中包含的字段和值。例如,总毛利润百分比。
将
html
参数添加到“探索”查询中引用并在提示中显示的原始衡量标准。在这种情况下,“探索”查询中当前显示在提示中的度量方式是总毛利润。在
html
参数中,使用 Liquid 变量创建一个表达式,将其他字段附加到现有衡量标准的值。- 此示例使用 Liquid 变量
_rendered_value
显示采用 Looker 格式的值。例如,total_gross_margin
使用 Looker 格式设置,保留两位小数,而percent_of_total_gross_margin
使用 Looker 格式设置,保留两位小数的百分比。 - 您可以使用竖线字符
|
来分隔不同字段的值。 - 您还可以附加其他字词,以阐明在提示中呈现的其他值的含义。在本例中,添加了
of total
以说明百分比值的含义。
- 此示例使用 Liquid 变量
保存和验证代码,在验证其按预期运行后将其推送到生产环境。
现在,当用户将鼠标悬停在带有提示的数据点上时,提示会显示两个值:数据点的 total_gross_margin
值和相应的 percent_of_total_gross_margin
值。
后续步骤
使用自定义提示创建可视化图表后,您可以与他人共享该图表: