Proveedores de widgets

Windows widgets son contenedores de interfaz de usuario pequeños que muestran el contenido proporcionado por una aplicación de Windows o aplicación web progresiva (PWA). Puede proporcionar una plantilla de tarjeta adaptable y datos, o usar un widget web para mostrar HTML desde una dirección URL. Los widgets web siguen usando una carga JSON de Adaptive Card para especificar la dirección URL del contenido.

Para una aplicación de escritorio empaquetada, implemente un proveedor de widgets que responda a las solicitudes del host del widget y envíe actualizaciones a través de WidgetManager. Una PWA usa las definiciones de widget en su manifiesto de aplicación web y controla los eventos de widget en su service worker.

Para obtener información general sobre la experiencia de Windows widgets y la guía de diseño para crear sus propios widgets, consulte Windows widgets.

Actualmente, puede implementar un proveedor de widgets mediante una aplicación de escritorio Win32 empaquetada o una aplicación web progresiva. Para obtener más información, consulte:

APIs y capacidades del proveedor de widgets de escritorio

Implemente IWidgetProvider para la creación, eliminación, activación, cambios de contexto y acciones del usuario de los widgets. La interfaz base sigue siendo necesaria cuando se agregan interfaces opcionales para la personalización o el contenido web.

Capacidad API u orientación Availability
Ciclo de vida del widget y actualizaciones de Adaptive Card IWidgetProvider y WidgetManager SDK de Aplicaciones para Windows 1.2
Personalización del usuario IWidgetProvider2 y el atributo IsCustomizable del manifiesto SDK de Aplicaciones para Windows 1.4
Contenido web, solicitudes de recursos y mensajería Proveedores de widgets web, IWidgetResourceProvider, IWidgetProviderMessage y WidgetManager.SendMessageToContent SDK de Aplicaciones para Windows 1.6.3; compruebe también el host de web-widget y los requisitos regionales.
Indica el contenido que aún no está personalizado o procesable WidgetUpdateRequestOptions.IsPlaceholderContent SDK de Aplicaciones para Windows 1.6.6
Devoluciones de llamada de análisis del widget IWidgetProviderAnalytics El panel de widgets de Windows admite estas devoluciones de llamada a partir de Windows 11 compilación 26900. Los demás hosts también deben admitir la interfaz; vea las observaciones de la API.

Las versiones del SDK identifican cuándo pasaron a estar disponibles las API, no qué versión debe instalar. Use una versión estable actualmente compatible de los canales de versión de SDK de Aplicaciones para Windows y pruebe las capacidades que use en el dispositivo Windows y el host de widgets de destino. Para ver las opciones de presentación de encabezado, consulte Personalizar el área de encabezado del widget. La API de service worker de PWA es una ruta de implementación independiente; las interfaces de escritorio de esta tabla no se aplican a ella.

El host del widget puede activar y liberar tu proveedor independientemente de la duración de los widgets anclados. Restaure el estado del widget cuando se inicie el proveedor y no conserve los objetos de argumento de devolución de llamada después de que finalice una devolución de llamada de IWidgetProvider. Para obtener más información, consulte los comentarios de IWidgetProvider.

Para la referencia completa de la API, vea el espacio de nombres Microsoft.Windows.Widgets.Providers.

Para ver una guía sobre los conceptos básicos para crear un widget e implementar un proveedor de widgets, ve el episodio Tabs vs Spaces "Crear widgets para Windows 11".

Recursos adicionales

  • Se actualizó por última vez el