Skip to content

Commit dca57b9

Browse files
authored
Merge pull request #2753 from MicrosoftDocs/user/pabrosse/widget-ot
Remove experimental flag and OT from PWA widgets doc
2 parents ce667f1 + d8299e5 commit dca57b9

3 files changed

Lines changed: 9 additions & 33 deletions

File tree

Binary file not shown.
Binary file not shown.

microsoft-edge/progressive-web-apps-chromium/how-to/widgets.md

Lines changed: 9 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -6,14 +6,10 @@ ms.author: msedgedevrel
66
ms.topic: conceptual
77
ms.prod: microsoft-edge
88
ms.technology: pwa
9-
ms.date: 06/14/2023
9+
ms.date: 08/04/2023
1010
---
1111
# Build PWA-driven widgets
1212

13-
![Experimental feature](./widgets-images/experimental-tag.png)
14-
15-
**Note:** Support for the `widgets` manifest member and associated JavaScript APIs, documented below, is experimental and depends on Microsoft Windows functionality that's not widely available yet.
16-
1713
Various operating systems have widgets dashboards that let users read content and perform tasks. Examples of this include Android Home Screen widgets, macOS Dashboard and Today Panel widgets, the Apple Touch Bar, Samsung Daily Cards, Mini App widgets, and smart watch app companions.
1814

1915
On Windows 11, widgets appear in the widgets board which you open from the left corner of your taskbar:
@@ -24,39 +20,15 @@ In Windows 11, Progressive Web Apps (PWAs) can define widgets, update them, and
2420

2521

2622
<!-- ====================================================================== -->
27-
## Enable widgets in Microsoft Edge
28-
29-
Widgets are experimentally supported starting with Microsoft Edge 108.
30-
31-
#### Enable local development of widgets
32-
33-
To enable developing widgets on your local machine:
34-
35-
1. Install [WinAppSDK 1.2](/windows/apps/windows-app-sdk/older-downloads#windows-app-sdk-12).
36-
37-
1. In Microsoft Edge, go to `edge://flags`.
38-
39-
1. In the **Search flags** text box, type **Web App widgets**, and then in the **Web App widgets** dropdown menu, select **Enabled**:
40-
41-
![Enabling the Web App widgets flag in the edge://flags page](./widgets-images/widgets-flag.png)
23+
## Install WinAppSDK
4224

43-
1. In the **Search flags** text box, this time type **Experimental Web Platform Features**, and then in the **Experimental Web Platform Features** dropdown menu, select **Enabled**:
44-
45-
![Enabling the Experimental Web Platform Features flag in the edge://flags page](./widgets-images/experimental-features-flag.png)
46-
47-
1. Click the **Restart** button, which appears in the lower right.
48-
49-
#### Enable widgets for your users
50-
51-
To enable widget support in Microsoft Edge for users of your production PWA, enroll your site in the [Web App Widgets](https://developer.microsoft.com/microsoft-edge/origin-trials/web-app-widgets/registration/) origin trial.
52-
53-
To learn more about origin trials, see [Enroll your site in an origin trial](./origin-trials.md#enroll-your-site-in-an-origin-trial) in _Experimental features and origin trials_.
25+
To enable developing widgets on your local machine, install [WinAppSDK 1.2](/windows/apps/windows-app-sdk/older-downloads#windows-app-sdk-12).
5426

5527

5628
<!-- ====================================================================== -->
5729
## Define widgets
5830

59-
widgets are defined in your PWA manifest file, by using the `widgets` manifest member. This manifest member is an array that can contain multiple widget definitions.
31+
Widgets are defined in your PWA manifest file, by using the `widgets` manifest member. This manifest member is an array that can contain multiple widget definitions.
6032

6133
```json
6234
{
@@ -413,10 +385,14 @@ async function updateWidget(widget) {
413385

414386
PWAmp is a music player PWA demo application that defines a widget. The PWAmp widget lets users visualize the current song and play the previous or next songs.
415387

416-
1. Follow the instructions in [enable widgets in Microsoft Edge](#enable-widgets-in-microsoft-edge).
388+
1. If not done yet, install [WinAppSDK 1.2](/windows/apps/windows-app-sdk/older-downloads#windows-app-sdk-12).
389+
417390
1. Go to [PWAmp](https://microsoftedge.github.io/Demos/pwamp/) and install the app on Windows 11.
391+
418392
1. Open the Windows 11 widgets board by pressing **Windows logo key + W**.
393+
419394
1. Click **Add widgets** to open the **widgets settings** screen, scroll to the **PWAmp mini player** widget and add it.
395+
420396
1. Close the **widgets settings** screen. The **PWAmp mini player** is now displayed in the widgets board.
421397

422398
The PWAmp widget displays the current song and buttons to play the previous or next song.

0 commit comments

Comments
 (0)