Skip to content

Commit cf0a824

Browse files
committed
Update 1.15 release notes
1 parent 5a35d98 commit cf0a824

File tree

1 file changed

+104
-0
lines changed

1 file changed

+104
-0
lines changed

docs/spfx/release-1.15.md

Lines changed: 104 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -133,6 +133,110 @@ The ___location actions can be configured as shown below:
133133
]
134134
```
135135

136+
The actions will be rendered as below
137+
138+
Location Action:
139+
140+
![Screenshot of ___location action](../images/release-notes/114/___location-action.jpg)
141+
142+
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:
143+
144+
![Screenshot of ___location panel](../images/release-notes/114/___location-panel.jpg)
145+
146+
147+
## Preview Features and Capabilities
148+
149+
Following features are still in preview status as part of the 1.15 release and should not be used in production. We are looking into releasing them officially as part of the upcoming 1.16 release.
150+
151+
### Adaptive Card Extensions card view caching
152+
153+
For improved performance, SPFx now supports local caching of your Adaptive Card Extension's
154+
card views. The cached card view will be immediately rendered when loading your Adaptive Card
155+
Extension. After your Adaptive Card Extension loads, it can optionally update the card view.
156+
157+
```typescript
158+
interface ICacheSettings {
159+
/**
160+
* Whether cache is enabled. Default: true
161+
*/
162+
isEnabled: boolean;
163+
/**
164+
* Expiry time in seconds. Default: 86400 seconds (24 hours)
165+
*/
166+
expiryTimeInSeconds: number;
167+
168+
/**
169+
* Returns the Card View used to generate the cached card.
170+
* By default, the currently rendered Card View will be used to cache the card.
171+
*/
172+
cachedCardView?: () => BaseCardView;
173+
}
174+
BaseAdaptiveCardExtension.getCacheSettings(): Partial<ICacheSettings>;
175+
```
176+
177+
By default caching is enabled with default settings. An Adaptive Card Extension can customize its
178+
cache settings by overriding `getCacheSettings` to return the settings it wants to override.
179+
180+
When the last known card view shouldn't be cached, you can provide a specific card view to be
181+
cached and displayed on the next page load through `ICacheSettings.cachedCardView`. This card view
182+
doesn't need to have been previously registered.
183+
184+
An Adaptive Card Extension can also locally cache its current state. By default no state is cached.
185+
186+
```typescript
187+
BaseAdaptiveCardExtension.getCachedState(state: TState): Partial<TState>;
188+
```
189+
190+
If `getCachedState` is overridden, then the cached values will be provided when the Adaptive Card
191+
Extension is initialized on the next page load.
192+
193+
`onInit` has a new overload, which passes information about the cached card state. If the card wasn't
194+
loaded from a cached card view, then `cachedLoadParameters` will be `undefined`.
195+
196+
```typescript
197+
interface ICachedLoadParameters {
198+
state: TState;
199+
}
200+
BaseAdaptiveCardExtension.onInit(cachedLoadParameters?: ICachedLoadParameters): Promise<void>;
201+
```
202+
203+
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.
204+
205+
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.
206+
207+
Caching can help significantly improve the perceived performance for your Adaptive Card Extension.
208+
209+
210+
### New Action types for media
211+
212+
After General Availability the support matrix for media action will be as follows:
213+
214+
Action | Viva Connection Desktop | Viva Connections Mobile | Browser
215+
------------- | ------------- | ------------- | -------------
216+
Select Media | Supported | Supported | Supported
217+
218+
219+
The SelectMedia can be configured as shown below:
220+
221+
```typescript
222+
actions: [
223+
{
224+
type: 'VivaAction.SelectMedia',
225+
id: 'Select File',
226+
parameters: {mediaType: MediaType.Image, allowMultipleCapture: true, maxSizePerFile : 200000, supportedFileFormats: ['jpg']},
227+
title: 'Select File'
228+
}
229+
]
230+
```
231+
232+
Select Media Action rendering:
233+
234+
![Screenshot of file action](../images/release-notes/114/file-action.jpg)
235+
236+
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:
237+
238+
![Screenshot of media panel](../images/release-notes/114/media-panel.jpg)
239+
136240
## Deprecations
137241

138242
- Deprecated SPComponentLoader#getManifests due to runtime performance overhead.

0 commit comments

Comments
 (0)