请注意，您正在查看 Looker 文档。如需查看 Looker Studio 文档，请访问 https://support.google.com/looker-studio。

此页面由 Cloud Translation API 翻译。

嵌入式 JavaScript 事件

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

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

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

使用 Looker 的嵌入软件开发套件 (SDK)，如嵌入 SDK 文档页面中所述
使用 JavaScript 事件，如本页中的在 JavaScript 中访问事件部分所述

准备工作

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

向 iframe 添加 ID。
将嵌入网域添加到 iframe src 属性。
将嵌入网域添加到许可名单。

向 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=2。sdk=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 的网域添加到许可名单中：

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

重要提示：请勿在域名网址中添加尾部斜杠 (/)。
点击更新。

您可以使用许可名单中的 * 通配符创建网域模式。例如，https://*.myownpersonaldomain.com 会同时允许 https://analytics.myownpersonaldomain.com 和 https://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 时创建的。当用户执行以下任一任务时，系统都会创建此事件：

点击 Edit（修改）按钮以修改 Look，然后点击 Save（保存）
使用保存 > 另存为… 菜单选项保存外观
将外观从一个文件夹移至另一个文件夹

如果通过保存 > 保存 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 进行更改：

以 JSON 格式编写请求。
将请求发布到 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 位置。

嵌入式 JavaScript 事件

准备工作

向 iframe 添加 ID

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

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

从 iframe 中检索数据

在 JavaScript 中访问事件

事件类型摘要表

事件类型参考文档

dashboard:loaded

dashboard:run:start

dashboard:run:complete

dashboard:download

dashboard:edit:start

dashboard:edit:cancel

dashboard:save:complete

dashboard:delete:complete

dashboard:tile:start

dashboard:tile:complete

dashboard:tile:download

dashboard:tile:explore

dashboard:tile:view

dashboard:filters:changed

look:ready

look:run:start

look:run:complete

look:save:complete

look:delete:complete

drillmenu:click

drillmodal:download

drillmodal:explore

explore:ready

explore:run:start

explore:run:complete

explore:state:changed

page:changed

page:properties:changed

session:tokens

session:status

env:client:dialog