屏幕截图

实验性： 这是一个 实验性技术
在生产环境中使用此功能之前，请仔细检查 浏览器兼容性表。

类型 数组

screenshots 成员定义了一个屏幕截图数组，用于展示应用程序。这些图像旨在供渐进式 Web 应用商店使用。

属性

screenshots 成员是一个对象的数组，每个对象代表一个屏幕截图。每个屏幕截图对象可能包含以下属性

form_factor

表示一类设备的字符串。仅当屏幕截图仅适用于特定外形尺寸时才应使用此属性。

此属性可以取以下值之一

  • "narrow"：屏幕截图仅适用于窄屏幕。
  • "wide"：屏幕截图仅适用于宽屏幕。
label

表示屏幕截图对象的辅助名称的字符串。此成员可以用作屏幕截图的替代文本。

platform

表示屏幕截图适用的平台的字符串。当屏幕截图仅适用于特定设备或分发平台时，应使用此属性。用户代理不应显示包含与当前平台不同的 platform 值的屏幕截图（例如，Google Play 不应显示 platform 为 "ios" 的屏幕截图）。

此属性可以取以下值之一

  • 设备平台标识符
    • "android"
    • "chromeos"
    • "ipados"
    • "ios"
    • "kaios"
    • "macos"
    • "windows"
    • "xbox"
  • 分发平台标识符
    • "chrome_web_store"
    • "itunes"
    • "microsoft-inbox"
    • "microsoft-store"
    • "play"
sizes

描述图像大小的字符串，或者对于可以包含多个图像的图像格式（如 ICO）而言，描述多个大小的字符串。此属性等效于 <link> 元素的 sizes 属性，并以相同的方式指定。

src

表示用户代理可以从中获取图像数据的 URL 的字符串。

type

表示图像的 MIME 类型 的字符串。

示例

json
"screenshots" : [
  {
    "src": "screenshot1.webp",
    "sizes": "1280x720",
    "type": "image/webp",
    "form_factor": "wide",
    "label": "Homescreen of Awesome App"
  },
  {
    "src": "screenshot2.webp",
    "sizes": "1280x720",
    "type": "image/webp",
    "form_factor": "wide",
    "label": "List of Awesome Resources available in Awesome App"
  }
]

规范

未找到规范

未找到 html.manifest.screenshots 的规范数据。
检查此页面的问题 或为缺少的 spec_url 贡献代码至 mdn/browser-compat-data。同时确保规范包含在 w3c/browser-specs.

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。