{"canonical_url":"https://engineer.company/sv/glossary/leaflet/","content_markdown":"# Leaflet\n\n## Vad det är\n\nLeaflet är ett JavaScript-bibliotek med öppen källkod som gör ett element på en webbsida till en\nkarta som går att panorera, zooma och klicka i. Projektet anger storleken till ungefär 42 KB\nJavaScript och listar inga externa beroenden. Det skapades av Volodymyr Agafonkin, utvecklas i dag\nav en gemenskap av bidragsgivare och ges ut under licensen BSD 2-Clause.\n\nProjektets egen översikt säger att det inte försöker göra allt för alla, utan koncentrerar sig på\natt få grunderna att fungera väl. `L.map` tar ett element och en uppsättning alternativ och blir\nkartan. Ett lager med kartplattor (tiles) hämtar kvadratiska bilder från en URL-mall med `{z}`,\n`{x}` och `{y}` i sig och lägger ut dem som ett rutnät av bildelement, och en WMS-variant gör samma\nsak mot en Web Map Service. Linjer, polygoner, cirklar och rektanglar ritas som SVG som standard,\neller på en enda canvas när kartan skapas med `preferCanvas`. Markörer är ikoner, antingen en bild\neller en enkel `div`, med popup-rutor och verktygstips kopplade till sig. Ett GeoJSON-lager gör\nvarje objekt till ett av de lagren, en punkt till en markör om inget annat anges. Zoomknappar,\nkällhänvisning, en lagerväljare och en skalstock utgör kontrollerna. Standardsystemet för\nkoordinater är EPSG:3857, som referensdokumentationen kallar det vanligaste för kartor på nätet.\n\nAllt utöver den listan kommer från tillägg. Projektets databas över tillägg beskriver Leaflet som\ntänkt att vara så lätt som möjligt och pekar på hundratals tillägg från tredje part, sorterade i\ngrupper som vektorplattor, klustring, värmekartor, redigering av geometri, ruttplanering och\ngeokodning.\n\nTvå utgivningslinjer finns när detta skrivs. Den stabila är 1.9.4, utgiven den 18 maj 2023, och\nAPI-referensen på projektets webbplats motsvarar den. Förhandsversionen, 2.0.0-alpha.1 från den\n16 augusti 2025, tar bort stödet för Internet Explorer och levereras som en ES-modul. Den behåller\ndet globala `L` bara i en paketerad `leaflet-global.js`, ersätter fabriksfunktioner med\nkonstruktorer, så att `L.marker(latlng)` blir `new Marker(latlng)`, och tar emot inmatning via\npekarhändelser (pointer events).\n\n## Varför det spelar roll\n\nAtt sätta en karta på en sida är två beslut som är lätta att ta för ett: vilken kod som ritar kartan\ni webbläsaren, och varifrån kartbilderna kommer. Leaflet håller isär dem, och valet att använda det\när till stor del ett val att hålla isär dem.\n\nLeaflet ritar. Kartplattorna kommer från dit URL-mallen pekar, så bakgrundskartan är ett separat\nbeslut med eget pris, egna villkor och egen ägare. Den kan vara OpenStreetMaps server för\nkartplattor medan en funktion byggs, en kommersiell leverantör i produktion, en server som\nprojektet driver själv eller en kommuns WMS via `TileLayer.WMS`. Att byta mellan dem ändrar en\nsträng och en rad med källhänvisning, och applikationskoden runt kartan förblir som den är.\n\nStorleken och licensen avgör var Leaflet passar bra. Ungefär 42 KB och inga beroenden passar en\nsida där kartan är en del bland många: ett formulär där någon sätter ut en nål, eller en\nadministrationsvy som visar var poster finns. Licensen BSD 2-Clause lägger inget konto, ingen\nnyckel och ingen mätning av användningen mellan biblioteket och sidan.\n\nPriset för en liten kärna är att tyngre funktioner kommer som separata paket, vart och ett med egen\nunderhållare och egen utgivningstakt, och en karta som lutar sig mot sex tillägg ärver sex\nuppgraderingsvägar. Alfan av 2.0 visar vad det betyder: dess migreringsanvisningar hänvisar den som\nanvänder äldre tillägg till en polyfill för V1, eftersom de tilläggen förväntar sig det globala `L`\noch fabriksfunktionerna. En karta som behöver vektorplattor som stilsätts i webbläsaren på varje\nzoomnivå passar bättre i ett bibliotek som är byggt kring dem, och det beslutet fattas helst innan\nsex tillägg håller uppe kartan.\n\n## Så ser det ut i praktiken\n\nLeaflet förekommer på två sidor på den här webbplatsen, båda från rollen som teamledare för\nutveckling av GIS-mjukvara mellan 2015 och 2022, och på båda delar det frontenden med Mapbox.\n\nRollen hade ansvar för\n[mer än trettio GIS-projekt](/sv/portfolio/led-30-gis-projects-from-build-to-support/)\ngenom utveckling och driftsättning. Det projekten visade utåt var webbkartor byggda på Leaflet och\nMapbox GL, ibland kopplade mot ArcGIS- eller HERE-API:erna, och koden runt kartorna skrevs i\nJavaScript, Python, PHP och SQL. Under låg PostgreSQL med PostGIS, och GDAL/OGR flyttade data mellan\nshapefiler, GeoJSON, GeoTIFF, KML och vektorplattor. Ansvaret sträckte sig längre än till\nleveransen, ända in i supporten i produktion.\n\nSamma roll fanns också med i\n[designprocessen för projektens användargränssnitt](/sv/portfolio/contributed-to-user-interface-design-processes/).\nDet var frontends i React, Angular och Vue ovanpå kartor i Mapbox och Leaflet, och sidan gör en\npoäng som är värd att ha bredvid vilket kartbibliotek som helst: i en webbkartprodukt är kartan den\nenkla delen, och det är i kontrollerna, filtreringen och flödet runt den som folk går vilse.\nAnvändbarheten satt i detaljer som hur en datamängd filtrerades och hur man rörde sig mellan\nvåningsplan på en inomhuskarta, och sidan tillskriver det mesta av skillnaden att de frågorna\nställdes under designen och inte efter lanseringen.\n\n## Var det går fel\n\nLeaflet är så litet att de flesta av dess fel kommer från sidan runt det, eller från de tjänster\ndet pekas mot.\n\n**Kartan visas som en grå ruta eller en remsa av lösa kartplattor.** Leaflet tar sin storlek från\nsin behållare. Snabbstartsguiden listar två saker att göra innan någon kartkod körs: ladda Leaflets\nCSS-fil före JavaScript-koden, och ge behållaren en bestämd höjd. En `div` utan höjd ger en karta\nutan höjd. Ett lurigare fall är en karta som skapas inuti en flik eller en dialog som är dold just\ndå: den mäter sig själv till noll och behåller den storleken när den visas. Leaflet 1.x följer när\nwebbläsarfönstret ändrar storlek, via `trackResize`, så en behållare som ändrar storlek av sig själv\npasserar obemärkt tills koden anropar `invalidateSize()`, som referensen säger ska anropas när\nkartans storlek har ändrats. Alfan av 2.0 använder `ResizeObserver` i stället för fönstrets\nresize-händelse.\n\n**Punkter hamnar tusentals kilometer bort.** GeoJSON, så som RFC 7946 definierar det, skriver en\nposition med longituden först. Leaflets `LatLng` och de arrayer som det tar emot i stället har\nlatituden först. `L.geoJSON` översätter mellan de två på egen hand, så buggen dyker upp när\nkoordinater plockas ut ur GeoJSON för hand och skickas direkt till en markör eller en linje. En\npunkt i Stockholm hamnar, omkastad, i Arabiska havet. Packa upp paret med namn vid gränsen:\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 hackar när datan växer.** Med SVG-renderaren är varje linje eller polygon ett eget\nelement i dokumentet, och varje standardmarkör en egen bild. Ett lager med många tusen objekt\nbetyder många tusen element som webbläsaren måste flytta vid varje panorering och zoomning.\nAlternativet `preferCanvas: true` ritar banor på en enda canvas, men gäller bara banor, så punkter\nmåste bli `L.circleMarker`, en cirkel med fast radie i pixlar som själv är en bana, via\nGeoJSON-lagrets alternativ `pointToLayer`. Bortom den gränsen är svaret att skicka mindre: ett\ntillägg för klustring, eller ett API som bara returnerar det som får plats i den aktuella vyn och\nzoomnivån.\n\n**Kartplattorna slutar laddas efter lanseringen.** Snabbstartsguiden bygger sin första karta på\nOpenStreetMaps server för kartplattor och säger rakt ut att de plattorna går bra under\nprogrammering, men att användningsvillkoren, Tile Usage Policy, ska läsas före produktion.\nVillkoren ber om synlig källhänvisning, en User-Agent som identifierar applikationen och en giltig\nReferer från webbsidor, cachning enligt HTTP-huvudena och att ingen massnedladdning eller\nförhämtning görs. De erbjuder inget servicenivåavtal, och åtkomsten kan spärras utan förvarning. En\nvälbesökt karta i produktion hör hemma hos en leverantör vars villkor passar trafiken, eller på en\negen server för kartplattor, och med Leaflet består flytten av URL-mallen och källhänvisningen.\n\n## Läs mer\n\n- [Leaflet](https://leafletjs.com/) — projektets översikt, funktionslista och en första karta på\n  några få rader.\n- [Leaflet API reference](https://leafletjs.com/reference.html) — varje klass, alternativ och\n  metod i 1.9.4, bl.a. `preferCanvas`, `invalidateSize` och alternativen för GeoJSON.\n- [Leaflet Quick Start Guide](https://leafletjs.com/examples/quick-start/) — CSS-filen,\n  behållarens höjd och ett första lager med kartplattor, steg för steg.\n- [Leaflet 2.0 Alpha released](https://leafletjs.com/2025/05/18/leaflet-2.0.0-alpha.html)\n  — vad som ändras i 2.0 och hur kod och tillägg migreras.\n- [Tile Usage Policy](https://operations.osmfoundation.org/policies/tiles/) — villkoren för att\n  använda kartplattorna från openstreetmap.org.\n- [RFC 7946: The GeoJSON Format](https://www.rfc-editor.org/rfc/rfc7946) — GeoJSON-standarden,\n  inklusive ordningen med longituden först i positioner.\n\n\u003chttps://engineer.company/sv/glossary/leaflet/\u003e\n","date_modified":"2026-10-20T21:59:50Z","description":"Hur Leaflet gör ett element på sidan till en webbkarta, vad det lämnar åt leverantörer av kartplattor och åt tillägg, och fällorna med höjd och koordinater.","formats":{"gemtext":"https://engineer.company/sv/glossary/leaflet/index.gmi","gopher":"https://engineer.company/sv/glossary/leaflet/gophermap","html":"https://engineer.company/sv/glossary/leaflet/","json":"https://engineer.company/sv/glossary/leaflet/index.json","markdown":"https://engineer.company/sv/glossary/leaflet/index.md","pdf":"https://engineer.company/sv/glossary/leaflet/index.pdf"},"kind":"page","language":"sv","title":"Vad är Leaflet?","url":"https://engineer.company/sv/glossary/leaflet/","version":1}