Développer des widgets et des tableaux de bord Windows

Widgets

Les widgets Windows sont de petits conteneurs d’interface utilisateur associés à une application installée. Le panneau Widgets les affiche dans une grille sur le bureau Windows, avec du contenu personnalisé et des actions rapides à partir de votre application. Vous pouvez définir du contenu avec Cartes adaptatives, qui lient des données à un gabarit JSON, ou afficher du code HTML à partir d’une URL avec un fournisseur de widgets web. Les widgets web utilisent toujours un payload JSON Adaptive Card pour spécifier l’URL de contenu.

Capture d’écran du panneau Widgets. La carte est un rectangle arrondi avec l’heure affichée en haut, suivie d’une barre de recherche. Le reste de la carte est une grille de rectangles arrondis chacun représentant un widget. Les widgets individuels affichent les principales actualités, la météo actuelle, le trafic actuel, etc.

Pour obtenir des conseils sur la conception, consultez Windows Vue d’ensemble de la conception des widgets.

Choisissez un chemin de développement de widget

Utilisez ce tableau pour sélectionner le chemin d’implémentation et la rubrique suivante à ouvrir.

Si vous souhaitez... Utiliser cette approche Commencer ici
Ajouter un widget Adaptive Card à une application de bureau C# empaquetée Implémentez IWidgetProvider, envoyez des mises à jour de modèle et de données avec WidgetManager et inscrivez le fournisseur via le manifeste du package. Guide pas à pas du fournisseur de widgets C#
Ajouter un widget de carte adaptative à une application de bureau C++/WinRT empaquetée Implémentez IWidgetProvider dans le serveur COM out-of-process et inscrivez son CLSID et les définitions de widget dans le manifeste du package. Guide pas à pas du fournisseur de widgets C++/WinRT
Afficher du code HTML à partir d’une URL à l’intérieur d’un widget du bureau Utilisez un fournisseur de widgets web. Cette fonctionnalité est disponible uniquement pour les utilisateurs de l’EEE. Le fournisseur envoie toujours une charge utile de carte adaptative contenant l’URL web et le contenu de secours. Fournisseurs de widgets web
Ajouter un widget pour une application web progressive existante (PWA) Définissez le widget dans le manifeste de l’application web et gérez les événements de widget dans le service worker. Ceci est distinct du chemin IWidgetProvider de bureau. Créer des widgets pilotés par les PWA
Gérez un bouton ou une action de formulaire dans votre fournisseur Desktop Utilisez Action.Execute et gérez le verbe dans OnActionInvoked. Affichez-le uniquement quand $host.isUserContextAuthenticated c’est vrai. Créer un modèle de widget
Ouvrir une page d’application ou un site web sans callback du fournisseur Utilisez Action.OpenUrl. Cela reste disponible lorsque le contexte utilisateur du widget n’est pas authentifié. Créer un modèle de widget
Permettre aux utilisateurs de configurer un widget Implémentez IWidgetProvider2, définissez l’attribut IsCustomizable du manifeste et fournissez un payload de personnalisation. Implémenter la personnalisation du widget
Adapter le contenu pour la taille, le thème, les paramètres, l’en-tête, la prise en charge web ou l’authentification Utilisez les propriétés Windows $host dans le modèle de carte adaptative et déclarez chaque taille prise en charge dans le manifeste du package. propriétés de l’hôte de widget Windows
Afficher le contenu de chargement ou le contenu lorsque l’utilisateur est déconnecté Envoyez intentionnellement un modèle et des données de secours. Définissez IsPlaceholderContent lorsque le contenu n’est pas encore personnalisé ou actionnable. Fournisseurs de widgets
Ajouter un flux de tableau de bord au lieu d’un widget individuel Implémentez un fournisseur de flux. Les fournisseurs de données sont une intégration distincte et sont disponibles uniquement dans l’EEE. Tableaux de bord et fournisseurs de flux
Demander à GitHub Copilot de créer et de valider un widget Utilisez le prompt réutilisable, qui sélectionne un chemin d’accès pris en charge et nécessite la validation du package, du manifeste, du build et du tableau de widgets. Créer un widget Windows avec GitHub Copilot

Dashboards

Les fournisseurs de flux inscrivent des flux de contenu qui apparaissent en tant que tableaux de bord dans le tableau des widgets. Un fournisseur de flux est une intégration distincte d’un fournisseur de widgets ; l’affichage du code HTML à l’intérieur d’un widget n’enregistre pas un flux de tableau de bord.

Important

Les fournisseurs de flux ne sont disponibles que pour les utilisateurs de l’Espace économique européen (EEE). Pour connaître les exigences en matière de disponibilité et d’implémentation, consultez Tableaux de bord et fournisseurs de flux.

Capture d’écran montrant le tableau de bord Découvrir

Contenu de cette section

Sujet Description
Fournisseurs de flux Découvrez comment inscrire les flux de contenu de votre application pour apparaître directement dans le tableau des widgets Windows.
Fournisseurs de widgets Découvrez comment implémenter un fournisseur de widgets qui fournit du contenu, une disposition et des éléments interactifs pour vos widgets.
Fournisseurs de widgets web Affichez du code HTML dans un widget et gérez les demandes de ressources et les messages entre votre fournisseur de contenu et le contenu web.
Concepteur de cartes adaptatives Découvrez comment créer un modèle de widget à l’aide du Concepteur Cartes adaptatives.
Créer un widget Windows avec GitHub Copilot Utilisez un prompt réutilisable pour générer, empaqueter et valider un widget dans un référentiel existant.