Web 应用清单成员参考
此页面列出了 Web 应用清单成员在 Web 上使用的参考信息。
- background_color
background_color清单成员用于指定 Web 应用程序的初始背景颜色。在应用程序样式表加载之前，此颜色会显示在应用程序窗口中。- categories
categories清单成员允许您为 Web 应用程序指定一个或多个分类。这些类别可帮助用户在应用商店中发现您的应用。- description
description清单成员用于解释 Web 应用程序的核心功能或用途。在应用商店中查看时，此文本可帮助用户了解您应用的用途。- display
display清单成员用于指定 Web 应用程序的首选显示模式。显示模式决定了在操作系统上下文中启动应用程序时向用户显示的浏览器 UI 的多少。您可以选择显示完整的浏览器界面或隐藏它，以提供更类似应用程序的体验。- display_override
display成员用于确定开发者对网站的首选显示模式。它遵循一个流程，即如果请求的模式不受支持，浏览器将回退到下一个显示模式。在某些高级用例中，此回退过程可能不足够。- file_handlers
file_handlers成员指定一个对象数组，这些对象表示已安装的渐进式 Web 应用程序 (PWA) 可以处理的文件类型。- icons
icons清单成员用于指定一个或多个图像文件，这些文件定义了代表您的 Web 应用程序的图标。- id
id清单成员用于为您的 Web 应用程序指定一个唯一标识符。- launch_handler
launch_handler成员定义了控制 Web 应用程序启动的值。目前它只能包含一个值：client_mode，它指定了应用程序启动时应加载的上下文。例如，在包含该应用程序实例的现有 Web 应用程序客户端中，或在新 Web 应用程序客户端中。这为未来定义更多launch_handler值留下了空间。- name
name清单成员用于指定 Web 应用程序的全名，通常会显示给用户，例如在应用程序列表中或作为应用程序图标的标签。- note_taking
note_taking成员将 Web 应用程序标识为笔记应用程序，并定义相关信息，例如指向用于创建新笔记功能的 URL。这使得操作系统能够集成应用程序的笔记功能，例如在应用程序的上下文菜单中包含“新建笔记”选项，或将该应用程序作为在其他应用程序中创建笔记的选项。- orientation
orientation清单成员用于指定 Web 应用程序的默认方向。它定义了应用程序在启动和使用期间相对于设备屏幕方向的显示方式，尤其是在支持多种方向的设备上。prefer_related_applications清单成员用于向浏览器提供一个提示，告知浏览器是否应优先安装related_applications清单成员中指定的原生应用程序，而不是您的 Web 应用程序。- protocol_handlers
protocol_handlers成员指定一个对象数组，这些对象是此 Web 应用程序可以注册和处理的协议。协议处理程序会在操作系统的应用程序首选项中注册应用程序；此注册会将特定应用程序与给定的协议方案相关联。例如，当网页中使用mailto://协议处理程序时，已注册的电子邮件应用程序会打开。related_applications清单成员用于指定一个或多个与您的 Web 应用程序相关的应用程序。这些应用程序可能是特定于平台的应用程序或渐进式 Web 应用程序。- scope
scope清单成员用于指定包含您的 Web 应用程序页面和子目录的顶级 URL 路径。当用户安装和使用您的 Web 应用程序时，在作用域内的页面会提供类似应用程序的界面。当用户导航到应用程序作用域之外的页面时，他们仍然会体验到类似应用程序的界面，但浏览器会显示 URL 栏等 UI 元素来指示上下文的变化。- scope_extensions
scope_extensions清单成员用于将 Web 应用程序的作用域扩展到包含其他来源。这允许多个域名被呈现为单个 Web 应用程序。- screenshots
screenshots清单成员允许您指定一个或多个展示您 Web 应用程序的图像。这些图像可帮助用户在应用商店中预览您 Web 应用程序的界面和功能。- serviceworker
serviceworker成员指定一个即时（JIT）安装和注册的服务工作线程，用于运行基于 Web 的支付应用程序，为商家网站上指定的支付方式提供支付机制。有关更多详细信息，请参阅Payment Handler API。share_target清单成员允许已安装的渐进式 Web 应用程序（PWA）在系统的共享对话框中注册为共享目标。- short_name
short_name清单成员用于指定 Web 应用程序的简称，当完整的name对可用空间来说太长时，可以使用此简称。- shortcuts
shortcuts清单成员用于指定指向 Web 应用程序内重要任务或页面的链接。浏览器可以使用此信息创建上下文菜单，通常在用户与 Web 应用程序图标交互时显示。- start_url
start_url清单成员用于指定当用户启动 Web 应用程序时应打开的 URL，例如在设备主屏幕或应用程序列表中点击应用程序图标时。- theme_color
theme_color成员用于指定 Web 应用程序用户界面的默认颜色。此颜色可能应用于各种浏览器 UI 元素，例如工具栏、地址栏和状态栏。在任务切换器或应用程序添加到主屏幕等上下文中尤其明显。