Widget-leverantörer

Windows widgetar är små UI-containrar som visar innehåll som tillhandahålls av en Windows app eller progressiv webbapp (PWA). Du kan ange en Adaptive Card-mall och data eller använda en webbwidget för att visa HTML från en URL. Webbwidgetar använder fortfarande en Adaptive Card JSON-nyttolast för att ange innehålls-URL:en.

För en paketerad skrivbordsapp implementerar du en widgetprovider som svarar på begäranden från widgetvärden och skickar uppdateringar via WidgetManager. En PWA använder widgetdefinitionerna i sitt webbappmanifest och hanterar widgethändelser i sin service worker.

En översikt över Windows widgetar och designvägledning för att skapa egna widgetar finns i Windows widgetar.

För närvarande kan du implementera en widgetprovider med en paketerad Win32-skrivbordsapp eller en progressiv webbapp (PWA). Mer information finns i:

API:er och funktioner för leverantörer av skrivbordswidgetar

Implementera IWidgetProvider för widget-skapande, widget-borttagning, widget-aktivering, widget-kontextändringar och widget-användaråtgärder. Basgränssnittet krävs fortfarande när du lägger till valfria gränssnitt för anpassning eller webbinnehåll.

Capability API eller vägledning Availability
Widgetlivscykel och uppdateringar av Adaptive Card IWidgetProvider och WidgetManager Windows App SDK 1.2
Användaranpassning IWidgetProvider2 och manifestets IsCustomizable-attribut Windows App SDK 1,4
Webbinnehåll, resursbegäranden och meddelanden Webbwidgetleverantörer, IWidgetResourceProvider, IWidgetProviderMessage och WidgetManager.SendMessageToContent Windows App SDK 1.6.3. Kontrollera även webbwidgetens värdprogram och regionala krav.
Anger innehåll som ännu inte är anpassat eller åtgärdsbart WidgetUpdateRequestOptions.IsPlaceholderContent Windows App SDK 1.6.6
Återanrop för widgetanalys IWidgetProviderAnalytics Windows Widgets Board stöder dessa återanrop från och med Windows 11 build 26900. Andra värdar måste också ha stöd för gränssnittet. se API-kommentarerna.

SDK-versionerna anger när API:er blev tillgängliga, inte vilken utgåva du ska installera. Använd en stabil version som för närvarande stöds från Windows App SDK-releasekanaler och testa de funktioner som du använder på din avsedda Windows-enhet och widgetvärd. Information om presentationsalternativ för rubriken finns i Anpassa widgetens rubrikområde. PWA service-worker-API:et är en separat implementeringsväg; skrivbordsgränssnitten i den här tabellen gäller inte för den.

widgetvärden kan aktivera och frigöra din leverantör oberoende av livslängden för fästa widgetar. Återställ widgettillståndet när providern startar och behåll inte callback-argumentobjekt när en IWidgetProvider-callback har returnerat. Mer information finns under IWidgetProvider-anmärkningar.

Fullständig API-referens finns, se Microsoft.Windows.Widgets.Providers-namnrymden.

En genomgång av grunderna för att skapa en widget och implementera en widgetprovider finns i avsnittet Tabs vs Spaces "Create Widgets for Windows 11".

Ytterligare resurser

  • Uppdaterades senast