Microsoft Graph Toolkit v3.0 GA

Microsoft Graph Toolkit v3.0 is now generally available after four months of preview and release candidates. This version provides new capabilities such as selecting an item from a collection of entities, toggling between light and dark mode, sending chat messages in the context of your application, selecting taxonomy items, providing a fully functional search experience, and leveraging an entirely new theming experience.

The Microsoft Graph Toolkit is a collection of reusable, framework-agnostic components and authentication providers for accessing and working with Microsoft Graph. The components are fully functional, customizable, and work with any web framework and on all modern browsers.

What's New in v3.0:

• Disambiguation Component: provides developers with a mechanism to use a specific version of the Toolkit in their solution without encountering collisions with other solutions that may be using the Toolkit.
• Entity Picker Component: intended to be used to select an item from a list of entities, such as a task list from a user's task lists, a user from their direct reports, a list from a site, etc.
• Dark Mode Component: this component can be used to change the theme experience from light to dark mode (and vice versa).
• Term Picker Component: built on top of the mgt-picker component, it's intended to be used to select a term from a term set.
• Search Components: provide new capabilities that allow developers to build solutions leveraging the Microsoft Graph search APIs.
  • mgt-search-box: allows users to search for content within a specific Microsoft 365 data source.
  • mgt-search-results: displays the results of the search.

Improved Scenarios:

• Seamlessly switch between accounts: the mgt-login component now offers a mechanism to allow multiple users connected to switch to a different user account.
• Quick Chat Message: a new capability that allows developers to send chat messages in the context of their application.

Updating Your Application:

To update your application to use the newest version of Microsoft Graph Toolkit, navigate to your project directory and run:

npm i @microsoft/mgt

If you're using the Toolkit via mgt-loader, update your script tag to:

<script type="module" src="https://unpkg.com/@microsoft/mgt@3.0.0/dist/mgt-loader.js"></script>

Note that this update includes breaking changes that may impact your application, such as deprecation of properties, use of the embedded Microsoft Graph client, and naming updates to CSS custom properties. The Microsoft Graph Toolkit team looks forward to hearing more feedback from the community and improving the Toolkit even further.