Control de eventos expuestos por componentes del kit de herramientas de Microsoft Graph

Muchos componentes del kit de herramientas de Microsoft Graph emiten eventos personalizados. La asociación de controladores de eventos a estos eventos le permite responder a ellos y controlar el comportamiento de la aplicación.

Detectar qué componentes de eventos emiten

Cada componente del kit de herramientas de Microsoft Graph emite eventos diferentes, específicos de su funcionalidad. Para ver la lista de eventos emitidos por el componente específico, consulte la sección Eventos de la documentación de ese componente.

Importante

Algunos eventos, como itemClick en el componente lista de archivos, solo se emiten cuando se usa la plantilla predeterminada. Si usa una plantilla personalizada, sobrescribirá la representación predeterminada que es responsable de emitir el evento.

Adición de controladores de eventos a eventos

Microsoft Graph Toolkit usa la función estándar EventTarget.dispatchEvent() para emitir eventos personalizados en sus componentes. Para adjuntar un controlador de eventos a un evento personalizado emitido por el componente de un kit de herramientas, use la función estándar EventTarget.addEventListener() .

Por ejemplo, para controlar el itemClick evento emitido por el componente lista de archivos, agregue lo siguiente al código.

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

Acceso a información adicional expuesta por el evento

Algunos eventos emitidos por Microsoft Graph Toolkit contienen información adicional relevante para el evento. Por ejemplo, el itemClick evento, emitido por el componente Lista de archivos, contiene información sobre el archivo en el que se hizo clic en la lista de archivos. Para ver si el evento determinado contiene información adicional, consulte la sección Eventos de la documentación del componente correspondiente.

Puede acceder a la información adicional expuesta por un evento a través de la details propiedad del event objeto que se pasa al controlador de eventos, como se muestra en el ejemplo siguiente.

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