Web-App-Manifeste

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

Die häufigste Verwendung eines Web-Anwendungsmanifests ist die Bereitstellung von Informationen, die der Browser benötigt, um eine Progressive Web App (PWA) auf einem Gerät zu installieren, wie z. B. den Namen und das Symbol der App.

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

Mitglieder

Dieser Abschnitt listet die Mitglieder auf, die im Manifest erscheinen können.

Alle Mitglieder sind in der Spezifikation optional, aber einige Anwendungen erfordern, dass bestimmte Mitglieder vorhanden sind. Zum Beispiel müssen PWAs bestimmte Manifestmitglieder bereitstellen.

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

Beispielmanifest

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 .webmanifest-Erweiterung 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 zur Abrufung Anmeldeinformationen 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 ein Startbildschirm angezeigt, wenn eine installierte PWA gestartet wird. Dieser Startbildschirm wird automatisch generiert und sein Erscheinungsbild wird durch Mitglieder im Web-App-Manifest definiert, insbesondere:

Browser-Kompatibilität

Siehe auch