{"canonical_url":"https://engineer.company/nb/glossary/leaflet/","content_markdown":"# Leaflet\n\n## Hva det er\n\nLeaflet er et JavaScript-bibliotek med åpen kildekode som gjør ett element på en nettside om til et\nkart en person kan panorere, zoome og klikke i. Prosjektet oppgir størrelsen til rundt 42 KB\nJavaScript og lister ingen eksterne avhengigheter. Det ble laget av Volodymyr Agafonkin, utvikles nå\nav et fellesskap av bidragsytere og er utgitt under lisensen BSD 2-Clause.\n\nProsjektets egen oversikt sier at det ikke prøver å gjøre alt for alle, og at det konsentrerer seg\nom å få det grunnleggende til å fungere godt. `L.map` tar et element og et sett med innstillinger og\nblir selve kartet. Et fliselag henter kvadratiske bilder fra en URL-mal med `{z}`, `{x}` og `{y}` i\nseg og legger dem ut som et rutenett av bildeelementer, og en WMS-variant gjør det samme mot en Web\nMap Service. Polylinjer, polygoner, sirkler og rektangler tegnes som SVG som standard, eller på ett\nenkelt canvas når kartet opprettes med `preferCanvas`. Markører er ikoner, enten et bilde eller en\nvanlig `div`, med popuper og verktøytips knyttet til seg. Et GeoJSON-lag gjør hver feature om til et\nav disse lagene, et punkt til en markør med mindre noe annet er angitt. Zoomknapper,\nkildehenvisning, en lagvelger og en målestokk utgjør kontrollene. Standard koordinatreferansesystem\ner EPSG:3857, som referansen kaller det vanligste for kart på nett.\n\nAlt utover den listen kommer fra programtillegg, plugins. Prosjektets database over programtillegg\nbeskriver Leaflet som ment å være så lett som mulig, og viser til hundrevis av programtillegg fra\ntredjeparter, sortert i grupper som vektorfliser, klynging, varmekart, redigering av geometri,\nruteplanlegging og geokoding.\n\nTo utgivelseslinjer finnes i skrivende stund. Den stabile er 1.9.4, utgitt 18. mai 2023, og\nAPI-referansen på prosjektets nettsted gjenspeiler den. Forhåndsutgivelsen, 2.0.0-alpha.1 fra 16.\naugust 2025, dropper støtten for Internet Explorer og leveres som en ES-modul. Den beholder den\nglobale `L` bare i en samlet `leaflet-global.js`, erstatter fabrikkfunksjoner med konstruktører,\nslik at `L.marker(latlng)` blir `new Marker(latlng)`, og tar imot inndata gjennom pointer-hendelser.\n\n## Hvorfor det er viktig\n\nÅ sette et kart på en side er to avgjørelser som er lette å forveksle med én: hvilken kode som\ntegner kartet i nettleseren, og hvor kartbildene kommer fra. Leaflet holder dem adskilt, og valget\nom å bruke det er for det meste et valg om å holde dem adskilt.\n\nLeaflet tegner. Flisene kommer fra der URL-malen peker, så bakgrunnskartet er en egen avgjørelse med\nsin egen pris, sine egne vilkår og sin egen eier. Det kan være flisserveren til OpenStreetMap mens\nen funksjon bygges, en kommersiell leverandør i produksjon, en flisserver prosjektet driver selv,\neller en kommunes WMS gjennom `TileLayer.WMS`. Å flytte mellom dem endrer en streng og en linje med\nkildehenvisning, og applikasjonskoden rundt kartet blir som den er.\n\nStørrelsen og lisensen avgjør hvor Leaflet passer uten å skave. Rundt 42 KB uten avhengigheter\npasser en side der kartet er én del blant mange: et skjema der noen setter en nål, eller en\nadministrasjonsskjerm som viser hvor postene befinner seg. BSD 2-Clause-lisensen setter ingen konto,\nnøkkel eller forbruksmåling mellom biblioteket og siden.\n\nPrisen for en liten kjerne er at tyngre funksjoner kommer som egne pakker, hver med sin egen\nvedlikeholder og sitt eget utgivelsestempo, og et kart som lener seg på seks programtillegg, arver\nseks oppgraderingsløp. Alfaversjonen av 2.0 viser hva det betyr: migreringsnotatene peker brukere av\neldre programtillegg til en V1-polyfill, fordi de programtilleggene forventer den globale `L` og\nfabrikkfunksjonene. Et kart som trenger vektorfliser stilsatt i nettleseren på hvert zoomnivå,\npasser bedre i et bibliotek som er bygd rundt dem, en avgjørelse som helst tas før seks\nprogramtillegg holder kartet oppe.\n\n## Slik ser det ut i praksis\n\nLeaflet dukker opp på to sider av dette nettstedet, begge fra rollen som teamleder for utvikling av\nGIS-programvare mellom 2015 og 2022, og på begge deler det frontenden med Mapbox.\n\nRollen bar leveransen av\n[over tretti GIS-prosjekter, med driftsstøtte også etter produksjonssettingen](/nb/portfolio/led-30-gis-projects-from-build-to-support/).\nDet brukerne så av prosjektene, var webkart i nettleseren, bygd på Mapbox GL og Leaflet, og i noen\nav prosjektene gikk kartet mot API-ene til ArcGIS eller HERE. Bak kartene sto et applikasjonslag i\nJavaScript, Python, PHP og SQL, de romlige dataene lå i PostGIS, og GDAL/OGR flyttet dem mellom\nformater som shapefiler, GeoJSON, GeoTIFF, KML og vektorfliser. Ansvaret strakk seg forbi leveransen\nog inn i driftsstøtten i produksjon.\n\nDen samme rollen satt også i\n[designprosessen for prosjektenes brukergrensesnitt](/nb/portfolio/contributed-to-user-interface-design-processes/).\nDette var frontender i React, Angular og Vue oppå kart i Mapbox og Leaflet, og siden poengterer noe\nsom er verdt å ha ved siden av ethvert kartbibliotek: i et webkartprodukt er kartet den enkle delen,\nog det er kontrollene, filtreringen og flyten rundt det som får folk til å gå seg vill.\nBrukervennligheten lå i detaljer som hvordan et datasett ble filtrert, og hvordan noen flyttet seg\nmellom etasjer på et innendørskart, og siden tilskriver det meste av forskjellen at de spørsmålene\nble stilt under designarbeidet og ikke etter lansering.\n\n## Hvor det går galt\n\nLeaflet er lite nok til at de fleste feilene kommer fra siden rundt det, eller fra tjenestene det\npeker mot.\n\n**Kartet vises som en grå boks eller en stripe med løse fliser.** Leaflet henter størrelsen sin fra\nbeholderen. Hurtigstarten lister to ting som må gjøres før noen kartkode kjører: last inn CSS-filen\ntil Leaflet før JavaScript-koden, og gi beholderen en bestemt høyde. En `div` uten høyde gir et kart\nuten høyde. Et mer subtilt tilfelle er et kart som opprettes i en fane eller dialog som er skjult i\nøyeblikket: det måler seg selv til null og beholder den størrelsen når det kommer til syne. Leaflet\n1.x følger med når nettleservinduet endrer størrelse, gjennom `trackResize`, så en beholder som\nendrer størrelse av seg selv, går upåaktet hen til koden kaller `invalidateSize()`, som referansen\nsier skal kalles etter at kartets størrelse er endret. Alfaversjonen av 2.0 bruker `ResizeObserver`\ni stedet for vinduets resize-hendelse.\n\n**Punkter havner tusenvis av kilometer unna.** GeoJSON, slik RFC 7946 definerer det, skriver en\nposisjon med lengdegraden først. `LatLng` i Leaflet og matrisene det godtar i stedet, har\nbreddegraden først. `L.geoJSON` gjør om mellom de to av seg selv, så feilen oppstår når koordinater\nhentes ut av GeoJSON for hånd og sendes rett til en markør eller en polylinje. Et punkt i København\nhavner, med koordinatene byttet om, i Arabiahavet. Pakk ut paret etter navn ved grensen:\n\n```js\nconst res = await fetch(\"/api/sites/42\");\nconst site = await res.json();\nconst [lon, lat] = site.geometry.coordinates; // GeoJSON: lon, lat\nL.marker([lat, lon]).addTo(map); // Leaflet: lat, lng\n```\n\n**Panoreringen hakker når dataene vokser.** Med SVG-tegneren er hver linje eller polygon sitt eget\nelement i dokumentet, og hver standardmarkør er sitt eget bilde. Et lag med mange tusen features\nbetyr mange tusen elementer nettleseren må flytte ved hver panorering og zooming. `preferCanvas:\ntrue` tegner baner på ett canvas, men det gjelder bare baner, så punkter må bli `L.circleMarker`, en\nsirkel med fast radius i piksler som selv er en bane, gjennom innstillingen `pointToLayer` på\nGeoJSON-laget. Forbi det punktet er svaret å sende mindre: et programtillegg for klynging, eller et\nAPI som bare returnerer det som passer det gjeldende utsnittet og zoomnivået.\n\n**Flisene slutter å laste etter lansering.** Hurtigstarten bygger det første kartet sitt på\nflisserveren til OpenStreetMap og sier rett ut at de flisene er greie for programmering, men at\nretningslinjene for bruk av fliser, Tile Usage Policy, skal leses før produksjon. Retningslinjene\nkrever synlig kildehenvisning, en User-Agent som identifiserer applikasjonen og en gyldig Referer\nfra nettsider, caching i tråd med HTTP-headerne, og ingen massenedlasting eller forhåndshenting. De\ntilbyr ingen tjenestenivåavtale og kan blokkere tilgangen uten varsel. Et travelt kart i produksjon\nhører hjemme hos en leverandør med vilkår som passer trafikken, eller på en egen flisserver, og med\nLeaflet er den flyttingen URL-malen og teksten i kildehenvisningen.\n\n## Les mer\n\n- [Leaflet](https://leafletjs.com/) — prosjektets oversikt, funksjonsliste og et første kart på noen\n  få linjer.\n- [Leaflet API reference](https://leafletjs.com/reference.html) — hver klasse, innstilling og metode\n  i 1.9.4, også `preferCanvas`, `invalidateSize` og innstillingene for GeoJSON.\n- [Leaflet Quick Start Guide](https://leafletjs.com/examples/quick-start/) — CSS-filen, høyden på\n  beholderen og et første fliselag, steg for steg.\n- [Leaflet 2.0 Alpha released](https://leafletjs.com/2025/05/18/leaflet-2.0.0-alpha.html) — hva som\n  endres i 2.0, og hvordan kode og programtillegg migreres.\n- [Tile Usage Policy](https://operations.osmfoundation.org/policies/tiles/) — vilkårene for å bruke\n  flisserverne på openstreetmap.org.\n- [RFC 7946: The GeoJSON Format](https://www.rfc-editor.org/rfc/rfc7946) — GeoJSON-standarden, også\n  rekkefølgen med lengdegraden først i posisjoner.\n\n\u003chttps://engineer.company/nb/glossary/leaflet/\u003e\n","date_modified":"2026-10-20T21:59:50Z","description":"Hva Leaflet tegner selv og hva det overlater til programtillegg og flisleverandører, og feilene bak grå kart, byttede koordinater og fliser som stopper.","formats":{"gemtext":"https://engineer.company/nb/glossary/leaflet/index.gmi","gopher":"https://engineer.company/nb/glossary/leaflet/gophermap","html":"https://engineer.company/nb/glossary/leaflet/","json":"https://engineer.company/nb/glossary/leaflet/index.json","markdown":"https://engineer.company/nb/glossary/leaflet/index.md","pdf":"https://engineer.company/nb/glossary/leaflet/index.pdf"},"kind":"page","language":"nb","title":"Hva er Leaflet?","url":"https://engineer.company/nb/glossary/leaflet/","version":1}