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

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 元素,例如工具欄、位址列和狀態列。在任務切換器或應用程式新增到主螢幕等上下文中尤其明顯。

另見