@svelte-parts/map
v0.0.24
Published
Leaflet map components for svelte
Downloads
59
Readme
@svelte-parts/map
Map components using leaflet. Lets you create very basic maps with tiles, markers and geojson. If you need something beyond that, use these components for inspiration and create your own. More about that below.
Try it out in the svelte REPL
Install
npm install @svelte-parts/map
Usage
<script>
import Map from '@svelte-parts/map'
import Marker from '@svelte-parts/map/marker'
import Tiles from '@svelte-parts/map/tiles'
</script>
<Map width="100%" height="300px" lon={0} lat={51.5}>
<Tiles />
<Marker lon={0} lat={51.5} popup="Hello, I am a popup" />
</Map>
Map
This is the wrapper. Other map components must be inside it.
Properties
- lat (default: 0)
- lon (default: 0)
- zoom (default: 5)
- width (default:
100%
) - height (default:
100px
)
Tiles
The background tiles.
Properties
- url (default:
https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png
) - maxZoom (default: 19)
- attribution (default:
© <a href="https://www.openstreetmap.org/copyright">OpenStreetMap</a> contributors
)
Find more tile providers here.
Marker
Properties
- lat (default: 0)
- lon (default: 0)
- popup (default:
undefined
)
Geojson
Properties
- data (a geojson object)
- style (optional styling, see leaflet docs)
CSS
In order to see a map at all, you need to use the css file node_modules/leaflet/dist/leaflet.css
. Add it to your project however you want.
Important: the folder node_modules/leaflet/dist/images
needs to be served in your build from the same folder as the css file.
Creating your own components
Leaflet is a very capable library. These components barely scratch the surface of what you can do. The api and documentation are easy to get into. You may want to create your own components. Have a look at how I made the Marker.
Access the leaflet map instance with:
const { getMap } = getContext('leaflet_map')
const map = getMap()
Import the leaflet functions and properties you need to create new components.
The Map component, to initialise the leaflet instance, is also straight forward. You may not need this library after all.