{"canonical_url":"https://engineer.company/sv/glossary/webmanifest/","content_markdown":"# Webbappsmanifest\n\n## Vad det är\n\nEtt webbappsmanifest är ett JSON-dokument som beskriver en webbplats som ett program: vad det heter,\nvilken adress det öppnas på, vilka adresser som hör till det, hur fönstret ska se ut och vilka\nbilder som representerar det. En sida pekar ut filen med ett `link`-element vars `rel` är\n`manifest`, och en webbläsare som erbjuder installation läser filen för att avgöra vad den\ninstallerade kopian ska bli. W3C-specifikationen som definierar formatet kallar det bara manifestet,\noch det gör de flesta i vardagligt tal också.\n\nFilen är vanlig JSON. Dess registrerade medietyp är `application/manifest+json` och dess\nregistrerade filändelse är `.webmanifest`, men specifikationen godtar vilken JSON-medietyp som\nhelst, och många webbplatser serverar en `manifest.json`. Varje fält, members i specifikationens\nspråk, är frivilligt. Ett litet manifest för en påhittad webbplats med tidvattentabeller ser ut så\nhär:\n\n```json\n{\n    \"name\": \"Harbour Tide Tables\",\n    \"short_name\": \"Tides\",\n    \"start_url\": \"/tides/\",\n    \"display\": \"standalone\",\n    \"background_color\": \"#ffffff\",\n    \"icons\": [\n        {\n            \"src\": \"/icons/tides-512.png\",\n            \"sizes\": \"512x512\",\n            \"type\": \"image/png\"\n        }\n    ]\n}\n```\n\nTre fält avgör vad appen är, till skillnad från hur den ser ut. `start_url` föreslår sidan som den\ninstallerade appen öppnas på; webbläsaren kan ignorera den eller låta användaren ändra den. `scope` är den mängd adresser som räknas som en del av appen. Saknas\nfältet tar specifikationen startadressen och skär bort filnamn, frågesträng och fragment, så\nexemplet ovan äger allt under `/tides/`. `id` är appens identitet, och saknas det faller identiteten\ntillbaka på startadressen. Relativa ikonadresser och startadressen tolkas relativt manifestets egen URL och inte mot\nsidan som länkade till det. Ett relativt `id` tolkas däremot relativt startadressens ursprung.\n\nResten är presentation. `display` ber om `fullscreen`, `standalone`, `minimal-ui` eller `browser`,\noch en webbläsare som inte kan tillmötesgå önskemålet går nedåt i den listan i tur och ordning.\nVarje ikon kan ha ett `purpose`: `any` som standard, `maskable` för en bild som är ritad för att\ntåla beskärning, eller `monochrome` för en bild vars färger kastas bort så att bara alfakanalen\nanvänds. `theme_color` färgar fönstret runt appen. En kompletterande anteckning från W3C lägger till\n`description`, `categories` och `screenshots`, som installationsdialoger och appbutiker kan visa.\n\n## Varför det spelar roll\n\nManifestet ger installationsmetadata som webbplatsen själv styr. Specifikationen lämnar\nbeslutet att installera åt webbläsaren: den får erbjuda ett sätt att installera, och varje\nwebbläsare sätter egna villkor, av vilka en del kräver vissa fält. Ett team levererar underlaget och\nwebbläsaren bestämmer vad den gör med det, så den användbara frågan är inte så mycket om ni ska ha\nett manifest som vad det lovar.\n\nIdentiteten är det löfte som överlever filen. När en webbläsare hämtar manifestet på nytt\nsäger specifikationen att den bör använda ett matchande `id` som en signal om att den nya\nfilen ersätter manifestet för en app som redan är installerad. Eftersom ett saknat `id` är\nlika med startadressen ändrar en flyttad startsida tyst identiteten, så webbläsaren bör\nbehandla den nya filen som en annan app än den som finns på läsarens enhet. Att låsa `id`\nredan i den första versionen kostar en rad och tar bort den risken.\n\nOmfånget, `scope`, avgör var appfönstret tar slut. Navigering inom omfånget stannar i det\ninstallerade fönstret. En länk som leder ut ur det öppnas ändå, men specifikationen förväntar sig\natt webbläsaren visar att läsaren har lämnat appen, så ett omfång som är snävare än webbplatsen får\nvanliga länkar mellan dess avdelningar att se ut som utgångar.\n\nDet mesta som syns gå fel gäller ikonerna. Hemskärmar och appmenyer beskär ikoner till cirklar,\nrundade kvadrater och andra former, och en logotyp som fyller hela sin kvadrat förlorar sina kanter.\nSpecifikationen definierar säkerhetszonen för en ikon med `maskable` som en cirkel i mitten med en\nradie på två femtedelar av ikonens kortare sida, och allt utanför den kan skäras bort. En ikon med\n`monochrome` behåller bara sin alfakanal, så en ikon som är ritad på en ogenomskinlig bakgrund blir\nen enfärgad kvadrat.\n\nFärgfälten gör mindre än de ser ut att göra. `background_color` är bara tänkt för ögonblicket innan\nstilmallen har kommit fram, och specifikationen förbjuder webbläsaren att använda färgen när\nstilmallen väl finns tillgänglig. Det är färgen på den första bildrutan och ingenting efter den.\n\n## Så ser det ut i praktiken\n\nDen här webbplatsen bygger sitt manifest ur en mall i stället för att hålla en fil för hand.\nKonfigurationen i Hugo registrerar `application/manifest+json` med ändelsen `webmanifest` och gör\nmanifestet till en utdata från varje språks startsida, så varje språk får sin egen fil, och `head`\npå varje sida länkar till filen för sidans eget språk. Konfigurationen skriver också ned varför: en\nenda global kopia kan bara ange en startadress, och en dansk besökare som installerade webbplatsen\nfick en app som öppnade den engelska startsidan.\n\nMallen bygger manifestet som en datastruktur och lämnar den till JSON-kodaren i Hugo, så escapning\noch kommatecken är kodarens sak och ett saknat komma kan inte nå ut. Varje ikonadress utgår från\nwebbplatsens rot, och kommentaren i mallen förklarar skälet: en relativ adress i\n`/da/manifest.webmanifest` skulle tolkas som en adress under `/da/`, och varje ikon på danska skulle ge 404.\nSjälva ikonerna läses från disk ur tre mappar, en per syfte, med tio storlekar i varje från 36 till\n512 pixlar, och storleken tas ur filnamnet, så en storlek som generatorn lägger till dyker upp i\nmanifestet utan att något behöver redigeras.\n\n`id` är låst till språkets startadress, och `scope` är satt till roten, så hela webbplatsen ingår\noch en länk till ett annat språk stannar i det installerade fönstret. Skärmbilderna heter\n`\u003clang\u003e-\u003cform_factor\u003e-\u003cWxH\u003e.webp`, och mallen läser alla tre uppgifterna ur filnamnet: engelska och\ndanska har var sin breda bild på 1 280 × 800 pixlar och var sin smala bild på 780 × 1 688. Ett språk\nutan skärmbilder får inget `screenshots`-fält alls, i stället för en tom lista.\n\n[Kolofonen](/sv/credits/) listar W3C-specifikationen bland de standarder som webbplatsen följer, och\nPWABuilder bland de externa kontroller som vem som helst kan köra: en tjänst som läser manifestet\noch resten av det som gör webbplatsen installerbar, från maskiner som Microsoft driver.\n\n[Sidan om att installera som app](/sv/install/) är läsarens halva av samma fil. Den går\nigenom var varje webbläsare har kommandot för att installera och noterar att webbläsarna\nfrån Apple aldrig erbjuder installation av sig själva. Firefox har en separat funktion för\nwebbappfönster, aktiverad som standard på Windows från version 143, eller version 150\nvid installation från Microsoft Store. Mozillas implementationsdokumentation anger att\nLinux-stödet är avstängt som standard och att stöd för macOS saknas. Sidan anger också\nförväntningarna på den här webbplatsen: den installerade appen är en ikon och ett eget\nfönster. Webbplatsen publicerar ingen service worker eller hanterad offlinekopia, så\nnormal användning kräver en anslutning.\n\n## Var det går fel\n\n**Varje ikon ger 404 under en översatt sökväg.** Ett relativt `src` tolkas relativt manifestets URL,\nså ett manifest som serveras under ett språkprefix ber om ikoner under det prefixet. Skriv\nikonadresserna från webbplatsens rot, eller som fullständiga URL:er.\n\n**Den installerade appen öppnas på fel språk.** Ett manifest kan bara ange en startadress, så varje\nläsare installerar samma startsida. Servera ett manifest per språk, vart och ett med egen\n`start_url` och eget `id`, och länka från varje sida till det manifest som hör till sidans språk.\n\n**Installerade kopior struntar i det nya manifestet.** Utan `id` är identiteten startadressen, så en\nflyttad startsida ger filen en ny identitet, och webbläsaren bör behandla den som en annan app än den\nsom läsarna redan har. Sätt `id` före den första versionen och låt det vara orört efteråt.\n\n**Hemskärmen beskär logotypen.** En ikon vars `purpose` är `any` placeras eller beskärs som\nplattformen finner lämpligt. Lägg till en ikon med `maskable` och håll allt som betyder något\ninnanför den centrala cirkeln, vars radie är 40 % av ikonens kortare sida.\n\n**Ändringar i manifestet ändrar ingenting.** HTML-standarden använder bara det första\n`link`-elementet vars `rel` innehåller `manifest`, så när ett tema eller ett tillägg har lagt in en\negen länk tidigare på sidan är filen som redigeras aldrig den som läses. Ha exakt en manifestlänk\nper sida.\n\n## Läs mer\n\n- [Web Application Manifest](https://www.w3.org/TR/appmanifest/) — varje fält, hur en webbläsare\n  bearbetar filen och reglerna för `id`, `scope` och ikonernas syften.\n- [Web App Manifest - Application Information](https://www.w3.org/TR/manifest-app-info/)\n  — `description`, `categories` och `screenshots`, med formfaktorer och etiketter.\n- [IANA: application/manifest+json](https://www.iana.org/assignments/media-types/application/manifest+json)\n  — registreringen av medietypen och dess filändelse `.webmanifest`.\n- [HTML Standard: link type manifest](https://html.spec.whatwg.org/multipage/links.html#link-type-manifest)\n  — hur manifestlänken hämtas och varför bara den första räknas.\n- [Use web apps in Firefox for Windows](https://support.mozilla.org/en-US/kb/web-apps-firefox-windows)\n  — Windows-funktionen och dess tillgänglighet från version 143 eller Microsoft Store-version 150.\n- [Firefox Source Docs: Web Apps in Firefox](https://firefox-source-docs.mozilla.org/browser/components/taskbartabs/docs/index.html)\n  — den aktuella implementationen: Windows aktiverat som standard, Linux avstängt som\n  standard och macOS utan stöd.\n\n\u003chttps://engineer.company/sv/glossary/webmanifest/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Vad fälten i ett webbappsmanifest avgör för en installerad webbplats, varför dess id måste ligga fast och vad hemskärmar gör med ikonerna i det.","formats":{"gemtext":"https://engineer.company/sv/glossary/webmanifest/index.gmi","gopher":"https://engineer.company/sv/glossary/webmanifest/gophermap","html":"https://engineer.company/sv/glossary/webmanifest/","json":"https://engineer.company/sv/glossary/webmanifest/index.json","markdown":"https://engineer.company/sv/glossary/webmanifest/index.md","pdf":"https://engineer.company/sv/glossary/webmanifest/index.pdf"},"kind":"page","language":"sv","title":"Vad är ett webbappsmanifest?","url":"https://engineer.company/sv/glossary/webmanifest/","version":1}