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;
});