Compartilhar via


Processar eventos expostos por componentes do Microsoft Graph Toolkit

Cuidado

O Toolkit do Microsoft Graph foi preterido. O período de reforma começa a 1 de setembro de 2025, com a reforma completa prevista para 28 de agosto de 2026. Os programadores devem migrar para utilizar os SDKs do Microsoft Graph ou outras ferramentas suportadas do Microsoft Graph para criar experiências Web. Para obter mais informações, veja o anúncio de preterição.

Muitos componentes do Microsoft Graph Toolkit emitem eventos personalizados. Anexar processadores de eventos a estes eventos permite-lhe responder aos mesmos e controlar o comportamento da sua aplicação.

Descobrir que componentes de eventos emitem

Cada componente do Microsoft Graph Toolkit emite diferentes eventos, específicos da respetiva funcionalidade. Para ver a lista de eventos emitidos pelo componente específico, veja a secção Eventos da documentação desse componente.

Importante

Alguns eventos, como itemClick no componente Lista de ficheiros, são emitidos apenas ao utilizar o modelo predefinido. Se utilizar um modelo personalizado, substitui a composição predefinida responsável pela emissão do evento.

Adicionar processadores de eventos a eventos

O Microsoft Graph Toolkit utiliza a função padrão EventTarget.dispatchEvent() para emitir eventos personalizados nos respetivos componentes. Para anexar um processador de eventos a um evento personalizado emitido pelo componente de um toolkit, utilize a função padrão EventTarget.addEventListener() .

Por exemplo, para processar o itemClick evento emitido pelo componente Lista de ficheiros, adicione o seguinte ao código.

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

Aceder a informações adicionais expostas pelo evento

Alguns eventos emitidos pelo Microsoft Graph Toolkit contêm informações adicionais relevantes para o evento. Por exemplo, o itemClick evento, emitido pelo componente Lista de ficheiros, contém informações sobre o ficheiro que foi clicado na lista de ficheiros. Para ver se o evento específico contém informações adicionais, veja a secção Eventos da documentação do componente correspondente.

Pode aceder às informações adicionais expostas por um evento através da details propriedade do objeto transmitido para o event processador de eventos, conforme mostrado no exemplo seguinte.

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