New

The executive guide to generative AI

Read more
About usPartnersSupport|Login
« expressions 插件 仪表板应用程序增强插件 »
Elastic 文档 ›Kibana 指南 [8.17] ›开发者指南 ›Kibana 插件列表

UI 操作

编辑

UI 操作

编辑

UI 操作插件提供 API 来管理触发器和操作。

触发器是对用户执行操作意图的抽象描述（例如用户点击图表中的值）。它允许我们在运行时绑定来自不同插件的代码。例如，一个这样的触发器是当有人在仪表板上应用过滤器时；另一个是当有人打开仪表板面板上下文菜单时。

操作是响应触发器而执行的代码片段。例如，可以为仪表板过滤触发器附加多个操作。一旦用户在仪表板上进行过滤，所有可能的操作都会在弹出菜单中显示给用户，用户必须选择一个。

一般来说，此插件提供：

  • 创建自定义功能（操作）。
  • 创建自定义用户交互事件（触发器）。
  • 将操作附加到触发器和从触发器分离操作。
  • 触发触发器事件。
  • 执行附加到给定触发器的操作。
  • 当单个触发器附加多个操作时，公开一个上下文菜单供用户选择要执行的适当操作。

基本用法

编辑

要开始使用，首先您需要知道您将要附加操作的触发器。您可以选择现有的触发器，也可以注册自己的触发器

plugins.uiActions.registerTrigger({
  id: 'MY_APP_PIE_CHART_CLICK',
  title: 'Pie chart click',
  description: 'When user clicks on a pie chart slice.',
});

现在，当用户点击饼图切片时，您需要“触发”您的触发器并提供一些上下文数据

plugins.uiActions.getTrigger('MY_APP_PIE_CHART_CLICK').exec({
  /* Custom context data. */
});

最后，您的代码或其他插件的开发人员可以注册 UI 操作，这些操作监听上述触发器并在触发器被触发时执行一些代码。

plugins.uiActions.registerAction({
  id: 'DO_SOMETHING',
  isCompatible: async (context) => true,
  execute: async (context) => {
    // Do something.
  },
});
plugins.uiActions.attachAction('MY_APP_PIE_CHART_CLICK', 'DO_SOMETHING');

现在，当 MY_APP_PIE_CHART_CLICK 触发器被触发时，您的 DO_SOMETHING 操作将自动执行；或者，如果该触发器附加了多个兼容的操作，则会向用户显示一个上下文菜单弹出窗口，以选择一个要执行的操作。

示例

编辑

ui_action 示例

« expressions 插件 仪表板应用程序增强插件 »

On this page

Was this helpful?
Feedback