SharePoint Framework v1.17 release notes

This release introduces updates across the features around Microsoft Viva, Microsoft Teams, Outlook, Office, and SharePoint.

Released: April 4, 2023

Important

This page addresses details related to a specific SPFx release version. This page doesn't include additional SPFx prerequisites that must be installed in order to develop SPFx solutions, including Node.js, Yeoman, and other tools.

To learn more about these prerequisites, see Set up your SharePoint Framework development environment.

Install the latest version

Install the latest release of the SharePoint Framework (SPFx) by including the @latest

npm install @microsoft/generator-sharepoint@latest --global

Upgrading projects from v1.16.1 to v1.17

In the project's package.json file, identify all SPFx v1.16.1 packages. For each SPFx package:

  1. Uninstall the existing v1.16.1 package:

    npm uninstall @microsoft/{spfx-package-name}@1.16.1
    
  2. Install the new v1.17 package:

    npm install @microsoft/{spfx-package-name}@latest --save --save-exact
    

Tip

The CLI for Microsoft 365 provides an easy step-by-step guidance to upgrade your solutions to latest SharePoint Framework version.

New features and capabilities

  • Updates and improvements on building Microsoft 365 wide experiences with Microsoft Teams apps build with SharePoint Framework – This model enables you to build auto-hosted apps in Microsoft 365, which are extended across Microsoft Teams, Outlook and Office 365 app (office.com). Any Microsoft Teams app build with SharePoint Framework is automatically now compliant with the requirements to get the app exposed across Microsoft 365.
  • Updates and improvements on the Microsoft Viva extensibility build with SharePoint Framework.
  • General availability of the top actions for custom web parts in SharePoint.
  • Authentication improvements with popup flow support for API authentication.
  • Accessibility improvements for the web part areas.
  • Development time improvements with central configuration of developer tenant details.
  • Microsoft Teams JS SDK version update to version 2.9.1 to support new APIs, such as Live Share SDK.
  • “Sync to Teams” functionality in SharePoint app catalog update to use Teams Manifest v1.16 for the automatically created Microsoft Teams solution package – making all SPFx components exposed across the Microsoft 365 also with automatically generated packaging
  • Viva Connections Adaptive Cards Extensions update to support Adaptive Cards schema v1.5. - enabling tables and other new features for ACEs

Microsoft Teams JS SDK v2.9.1 support

Microsoft Teams JS SDK was bumped to v2.9.1 to support new API, such as LiveShare.

Support for Adaptive Cards schema v1.5 in Adaptive Cards Extensions

Adaptive Cards Extensions now support Adaptive Cards schema v1.5. For more information about the supported features in v1.5, see Adaptive Cards schema v1.5 for more details.

Support for Microsoft Teams Manifest v1.16 in Sync to Teams

"Sync to Teams" operation in SharePoint App Catalog now supports Teams Manifest v1.16. Any SPFx solution that is synchronized from app catalog to Microsoft Teams is available automatically across Microsoft 365 (Microsoft Teams, Outlook, Microsoft 365 app).

Ability to use SPFX_SERVE_TENANT_DOMAIN OS environment variable for serve configurations

Developers can use the SPFX_SERVE_TENANT_DOMAIN OS environment variable to specify the tenant domain (or site URL) for serve configurations across different SPFx solutions. If a URL in the serve configuration (for example, pageUrl for Field Customizer) contains the {tenantDomain} placeholder, it will be automatically replaced with the variable's value.

Top Actions-specific types

In previous versions, web part Top Actions' configuration was based on proxied property pane types. It led to some issues and confusion as not all the properties worked or were supported.

This version includes specific Top Actions-specific types to avoid confusion and make the configuration more clear.

See more details from documentation

onBeforeAction handler for Adaptive Card Extensions

The onBeforeAction handler is added to BaseAdaptiveCardExtension class to allow developers to run custom code before the action is executed.

  /** @virtual */
  onBeforeAction(action: IOnBeforeActionArguments): void;

Note

This method is not intended to be used to cancel the action or to change the flow. We do not recommend changing the state or the action argument.

Ability to specify initial focus element in an Adaptive Card Extension Quick View

New focusParameters virtual property allows to set focus when the view is rendered for accessibility purposes. If not overridden, the focus element defaulted to the first actionable element of the Quick View.

  /** @virtual */
  get focusParameters(): IFocusParameters | undefined;

See more details from documentation

Support for SharePoint Pages 'iframing' in Teams applications

Developers can specify supportsSelfFramingInTeams flag in a web part's manifest if the scenario requires the web part to render SharePoint page in an <iframe>.

Ability to specify claims parameter when requesting an Azure Active Directory OAuth2 token

AADTokenProvider.getToken definition was updated to allow specifying claims parameter:

getToken(resourceEndpoint: string, options?: IGetTokenOptions): Promise<string>;

Where IGetTokenOptions:

interface IGetTokenOptions {
  useCachedToken?: boolean;
  claims?: string;
}

AadTokenProvider now supports popup flow. Developers should handle AadTokenProvider.popupEvent: SPEvent<PopupEventArgs> event to implement the flow.

For more details, see PopupEventArgs definitions in the API reference documentation.

For more information on implementing the popup flow, see Working with the AADTokenProvider.

PropertyPaneLink now supports ariaLabel property.

interface IPropertyPaneLinkProps {
  // ...

  /**
   * Adds an aria label to the link for accessibility.
   */
  ariaLabel?: string;

  // ...
}

Fixed Issues

Here's a list of specific issues fixed around SharePoint Framework since the previous public release.

February-March Timeframe

  • #8705 - Live Share SDK doesn't work in SPFx web part

December-February Time Frame

  • #8623 - 1.16.1 Issue: Cannot find manifest for f9e737b7-f0df-4597-ba8c-3060f82380db_1.16.1. Store had [1.16.0]. Service worker version: (none),DurableN1=true
  • #6091 - Lazy loading of custom web parts in modern pages
  • #8559 - ListView Command Set command is not displayed for a list that was placed on a modern page and only 1 item is select there
  • #8683 - Permission Error with Form Customizer for new form
  • #8540 - Web part property updates causes child component to remount and lose state
  • #8552 - SPFx Field Customizer - onInit executes multiple times when navigating between folders in same document library
  • #8619 - Vulnerability introduced by CVE-2022-37601 in loader-utils package