Leaflet JS Rails¶ ↑

Overview¶ ↑

leaflet-js wraps the Leaflet Javascript library in an asset gem so it can easily be used with Rails. It also includes the Leaflet.Label and Leaflet.Draw plugins. For more information about the Leaflet library, please visit leafletjs.com.

Installation¶ ↑

In your Gemfile, add this line:

gem "leaflet-js"

Then, run bundle install. You’re done!

Usage¶ ↑

Leaflet provides javascript, css and image assets. The easiest way to use these assets in your project is to include leaflet-js.js and leaflet-js.css in your application.js and application.css files. You may also pick just the files you want to use in your project.

Javascripts¶ ↑

• leaflet-js.js <- Includes all the js files below

• leaflet.js

• leaflet.draw.js

• leaflet.label.js

Stylesheets¶ ↑

• leaflet-js.css <- Includes all the css files below

• leaflet.css

• leaflet.draw.css

• leaflet.draw.ie.css

• leaflet.label.css

Images¶ ↑

• layers.png

• layers-2x.png

• marker-icon.png

• marker-icon-2x.png

• market-shadow.png

• market-shadow-2x.png

• spritesheet.png

• spritesheet-2x.png

Note when using Rails in production, with asset digests on, the Leaflet.Draw marker tool will not display an icon. The issue is that images included in this gem will be have a digest added to their name. However, the leaflet javascript code will be looking for asset/images/marker-icon.png or assets/images/marker-icon-2x.png.

One solution is to copy the images to your public/images folder. Then you have to tell leaflet about the path by setting L.Icon.Default.imagePath to +‘/images’+.

Support¶ ↑

If you have any questions about leaflet, please refer them to the Leaflet maintainers at leafletjs.com. If you have any questions about how leaflet-js wraps leaflet, then please refer to github.com/cfis/leaflet-js.

License¶ ↑

See LICENSE for license information about leaflet-js. Please note that the Leaflet project has its own LICENSE file also.