Web 應用程式清單

Web 應用程式清單，定義於 Web 應用程式清單規範中，是一個提供有關 Web 應用程式的訊息的 JSON 文字檔案。

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

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

成員

本節列出了記錄在 MDN 上的清單成員的參考頁面

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

備註： dir、lang 和 iarc_rating_id 成員尚未實作。

範例清單

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"
}

部署清單

在 HTML 頁面中，Web 應用程式清單是透過 <link> 元素部署的，該元素應該放置在文件的 <head> 區塊內：

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 應用程式清單中的成員定義，具體如下：

瀏覽器相容性

參見

漸進式 Web 應用程式（PWA）

Help improve MDN

Learn how to contribute

This page was last modified on ⁨2025年7月6日⁩ by MDN contributors.

View this page on GitHub • Report a problem with this content