圖示

型別 陣列

icons 成員指定一個物件陣列,表示可以作為不同上下文中的應用程式圖示的影像檔案。例如,它們可以用來在其他應用程式列表中表示 Web 應用程式,或將 Web 應用程式與作業系統的任務切換器和/或系統偏好設定整合。

示例

json
"icons": [
  {
    "src": "icon/lowres.webp",
    "sizes": "48x48",
    "type": "image/webp"
  },
  {
    "src": "icon/lowres",
    "sizes": "48x48"
  },
  {
    "src": "icon/hd_hi.ico",
    "sizes": "72x72 96x96 128x128 256x256"
  },
  {
    "src": "icon/hd_hi.svg",
    "sizes": "any"
  }
]

影像物件可能包含以下值

成員 描述
sizes 一個字串,包含使用與 sizes 屬性相同的語法表示的空間分隔的影像尺寸。
src 影像檔案的路徑。如果 src 是一個相對 URL,則基 URL 將是清單的 URL。
type 關於影像媒體型別的提示。此成員的目的是允許使用者代理快速忽略它不支援的媒體型別的影像。
purpose

定義影像的目的,例如如果影像旨在在主機作業系統的上下文中服務於一些特殊目的(即,為了更好地整合)。

purpose 可以包含以下一個或多個值,用空格隔開

  • monochrome: 使用者代理可以在需要 具有實心填充的單色圖示 的地方顯示此圖示。圖示中的顏色資訊將被丟棄,只有 alpha 資料將被使用。然後,使用者代理可以像在任何實心填充上使用蒙版一樣使用圖示。
  • maskable: 該影像是在 圖示蒙版和安全區域 的前提下設計的,因此,使用者代理可以安全地忽略和遮蔽安全區域之外的影像的任何部分。
  • any: 使用者代理可以自由地在任何上下文中顯示圖示(這是預設值)。

規範

規範
Web 應用清單
# icons-member

瀏覽器相容性

BCD 表格僅在瀏覽器中載入