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

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

提示：从 Looker 26.4 开始，自定义提示设置可让您在探索可视化图表编辑器中配置提示，方法是结合使用界面设置和支持 Liquid 模板的 HTML 编辑器。详细了解自定义提示。

可视化图表提示默认显示所选维度和测量的值，可帮助用户了解单个数据点的重要性。

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

但是，如果您想在提示中包含默认字段以外的字段，以便用户无需查看其他位置即可获取有关数据点的更多信息或背景信息，该怎么办？

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

注意： HTML 格式仅在表格、表格（旧版）、KPI（单值）和单值（旧版）图表可视化图表中呈现，以及在组合多个字段时在可视化图表提示中呈现。任何使用 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 是测量或维度的实际名称）。

示例

注意： 本部分中的示例是在本页前面介绍的按州分组的总毛利率示例地图的基础上进行推断的。

默认情况下，可视化图表数据点的提示会包含总毛利和州的值。不过，如果您想向用户提供地图上未显示或 Explore 查询中未包含的其他信息，该怎么办？如果您想添加名为 Percent of Total Gross Margin（总毛利率百分比）的字段值，而不是 State（州/省/自治区/直辖市）字段值，该怎么办？添加总毛利润百分比有助于用户了解单个数据点的总毛利润值与整个数据集的总毛利润相比如何。

如需自定义提示，请按以下步骤操作：

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
• 将探索添加到信息中心
• 通过网址分享“探索”