嵌入式 JavaScript 事件

创建嵌入后(可公开私下、使用签名嵌入或通过 API 完成),您可以使用 JavaScript 与这些 iframe 进行交互。您可以根据嵌入项的状态让页面更具动态性,甚至可以从网页中对嵌入项进行更改。

请注意,Looker 并不控制浏览器将事件分派给 Web 应用的顺序。这意味着,无法保证不同浏览器或平台之间的事件顺序。请务必正确编写 JavaScript,以考虑不同浏览器的事件处理。

您可以通过以下任一方式将 JavaScript 用于 Looker 嵌入内容:

准备工作

您必须先按以下步骤操作,然后才能与嵌入的 iframe 互动:

向 iframe 添加 ID

稍后,当您从 iframe 检索数据时,需要验证您所处理的信息是否确实来自 Looker 的 iframe。为方便起见,请务必向 iframe 中添加 ID(如果您尚未添加)。在以下示例中,您通过向 iframe 添加 id="looker" 将 ID 设置为 looker

<iframe id="looker" src="https://instance_name.looker.com/embed/dashboards/1"></iframe>

将嵌入网域添加到 iframe src 属性中

在 iframe 的 src 属性中,请添加使用 iframe 的网域。在以下示例中,您可以通过在 src 属性的网址末尾添加 ?embed_domain=https://myownpersonaldomain.com",将 myownpersonaldomain.com 指定为网域:

<iframe
  id="looker"
  src="https://instance_name.looker.com/embed/dashboards/1?embed_domain=https://myownpersonaldomain.com">
</iframe>

如果您使用的是已签名的嵌入,请务必将 embed_domain 添加到嵌入网址

如果您使用的是嵌入 SDK,请在嵌入网址的末尾添加 sdk=2sdk=2 参数表示 SDK 已存在,并且 Looker 可以利用 SDK 提供的其他功能,例如在 Looker iframe 和您的网域之间传递 JavaScript 事件。SDK 无法自行添加此参数,因为该参数是已签名网址的一部分。例如:

<iframe
  id="looker"
  src="https://instance_name.looker.com/embed/dashboards/1?embed_domain=https://myownpersonaldomain.com&sdk=2">
</iframe>

将嵌入网域添加到许可名单

最后,您需要按照以下步骤在 Looker 管理面板的嵌入页面上将使用 iframe 的网域添加到许可名单中:

  1. 嵌入的网域许可名单字段中,输入使用 iframe 的网域,然后按 Tab 键,使该网域显示在该字段内的框中。

  2. 点击更新

您可以使用许可名单中的 * 通配符创建网域模式。例如,https://*.myownpersonaldomain.com 会同时允许 https://analytics.myownpersonaldomain.comhttps://data.myownpersonaldomain.com

如果您将 无 Cookie 嵌入与 Looker 23.8 或更高版本搭配使用,则可以在获取无 Cookie 会话时指定嵌入网域。这是一种将嵌入网域添加到许可名单的替代方法,您也可以使用管理 > 嵌入面板执行此操作。如果您决定使用此功能,请查看安全性最佳实践

从 iframe 中检索数据

完成准备步骤后,您可以通过监听 postMessage 事件来访问在 Looker iframe 和您的网域之间传递的事件。

如本页事件类型参考部分所述,嵌入式 iframe 可以创建几种事件类型。

在 JavaScript 中访问事件

以下示例展示了如何在原生 JavaScript 中监听这些事件,然后将其记录到控制台:

window.addEventListener("message", function(event) {
  if (event.source === document.getElementById("looker").contentWindow) {
    if (event.origin === "https://instance_name.looker.com") {
      console.log(JSON.parse(event.data));
    }
  }
});

以下示例展示了如何在 jQuery 中监听这些事件,然后将其记录到控制台:

$(window).on("message", function(event) {
  if (event.originalEvent.source === $("#looker")[0].contentWindow) {
    if (event.origin === "https://instance_name.looker.com") {
      console.log(JSON.parse(event.data));
    }
  }
});

事件类型摘要表

下表总结了事件类型。选择事件类型可查看有关该事件的详细信息。

事件类型 事件原因
dashboard:loaded 在未将功能块设置为自动运行的信息中心中,信息中心及其元素已加载,但查询尚未运行。
dashboard:run:start 信息中心已开始加载,其图块也已开始加载和查询数据。
dashboard:run:complete 信息中心已运行完毕,所有功能块均已完成加载和查询。
dashboard:download 信息中心的 PDF 文件已开始下载。
dashboard:edit:start 添加 22.20 信息中心已切换到修改模式。成功保存信息中心后,将会触发 dashboard:save:complete 事件。
dashboard:edit:cancel 新增了 22.20 处于修改模式的信息中心已退出修改模式,但未保存。
dashboard:save:complete 已修改并保存一个信息中心。
dashboard:delete:complete 已删除信息中心。
dashboard:tile:start 功能块已开始加载或查询数据。
dashboard:tile:complete 某个功能块已完成查询的运行。
dashboard:tile:download 板块的数据已开始下载。
dashboard:tile:explore 用户点击了信息中心功能块中的从此处探索选项。
dashboard:tile:view 用户点击了信息中心图块中的 View Original Look 选项。
dashboard:filters:changed 信息中心的过滤条件已应用或更改。
look:ready 无论查询是否会运行,Look 都已开始加载查询数据。
look:run:start Look 已开始加载查询数据,且该查询已开始运行。
look:run:complete 某个数据分析图表已完成查询的运行。
look:save:complete 修改并保存了某个外观。
look:delete:complete 某个外观已移至回收站文件夹
drillmenu:click 用户点击了使用 link LookML 参数创建的信息中心中的展开菜单。
drillmodal:download 用户通过信息中心图块打开深入分析对话框,然后点击了下载选项。
drillmodal:explore 用户在深入分析对话框中点击从这里探索选项。
explore:ready 无论查询是否会运行,探索都已开始加载查询数据。
explore:run:start 探索已开始加载查询数据,并且查询已开始运行。
explore:run:complete 探索已完成运行查询。
explore:state:changed 由于用户的操作,“探索”页面网址发生了变化。
page:changed 用户导航到了 iframe 中的新页面。
page:properties:changed 信息中心 iframe 的高度已更改。
session:tokens Looker 客户端需要令牌才能继续。
session:status 发送有关会话状态的信息。
env:client:dialog 系统打开了一个对话框,但该对话框可能部分超出了视野范围,例如展开式对话框。借助此事件,托管应用可以将对话框滚动到视野中。

事件类型参考文档

嵌入式 iframe 可以创建许多不同类型的事件:

dashboard:loaded

在图块未设置为自动运行的信息中心内,此事件是在信息中心及其元素加载完成后、查询运行之前创建的。


type: "dashboard:loaded",
status: "complete",
dashboard: {
  id: 1,
  title: "Business Pulse",
  canEdit: true,
  dashboard_filters: {
    "date": "Last 6 Years",
    "state": ""
  },
  absoluteUrl: "https://self-signed.looker.com:9999/embed/dashboards/1?embed_domain=https%3A%2F%2Fself-signed.looker.com%3A9999&date=Last+6+Years&state=",
  url: "/embed/dashboards/1?embed_domain=https%3A%2F%2Fself-signed.looker.com%3A9999&date=Last+6+Years&state=",
  options: {
    layouts: [
      {
        id: 1,
        dashboard_id: 1,
        type: "newspaper",
        active: true,
        column_width: null,
        width: null,
        deleted: false,
        dashboard_layout_components: [
          {
            id: 1,
            dashboard_layout_id: 1,
            dashboard_element_id: 1,
            row: 0,
            column: 0,
            width: 8,
            height: 4,
            deleted: false
          },
          {
            id: 2,
            dashboard_layout_id: 1,
            dashboard_element_id: 2,
            row: 0,
            column: 8,
            width: 8,
            height: 4,
            deleted: false
          }
        ]
      }
    ],
    elements: {
      1: {
        title: "Total Orders",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          font_size: "medium",
          title: "Total Orders"
        }
      },
      2: {
        title: "Average Order Profit",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          title: "Average Order Profit"
        }
      }
    }
  }
}
属性 格式 说明
status 字符串 指示信息中心及其元素是否已成功加载。
dashboard.id 数字/字符串 信息中心的 ID。
dashboard.title 字符串 标题,如信息中心顶部所示。
dashboard.canEdit 布尔值 添加时间:22.20 true 时,用户可以修改信息中心。
dashboard.dashboard_filters 对象 应用于信息中心的过滤条件。此对象的格式为:{"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.absoluteUrl 字符串 完整的信息中心网址。
dashboard.url 字符串 信息中心的相对网址(仅限路径)。
dashboard.options 对象 信息中心布局信息中心布局组件信息中心元素属性和值。您可以使用 dashboard:options:set 事件为 options 对象中返回的所有属性赋予更新后的值。

dashboard:run:start

此事件在信息中心开始加载时创建,届时其图块将开始加载和查询数据。

type: "dashboard:run:start",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
属性 格式 说明
dashboard.id 数字/字符串 信息中心的 ID。
dashboard.title 字符串 标题,如信息中心顶部所示。
dashboard.canEdit 布尔值 添加时间:22.20 true 时,用户可以修改信息中心。
dashboard.url 字符串 相对信息中心网址(仅限路径)。
dashboard.absoluteUrl 字符串 完整的信息中心网址。
dashboard.dashboard_filters 对象 应用于信息中心的过滤条件。此对象的格式为:{"Filter name 1": "value 1", "Filter name 2": "value 2", ...}

dashboard:run:complete

当信息中心运行完毕且所有功能块均已加载和查询完毕时,系统会创建此事件。无论所有图块是否成功加载,系统都会创建此事件。

type: "dashboard:run:complete",
status: "complete",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://my.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
  options: {
    layouts: [
      {
        id: 1,
        dashboard_id: 1,
        type: "newspaper",
        active: true,
        column_width: null,
        width: null,
        deleted: false,
        dashboard_layout_components: [
          {
            id: 1,
            dashboard_layout_id: 1,
            dashboard_element_id: 1,
            row: 0,
            column: 0,
            width: 8,
            height: 4,
            deleted: false
          },
          {
            id: 2,
            dashboard_layout_id: 1,
            dashboard_element_id: 2,
            row: 0,
            column: 8,
            width: 8,
            height: 4,
            deleted: false
          }
        ]
      }
    ],
    elements: {
      1: {
        title: "Total Orders",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          font_size: "medium",
          title: "Total Orders"
        }
      },
      2: {
        title: "Average Order Profit",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          title: "Average Order Profit"
        }
      }
    }
  }
}
属性 格式 说明
status 字符串 指示信息中心及其元素是否已成功运行。如果信息中心及其元素成功运行,status 会返回 "complete";否则,status 会返回 "error"。如果正在运行的信息中心停止(无论是从界面还是通过 dashboard:stop 操作停止),status 将返回 "stopped"
dashboard.id 数字/字符串 信息中心的 ID。
dashboard.title 字符串 标题,如信息中心顶部所示。
dashboard.canEdit 布尔值 添加时间:22.20 true 时,用户可以修改信息中心。
dashboard.url 字符串 相对信息中心网址(仅限路径)。
dashboard.absoluteUrl 字符串 完整的信息中心网址。
dashboard.dashboard_filters 对象 应用于信息中心的过滤条件。此对象的格式为:{"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.options 对象 信息中心布局信息中心布局组件信息中心元素属性和值。您可以使用 dashboard:options:set 操作为 options 对象中返回的所有属性指定更新后的值。
dashboard.tileStatuses 对象数组 用于提供功能块状态的对象数组。对象属性包括:

  • tileId - 功能块的 ID 号。
  • status - 如果成功运行了功能块查询,status 会返回 "complete";否则,status 会返回 "error"
  • errors - 当 status 属性为 "error" 时填充。一个对象数组,用于提供错误的详细信息,包括错误消息文本、更详细的错误说明,以及导致错误的功能块的 SQL 查询。

dashboard:download

当信息中心的 PDF 文件开始下载时,系统会创建此事件。

type: "dashboard:download",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
fileFormat: "pdf"
属性 格式 说明
dashboard.id 数字/字符串 信息中心的 ID。
dashboard.title 字符串 标题,如信息中心顶部所示。
dashboard.canEdit 布尔值 添加时间:22.20 true 时,用户可以修改信息中心。
dashboard.url 字符串 相对信息中心网址(仅限路径)。
dashboard.absoluteUrl 字符串 完整的信息中心网址。
dashboard.dashboard_filters 对象 应用于信息中心的过滤条件。此对象的格式为:{"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
fileFormat 字符串 已下载的信息中心的格式(目前只有 "pdf")。

dashboard:edit:start

添加 22.20 当信息中心切换到修改模式时,系统会创建此事件。

type: "dashboard:edit:start",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
属性 格式 说明
dashboard.id 数字/字符串 信息中心的 ID。
dashboard.title 字符串 标题,如信息中心顶部所示。
dashboard.canEdit 布尔值 添加时间:22.20 true 时,用户可以修改信息中心。
dashboard.url 字符串 相对信息中心网址(仅限路径)。
dashboard.absoluteUrl 字符串 完整的信息中心网址。
dashboard.dashboard_filters 对象 应用到信息中心的过滤条件。此对象的格式为:{"Filter name 1": "value 1", "Filter name 2": "value 2", ...}

dashboard:edit:cancel

新增时间:22.20 当处于修改模式的信息中心退出修改模式且未保存时,系统会创建此事件。

type: "dashboard:edit:cancel",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
属性 格式 说明
dashboard.id 数字/字符串 信息中心的 ID。
dashboard.title 字符串 标题,如信息中心顶部所示。
dashboard.canEdit 布尔值 添加时间:22.20 true 时,用户可以修改信息中心。
dashboard.url 字符串 相对信息中心网址(仅限路径)。
dashboard.absoluteUrl 字符串 完整的信息中心网址。
dashboard.dashboard_filters 对象 应用于信息中心的过滤条件。此对象的格式为:{"Filter name 1": "value 1", "Filter name 2": "value 2", ...}

dashboard:save:complete

当您修改并保存信息中心时,系统会创建此事件。

type: "dashboard:save:complete",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  url: "/embed/dashboards/...",
  options: {
    layouts: [
      {
        id: 1,
        dashboard_id: 1,
        type: "newspaper",
        active: true,
        column_width: null,
        width: null,
        deleted: false,
        dashboard_layout_components: [
          {
            id: 1,
            dashboard_layout_id: 1,
            dashboard_element_id: 1,
            row: 0,
            column: 0,
            width: 8,
            height: 4,
            deleted: false
          },
          {
            id: 2,
            dashboard_layout_id: 1,
            dashboard_element_id: 2,
            row: 0,
            column: 8,
            width: 8,
            height: 4,
            deleted: false
          }
        ]
      }
    ],
    elements: {
      1: {
        title: "Total Orders",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          font_size: "medium",
          title: "Total Orders"
        }
      },
      2: {
        title: "Average Order Profit",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          title: "Average Order Profit"
        }
      }
    }
  }
}
属性 格式 说明
dashboard.id 数字/字符串 信息中心的 ID。
dashboard.title 字符串 标题,如信息中心顶部所示。
dashboard.canEdit 布尔值 添加时间:22.20 true 时,用户可以修改信息中心。
dashboard.dashboard_filters 对象 应用于信息中心的过滤条件。此对象的格式为:{"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.absoluteUrl 字符串 完整的信息中心网址。
dashboard.url 字符串 信息中心的相对网址(仅限路径)。
dashboard.options 对象 信息中心布局信息中心布局组件信息中心元素属性和值。您可以使用 dashboard:options:set 事件为 options 对象中返回的所有属性提供更新后的值。

dashboard:delete:complete

信息中心被删除时,系统会创建此事件。

type: "dashboard:delete:complete",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  url: "/embed/dashboards/...",
  options: {
    layouts: [
      {
        id: 1,
        dashboard_id: 1,
        type: "newspaper",
        active: true,
        column_width: null,
        width: null,
        deleted: false,
        dashboard_layout_components: [
          {
            id: 1,
            dashboard_layout_id: 1,
            dashboard_element_id: 1,
            row: 0,
            column: 0,
            width: 8,
            height: 4,
            deleted: false
          },
          {
            id: 2,
            dashboard_layout_id: 1,
            dashboard_element_id: 2,
            row: 0,
            column: 8,
            width: 8,
            height: 4,
            deleted: false
          }
        ]
      }
    ],
    elements: {
      1: {
        title: "Total Orders",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          font_size: "medium",
          title: "Total Orders"
        }
      },
      2: {
        title: "Average Order Profit",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          title: "Average Order Profit"
        }
      }
    }
  }
}
属性 格式 说明
dashboard.id 数字/字符串 信息中心的 ID。
dashboard.title 字符串 标题,如信息中心顶部所示。
dashboard.canEdit 布尔值 添加时间:22.20 true 时,用户可以修改信息中心。
dashboard.dashboard_filters 对象 应用于信息中心的过滤条件。此对象的格式为:{"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.absoluteUrl 字符串 完整的信息中心网址。
dashboard.url 字符串 信息中心的相对网址(仅限路径)。
dashboard.options 对象 信息中心布局信息中心布局组件信息中心元素属性和值。您可以使用 dashboard:options:set 事件为 options 对象中返回的所有属性赋予更新后的值。

dashboard:tile:start

当功能块开始加载或查询数据时,系统会创建此事件。

type: "dashboard:tile:start",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
tile: {
  id: 123,
  title: "Quarterly Sales",
  listen: {
    "Date": "order.date",
    "Total Orders": "order.count"
  }
}
属性 格式 说明
dashboard.id 数字/字符串 功能块所属的信息中心的 ID。
dashboard.title 字符串 信息中心标题,显示在功能块所属信息中心的顶部。
dashboard.canEdit 布尔值 添加时间:22.20 true 时,用户可以修改信息中心。
dashboard.url 字符串 功能块所属的相对信息中心网址(仅限路径)。
dashboard.absoluteUrl 字符串 功能块所属的信息中心的完整网址。
dashboard.dashboard_filters 对象 应用于板块所属的信息中心的过滤条件。此对象的格式为:{"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
tile.id 整数 事件的 ID 编号,不是图块。
tile.title 字符串 功能块标题,显示在功能块顶部。
tile.listen 对象 此图块正在监听的全局信息中心过滤器。此对象的格式为:{"Filter Label": "Filter Field", ...}

dashboard:tile:complete

当功能块运行完查询时,系统就会创建此事件。

type: "dashboard:tile:complete",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
status: "complete",
truncated: false,
tile: {
  id: 123,
  title: "Quarterly Sales",
  listen: {
    "Date": "order.date",
    "Total Orders": "order.count"
  }
}
属性 格式 说明
dashboard.id 数字/字符串 功能块所属的信息中心的 ID。
dashboard.title 字符串 信息中心标题,显示在功能块所属信息中心的顶部。
dashboard.canEdit 布尔值 添加时间:22.20 true 时,用户可以修改信息中心。
dashboard.url 字符串 功能块所属的相对信息中心网址(仅限路径)。
dashboard.absoluteUrl 字符串 功能块所属的信息中心的完整网址。
dashboard.dashboard_filters 对象 应用于板块所属的信息中心的过滤条件。此对象的格式为:{"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
status 字符串 功能块查询是否成功完成。可能的值为 "complete""error"
truncated 布尔值 功能块查询结果是否因查询返回的行数超出查询行数限制而被截断。行数上限可以是用户指定的行数上限,也可以是 Looker 默认行数上限(5,000 个)。
tile.id 整数 事件的 ID 编号,不是图块。
tile.title 字符串 功能块标题,显示在功能块顶部。
tile.listen 对象 此功能块正在监听的全局信息中心过滤条件。此对象的格式为:{"Filter Label": "Filter Field", ...}
tile.errors 对象数组 status 属性为 "error" 时填充。一个对象数组,用于提供错误的详细信息,包括错误消息文本、错误的更详细说明,以及生成该错误的功能块 SQL 查询。

dashboard:tile:download

当功能块的数据开始下载时,系统会创建此事件。

type: "dashboard:tile:download",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
tile: {
  id: 123,
  title: "Quarterly Sales"
  listen: {
    "Date": "order.date",
    "Total Orders": "order.count"
  }
}
fileFormat: "pdf"
属性 格式 说明
dashboard.id 数字/字符串 功能块所属的信息中心的 ID。
dashboard.title 字符串 信息中心标题,显示在功能块所属信息中心的顶部。
dashboard.canEdit 布尔值 添加时间:22.20 true 时,用户可以修改信息中心。
dashboard.url 字符串 功能块所属的相对信息中心网址(仅限路径)。
dashboard.absoluteUrl 字符串 功能块所属的信息中心的完整网址。
dashboard.dashboard_filters 对象 应用于板块所属的信息中心的过滤条件。此对象的格式为:{"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
tile.id 整数 事件的 ID 编号,不是图块。
tile.title 字符串 功能块标题,显示在功能块顶部。
tile.listen 对象 此图块正在监听的全局信息中心过滤器。此对象的格式为:{"Filter Label": "Filter Field", ...}
fileFormat 字符串 下载的功能块的格式(目前仅限 "pdf")。

dashboard:tile:explore

当用户点击信息中心功能块中的从此处探索选项时,系统会创建此事件。

type: "dashboard:tile:explore",
label: 'Explore From Here',
url: '/embed/explore/model/view...',
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
tile: {
  id: 123,
  title: "Quarterly Sales",
  listen: {
    "Date": "order.date",
    "Total Orders": "order.count"
  }
}
属性 格式 说明
label 字符串 按钮标签。
url 字符串 要查看的探索的相对网址(仅限路径)。
dashboard.id 数字/字符串 功能块所属的信息中心的 ID。
dashboard.title 字符串 信息中心标题,显示在功能块所属信息中心的顶部。
dashboard.canEdit 布尔值 添加时间:22.20 true 时,用户可以修改信息中心。
dashboard.url 字符串 功能块所属的相对信息中心网址(仅限路径)。
dashboard.absoluteUrl 字符串 功能块所属的信息中心的完整网址。
dashboard.dashboard_filters 对象 应用于板块所属的信息中心的过滤条件。此对象的格式为:{"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
tile.id 整数 事件的 ID 编号,不是图块。
tile.title 字符串 功能块标题,显示在功能块顶部。
tile.listen 对象 此图块正在监听的全局信息中心过滤器。此对象的格式为:{"Filter Label": "Filter Field", ...}

dashboard:tile:view

当用户点击信息中心图块中的 View Original Look 选项时,系统会创建此事件。

type: "dashboard:tile:view",
label: 'View Original Look',
url: '/embed/look/...',
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
tile: {
  id: 123,
  title: "Quarterly Sales",
  listen: {
    "Date": "order.date",
    "Total Orders": "order.count"
  }
}
属性 格式 说明
label 字符串 按钮标签。
url 字符串 要查看的外观的相对网址(仅限路径)。
dashboard.id 数字/字符串 功能块所属的信息中心的 ID。
dashboard.title 字符串 信息中心标题,显示在功能块所属信息中心的顶部。
dashboard.canEdit 布尔值 添加时间:22.20 true 时,用户可以修改信息中心。
dashboard.url 字符串 功能块所属的相对信息中心网址(仅限路径)。
dashboard.absoluteUrl 字符串 功能块所属的信息中心的完整网址。
dashboard.dashboard_filters 对象 应用于板块所属的信息中心的过滤条件。此对象的格式为:{"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
tile.id 整数 事件的 ID 编号,不是图块。
tile.title 字符串 功能块标题,显示在功能块顶部。
tile.listen 对象 此功能块正在监听的全局信息中心过滤条件。此对象的格式为:{"Filter Label": "Filter Field", ...}

dashboard:filters:changed

当应用或更改信息中心的过滤条件时,系统会创建此事件。

type: "dashboard:filters:changed",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
  options: {
    layouts: [
      {
        id: 1,
        dashboard_id: 1,
        type: "newspaper",
        active: true,
        column_width: null,
        width: null,
        deleted: false,
        dashboard_layout_components: [
          {
            id: 1,
            dashboard_layout_id: 1,
            dashboard_element_id: 1,
            row: 0,
            column: 0,
            width: 8,
            height: 4,
            deleted: false
          },
          {
            id: 2,
            dashboard_layout_id: 1,
            dashboard_element_id: 2,
            row: 0,
            column: 8,
            width: 8,
            height: 4,
            deleted: false
          }
        ]
      }
    ],
    elements: {
      1: {
        title: "Total Orders",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          font_size: "medium",
          title: "Total Orders"
        }
      },
      2: {
        title: "Average Order Profit",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          title: "Average Order Profit"
        }
      }
    }
  }
}
属性 格式 说明
dashboard.id 数字/字符串 信息中心的 ID。
dashboard.title 字符串 标题,如信息中心顶部所示。
dashboard.canEdit 布尔值 添加时间:22.20 true 时,用户可以修改信息中心。
dashboard.url 字符串 相对信息中心网址(仅限路径)。
dashboard.absoluteUrl 字符串 完整的信息中心网址。
dashboard.dashboard_filters 对象 应用于信息中心的过滤条件。此对象的格式为:{"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.options 对象 信息中心布局信息中心布局组件信息中心元素属性和值。您可以使用 dashboard:options:set 事件为 options 对象中返回的所有属性提供更新后的值。

look:ready

当 Look 开始加载查询数据时,系统会创建此事件,无论查询是否运行。

type: "look:ready",
look: {
  url: "/embed/looks/...",
  absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
  }
}
属性 格式 说明
look.url 字符串 相对 Look 网址(仅路径)
look.absoluteUrl 字符串 完整的 Look 网址

look:run:start

当数据分析开始加载查询数据并开始运行时,系统会创建此事件。

type: "look:run:start",
look: {
  url: "/embed/looks/...",
  absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
  }
}
属性 格式 说明
look.url 字符串 相对 Look 网址(仅路径)
look.absoluteUrl 字符串 完整的 Look 网址

look:run:complete

当 Look 运行完查询后,系统就会创建此事件。

type: look:run:complete
look: {
  url: "/embed/looks/...",
  absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
  }
}
属性 格式 说明
look.url 字符串 相对 Look 网址(仅路径)
look.absoluteUrl 字符串 完整 Look 网址

look:save:complete

此事件是在修改和保存 Look 时创建的。当用户执行以下任一任务时,系统都会创建此事件:

如果通过保存 > 保存 Look,则不会创建此事件转至现有信息中心修改设置菜单选项。

type: look:save:complete
look: {
  url: "/embed/looks/...",
  absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
  folderid: 123
  }
}
属性 格式 说明
look.url 字符串 相对 Look 网址(仅路径)
look.absoluteUrl 字符串 完整的 Look 网址
look.folderid 整数 存储外观的文件夹 ID

look:delete:complete

当 Look 移至回收站文件夹时,系统会创建此事件。

type: look:delete:complete
look: {
  url: "/embed/looks/...",
  absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
  }
}
属性 格式 说明
look.url 字符串 相对 Look 网址(仅路径)
look.absoluteUrl 字符串 完整的 Look 网址

drillmenu:click

当用户点击使用 link LookML 参数创建的信息中心中的深入分析菜单时,系统会创建此事件。例如,以下 LookML 创建了一个深入分析菜单,用户可以在该菜单中查看按 state 维度过滤的数据:


dimension: state {
  type: string
  sql: ${TABLE}.state ;;
  link: {
    label: "Filter by {{ state | encode_uri }}"
    url: "filter::q={{ state | encode_uri }}"
    icon_url: "https://google.com/favicon.ico"
  }
}

state 过滤器设置为 Illinois 后,drillmenu:click 事件会向 iframe 的托管方返回以下内容:

type: "drillmenu:click",
label: "Filter by Illinois",
link_type: "url",
modal: false,
target: '_self',
url: "#filter::state=Illinois"
context: ' '
属性 格式 说明
label 字符串 展开菜单中显示的链接标签
link_type 字符串 链接目标中的对象的类型
modal 布尔值 是否使用展开对话框,而非浏览器导航
target 字符串 如果链接目标页面将替换当前的 iframe,则为 _self;如果链接目标页面会打开新窗口,则为 _blank
url 字符串 链接目标的网址
context 字符串 某些类型的可视化图表使用的内部属性

沙盒化 iframe 可防止点击展开式菜单后在新的窗口中打开。在 iframe 标记中使用以下沙盒化值:

sandbox = "allow-same-origin allow-scripts"

drillmodal:download

当用户通过信息中心图块打开深入分析对话框并点击下载选项时,系统会创建此事件。

{
type: "drillmodal:download",
dashboard: {
  id: 23,
  title: "My Dashboard",
  url: "/embed/dashboards/…",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/…",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
drillExploreUrl: "/embed...",
fileFormat: "pdf"
}
属性 格式 说明
dashboard.id 数字/字符串 功能块所属的信息中心的 ID。
dashboard.title 字符串 信息中心标题,显示在功能块所属信息中心的顶部。
dashboard.url 字符串 功能块所属的相对信息中心网址(仅限路径)。
dashboard.absoluteUrl 字符串 功能块所属的信息中心的完整网址。
dashboard.dashboard_filters 对象 应用于板块所属的信息中心的过滤条件。此对象的格式为:{"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
drillExploreUrl 字符串 要下载的相对探索网址(仅限路径)。
fileFormat 字符串 数据下载的文件格式。

drillmodal:explore

当用户点击展开式对话框中的从此处探索选项时,系统会创建此事件。

type: "drillmodal:explore",
label: "Explore From Here",
url: "/embed/explore/model/view..."
属性 格式 说明
label 字符串 深入分析菜单中显示的按钮标签
url 字符串 要查看的相对探索网址(只是路径)

explore:ready

当探索开始加载查询数据时,系统会创建此事件,无论查询是否运行。

type: "explore:ready",
explore: {
  url: "/embed/explore/...",
  absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
  }
}
属性 格式 说明
explore.url 字符串 相对的“探索”网址(仅限路径)
explore.absoluteUrl 字符串 完整的“探索”页面网址

explore:run:start

当“探索”开始加载查询数据且该查询开始运行时,系统就会创建此事件。

type: "explore:run:start",
explore: {
  url: "/embed/explore/...",
  absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
  }
}
属性 格式 说明
explore.url 字符串 相对的“探索”网址(仅限路径)
explore.absoluteUrl 字符串 完整的“探索”页面网址

explore:run:complete

当探索完成运行查询时,系统会创建此事件。

type: "explore:run:complete",
explore: {
  url: "/embed/explore/...",
  absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
  }
}
属性 格式 说明
explore.url 字符串 相对的“探索”网址(仅限路径)
explore.absoluteUrl 字符串 完整的“探索”页面网址

explore:state:changed

当探索页面网址因用户操作而发生变化时,系统会创建此事件。

type: "explore:state:changed",
explore: {
  url: "/embed/explore/...",
  absoluteUrl: "https://instance_name.looker.com/embed/explore/..."
}
属性 格式 说明
explore.url 字符串 相对的“探索”网址(仅限路径)
explore.absoluteUrl 字符串 完整的“探索”页面网址

page:changed

当用户在 iframe 中导航到新页面时,系统会创建此事件。

type: "page:changed",
page: {
  type: "dashboard",
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/..."
}
属性 格式 说明
page.type 字符串 刚刚导航到的页面的类型,例如 "dashboard""look""explore"
page.url 字符串 刚刚导航到的网页的相对网址(只是路径)
page.absoluteUrl 字符串 刚刚导航到的网页的完整网址

page:properties:changed

当信息中心 iframe 的高度发生变化时,系统会创建此事件。此功能不适用于“外观”或“探索”,因为这些内容会自动调整其高度以适应 iframe 的大小。

type: "page:properties:changed",
height: 1000
属性 格式 说明
height 整数 信息中心 iframe 的高度(以像素为单位)

session:tokens

此事件表示 Looker 客户端需要令牌才能继续。此事件会在创建 iframe 时立即创建,之后会在会话期间定期创建。

{
  "type": "session:tokens",
  "api_token": "eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwczovL3NlbGYtc2lnbmVkLmxvb2tlci5jb206OTk5OSIsImV4cCI6MTY3MDYyNjMzMCwic3ViIjoiYVdrNWFGUzM4RnRwNzFFWXhuS3ZaMXdKRmV3ZjB2VzYtTV9zLWtCcHE1dXIiLCJ0b2tlbl90eXBlIjoiYXBpX3Rva2VuIiwicmFuZG9taXplciI6IkxjYnpOeDNTVjNOb3o3UVlqTVJjNmhlMkdodjh1a2UwWUhiZWNRMHVCYm1KIn0.CBv1__QGc_H7bKNe31SHMMQCsc5ya1xOiEv1UDWAyxM",
  "api_token_ttl": 463,
  "navigation_token": "eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwczovL3NlbGYtc2lnbmVkLmxvb2tlci5jb206OTk5OSIsImV4cCI6MTY3MDYyNjMzMCwic3ViIjoiYVdrNWFGUzM4RnRwNzFFWXhuS3ZaMXdKRmV3ZjB2VzYtTV9zLWtCcHE1dXIiLCJ0b2tlbl90eXBlIjoibmF2aWdhdGlvbl90b2tlbiIsInJhbmRvbWl6ZXIiOiJHVVNlc00tdTRPRDlNdktodFJDU2pEcVFhUkJNeTh5dm42Q1FDUXhuLTNxMiJ9.sWo7LUEI5LeragVmeDamUR7u2myXpFJ0aqK_IIALUqI",
  "navigation_token_ttl": 463,
  "session_reference_token_ttl": 2924
}
属性 格式 说明
authentication_token 字符串 身份验证令牌。创建 iframe 时添加。对于生成令牌的请求的响应,或者会话已过期,则不包含此项。
authentication_token_ttl 数字 身份验证令牌的存活时间(以秒为单位)。在创建 iframe 时包含。生成令牌请求的响应中不包含该字段,或者会话已过期。
api_token 字符串 API 令牌。如果会话已过期,则不包含。
api_token_ttl 数字 API 令牌存留时间(以秒为单位)。如果会话已过期,则不包含。
navigation_token 字符串 导航令牌。如果会话已过期,则不包含此项。
navigation_token_ttl 数字 导航令牌的存活时间(以秒为单位)。如果会话已过期,则不包含此字段。
session_references_token_ttl 数字 会话存活时间(以秒为单位)。如果会话过期,此值将为 0。若要恢复,嵌入应用必须获取新会话。

session:status

嵌入式 Looker 应用处理会话令牌请求时,系统会生成此事件。

{
  "type": "session:status",
  "session_ttl": 0,
  "expired": true,
  "interrupted": false
}
属性 格式 说明
session_ttl 数字 会话存留时间(以秒为单位)。
expired 布尔值 true 时,表示会话已过期。
interrupted 布尔值 如果为 true,则表示会话令牌请求未得到响应。这可能表示服务器暂时不可用。
recoverable 布尔值 仅当 interrupted 为 true 时填充。指示会话是否可以恢复。值为 false 可能表示嵌入应用存在问题。

env:client:dialog

当打开的对话框可能部分超出视野范围时,系统会生成此事件,例如展开式对话框。此事件可让托管应用通过 env:host:scroll 操作将对话框滚动到可见状态。

{
  type: "env:client:dialog",
  dialogType: 'drilling',
  placement: 'cover',
  open: true
}
属性 格式 说明
type 字符串 env:client:dialog 表示对话框已打开或关闭。目前仅支持“深入分析”对话框,但将来可能会添加其他对话框。由于该对话框会遮盖 iframe 视口,因此可能无法看到展开式对话框的顶部。此事件允许托管应用将对话框顶部滚动到视图中。
dialogType 字符串 对话框的类型。目前仅支持“钻探”的打开或关闭操作对话框类型会触发此事件。
placement 字符串 对话框的放置位置。类型为“钻研”的对话框始终使用“封面”的 placement
open 布尔值 指示对话框是处于打开还是滚动状态。

更改 iframe

准备好 iframe 以进行数据检索后,您可以按照以下步骤对 iframe 进行更改:

  1. 以 JSON 格式编写请求
  2. 将请求发布到 iframe 的 contentWindow

以 JSON 格式编写请求

您可以对 iframe 进行一些更改,并以 JSON 表单的形式提交。本页的操作参考部分介绍了可用的选项。别忘了使用 JSON.stringify 将操作转换为 JSON,如下所示:

var my_request = JSON.stringify(
  {
    type: "dashboard:run"
  }
);

将请求发布到 iframe 的 contentWindow 属性

最后,将您的消息发布到 iframe 的 contentWindow,如下所示:

var my_iframe = document.getElementById("my_iframe_id");

my_iframe.contentWindow.postMessage(my_request, 'https://instance_name.looker.com');

操作摘要表

下表总结了操作。选择一项操作即可查看有关该操作的详细信息。

操作 操作说明
dashboard:load 在 iframe 中加载新信息中心,替换现有信息中心。
dashboard:run 在 iframe 中运行信息中心。
dashboard:edit 添加 22.20 将信息中心切换到修改模式
dashboard:filters:update 更新 iframe 中的现有信息中心过滤条件。
dashboard:options:set 将新值写入信息中心布局和信息中心元素属性。
dashboard:schedule_modal:open 打开调度器,让用户能够将 Looker 内容传送到各个目标位置。
dashboard:stop 停止正在运行的信息中心或正在重新加载数据的信息中心。
look:run 在 iframe 中运行外观。
look:filters:update 更新 iframe 中的现有外观过滤条件。
explore:run 在 iframe 中运行“探索”。
explore:filters:update 更新或移除 iframe 中的现有“探索”过滤器。
session:tokens:request 响应 session:tokens:request 事件发送令牌。
env:host:scroll 向嵌入的 Looker 应用发送有关主机 iframe 当前滚动位置的信息。

操作参考文档

以下是您可以发布到嵌入式 iframe 的可用操作:

dashboard:load

使用此操作可在 iframe 中加载新信息中心,从而替换现有信息中心。新信息中心将开始执行查询,就好像新信息中心页面已打开一样。

{
  type: "dashboard:load",
  id: "101",
  pushHistory: false
}
属性 格式 说明
type 字符串 使用 dashboard:load 类型表示您要将新的信息中心加载到 iframe 中。
id 字符串 要加载的信息中心的 ID。
pushHistory 布尔值 如果为 true,则已加载的信息中心会创建新的浏览器历史记录条目,并且用户可以使用浏览器的返回按钮返回之前的信息中心。如果为 false,则当前信息中心会被替换,并且无法使用浏览器导航功能返回到该信息中心。

dashboard:run

使用此操作可在 iframe 中运行信息中心。这与点击信息中心内的运行重新加载数据按钮的效果相同。

{
  type: "dashboard:run"
}
属性 格式 说明
type 字符串 使用类型 dashboard:run 表示您要运行信息中心。

dashboard:edit

添加 22.20 使用此操作可将 iframe 中的现有信息中心切换到修改模式。这与从信息中心菜单中选择修改信息中心的操作相同。

{
  type: "dashboard:edit"
}
属性 格式 说明
type 字符串 使用类型 dashboard:edit 表示您想将信息中心切换到修改模式

dashboard:filters:update

您可以使用此操作更新 iframe 中的现有信息中心过滤条件。您无法使用此方法向信息中心添加新的过滤条件。

{
  type: "dashboard:filters:update",
  filters: {
    "Sale date": "Last 28 days",
    "Sale amount": "Greater than 100"
  }
}
属性 格式 说明
type 字符串 使用 dashboard:filters:update 类型表示您要更新信息中心使用的过滤条件。
filters 对象 您要应用到信息中心的新过滤条件。此对象的格式为:{"Filter name 1": "value 1", "Filter name 2": "value 2", ...}

dashboard:options:set

此操作在 dashboard:run:complete 事件发生后可用。

嵌入器会创建消息并将其发送到 iframe,但直到 dashboard:run:complete 发生后,信息中心才会响应。dashboard:options:set 操作会将新值写入信息中心布局和信息中心元素属性。只有在 dashboard:run:complete 事件的 options 属性中返回的属性才能使用 dashboard:options:set 进行更新。之前未由 dashboard:run:complete 事件的 options 属性返回的所有属性集都会被忽略。

{
  type: "dashboard:options:set",
  layouts: [
    {
      id: 1,
      dashboard_id: 1,
      type: "newspaper",
      active: true,
      column_width: null,
      width: null,
      deleted: false,
      dashboard_layout_components: [
        {
          id: 1,
          dashboard_layout_id: 1,
          dashboard_element_id: 1,
          row: 0,
          column: 0,
          width: 8,
          height: 4,
          deleted: false
        },
        {
          id: 2,
          dashboard_layout_id: 1,
          dashboard_element_id: 2,
          row: 0,
          column: 8,
          width: 8,
          height: 4,
          deleted: false
        }
      ]
    }
  ],
  elements: {
    1: {
      title: "Total Orders",
      title_hidden: false,
      vis_config: {
        type: "single_value",
        font_size: "medium",
        title: "Total Orders"
      }
    },
    2: {
      title: "Average Order Profit",
      title_hidden: false,
      vis_config: {
        type: "single_value",
        title: "Average Order Profit"
      }
    }
  }
}
属性 格式 说明
type 字符串 使用类型 dashboard:options:set 表示您想向信息中心布局和信息中心元素属性写入新值。
layouts 对象 dashboard:run:complete 事件中的 options 属性返回的信息中心布局属性。其格式类似于:

  • id: "string",
  • dashboard_id: "string",
  • type: "newspaper",
  • active: boolean,
  • column_width: number,
  • width: number
layouts.dashboard_layout_components 对象 dashboard:run:complete 事件中的 options 属性返回的一个或多个信息中心布局组件对象。这些值的格式类似于:

  • id: "string",
  • dashboard_layout_id: "string",
  • dashboard_element_id: "string",
  • row: number,
  • column: number,
  • width: number,
  • height: number,
  • deleted: boolean,
elements 对象 dashboard:run:complete 事件中的 options 属性返回的一个或多个信息中心元素对象。这些标记的格式类似于:

id: {

  title: "string",

  title_hidden: boolean,

  vis_config: {

    type: "string", title: "string"

  }

}

dashboard:schedule_modal:open

使用此操作打开调度程序,用户可以将 Looker 内容传送到各个目标位置。

{
  type: "dashboard:schedule_modal:open"
}
属性 格式 说明
type 字符串 使用类型 dashboard:schedule_modal:open 表示您想打开时间表对话框。

dashboard:stop

使用此操作可停止正在运行的信息中心或重新加载数据。这与点击信息中心上的取消按钮的操作相同。使用 dashboard:stop 停止的仪表板会发送一个 dashboard:run:complete 事件,并将 status: 设置为 "stopped"

{
  type: "dashboard:stop"
}
属性 格式 说明
type 字符串 使用类型 dashboard:stop 表示您想停止正在运行的信息中心。

look:run

使用此操作可在 iframe 中运行用于构建外观的查询。此操作与点击 Look 上的 Run 按钮类似,不同之处在于 look:run 始终会直接查询数据库,而不会从 Looker 缓存中检索数据。

{
  type: "look:run"
}
属性 格式 说明
type 字符串 使用类型 look:run 表示您要运行该外观。

look:filters:update

使用此操作可更新 iframe 中的现有 Look 过滤器。您无法使用此方法向外观添加新过滤条件。

{
  type: "look:filters:update",
  filters: {
    "orders.created_at": "90 days",
    "products.department": "sweaters"
  }
}
属性 格式 说明
type 字符串 使用 look:filters:update 类型表示您要更新 Look 使用的过滤条件。
filters 对象 您要应用于外观的新滤镜。此对象的格式为:{"view_name.field_name_1": "value 1", "view_name.field_name_1": "value 2", ...}

explore:run

使用此操作可在 iframe 中运行“探索”。此操作类似于在“探索”中点击运行按钮,但不同之处在于 explore:run 始终直接查询数据库,而不是从 Looker 缓存中检索数据。

{
  type: "explore:run"
}
属性 格式 说明
type 字符串 使用 explore:run 类型表示您想要运行“Explore”。

explore:filters:update

您可以使用此操作更新或移除 iframe 中的现有探索过滤条件。添加引用有效字段的新过滤条件会将新过滤条件添加到“探索”中。

{
  type: "explore:filters:update",
  filters: {
    "orders.created_at": "90 days",
    "orders.status": "complete"
  }
  deleteFilters:  ["products.department"]
}
属性 格式 说明
type 字符串 使用类型 explore:filters:update 表示您想更新“探索”功能使用的过滤条件。
filters 对象 您要应用于“探索”的新过滤条件。如果 filters 包含目前不存在于“探索”中但引用有效字段的过滤条件,系统会将该过滤条件添加到“探索”中。此对象的格式为:{"view_name.field_name_1": "value 1", "view_name.field_name_1": "value 2", ...}
deleteFilters 数组 您要从“探索”中移除的现有过滤条件。数组的格式为:["view_name.field_name_1", "view_name.field_name_2", ...]

session:tokens:request

使用此操作发送令牌以响应 session:tokens:request 请求。

{
  type: "session:tokens:request",
}
属性 格式 说明
type 字符串 使用类型 session:tokens:request 表示您希望在响应 session:tokens:request 事件时发送令牌。

env:host:scroll

您可以使用此操作将有关主机 iframe 当前滚动位置的信息发送到嵌入的 Looker 应用。

{
  type: "env:host:scroll",
  offsetTop: 10,
  offsetLeft: 10,
  scrollX: 5,
  scrollY: 5
}
属性 格式 说明
type 字符串 使用类型 env:host:scroll 表示您希望向嵌入的 Looker 应用发送有关主机 iframe 当前滚动位置的信息。
offsetTop 数字 iframe 的顶部偏移量。
offsetLeft 数字 iframe 左边的偏移量。
scrollX 数字 应用主机的 scrollX 位置。
scrollY 数字 应用宿主的滚动 Y 位置。