跳转到内容

Manifest widgets 浏览器支持

发布于 更新于

manifest 的 widgets 成员是一个小组件定义数组;每一项为操作系统的小组件面板注册一个小组件,由 PWA 的 Service Worker 通过 ServiceWorkerGlobalScope 上的 widgets 属性渲染和更新。

Microsoft 的 Edge 文档只记载 Windows 11 上的实现。PWA-driven Widgets 说明文档仍是状态为“Active”的孵化提案,拟提交 W3C Web Incubator Community Group,尚未成为正式标准。两份来源都没有逐浏览器的支持数据,Microsoft 未记载的平台是否支持还无法确定。

  • 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 并开启开发者模式。