Web 應用清單

根據Web 應用清單規範定義的**Web 應用清單**是一個JSON文字檔案，提供有關 Web 應用程式的資訊。

Web 應用清單最常見的用途是提供瀏覽器安裝裝置上的漸進式 Web 應用 (PWA)所需的資訊，例如應用的名稱和圖示。

Web 應用清單包含一個 JSON 物件，其中頂級鍵稱為成員。

成員

本節列出了清單中可能出現的成員。

規範中所有成員都是可選的，但某些應用程式需要某些成員存在。例如，PWA 必須提供某些清單成員。

注意：dir、lang、iarc_rating_id和note_taking成員未實現。

清單示例

json

{
  "short_name": "MDN",
  "name": "MDN Web Docs",
  "icons": [
    {
      "src": "/favicon-192x192.png",
      "sizes": "192x192",
      "type": "image/png"
    },
    {
      "src": "/favicon-512x512.png",
      "sizes": "512x512",
      "type": "image/png"
    }
  ],
  "start_url": ".",
  "display": "standalone",
  "theme_color": "#000000",
  "background_color": "#ffffff"
}

部署清單

Web 應用清單使用文件<head>中的<link>元素部署在 HTML 頁面中

html

<link rel="manifest" href="manifest.json" />

.webmanifest副檔名在規範的媒體型別註冊部分中指定（清單檔案的響應應返回Content-Type: application/manifest+json）。瀏覽器通常支援具有其他適當副檔名的清單，例如.json（Content-Type: application/json）。

如果清單需要憑據才能獲取，則必須將crossorigin屬性設定為use-credentials，即使清單檔案與當前頁面位於同一來源。

html

<link rel="manifest" href="/app.webmanifest" crossorigin="use-credentials" />

啟動畫面

在某些瀏覽器和作業系統中，啟動已安裝的 PWA 時會顯示啟動畫面。此啟動畫面是自動生成的，其外觀由 Web 應用清單中的成員定義，具體來說是

瀏覽器相容性

BCD 表僅在啟用 JavaScript 的瀏覽器中載入。

另請參閱

漸進式 Web 應用 (PWA)