使用 Liquid 和 HTML 创建动态信息中心图片

您可以通过在 Markdown 文本图块中对图片网址进行硬编码,将图片添加到 Looker 信息中心。不过,文本图块中的图片是静态的,不会根据结果进行更新。 如果您希望信息中心图片根据用户选择的过滤条件值动态变化,该怎么办?

本最佳实践页面演示了如何使用 Liquid 和 html 参数实现动态信息中心图片。

解决方案

以下解决方案基于一个电子商务数据集,该数据集包含一个名为 users.state 的字段,代表假设的电子商务数据集中的州:

dimension: state {
  type: string
  sql: ${TABLE}.state ;;
}

假设您想在信息中心内显示州旗图片,并希望该图片能根据用户选择过滤信息中心结果的州进行更新。

您需要完成以下三个步骤才能创建动态信息中心图片:

  1. 在 LookML 中创建图片维度。
  2. 创建动态图片信息中心图块。
  3. 添加信息中心过滤条件并进行最后的润色。

第 1 步:在 LookML 中创建图片维度

如需在 LookML 中创建图片维度,请执行以下操作:

  1. 首先,前往包含要添加图片的维度的项目和视图文件。然后,基于该字段创建一个新维度,专门用于显示图片。
  2. 对于您要显示图片的每个值,添加一个 html 参数,用于通过 value 变量定义 Liquid {% if %} 条件语句。

    例如,以下 state_flag_image 维度建立了一个条件,即当 state 的值为 "California"、"New York"、"Colorado" 或 "Illinois" 时,显示指定的图片(带有 html <img> 标记)。对于所有其他状态,您可以显示“无可用图片”图标:

          dimension: state_flag_image {
              type: string
              sql: ${state} ;;
              html:
                  {% if state._value == "California" %}
                  <img src="https://upload.wikimedia.org/wikipedia/commons/0/01/Flag_of_California.svg" height="170" width="255">
                  {% elsif state._value == "New York" %}
                  <img src="https://upload.wikimedia.org/wikipedia/commons/thumb/1/1a/Flag_of_New_York.svg/1200px-Flag_of_New_York.svg.png" height="170" width="255">
                  {% elsif state._value == "Colorado" %}
                  <img src="https://upload.wikimedia.org/wikipedia/commons/thumb/4/46/Flag_of_Colorado.svg/255px-Flag_of_Colorado.svg.png" height="170" width="255">
                  {% elsif state._value == "Illinois"%}
                  <img src="https://upload.wikimedia.org/wikipedia/commons/thumb/0/01/Flag_of_Illinois.svg/1200px-Flag_of_Illinois.svg.png" height="170" width="255">
                  {% else %}
                  <img src="https://upload.wikimedia.org/wikipedia/commons/thumb/a/ac/No_image_available.svg/1024px-No_image_available.svg.png" height="170" width="170">
                  {% endif %} ;;
          }
        
  3. 为要显示图片的每个值创建一个值条件。或者,您也可以使用 value Liquid 变量创建动态图片字段,如如何向可视化图表添加图片社区帖子中所述。

接下来,您可以为图片维度创建信息中心图块。

第 2 步:创建动态图片信息中心图块

现在,图片维度 (state_flag_image) 已创建,您可以构建一个探索,该探索将成为动态图片信息中心图块。

使用以下条件构建探索:

  • 为原始维度(在本例中为 state)添加过滤条件。将过滤条件设置为任意值。由于未选择特定的过滤条件值,因此最初会显示“无可用图片”图片。此过滤条件值将根据用户为信息中心过滤条件选择的值进行更新。 
  • 选择图片维度(在本例中为 state_flag_image)以及确定图片所需的任何其他维度(例如,如果您想考虑日期,可以添加日期等)。
  • 将行数限制更改为一行。
  • 将可视化图表类型更改为 KPI(单值)可视化图表或单值(旧版),并隐藏除图片维度 (state_flag_image) 以外的所有其他列。 

您的探索最初会在可视化面板中呈现的单值可视化图表中显示“无可用图片”图片。展示的图片会根据用户在最终信息中心内选择的过滤条件值而变化:

将探索作为图块保存到信息中心。

第 3 步:添加信息中心过滤条件并进行最后的美化

现在,您需要向信息中心添加信息中心过滤条件。信息中心内的过滤条件会更新“探索”中的过滤条件,以便根据用户选择更改显示的图片。

在信息中心的修改模式下,创建过滤条件:

  • 打开“添加过滤条件”窗口
  • 选择要作为过滤条件的字段。过滤条件字段应为图片维度所基于的维度。在本示例中,过滤条件的字段将为 state。
  • 在要更新的图块标签页上,选择第 2 步中的图片图块。
  • 在内嵌的要过滤的字段下拉菜单中,选择原始维度(在本例中为州)。
  • 根据需要选择要更新的其他板块。
  • 根据需要自定义过滤条件。如果您选择高级 控件选项,请务必取消选中允许多个过滤条件值选项,该选项会自动为高级控件选项启用。

现在,图片图块将根据用户选择的过滤条件进行更新。

当用户选择按“California”过滤时,信息中心将显示加利福尼亚州的州旗和数据:

当用户选择按“Colorado”过滤时,信息中心将显示科罗拉多州的州旗和数据: