Web-Anwendungsmanifest
Ein Web-Anwendungsmanifest, definiert in der Web Application Manifest Spezifikation, ist eine JSON-Textdatei, die Informationen über eine Webanwendung bereitstellt.
Der häufigste Verwendungszweck eines Web-Anwendungsmanifests ist, dem Browser die Informationen bereitzustellen, die er 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 Schlüssel auf oberster Ebene als Mitglieder bezeichnet werden.
Mitglieder
Dieser Abschnitt listet Referenzseiten für die Manifestmitglieder auf, die auf MDN dokumentiert sind. In der Spezifikation sind alle Mitglieder optional, aber einige Anwendungen erfordern, dass bestimmte Mitglieder vorhanden sind. Zum Beispiel müssen PWAs bestimmte Manifestmitglieder bereitstellen.
- background_color
- Beschreibung
- display
- display_override Experimentell
- file_handlers Experimentell
- icons
- id
- Kategorien
- launch_handler Experimentell
- name
- note_taking Experimentell
- orientation
- prefer_related_applications Experimentell
- protocol_handlers Experimentell
- related_applications Experimentell
- scope
- scope_extensions Experimentell
- screenshots
- serviceworker Experimentell Nicht standardisiert
- share_target Experimentell
- short_name
- shortcuts
- start_url
- theme_color
Hinweis:
Die Mitglieder dir, lang, und iarc_rating_id sind nicht implementiert.
Beispielmanifest
{
"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": "black",
"background_color": "white"
}
Bereitstellen eines Manifests
Web-App-Manifeste werden in Ihren HTML-Seiten mithilfe eines <link>-Elements im <head> eines Dokuments bereitgestellt:
<link rel="manifest" href="manifest.json" />
Die .webmanifest-Erweiterung ist in der Media-Type-Registration Sektion der Spezifikation festgelegt (die Antwort der Manifestdatei sollte Content-Type: application/manifest+json zurückgeben). Browser unterstützen generell auch Manifeste mit anderen geeigneten Erweiterungen wie .json (Content-Type: application/json).
Wenn das Manifest Anmeldeinformationen benötigt, um abgerufen zu werden, muss das crossorigin Attribut auf use-credentials gesetzt werden, selbst wenn sich die Manifestdatei im selben Ursprung wie die aktuelle Seite befindet.
<link rel="manifest" href="/app.webmanifest" crossorigin="use-credentials" />
Splashscreens
In einigen Browsern und Betriebssystemen wird beim Starten einer installierten PWA ein Splashscreen angezeigt. Dieser Splashscreen wird automatisch generiert und sein Erscheinungsbild wird durch Mitglieder im Web-App-Manifest definiert, insbesondere:
Browser-Kompatibilität
Loading…