充分利用 Looker 可视化图表手册：自定义提示

注意：本页面是 Looker 食谱：充分利用 Looker 可视化图表的一部分。

提示：从 Looker 24.0 开始，您可以使用图表配置编辑器进一步自定义提示样式和颜色。

提示：从 Looker 26.0 开始，借助自定义提示实验室功能，您可以使用界面设置和支持 Liquid 模板的 HTML 编辑器，在探索可视化图表编辑器中配置提示。

可视化图表提示默认显示所选维度和指标的值，可帮助用户了解单个数据点的意义。

例如，如果地图可视化图表基于按州分组的总毛利润，那么当用户将鼠标悬停在加利福尼亚州上时，系统会显示这两个字段的值。

不过，如果您想在提示中添加其他字段，以便用户无需前往其他位置即可获取有关数据点的更多信息或背景信息，该怎么办？

您可以自定义提示，以显示多个指定字段中的值，包括不在探索查询中的字段。

注意： HTML 格式仅在表格、表格（旧版）和单值图图表可视化效果中呈现，并且仅当合并多个字段时才会在可视化效果提示中呈现。如果使用 html 参数将任何互动内容放置在地图图表的提示中，则在使用新版信息中心体验的信息中心内将无法访问该内容，但在 Look 和探索中可以访问该内容。

素材

• Liquid 变量 - Liquid 变量可与现有的探索查询结合使用，以呈现其他字段的值。
• html 参数 - 如果在指标的 html 参数中定义了字段，当用户将鼠标悬停在可视化图表上时，这些字段将显示在提示中。
• 可视化图表 - 当用户将光标悬停在某些可视化图表类型中的数据点上时，系统会显示提示。
  • 笛卡尔坐标图
  • 饼图或圆环图
  • 进展图表
  • 地图图表

前提条件

自定义提示需要执行以下操作：

• 创建探索的权限和开发 LookML 的权限。
• 了解 SQL 和 LookML 开发。
• 具备在 Looker 中使用 Liquid 和 HTML 编码方面的基础知识。如需了解必要的背景信息，请访问 html 文档页面的在 html 参数中使用 Liquid 变量部分。
• 保存内容的权限（如果您想将可视化图表保存为 Look 或信息中心）

提示自定义注意事项

自定义提示时，请务必考虑以下事项：

• html 参数中的值会成为可视化的 y 轴。
• 您要在 y 轴上显示的值应该是指标的 sql 参数中的值。
• 使用任何格式化衡量指标（type: percent_of_total 类型的衡量指标或具有 value_format_name 或 value_format 参数的衡量指标）时，请务必使用渲染值的 Liquid 语法 {{ field_name._rendered_value }}（其中 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 ;;
}

1. 在开发模式下，找到要自定义的字段的 LookML 定义。

   您可以从探索直接前往字段的 LookML 定义。

2. 确定除了原始字段之外，您还希望在提示中包含哪些字段和值。例如，总毛利润百分比。

3. 向探索查询中引用并在提示中显示的原始度量添加 html 参数。在此示例中，探索查询中当前包含且在提示中显示的度量是总毛利率。

4. 在 html 参数中，创建一个包含 Liquid 变量的表达式，用于将其他字段附加到现有指标的值。

   • 此示例使用 Liquid 变量 _rendered_value 显示 Looker 格式的值。例如，total_gross_margin 使用 Looker 格式设置两位小数，而 percent_of_total_gross_margin 使用 Looker 格式设置两位小数的百分比。
   • 您可以使用竖线字符 | 分隔不同字段的值。
   • 您还可以附加其他字词，以明确提示中呈现的其他值的含义。在这种情况下，添加了 of total 以明确百分比值的含义。

5. 验证代码是否按预期运行后，保存、验证代码并将其推送到生产环境。

注意： html 参数的输入仅影响向用户呈现值的方式。它不会更改数据库中的底层值。

现在，当用户将鼠标悬停在带有工具提示的数据点上时，工具提示将显示两个值：数据点的 total_gross_margin 值和相应的 percent_of_total_gross_margin 值。

后续步骤

创建带有自定义工具提示的可视化图表后，您可以与他人分享：

• 将探索另存为 Look
• 将探索添加到信息中心
• 通过网址分享探索