{"canonical_url":"https://engineer.company/da/glossary/webmanifest/","content_markdown":"# Web app-manifest\n\n## Hvad det er\n\nEt web app-manifest er et JSON-dokument, der beskriver et website som et\nprogram: hvad det hedder, hvilken adresse det åbner på, hvilke adresser der\nhører til det, hvordan vinduet skal se ud, og hvilke billeder der står for det.\nSiden peger på filen med et `link`-element, hvis `rel` er `manifest`, og en\nbrowser, der tilbyder installation, læser web app-manifestet for at afgøre, hvad\nden installerede kopi skal være. W3C-specifikationen bag formatet kalder det\nblot manifestet, og det gør de fleste i daglig tale også.\n\nFilen er almindelig JSON. Den registrerede medietype er\n`application/manifest+json`, og den registrerede filendelse er `.webmanifest`,\nmen specifikationen godtager enhver JSON-medietype, og mange sites serverer en\n`manifest.json`. Alle medlemmer er valgfrie. Et lille manifest til et opdigtet\nsite med tidevandstabeller for en havn kan se sådan ud:\n\n```json\n{\n    \"name\": \"Havnens tidevandstabeller\",\n    \"short_name\": \"Tidevand\",\n    \"start_url\": \"/tidevand/\",\n    \"display\": \"standalone\",\n    \"background_color\": \"#ffffff\",\n    \"icons\": [\n        {\n            \"src\": \"/ikoner/tidevand-512.png\",\n            \"sizes\": \"512x512\",\n            \"type\": \"image/png\"\n        }\n    ]\n}\n```\n\nTre medlemmer bestemmer, hvad appen er, til forskel fra hvordan den ser ud.\n`start_url` foreslår den side, den installerede app åbner på; browseren kan\nignorere den eller lade brugeren ændre den. `scope` er de adresser,\nder regnes for at høre til inde i appen; mangler det, tager specifikationen\nstart-URL'en og skærer filnavn, forespørgsel og fragment af, så eksemplet\novenfor ejer alt under `/tidevand/`. `id` er appens identitet, og mangler det,\nfalder det tilbage på start-URL'en. Relative ikonadresser og\nstart-URL'en fortolkes i forhold til manifestets egen URL og ikke til den side,\nder linkede til det. Et relativt `id` fortolkes derimod i forhold til\nstart-URL'ens origin.\n\nResten handler om udseende. `display` beder om `fullscreen`, `standalone`,\n`minimal-ui` eller `browser`, og en browser, der ikke kan imødekomme ønsket, går\nned ad listen i netop den rækkefølge. Hvert ikon kan have et `purpose`: `any`\nsom standard, `maskable` til et billede tegnet til at tåle beskæring eller\n`monochrome` til et billede, hvis farver smides væk, så kun alfakanalen bruges.\n`theme_color` farver vinduet omkring appen. En ledsagende W3C-note tilføjer\n`description`, `categories` og `screenshots`, som installationsdialoger og\nappbutikker kan vise.\n\n## Hvorfor det betyder noget\n\nManifestet leverer installationsmetadata, som sitet selv styrer.\nSpecifikationen overlader beslutningen til browseren: den må tilbyde\ninstallation, og hver browser fastsætter sine egne betingelser, hvoraf nogle\nkræver bestemte medlemmer. Et team leverer råmaterialet, og browseren afgør,\nhvad der sker med det, så det nyttige spørgsmål handler mindre om, hvorvidt der\nskal være et manifest, end om, hvad det lover.\n\nIdentiteten er det løfte, der lever længere end filen. Når en browser henter\nmanifestet igen, siger specifikationen, at den bør bruge et matchende `id` som\ntegn på, at den nye fil erstatter manifestet til en allerede installeret app.\nFordi et manglende `id` er lig med start-URL'en, skifter identiteten i stilhed,\nnår startsiden flyttes, så browseren bør behandle den nye fil som et andet\nprogram end det, der ligger på læserens enhed. At låse `id` fast i den første\nudgivelse koster én linje og fjerner den risiko.\n\nOmfanget afgør, hvor appvinduet slutter. Navigation inden for `scope` bliver i\ndet installerede vindue. Et link, der fører ud, åbner stadig, men\nspecifikationen forventer, at browseren gør det synligt for læseren, at siden\nligger uden for appen, så et omfang, der er smallere end sitet, får almindelige\nlinks mellem dets afsnit til at ligne udgange.\n\nIkonerne er dér, hvor det meste af den synlige skade sker. Hjemmeskærme og\nappstartere beskærer ikoner til cirkler, afrundede firkanter og andre former, og\net logo, der fylder hele sit kvadrat, mister kanterne. Specifikationen definerer\nsikkerhedszonen for et maskable ikon som en cirkel i midten med en radius på to\nfemtedele af ikonets korteste side, og alt uden for den kan blive skåret væk. Et\nmonokromt ikon beholder kun sin alfakanal, så et ikon tegnet på en\nuigennemsigtig baggrund bliver til en massiv firkant.\n\nFarvemedlemmerne rækker kortere, end de ser ud til. `background_color` er kun\nment til øjeblikket, før stylesheetet når frem, og specifikationen forbyder\nbrowseren at bruge den, når stylesheetet er klar. Den farver det første billede,\nog intet efter det.\n\n## Sådan ser det ud i praksis\n\nDette site bygger sit manifest ud fra en skabelon i stedet for at vedligeholde\nen fil i hånden. Hugo-konfigurationen registrerer `application/manifest+json`\nmed endelsen `webmanifest` og gør manifestet til et output af hvert sprogs\nforside, så hvert sprog får sin egen fil, og hovedet på hver side linker til\nfilen for sit eget sprog. Konfigurationen noterer også hvorfor: én fælles kopi\nkan kun angive én start-URL, og en dansk besøgende, der installerede sitet, fik\nen app, der åbnede den engelske forside.\n\nSkabelonen samler manifestet med Hugos `dict` og sender det gennem Hugos\nJSON-encoder, så escaping og kommaer er encoderens ansvar, og et glemt komma når\naldrig ud. Hver ikonadresse starter ved roden af værten, og kommentaren i\nskabelonen forklarer grunden: en relativ adresse i `/da/manifest.webmanifest`\nville blive fortolket som en adresse under `/da/`, og hvert ikon på dansk ville give 404. Selve\nikonerne læses fra disken i tre mapper, én pr. formål, med ti størrelser i hver\nfra 36 til 512 pixel, og størrelsen aflæses i filnavnet, så en størrelse, som\ngeneratoren tilføjer, dukker op i manifestet, uden at nogen skal rette i det.\n\n`id` er låst fast til sprogets forsideadresse, og `scope` er hele originet, så\net link over i et andet sprog bliver i det installerede vindue. Skærmbilleder\nnavngives `\u003clang\u003e-\u003cform_factor\u003e-\u003cWxH\u003e.webp`, og skabelonen aflæser alle tre\noplysninger i filnavnet: engelsk og dansk har hver ét bredt billede på 1.280\ngange 800 og ét smalt på 780 gange 1.688. Et sprog uden skærmbilleder får slet\nintet `screenshots`-medlem, i stedet for en tom liste.\n\n[Kolofonen](/da/credits/) nævner W3C-specifikationen blandt de standarder, sitet\nfølger, og PWABuilder blandt de eksterne tjek, enhver selv kan køre: en tjeneste\npå Microsofts servere, der gennemgår manifestet og alt det øvrige, som\ninstallation afhænger af.\n\n[Installationssiden](/da/install/) er læserens halvdel af den samme fil. Den viser, hvor\nhver browser gemmer installationskommandoen, og fortæller, at Apples browsere aldrig\ntilbyder installation af sig selv. Firefox har en særskilt funktion til webappvinduer,\nsom er slået til som standard på Windows fra version 143, eller version 150 hvis Firefox\ner installeret fra Microsoft Store. Mozillas implementeringsdokumentation angiver,\nat Linux-understøttelsen er slået fra som standard, og at macOS ikke understøttes.\nSiden afstemmer også forventningerne til dette site: den installerede app er et ikon\nog et selvstændigt vindue. Sitet udgiver ingen service worker eller administreret\nkopi til offlinebrug, så det kræver forbindelse til normal brug.\n\n## Hvor det går galt\n\n**Alle ikoner giver 404 på en oversat sti.** En relativ `src` fortolkes i forhold\ntil manifestets URL, så et manifest, der serveres under et sprogpræfiks, beder\nom ikoner under samme præfiks. Skriv ikonadresser fra værtens rod eller som\nfulde URL'er.\n\n**Den installerede app åbner på det forkerte sprog.** Ét manifest kan angive én\nstart-URL, så alle læsere installerer den samme forside. Server ét manifest pr.\nsprog med sin egen `start_url` og sit eget `id`, og link til det passende fra\nhver side.\n\n**Installerede kopier overser det nye manifest.** Uden `id` er identiteten\nstart-URL'en, så når startsiden flyttes, får filen en ny identitet, og browseren\nbør derefter behandle den som en anden app end den, læserne allerede har. Sæt `id` før første\nudgivelse, og lad det ligge bagefter.\n\n**Hjemmeskærmen beskærer logoet.** Et ikon med formålet `any` placeres eller\nbeskæres, som platformen finder passende. Tilføj et `maskable` ikon, hvor alt\nvigtigt ligger inden for den midterste cirkel, hvis radius er 40 % af ikonets\nkorteste side.\n\n**Rettelser i manifestet gør ingen forskel.** HTML-standarden bruger kun det\nførste `link`-element, hvis `rel` indeholder `manifest`, så har et tema eller et\nplugin sat sit eget link tidligere på siden, bliver den fil, der rettes i,\naldrig læst. Hold præcis ét manifestlink pr. side.\n\n## Læs mere\n\n- [Web Application Manifest](https://www.w3.org/TR/appmanifest/) — alle\n  medlemmer, hvordan en browser behandler filen, og reglerne for `id`, `scope`\n  og ikonformål.\n- [Web App Manifest - Application Information](https://www.w3.org/TR/manifest-app-info/)\n  — `description`, `categories` og `screenshots` med formfaktorer og etiketter.\n- [IANA: application/manifest+json](https://www.iana.org/assignments/media-types/application/manifest+json)\n  — registreringen af medietypen og filendelsen `.webmanifest`.\n- [HTML Standard: link type manifest](https://html.spec.whatwg.org/multipage/links.html#link-type-manifest)\n  — hvordan manifestlinket hentes, og hvorfor kun det første tæller.\n- [Use web apps in Firefox for Windows](https://support.mozilla.org/en-US/kb/web-apps-firefox-windows)\n  — Windows-funktionen og dens tilgængelighed fra version 143 eller Microsoft\n  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 aktuelle implementering: Windows slået til som standard, Linux slået\n  fra som standard og macOS ikke understøttet.\n\n\u003chttps://engineer.company/da/glossary/webmanifest/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Hvad medlemmerne i et web app-manifest bestemmer for et installeret site, hvorfor dets id skal ligge fast, og hvad hjemmeskærme gør ved ikonerne.","formats":{"gemtext":"https://engineer.company/da/glossary/webmanifest/index.gmi","gopher":"https://engineer.company/da/glossary/webmanifest/gophermap","html":"https://engineer.company/da/glossary/webmanifest/","json":"https://engineer.company/da/glossary/webmanifest/index.json","markdown":"https://engineer.company/da/glossary/webmanifest/index.md","pdf":"https://engineer.company/da/glossary/webmanifest/index.pdf"},"kind":"page","language":"da","title":"Hvad er et web app-manifest?","url":"https://engineer.company/da/glossary/webmanifest/","version":1}