Web App Manifest

分享:
標籤: manifest JSON HTML5

Web App manifest 是一個 JSON 格式的文件,它提供了應用程式相關的資訊,像是名稱、作者、圖示和描述等,還可以設定類似 app 的開啟畫面,可以讓使用者將 Web 應用程式安裝到設備的主畫面,提供更快速的訪問和更豐富的體驗。

Web App manifests 是屬於 PWA(progressive web apps) 的 Web 技術的一部分,是一個能不透過 App 商店就能被安裝到設備主畫面的 Web 應用程式,這個技術還包含了離線使用與通知的接收發送。

關於 manifest 也看先看這隻 google 介紹的影片:

 

設定好 manifest 後只要像這樣在頁面加上連結就可以了:

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

 

以下則為可以設定的參數:

  • name:網站的完整名稱
  • short_name:網站的簡短名稱,啟動圖示上會
  • 顯示的名稱
  • icons:啟動網頁的圖示
  • start_url:點選啟動圖示會開啟的網頁
  • display:網頁顯示模式,有以下4種選擇
    • fullscreen:隱藏瀏覽器的URL
    • standalone:隱藏瀏覽器的UI
    • minimal-ui:顯示最少的UI,類似standalone
    • browser:同原有瀏覽器的設定
  • orientation:手機瀏覽網站的方向,可分成 landscape 與 portrait
  • dir:文字顯示方向,可分成ltr(左到右)、rtl(右到左)、auto三種
  • description:網站內容的敘述
  • lang:網站的語言
  • background_color:過場時的背景顏色
  • theme_color:資訊列的顏色
  • scope: 如果有填,這樣 app 的作用範圍就會在指定的資料夾內,超過則會變成一般網頁

以下為制服地圖的範例 manifest 檔案:

{
  "name": "Uniform Map 制服地圖",
  "short_name": "Uniform Map",
  "theme_color": "#ad2148",
  "background_color": "#ad2148",
  "display": "fullscreen",
  "Scope": "/",
  "start_url": "/",
  "description": "制服地圖以制服為出發點,希望帶給喜歡制服的朋友青春的回憶,非常歡迎大家提供各種相關的訊息,舉凡學校、動漫或其他行業制服等,都可以讓網站的資料更豐富。",
  "lang": "zh-Hant-TW",
  "icons": [
    {
      "src": "assets/icons/icon-72x72.png",
      "sizes": "72x72",
      "type": "image/png"
    },
    {
      "src": "assets/icons/icon-96x96.png",
      "sizes": "96x96",
      "type": "image/png"
    },
    {
      "src": "assets/icons/icon-128x128.png",
      "sizes": "128x128",
      "type": "image/png"
    },
    {
      "src": "assets/icons/icon-144x144.png",
      "sizes": "144x144",
      "type": "image/png"
    },
    {
      "src": "assets/icons/icon-152x152.png",
      "sizes": "152x152",
      "type": "image/png"
    },
    {
      "src": "assets/icons/icon-192x192.png",
      "sizes": "192x192",
      "type": "image/png"
    },
    {
      "src": "assets/icons/icon-384x384.png",
      "sizes": "384x384",
      "type": "image/png"
    },
    {
      "src": "assets/icons/icon-512x512.png",
      "sizes": "512x512",
      "type": "image/png"
    }
  ],
  "splash_pages": null
}

 

也可以透過線上工具 Web App Manifest Generator 幫我們產生這個檔案,其中有一個功能只要上傳 512 x 512 大小的圖片就可以直接幫我們產生各種尺寸的大小很方便。

設定好後可以透過 Web App Manifest Validator 幫我們檢查格式是否正確。

之後就可以透過將網頁加到主畫面的方式將網頁放到桌面了。