2012-07-17 01:21:00 +08:00
---
layout: default
---
2013-06-26 23:05:57 +08:00
< p class = "notice" > June 26, 2013 — Leaflet 0.6 Released, Code Sprint in DC with MapBox — < a href = "2013/06/26/leaflet-0-6-released-dc-code-sprint-mapbox.html" > Read More in the Blog< / a > < / p >
2012-07-25 06:09:31 +08:00
2012-12-20 23:57:21 +08:00
Leaflet is a modern open-source JavaScript library for mobile-friendly interactive maps.
2013-01-15 23:01:36 +08:00
It is developed by [Vladimir Agafonkin][] with a team of dedicated [contributors][].
2013-06-26 23:16:14 +08:00
Weighing just about < abbr title = "31KB gzipped — that's 117 KB minified and 202 KB in the source form, with 10 KB of CSS (2 KB gzipped) and 17 KB of images." > 31 KB of JS< / abbr > ,
2012-12-20 23:57:21 +08:00
it has all the [features][] most developers ever need for online maps.
2012-07-17 01:21:00 +08:00
2012-12-20 23:57:21 +08:00
Leaflet is designed with _simplicity_ , _performance_ and _usability_ in mind.
It works efficiently across all major desktop and mobile platforms out of the box,
taking advantage of HTML5 and CSS3 on modern browsers while still being accessible on older ones.
It can be extended with many [plugins][], has a beautiful, easy to use and [well-documented API][]
2013-06-26 23:16:14 +08:00
and a simple, readable [source code][] that is a joy to [contribute][] to.
2012-07-17 01:21:00 +08:00
2012-07-25 18:05:51 +08:00
{: .usedby}
2012-12-20 23:57:21 +08:00
Used by:
[Flickr ](http://flickr.com/map )
[foursquare ](https://foursquare.com/ )
[craigslist ](http://t.co/V4EiURIA )
2013-06-26 23:05:57 +08:00
[Data.gov ](http://data.gov )
2012-12-20 23:57:21 +08:00
[IGN ](http://www.ign.com/wikis/the-elder-scrolls-5-skyrim/interactive-maps/Skyrim )
[Wikimedia ](http://blog.wikimedia.org/2012/04/05/new-wikipedia-app-for-ios-and-an-update-for-our-android-app/ )
[OSM ](http://openstreetmap.org )
[Meetup ](http://www.meetup.com/ )
[WSJ ](http://projects.wsj.com/campaign2012/maps/ )
2013-06-26 23:05:57 +08:00
[MapBox ](http://mapbox.com )
2013-01-31 19:33:12 +08:00
[CloudMade ](http://cloudmade.com )
[CartoDB ](http://cartodb.com )
2012-12-20 23:57:21 +08:00
[GIS Cloud ](http://www.giscloud.com/ )
...
2012-07-17 01:21:00 +08:00
2012-07-29 07:20:15 +08:00
< div id = "map" class = "map" style = "height: 300px" > < / div >
2012-07-17 01:21:00 +08:00
2013-01-15 23:01:36 +08:00
In this basic example, we create a map with < abbr title = "Here we use OpenStreetMap tiles, but Leaflet doesn't force you to — use whatever works for you, it's open source!" > tiles of our choice< / abbr > , add a marker and bind a popup with some text to it:
2012-07-17 01:21:00 +08:00
2013-01-15 23:01:36 +08:00
// create a map in the "map" div, set the view to a given place and zoom
var map = L.map('map').setView([51.505, -0.09], 13);
2012-07-17 01:21:00 +08:00
2013-01-15 23:01:36 +08:00
// add an OpenStreetMap tile layer
L.tileLayer('http://{s}.tile.osm.org/{z}/{x}/{y}.png', {
attribution: '© < a href = "http://osm.org/copyright" > OpenStreetMap< / a > contributors'
}).addTo(map);
2012-07-17 01:21:00 +08:00
2013-01-15 23:01:36 +08:00
// add a marker in the given location, attach some popup content to it and open the popup
L.marker([51.5, -0.09]).addTo(map)
.bindPopup('A pretty CSS3 popup. < br > Easily customizable.')
.openPopup();
2012-07-17 01:21:00 +08:00
2012-07-18 21:41:48 +08:00
Learn more with the [quick start guide ](examples/quick-start.html ), check out [other tutorials ](examples.html ), or head straight to the [API documentation ](reference.html ).
2012-07-17 01:21:00 +08:00
2012-10-31 22:59:52 +08:00
## Getting Involved
2012-07-17 01:21:00 +08:00
2012-12-20 23:57:21 +08:00
Third-party patches are absolutely essential on our quest to create the best mapping library that will ever exist.
However, they're not the only way to get involved with the development of Leaflet.
You can help the project tremendously by discovering and [reporting bugs][], [improving documentation][],
helping others on the [Leaflet forum ](https://groups.google.com/forum/#!forum/leaflet-js )
2013-01-11 19:48:54 +08:00
and [GitHub issues ](https://github.com/Leaflet/Leaflet/issues ),
2012-12-20 23:57:21 +08:00
showing your support for your favorite feature suggestions on [Leaflet UserVoice page ](http://leaflet.uservoice.com ),
tweeting to [@LeafletJS ](http://twitter.com/LeafletJS )
and spreading the word about Leaflet among your colleagues and friends.
2012-07-17 01:21:00 +08:00
2012-10-31 22:59:52 +08:00
Check out the [contribution guide][contribute] for more information on getting involved with Leaflet development.
2012-07-17 01:21:00 +08:00
[Vladimir Agafonkin]: http://agafonkin.com/en
[CloudMade]: http://cloudmade.com
2013-01-11 19:48:54 +08:00
[contributors]: https://github.com/Leaflet/Leaflet/graphs/contributors
2012-07-17 01:21:00 +08:00
[features]: features.html
2012-10-31 22:23:26 +08:00
[plugins]: plugins.html
2012-12-20 23:57:21 +08:00
[well-documented API]: reference.html "Leaflet API reference"
2013-01-11 19:48:54 +08:00
[source code]: https://github.com/Leaflet/Leaflet "Leaflet GitHub repository"
[hosted on GitHub]: http://github.com/Leaflet/Leaflet
[contribute]: https://github.com/Leaflet/Leaflet/blob/master/CONTRIBUTING.md "A guide to contributing to Leaflet"
[reporting bugs]: https://github.com/Leaflet/Leaflet/blob/master/CONTRIBUTING.md#reporting-bugs
[improving documentation]: https://github.com/Leaflet/Leaflet/blob/master/CONTRIBUTING.md#improving-documentation
2012-07-17 01:21:00 +08:00
[@mourner]: http://github.com/mourner
2013-01-11 19:48:54 +08:00
[GitHub issues page]: http://github.com/Leaflet/Leaflet/issues
2012-07-17 01:21:00 +08:00
[Leaflet UserVoice page]: http://leaflet.uservoice.com
[@LeafletJS]: http://twitter.com/LeafletJS
[Leaflet mailing list]: https://groups.google.com/group/leaflet-js
< script >
2013-01-15 23:01:36 +08:00
var osmUrl = 'http://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png',
osmAttrib = '© < a href = "http://openstreetmap.org/copyright" > OpenStreetMap< / a > contributors',
osm = L.tileLayer(osmUrl, {maxZoom: 18, attribution: osmAttrib});
2012-07-17 01:21:00 +08:00
2013-01-15 23:01:36 +08:00
var map = L.map('map').setView([51.505, -0.159], 15).addLayer(osm);
2012-07-17 01:21:00 +08:00
2013-01-15 23:01:36 +08:00
L.marker([51.504, -0.159])
.addTo(map)
.bindPopup('A pretty CSS3 popup.< br / > Easily customizable.')
.openPopup();
2012-07-18 21:41:48 +08:00
< / script >