icons

配列 (Array)
必須 はい

icons メンバーは、様々なコンテキストでアプリケーションアイコンとして機能する画像ファイルを表すオブジェクトの配列を指定します。例えば、他のアプリケーションのリストの中でウェブアプリケーションを表現したり、ウェブアプリケーションを OS のタスクマネージャーやシステム環境設定と統合したりするために使用することができます。

"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": "72x72"
  }
]

画像オブジェクトには、次の値を入れることができます。

メンバー 説明
sizes 画像の寸法を空白区切りで指定する文字列です。
src 画像ファイルへのパスです。 src が相対 URL である場合、基準 URL はマニフェストの URL です。
type 画像のメディア種別のヒントです。このメンバーは、ユーザーエージェントが対応していないメディア種別の画像を素早く無視することができるようにするためのものです。
purpose

画像の目的を定義します。例えば、画像がホスト OS の特定の場面で、特別な目的を果たすことを意図している場合などです (すなわち、よりよく統合するため)。

purpose は以下の値を1つ以上、空白で区切って指定することができます。

  • badge: ユーザーエージェントは、アプリケーションアイコンと異なるスペースの制約や色の要件がある場合に、このアイコンを表示することができます。
  • maskable: 画像がアイコンのマスクと安全領域に配慮して設計されており、画像の安全領域外の部分をユーザーエージェントが無視したりマスクしたりしても安全になるようになっています。
  • any: ユーザーエージェントはどのような場合でも、自由にこのアイコンを表示することができます (これが既定値です)。

仕様書

仕様書 状態 備考 フィードバック

Web App Manifest
icons の定義

草案

初回定義

Web App Manifest Working Group drafts

ブラウザーの互換性

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
icons
実験的
Chrome ? Edge ? Firefox ? IE ? Opera ? Safari ? WebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 53
補足 無効
完全対応 53
補足 無効
補足 By default, used for as the source for "Add to home screen" (see bug 1234558).
無効 From version 53: this feature is behind the manifest.install.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android ? Safari iOS ? Samsung Internet Android 完全対応 あり

凡例

完全対応  
完全対応
実装状況不明  
実装状況不明
実験的。動作が変更される可能性があります。
実験的。動作が変更される可能性があります。
実装ノートを参照してください。
実装ノートを参照してください。
ユーザーが明示的にこの機能を有効にしなければなりません。
ユーザーが明示的にこの機能を有効にしなければなりません。