{"canonical_url":"https://engineer.company/nb/glossary/webmanifest/","content_markdown":"# web app-manifest\n\n## Hva det er\n\nEt web app-manifest, i bestemt form web app-manifestet og i daglig tale bare manifestet, er et\nJSON-dokument som beskriver et nettsted som et program: hva det heter, hvilken adresse det åpnes på,\nhvilke adresser som hører til det, hvordan vinduet skal se ut, og hvilke bilder som representerer\ndet. En side peker på filen med et `link`-element der `rel` er `manifest`, og en nettleser som\ntilbyr installasjon, leser filen for å avgjøre hva den installerte kopien skal bli. Spesifikasjonen\nfra W3C som definerer formatet, kaller det også bare manifestet.\n\nFilen er ren JSON. Den registrerte medietypen er `application/manifest+json` og den registrerte\nfilendelsen `.webmanifest`, selv om spesifikasjonen godtar enhver JSON-medietype og mange nettsteder\nserverer en `manifest.json`. Hvert medlem er valgfritt. Et lite manifest for et oppdiktet nettsted\nmed tidevannstabeller ser slik ut:\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 medlemmer avgjør hva appen er, til forskjell fra hvordan den ser ut. `start_url` foreslår siden den\ninstallerte appen åpnes på; nettleseren kan ignorere den eller la brukeren endre den. `scope` er mengden adresser som regnes som en del av appen; mangler den,\ntar spesifikasjonen start-URL-en og skjærer bort filnavn, spørrestreng og fragment, så eksempelet\nover eier alt under `/tides/`. `id` er identiteten til appen, og mangler den, faller den tilbake på\nstart-URL-en. Relative ikonadresser og start-URL-en tolkes i forhold til URL-en til selve manifestet og ikke mot\nsiden som lenket til det. En relativ `id` tolkes derimot i forhold til start-URL-ens opprinnelse.\n\nResten er presentasjon. `display` ber om `fullscreen`, `standalone`, `minimal-ui` eller `browser`,\nog en nettleser som ikke kan innfri ønsket, går nedover den listen i rekkefølge. Hvert ikon kan ha\net `purpose`: `any` som standard, `maskable` for et bilde som er tegnet for å tåle beskjæring, eller\n`monochrome` for et bilde der fargen kastes og bare alfakanalen brukes. `theme_color` farger vinduet\nrundt appen. Et tilhørende notat fra W3C legger til `description`, `categories` og `screenshots`,\nsom installasjonsdialoger og appbutikker kan vise.\n\n## Hvorfor det er viktig\n\nManifestet leverer installasjonsmetadata som nettstedet selv styrer. Spesifikasjonen overlater\nbeslutningen om å installere til nettleseren: den kan tilby en måte å installere på, og hver\nnettleser setter sine egne betingelser, der noen krever bestemte medlemmer. Et team leverer\ninndataene, og nettleseren avgjør hva den gjør med dem. Det nyttige spørsmålet er derfor mindre om\nnettstedet skal ha et manifest, og mer hva manifestet lover.\n\nIdentiteten er løftet som lever lenger enn filen. Når en nettleser henter manifestet på nytt,\nsier spesifikasjonen at den bør bruke en samsvarende `id` som et signal om at den nye filen\nerstatter manifestet til en app som allerede er installert. Fordi en manglende `id` er det\nsamme som start-URL-en, endrer en flytting av startsiden identiteten i det stille. Nettleseren\nbør derfor behandle den nye filen som en annen app enn den som ligger på leserens enhet.\nÅ låse `id` i den første utgivelsen koster én linje og fjerner den risikoen.\n\nOmfanget avgjør hvor appvinduet slutter. Navigasjon innenfor `scope` blir i det installerte vinduet.\nEn lenke som går ut av det, åpnes fortsatt, men spesifikasjonen forventer at nettleseren viser\nleseren at vedkommende er utenfor appen, så et omfang som er smalere enn nettstedet, får vanlige\nlenker mellom seksjonene til å se ut som utganger.\n\nIkonene er der det meste av den synlige skaden skjer. Startmenyer og hjemskjermer beskjærer ikoner\ntil sirkler, avrundede kvadrater og andre former, og en logo som fyller hele kvadratet sitt, mister\nkantene. Spesifikasjonen definerer den trygge sonen for et maskerbart ikon som en sirkel i midten\nmed en radius på to femtedeler av ikonets korteste side, og alt utenfor den kan bli skåret bort. Et\nmonokromt ikon beholder bare alfakanalen, så et ikon tegnet på en ugjennomsiktig bakgrunn blir til\net ensfarget kvadrat.\n\nFargemedlemmene har et snevrere bruksområde enn det kan virke som. `background_color` er bare ment for øyeblikket før\nstilarket kommer, og spesifikasjonen forbyr nettleseren å bruke den når stilarket er tilgjengelig.\nDet er fargen ved den første opptegningen, og bare da.\n\n## Slik ser det ut i praksis\n\nDette nettstedet bygger manifestet fra en mal i stedet for å vedlikeholde en fil for hånd.\nHugo-konfigurasjonen registrerer `application/manifest+json` med endelsen `webmanifest` og gjør\nmanifestet til et utdataformat for hjemmesiden på hvert språk, så hvert språk får sin egen fil, og\nhodet på hver side lenker til filen for sitt eget språk. Konfigurasjonen skriver ned hvorfor: én\nfelles kopi kan bare angi én start-URL, og en dansk besøkende som installerte nettstedet, fikk en\napp som åpnet den engelske hjemmesiden.\n\nMalen setter sammen manifestet som en nøkkel-verdi-struktur og gir den til JSON-koderen i Hugo, så escaping og\nkommaer er koderens problem, og et manglende komma kan ikke sendes ut. Hver ikonadresse starter ved\nroten av verten. Kommentaren i malen forklarer grunnen: en relativ adresse i\n`/da/manifest.webmanifest` ville blitt tolket som en adresse under `/da/`, og hvert ikon på dansk ville gitt 404.\nSelve ikonene leses fra disk i tre mapper, én per formål, med ti størrelser hver fra 36 til 512\npiksler, og størrelsen hentes fra filnavnet, så en størrelse som generatoren legger til, dukker opp\ni manifestet uten at noe må redigeres.\n\n`id` er låst til hjemmeadressen for språket, og `scope` er hele opprinnelsen, så en lenke til et\nannet språk blir i det installerte vinduet. Skjermbildene heter `\u003clang\u003e-\u003cform_factor\u003e-\u003cWxH\u003e.webp`,\nog malen leser alle tre opplysningene fra filnavnet: engelsk og dansk har hver ett bredt bilde på\n1280 ganger 800 og ett smalt på 780 ganger 1688. Et språk uten skjermbilder får ikke noe\n`screenshots`-medlem i det hele tatt, heller enn en tom liste.\n\n[Kolofonsiden](/nb/credits/) lister spesifikasjonen fra W3C blant standardene nettstedet følger, og\nPWABuilder blant de eksterne sjekkene hvem som helst kan kjøre: en tjeneste som leser manifestet og\nresten av det som gjør nettstedet installerbart, fra Microsofts maskiner.\n\n[Installasjonssiden](/nb/install/) er leserens halvdel av den samme filen. Den viser hvor\nhver nettleser gjemmer installasjonskommandoen, og nevner at Apples nettlesere aldri\ntilbyr installasjon av seg selv. Firefox har en egen funksjon for nettappvinduer, aktivert\nsom standard på Windows fra versjon 143, eller versjon 150 ved installasjon fra Microsoft\nStore. Mozillas implementasjonsdokumentasjon oppgir at Linux-støtten er deaktivert som\nstandard, og at macOS-støtte ikke er tilgjengelig. Siden forteller også hva leseren kan\nforvente av dette nettstedet: den installerte appen er et ikon og et eget vindu.\nNettstedet publiserer ingen service worker eller administrert frakoblet kopi, så det\ntrenger en tilkobling ved normal bruk.\n\n## Hvor det går galt\n\n**Hvert ikon gir 404 på en oversatt sti.** En relativ `src` tolkes i forhold til URL-en til manifestet, så\net manifest som serveres under et språkprefiks, ber om ikoner under det prefikset. Skriv\nikonadresser fra roten av verten, eller som fullstendige URL-er.\n\n**Den installerte appen åpnes på feil språk.** Ett manifest kan angi én start-URL, så hver leser\ninstallerer den samme hjemmesiden. Lever ett manifest per språk, hvert med sin egen `start_url` og\n`id`, og lenk til det som passer, fra hver side.\n\n**Installerte kopier overser det nye manifestet.** Uten `id` er identiteten start-URL-en, så å\nflytte startsiden gir filen en ny identitet, og nettleseren bør behandle den som en annen app enn den leserne\nallerede har. Sett `id` før den første utgivelsen, og la den være i fred etterpå.\n\n**Startmenyen beskjærer logoen.** Et ikon med formålet `any` plasseres eller skjæres til slik\nplattformen finner det best. Legg til et `maskable`-ikon med alt som betyr noe, innenfor sirkelen i\nmidten, der radien er 40 % av ikonets korteste side.\n\n**Endringer i manifestet endrer ingenting.** HTML-standarden bruker bare det første `link`-elementet\nder `rel` inneholder `manifest`, så når et tema eller et tillegg har lagt inn sin egen lenke\ntidligere på siden, er filen som redigeres, aldri den som leses. Hold deg til nøyaktig én\nmanifestlenke per side.\n\n## Les mer\n\n- [Web Application Manifest](https://www.w3.org/TR/appmanifest/) — hvert medlem, hvordan en\n  nettleser behandler filen, og reglene for `id`, `scope` og formålet med ikoner.\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 av medietypen og filendelsen `.webmanifest`.\n- [HTML Standard: link type manifest](https://html.spec.whatwg.org/multipage/links.html#link-type-manifest)\n  — hvordan manifestlenken hentes, og hvorfor bare den første teller.\n- [Use web apps in Firefox for Windows](https://support.mozilla.org/en-US/kb/web-apps-firefox-windows)\n  — Windows-funksjonen og tilgjengeligheten fra versjon 143 eller Microsoft Store-versjon 150.\n- [Firefox Source Docs: Web Apps in Firefox](https://firefox-source-docs.mozilla.org/browser/components/taskbartabs/docs/index.html)\n  — den gjeldende implementasjonen: Windows aktivert som standard, Linux deaktivert som\n  standard og macOS ikke støttet.\n\n\u003chttps://engineer.company/nb/glossary/webmanifest/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Én JSON-fil avgjør navn, startside, vindu og ikoner for et installert nettsted: hvorfor id må stå fast, og hva startmenyen gjør med ikonene.","formats":{"gemtext":"https://engineer.company/nb/glossary/webmanifest/index.gmi","gopher":"https://engineer.company/nb/glossary/webmanifest/gophermap","html":"https://engineer.company/nb/glossary/webmanifest/","json":"https://engineer.company/nb/glossary/webmanifest/index.json","markdown":"https://engineer.company/nb/glossary/webmanifest/index.md","pdf":"https://engineer.company/nb/glossary/webmanifest/index.pdf"},"kind":"page","language":"nb","title":"Hva er et web app-manifest?","url":"https://engineer.company/nb/glossary/webmanifest/","version":1}