Provedores de widget

Windows widgets são pequenos contêineres de interface do usuário que exibem o conteúdo fornecido por um aplicativo Windows ou PWA (Aplicativo Web Progressivo). Você pode fornecer um modelo de Cartão Adaptável e dados ou usar um widget web para exibir HTML de uma URL. Os widgets da Web ainda usam uma carga JSON do Adaptive Card para especificar a URL de conteúdo.

Para um aplicativo de área de trabalho empacotado, você implementa um provedor de widget que responde às solicitações do host do widget e envia atualizações por meio do WidgetManager. Um PWA usa as definições de widget em seu manifesto do aplicativo Web e manipula eventos de widget em seu service worker.

Para obter uma visão geral da experiência Windows widgets e diretrizes de design para criar seus próprios widgets, consulte Windows widgets.

No momento, você pode implementar um provedor de widget usando um aplicativo da área de trabalho do Win32 empacotado ou um PWA (Aplicativo Web Progressivo). Para obter mais informações, consulte:

APIs e funcionalidades do provedor de widget da área de trabalho

Implemente IWidgetProvider para a criação, exclusão e ativação de widgets, bem como para alterações de contexto e ações do usuário. A interface base permanece necessária quando você adiciona interfaces opcionais para personalização ou conteúdo da Web.

Capability API ou diretrizes Availability
Ciclo de vida do widget e atualizações de Adaptive Card IWidgetProvider e WidgetManager SDK do Aplicativo Windows 1.2
Personalização do usuário IWidgetProvider2 e o atributo IsCustomizable do manifesto SDK do Aplicativo Windows 1.4
Conteúdo da Web, solicitações de recursos e mensagens Provedores de widget web, IWidgetResourceProvider, IWidgetProviderMessage e WidgetManager.SendMessageToContent SDK do Aplicativo Windows 1.6.3; verifique também os requisitos regionais e do host do widget web.
Indicando conteúdo que ainda não é personalizado ou acionável WidgetUpdateRequestOptions.IsPlaceholderContent SDK do Aplicativo Windows 1.6.6
Callbacks de análise de widgets IWidgetProviderAnalytics O Windows Widgets Board dá suporte a esses callbacks a partir do Windows 11 build 26900. Outros hosts também devem dar suporte à interface; consulte as observações da API.

As versões do SDK identificam quando as APIs ficaram disponíveis, não qual release do software você deve instalar. Use uma versão estável atualmente suportada, proveniente dos canais de lançamento do SDK do Aplicativo Windows, e teste as funcionalidades que você utiliza no dispositivo Windows de destino e no host de widgets. Para obter opções de apresentação de cabeçalho, consulte Personalizar a área de cabeçalho do widget. A API de service worker de PWA é um caminho de implementação separado; as interfaces da área de trabalho nesta tabela não se aplicam a ela.

O host do widget pode ativar e liberar seu provedor independentemente do tempo de vida dos widgets fixados. Restaure o estado do widget quando o provedor for iniciado e não retenha objetos de argumento de callback após o retorno de um callback de IWidgetProvider. Para obter mais informações, consulte as observações do IWidgetProvider.

Para obter a referência completa da API, consulte o namespace Microsoft.Windows.Widgets.Providers.

Para obter um passo a passo dos conceitos básicos de criação de um widget e implementação de um provedor de widget, assista ao episódio Tabs vs Spaces "Criar Widgets para Windows 11".

Recursos adicionais

  • Última atualização em