Updating 1.14 release notes

Author: VesaJuvonen

docs/images/release-notes/114/file-action.jpg

@@ -1,19 +1,15 @@
 ---
 title: SharePoint Framework v1.14 release notes
 description: Release notes for the SharePoint Framework v1.14 release
-ms.date: 2/10/2022
+ms.date: 2/17/2022
 ms.prod: sharepoint
 ms.localizationpriority: high
 ---
 # SharePoint Framework v1.14 release notes
 
 There will be multiple public preview release using the **@next** tag in the [NPMJS.org](https://www.npmjs.org) registry before final release candidates and a final public release.
 
-[!INCLUDE [spfx-release-beta](../../includes/snippets/spfx-release-beta.md)]
-
-- Release Candidate 1 **Released:** February 10, 2022
-- beta.5 **Released:** January 26, 2022
-- beta.4 **Released:** December 8, 2021
+**Released:** February 17, 2021
 
 [!INCLUDE [spfx-release-notes-common](../../includes/snippets/spfx-release-notes-common.md)]
 
@@ -44,114 +40,199 @@ npm install @microsoft/generator-sharepoint@next --global
 
 ## New features and capabilities
 
-### Adaptive Card Extensions card view caching
+### Adaptive Card Extension updates for Viva Connections
+
+#### Updated the ACE scaffolding for Viva Connections
 
-For improved performance, SharePoint Framework now supports local caching of your Adaptive Card Extension's card views. The cached card view will be immediately rendered when loading your Adaptive Card Extension. After Adaptive Card Extension loads, it can optionally update the card view.
+Updated Adaptive Card Extensions scaffolding to be more succinct.
+
+#### Get Current ViewNavigator for Adaptive Card Extension
 
 ```typescript
-interface ICacheSettings {
-/**
- * Whether cache is enabled. Default: true
- */
-isEnabled: boolean;
-/**
- * Expiry time in seconds. Default: 86400 seconds (24 hours)
- */
-expiryTimeInSeconds: number;
-
-/**
- * Returns the Card View used to generate the cached card.
- * By default, the currently rendered Card View will be used to cache the card.
- */
-cachedCardView?: () => BaseCardView;
-}
-BaseAdaptiveCardExtension.getCacheSettings(): Partial<ICacheSettings>;
+BaseAdaptiveCardExtension.navigator
 ```
 
-By default caching is enabled with default settings. An Adaptive Card Extension can customize its
-cache settings by overriding `getCacheSettings` to return the settings it wants to override.
+If the current `renderType` is `Card` then returns `BaseAdaptiveCardExtension.cardNavigator`. If the current `renderType` is `QuickView` then returns `BaseAdaptiveCardExtension.quickViewNavigator`.
 
-When the last known card view shouldn't be cached, you can provide a specific card view to be
-cached and displayed on the next page load through `ICacheSettings.cachedCardView`. This card view
-doesn't need to have been previously registered.
+### List View Command Set Updates
 
-An Adaptive Card Extension can also locally cache its current state. By default no state is cached.
+#### Inform ListView on Command Set Changes
 
 ```typescript
-BaseAdaptiveCardExtension.getCachedState(state: TState): Partial<TState>;
+BaseListViewCommandSet.raiseOnChange: () => void
 ```
 
-If `getCachedState` is overridden, then the cached values will be provided when the Adaptive Card
-Extension is initialized on the next page load.
+Use this method to fire `onChange` event and initialize a reflow of the ListView.
 
-`onInit` has a new overload, which passes information about the cached card state. If the card wasn't
-loaded from a cached card view, then `cachedLoadParameters` will be `undefined`.
+#### Expanded List View Accessor State
+
+`ListViewAccessor` provides expanded state of the current list view. **New** state properties are listed below.
+
+- `rows` - currently rendered rows in the list view.
+- `selectedRows` - selected rows in the list view.
+- `list` - basic information about the list rendered by the list view.
+- `view` - basic information about the view rendered by the list view.
+- `folderInfo` - folder information for the list view.
+- `appliedFilters` - filters applied to the list view.
+- `sortField` - sort field name.
+- `sortAscending` - specifies whether the list view is sorted ascending or descending.
+
+#### List View State Changed Event
 
 ```typescript
-interface ICachedLoadParameters {
-    state: TState;
-}
-BaseAdaptiveCardExtension.onInit(cachedLoadParameters?: ICachedLoadParameters): Promise<void>;
+ListViewAccessor.listViewStateChangedEvent: SPEvent<ListViewStateChangedEventArgs>
 ```
 
-Initial state of the Adaptive Card Extension can be seeded from the cached state. The cached state can also be used to determine if any further logic needs to be executed.
+This event gets raised every time the list view state changes. The arguments contain type of occured event (see `ListViewAccessorStateChanges`) and previous state of the list view (see `IListViewAccessorState`).
 
-State caching and the cache expiry time can be used to determine when
-expensive remote calls need to be made by the Adaptive Card Extension.
+#### List Command Set Command Disabled Property
 
-Caching can help significantly improve the perceived performance for your Adaptive Card Extension.
+```typescript
+Command.disabled: boolean | undefined;
+```
+
+### Web Part specific updates
 
-### Web Part lifecycle method for theme changes
+#### Predefined Web Part Picker Group for Web Parts in Development
+
+```typescript
+PredefinedGroup.Local = '8b7bf6f1-a56a-4aa3-8657-7eb6e7e6af61';
+```
+
+The group displays locally debugged web parts.
+
+#### Callback to Clear DOM Element Before Loading Indicator or Error Element is Displayed
+
+```typescript
+IClientSideWebPartStatusRenderer.displayLoadingIndicator(domElement: Element, loadingMessage: string, timeout?: number, clearDomElementCallback?: ClearDomElementCallback): void;
+IClientSideWebPartStatusRenderer.renderError(domElement: HTMLElement, error: Error | string, clearDomElementCallback?: ClearDomElementCallback);
+```
+
+Use `clearDomElementCallback` to clear the DOM node.
+
+#### Web Part lifecycle method for theme changes
 
 ```typescript
 BaseClientSideWebPart.onThemeChanged(theme: IReadonlyTheme | undefined): void;
 ```
 
-When a theme is initialized or changed on a page, `onThemeChanged` will be invoked with the new theme.
+When a theme is initialized or changed on a page, `onThemeChanged` will be invoked with the new
+theme.
 
-> [!NOTE]
+> [!IMPORTANT]
 > `render` should not be invoked in `onThemeChanged`. Calling `render` can lead to unpredicted re-flow of the web part. `render` will automatically be invoked if needed.
 
-### Detect if a component is loading from localhost
+#### Updated Web Part Templates
+
+- No Framework, and React templates are updated with new user-friendly UI
+- New "Minimal" template is added: allows to start development with the minimal amount of code provisioned.
+
+### Other generic updates and changes
+
+#### Changes to Scaffolding Options and Prompts
+
+The next propmts were deprecated in favor to their defaults:
+
+- Solution description
+- Environment (SharePoint) version
+- Tenant-wide deployment
+- Isolated permissions
+- Component description
+
+#### Detect if a component is loading from localhost
 
 ```typescript
 BaseComponentContext.isServedFromLocalhost(): boolean;
 ```
 
 Any SPFx component can now check if it's currently running from code served locally.
 
-### Hide a Property Pane group name
+#### Hide a Property Pane group name
 
 ```typescript
 IPropertyPaneGroup.isGroupNameHidden?: boolean;
 ```
 
-`isGroupNameHidden` can be used to skip the rendering of the Property Pane group name to avoid an empty group header being displayed.
+`isGroupNameHidden` can be used to skip the rendering of the Property Pane group name to avoid an
+empty group header being displayed.
 
 The default value of `isGroupNameHidden` is false.
 
-### Updated Web Part Templates
+#### ipAddress Property in serve.json
+New property `ipAddress` has been added to `serve.json` configuration. This parameter is helpful when using Docker containers. For example, to set the serve host as '0.0.0.0'.
+This property will be explicitly used to wind up the server, meaning all debug URLs and webpack configurations will not be affected.
 
-- No Framework, and React templates are updated with new end-user friendly UI for SharePoint and Microsoft Teams with theme detection, section background color support and more.
-- New "Minimal" template is added: allows to start development with the minimal amount of code provisioned.
+## Preview Features and Capabilities
+
+Following features are still in preview status as part of the 1.14 release and should not be used in production. We are looking into releasing them officially as part of the upcoming 1.15 release.
+
+### Adaptive Card Extensions card view caching
 
-### Get Current ViewNavigator for Adaptive Card Extension
+For improved performance, SPFx now supports local caching of your Adaptive Card Extension's
+card views. The cached card view will be immediately rendered when loading your Adaptive Card
+Extension. After your Adaptive Card Extension loads, it can optionally update the card view.
 
 ```typescript
-BaseAdaptiveCardExtension.navigator
+interface ICacheSettings {
+  /**
+   * Whether cache is enabled. Default: true
+   */
+  isEnabled: boolean;
+  /**
+   * Expiry time in seconds. Default: 86400 seconds (24 hours)
+   */
+  expiryTimeInSeconds: number;
+
+  /**
+   * Returns the Card View used to generate the cached card.
+   * By default, the currently rendered Card View will be used to cache the card.
+   */
+  cachedCardView?: () => BaseCardView;
+}
+BaseAdaptiveCardExtension.getCacheSettings(): Partial<ICacheSettings>;
 ```
 
-If the current `renderType` is `Card` then returns `BaseAdaptiveCardExtension.cardNavigator`. If the current `renderType` is `QuickView` then returns `BaseAdaptiveCardExtension.quickViewNavigator`.
+By default caching is enabled with default settings. An Adaptive Card Extension can customize its
+cache settings by overriding `getCacheSettings` to return the settings it wants to override.
 
-#### Error Handler Method. This method will be invoked when an Action throws an error.
+When the last known card view shouldn't be cached, you can provide a specific card view to be
+cached and displayed on the next page load through `ICacheSettings.cachedCardView`. This card view
+doesn't need to have been previously registered.
+
+An Adaptive Card Extension can also locally cache its current state. By default no state is cached.
+
+```typescript
+BaseAdaptiveCardExtension.getCachedState(state: TState): Partial<TState>;
+```
+
+If `getCachedState` is overridden, then the cached values will be provided when the Adaptive Card
+Extension is initialized on the next page load.
+
+`onInit` has a new overload, which passes information about the cached card state. If the card wasn't
+loaded from a cached card view, then `cachedLoadParameters` will be `undefined`.
+
+```typescript
+interface ICachedLoadParameters {
+    state: TState;
+}
+BaseAdaptiveCardExtension.onInit(cachedLoadParameters?: ICachedLoadParameters): Promise<void>;
+```
+
+Your Adaptive Card Extension's initial state can be seeded from the cached state. The cached state can also be used to determine if any further logic needs to be executed.
+
+State caching and the cache expiry time can be used to determine when expensive remote calls need to be made by the Adaptive Card Extension.
+
+Caching can help significantly improve the perceived performance for your Adaptive Card Extension.
+
+### Error Handler Method. This method will be invoked when an Action throws an error
 
 ```typescript
 BaseView.onActionError(error: IActionErrorArguments): void
 ```
 
 Override this method to handle errors from Adaptive Card actions.
 
-### New Action types for media and geolocation.
+### New Action types for media and geolocation
 
 > [!NOTE]
 > These new actions are **only available in the browser** currently. Viva Connections desktop and Viva Connections mobile support will be enabled later.
@@ -165,6 +246,7 @@ Get Location  | Not Supported | Supported | Supported
 Show Location | Not Supported | Supported | Supported
 
 ```typescript
+
 ISPFxAdaptiveCard.actions?: (
     | ISubmitAction
     | IOpenUrlAction
@@ -189,7 +271,7 @@ The SelectMedia and Location action can be configured as shown below:
       type: 'VivaAction.GetLocation',
       id: 'Get Location',
       parameters: {chooseLocationOnMap: true}
-    },
+    }
     {
       type: 'VivaAction.ShowLocation',
       id: 'Show Location',
@@ -198,79 +280,23 @@ The SelectMedia and Location action can be configured as shown below:
   ]
 ```
 
-### List View Command Set Updates
-
-> [NOTE!]
-> Although the APIs are added, the functionality may not be available on some tenants.
-
-#### Inform ListView on Command Set Changes
-
-```typescript
-BaseListViewCommandSet.raiseOnChange: () => void
-```
-
-Use this method to fire `onChange` event and initialize a reflow of the ListView.
+The actions  will be rendered as below
 
-#### Expanded List View Accessor State
+Location Action:
 
-`ListViewAccessor` provides expanded state of the current list view. **New** state properties are listed below.
+![Image showing a site footer with a logo](../images/release-notes/114/___location-action.jpg)
 
-- `rows` - currently rendered rows in the list view.
-- `selectedRows` - selected rows in the list view.
-- `list` - basic information about the list rendered by the list view.
-- `view` - basic information about the view rendered by the list view.
-- `folderInfo` - folder information for the list view.
-- `appliedFilters` - filters applied to the list view.
-- `sortField` - sort field name.
-- `sortAscending` - specifies whether the list view is sorted ascending or descending.
-
-#### List View State Changed Event
-
-```typescript
-ListViewAccessor.listViewStateChangedEvent: SPEvent<ListViewStateChangedEventArgs>
-```
+Select Media Action:
 
-This event gets raised every time the list view state changes. The arguments contain type of occurred event (see `ListViewAccessorStateChanges`) and previous state of the list view (see `IListViewAccessorState`).
+![Image showing a site footer with a logo](../images/release-notes/114/file-action.jpg)
 
-#### List Command Set Command Disabled Property
-
-```typescript
-Command.disabled: boolean | undefined;
-```
-
-### Predefined Web Part Picker Group for Web Parts in Development
-
-```typescript
-PredefinedGroup.Local = '8b7bf6f1-a56a-4aa3-8657-7eb6e7e6af61';
-```
-
-The group displays locally debugged web parts.
-
-### Call back to Clear DOM Element Before Loading Indicator or Error Element is Displayed
-
-```typescript
-IClientSideWebPartStatusRenderer.displayLoadingIndicator(domElement: Element, loadingMessage: string, timeout?: number, clearDomElementCallback?: ClearDomElementCallback): void;
-IClientSideWebPartStatusRenderer.renderError(domElement: HTMLElement, error: Error | string, clearDomElementCallback?: ClearDomElementCallback);
-```
-
-Use `clearDomElementCallback` to clear the DOM node.
-
-### ipAddress Property in serve.json
-
-New property `ipAddress` has been added to `serve.json` configuration. This parameter is helpful when using Docker containers. For example, to set the serve host as '0.0.0.0'.
-This property will be explicitly used to wind up the server, meaning all debug URLs and webpack configurations won't be affected.
+The Location Action can be used to get your current ___location, show your current or a custom ___location on a map, and choose your current ___location from a map. In the browser it uses Bing Maps as the mapping interface:
 
+![Image showing a site footer with a logo](../images/release-notes/114/___location-panel.jpg)
 
-### Changes to Scaffolding Options and Prompts
+The Select Media Action can be used to select Images from your native device. In the browser it uses the file picker to help access relavant files:
 
-- New prompt for solution description is added.
-- "Tenant-wide deployment" prompt is removed. The property is set to `true` by default and can be changed manually or using `skip-feature-deployment` argument.
-- The next prompts were deprecated in favor to their defaults:
-  - Solution description
-  - Environment (SharePoint) version
-  - Tenant-wide deployment
-  - Isolated permissions
-  - Component description
+![Image showing a site footer with a logo](../images/release-notes/114/media-panel.jpg)
 
 ## Deprecations and removed items in this release
 

docs/images/release-notes/114/___location-action.jpg

@@ -450,7 +450,7 @@
     items:
     - name: Overview
       href: spfx/roadmap.md
-    - name: SPFx v1.14 RC - February 10, 2022
+    - name: SPFx v1.14 - February 17, 2022
       href: spfx/release-1.14.md
     - name: SPFx v1.13.1 - November 23, 2021
       href: spfx/release-1.13.1.md