Web-App-Manifeste

Ein Web-Anwendungsmanifest, definiert in der Web Application Manifest-Spezifikation, ist eine JSON-Textdatei, die Informationen über eine Webanwendung bereitstellt.

Der häufigste Verwendungszweck für ein Web-Anwendungsmanifest besteht darin, dem Browser Informationen bereitzustellen, die zur Installation einer Progressive Web App (PWA) auf einem Gerät benötigt werden, wie z. B. der Name und das Symbol der App.

Ein Web-Anwendungsmanifest enthält ein einzelnes JSON-Objekt, bei dem die obersten Schlüssel Member genannt werden.

Member

Dieser Abschnitt führt die Member auf, die im Manifest erscheinen können.

In der Spezifikation sind alle Member optional, aber einige Anwendungen erfordern das Vorhandensein bestimmter Member. Zum Beispiel müssen PWAs bestimmte Manifest-Member bereitstellen.

Hinweis: Die dir, lang und iarc_rating_id Member sind nicht implementiert.

Beispiel für ein Manifest

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

Bereitstellung eines Manifests

Web-App-Manifeste werden in Ihren HTML-Seiten mithilfe eines <link>-Elements im <head> eines Dokuments bereitgestellt:

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

Die Erweiterung .webmanifest ist im Abschnitt Medientyp-Registrierung der Spezifikation angegeben (die Antwort der Manifestdatei sollte Content-Type: application/manifest+json zurückgeben). Browser unterstützen im Allgemeinen Manifeste mit anderen geeigneten Erweiterungen wie .json (Content-Type: application/json).

Wenn das Manifest Anmeldeinformationen zum Abrufen benötigt, muss das crossorigin-Attribut auf use-credentials gesetzt werden, selbst wenn sich die Manifestdatei im gleichen Ursprung wie die aktuelle Seite befindet.

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

Startbildschirme

In einigen Browsern und Betriebssystemen wird beim Start einer installierten PWA ein Startbildschirm angezeigt. Dieser Startbildschirm wird automatisch generiert und sein Erscheinungsbild wird durch Member im Web-App-Manifest definiert, insbesondere:

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch