处理 Microsoft Graph 工具包组件公开的事件

许多 Microsoft Graph 工具包组件发出自定义事件。 将事件处理程序附加到这些事件允许你响应它们并控制应用的行为。

发现组件发出哪些事件

每个 Microsoft Graph 工具包组件发出特定于其功能的不同事件。 若要查看特定组件发出的事件列表,请参阅该组件的文档 的“事件 ”部分。

重要

某些事件(如 itemClick 文件列表组件)仅在使用默认模板时发出。 如果使用自定义模板,将覆盖负责发出事件的默认呈现。

向事件添加事件处理程序

Microsoft Graph 工具包使用标准 EventTarget.dispatchEvent() 函数在其组件中发出自定义事件。 若要将事件处理程序附加到工具包组件发出的自定义事件,请使用标准 EventTarget.addEventListener() 函数。

例如,若要处理 itemClick 文件列表组件发出的事件,请将以下内容添加到代码中。

document.querySelector('mgt-file-list').addEventListener('itemClick', e => {
  // your event handler code goes here
});

访问事件公开的其他信息

Microsoft Graph 工具包发出的某些事件包含与该事件相关的其他信息。 例如, itemClick 由文件列表组件发出的 事件包含有关在文件列表中单击的文件的信息。 若要查看特定事件是否包含其他信息,请参阅相应组件的文档 事件 部分。

可以通过传递到事件处理程序中的 event 对象的 属性访问事件details公开的其他信息,如以下示例所示。

document.querySelector('mgt-file-list').addEventListener('itemClick', e => {
  const clickedFile = e.details;
});