Behandeln von Ereignissen, die von Komponenten des Microsoft Graph-Toolkits verfügbar gemacht werden

Viele Komponenten des Microsoft Graph-Toolkits geben benutzerdefinierte Ereignisse aus. Durch das Anfügen von Ereignishandlern an diese Ereignisse können Sie darauf reagieren und das Verhalten Ihrer App steuern.

Ermitteln, welche Ereignisse von Komponenten ausgegeben werden

Jede Komponente des Microsoft Graph-Toolkits gibt unterschiedliche Ereignisse aus, die für ihre Funktionalität gelten. Die Liste der von der jeweiligen Komponente ausgegebenen Ereignisse finden Sie im Abschnitt Ereignisse der Dokumentation für diese Komponente.

Wichtig

Einige Ereignisse, z. B itemClick . in der Dateilistenkomponente, werden nur ausgegeben, wenn die Standardvorlage verwendet wird. Wenn Sie eine benutzerdefinierte Vorlage verwenden, überschreiben Sie das Standardrendering, das für die Ausgabe des Ereignisses verantwortlich ist.

Hinzufügen von Ereignishandlern zu Ereignissen

Das Microsoft Graph-Toolkit verwendet die Standardfunktion EventTarget.dispatchEvent() , um benutzerdefinierte Ereignisse in seinen Komponenten ausgibt. Verwenden Sie die Standardfunktion EventTarget.addEventListener() , um einen Ereignishandler an ein benutzerdefiniertes Ereignis anzufügen, das von der Komponente eines Toolkits ausgegeben wird.

Um z. B. das von der itemClick Dateilistenkomponente ausgegebene Ereignis zu behandeln, fügen Sie Dem Code Folgendes hinzu.

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

Zugreifen auf zusätzliche Informationen, die vom Ereignis verfügbar gemacht werden

Einige ereignisse, die vom Microsoft Graph-Toolkit ausgegeben werden, enthalten zusätzliche informationen, die für das Ereignis relevant sind. Beispielsweise enthält das itemClick von der Dateilistenkomponente ausgegebene Ereignis Informationen zu der Datei, auf die in der Dateiliste geklickt wurde. Um festzustellen, ob das bestimmte Ereignis zusätzliche Informationen enthält, lesen Sie den Abschnitt Ereignisse der Dokumentation für die entsprechende Komponente.

Sie können auf die zusätzlichen Informationen zugreifen, die von einem Ereignis über die details -Eigenschaft des -Objekts bereitgestellt werden, das event an Ihren Ereignishandler übergeben wird, wie im folgenden Beispiel gezeigt.

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