Fournisseurs de widgets

Windows widgets sont de petits conteneurs d’interface utilisateur qui affichent du contenu fourni par une application Windows ou une application web progressive (PWA). Vous pouvez fournir un modèle de carte adaptative et des données, ou utiliser un widget web pour afficher du code HTML à partir d’une URL. Les widgets web utilisent toujours un payload JSON Adaptive Card pour spécifier l’URL de contenu.

Pour une application de bureau empaquetée, vous implémentez un fournisseur de widgets qui répond aux demandes de l’hôte du widget et envoie des mises à jour via WidgetManager. Une PWA utilise les définitions de widgets dans son manifeste d’application web et gère les événements de widget dans son service worker.

Pour obtenir une vue d’ensemble de l’expérience des widgets Windows et des conseils de conception pour la création de vos propres widgets, consultez Windows widgets.

Actuellement, vous pouvez implémenter un fournisseur de widgets en utilisant une application de bureau Win32 packagée ou une application web progressive (PWA). Pour plus d’informations, consultez les pages suivantes :

API et fonctionnalités du fournisseur de widgets de bureau

Implémentez IWidgetProvider pour la création, la suppression, l’activation, les modifications de contexte et les actions utilisateur. L’interface de base reste requise lorsque vous ajoutez des interfaces facultatives pour la personnalisation ou le contenu web.

Capability API ou instructions Availability
Mises à jour du cycle de vie des widgets et des cartes adaptatives IWidgetProvider et WidgetManager SDK d'application Windows 1.2
Personnalisation de l’utilisateur IWidgetProvider2 et l’attribut IsCustomizable du manifeste SDK d'application Windows 1.4
Contenu web, demandes de ressources et messagerie Fournisseurs de widgets web, IWidgetResourceProvider, IWidgetProviderMessage et WidgetManager.SendMessageToContent SDK d'application Windows 1.6.3 ; vérifiez également les exigences régionales et d’hôte de widget web.
Indication du contenu qui n’est pas encore personnalisé ou actionnable WidgetUpdateRequestOptions.IsPlaceholderContent SDK d'application Windows 1.6.6
Callbacks d’analyse des widgets IWidgetProviderAnalytics Windows Widgets Board prend en charge ces fonctions de rappel à partir de Windows 11 build 26900. D’autres hôtes doivent également prendre en charge l’interface ; consultez les remarques sur l’API.

Les versions du Kit de développement logiciel (SDK) identifient quand les API sont devenues disponibles, et non la version que vous devez installer. Utilisez une version stable actuellement prise en charge à partir des canaux de publication de SDK d'application Windows et testez les fonctionnalités que vous utilisez sur votre appareil Windows cible et votre hôte de widget. Pour connaître les options de présentation d’en-tête, consultez Personnaliser la zone d’en-tête du widget. L’API Service Worker de PWA est une voie d’implémentation distincte ; les interfaces de bureau de ce tableau ne s’y appliquent pas.

L’hôte de widget peut activer et libérer votre fournisseur indépendamment de la durée de vie des widgets épinglés. Restaurez l’état du widget lorsque le fournisseur démarre et ne conservez pas les objets d’argument de rappel après qu’un rappel IWidgetProvider retourne. Pour plus d’informations, consultez les remarques IWidgetProvider.

Pour obtenir la référence complète de l’API, consultez la Microsoft.Windows.Widgets.Providers.

Pour obtenir une procédure pas à pas des concepts de base de la création d’un widget et de l’implémentation d’un fournisseur de widgets, regardez l’épisode Tabs vs Spaces « Créer des widgets pour Windows 11 ».

Ressources additionnelles

  • Dernière mise à jour :