Manifest widgets 浏览器支持
发布于 更新于
manifest 的 widgets 成员是一个小组件定义数组;每一项为操作系统的小组件面板注册一个小组件,由 PWA 的 Service Worker 通过 ServiceWorkerGlobalScope 上的 widgets 属性渲染和更新。
Microsoft 的 Edge 文档只记载 Windows 11 上的实现。PWA-driven Widgets 说明文档仍是状态为“Active”的孵化提案,拟提交 W3C Web Incubator Community Group,尚未成为正式标准。两份来源都没有逐浏览器的支持数据,Microsoft 未记载的平台是否支持还无法确定。
Microsoft 为 Windows 11 记载的内容
链接到“Microsoft 为 Windows 11 记载的内容”一节name、description、tag、ms_ac_template与screenshots为必填;short_name、icons、template、data、type、auth、update与multiple为可选。只支持通过ms_ac_template提供的 Adaptive Cards 模板,template字段仅供参考。- 安装 PWA 会把它的小组件加入小组件面板,但并不安装它们;用户从面板添加后小组件才算安装,且只有在 Service Worker 调用
widgets.updateByTag()之后才会渲染。update是以秒为单位的更新间隔,需要 Service Worker 自己执行更新。 - Service Worker 会收到
widgetinstall、widgetuninstall、widgetresume与widgetclick事件。浏览器会忽略大于 1024x1024 像素的小组件icons与screenshots,截图的platform接受Windows与any。本地测试需要 Windows 11 上的 WinAppSDK 1.2 并开启开发者模式。
另请参阅
链接到“另请参阅”一节- Manifest widgets:操作系统小组件面板上的 PWA 内容
- Periodic Background Sync 浏览器支持
- Build PWA-driven widgets(learn.microsoft.com)
- PWA-driven Widgets explainer(microsoftedge.github.io)