Skip to content

Commit

Permalink
Updated Readme
Browse files Browse the repository at this point in the history
  • Loading branch information
hiasinho committed Sep 10, 2014
1 parent abc2fb1 commit 754beb9
Showing 1 changed file with 87 additions and 0 deletions.
87 changes: 87 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,3 +2,90 @@ Leaflet.vector-markers
======================

Vector SVG markers for Leaflet, with an option for Font Awesome/Twitter Bootstrap icons.

Thanks to https://github.com/lvoogdt for https://github.com/lvoogdt/Leaflet.awesome-markers.

Version 0.0.1 of Leaflet.vector-markers is tested with:
- Bootstrap 3
- Font Awesome 4.2
- Leaflet 0.7.3

## Example

Please have a look at the examples or check out this example: http://codepen.io/anon/pen/Jdayb.

### Twitter Bootstrap/Font-Awesome icons
This plugin depends on either Bootstrap or Font-Awesome for the rendering of the icons. See these urls for more information:

For Font-Awesome
- http://fortawesome.github.com/Font-Awesome/
- http://fortawesome.github.com/Font-Awesome/#integration

For Twitter bootstrap:
- http://getbootstrap.com

## Using the plugin
- 1) First, follow the steps for including Font-Awesome or Twitter bootstrap into your application.

For Font-Awesome, steps are located here:

http://fortawesome.github.io/Font-Awesome/get-started/

For Twitter bootstrap, steps are here:

http://getbootstrap.com/getting-started/


- 2) Next, copy the dist/images directory, vector-markers.css, and vector-markers.js to your project and include them:
````xml
<link rel="stylesheet" href="css/Leaflet.vector-markers.css">
````
````xml
<script src="js/leaflet.vector-markers.js"></script>
````

- 3) Now use the plugin to create a marker like this:
````js
// Creates a red marker with the coffee icon
var redMarker = L.VectorMarkers.icon({
icon: 'coffee',
markerColor: 'red'
});

L.marker([48.15491,11.54183], {icon: redMarker}).addTo(map);
````

### Properties

| Property | Description | Default Value | Possible values |
| --------------- | ---------------------- | ------------- | ---------------------------------------------------- |
| icon | Name of the icon | 'home' | See glyphicons or font-awesome |
| prefix | Select de icon library | 'fa' | 'fa' for font-awesome or 'glyphicon' for bootstrap 3 |
| markerColor | Color of the marker | 'blue' | Any HEX color you can find |
| iconColor | Color of the icon | 'white' | 'white', 'black' or css code (hex, rgba etc) |
| spin | Make the icon spin | false | true or false. Font-awesome required |
| extraClasses | Additional classes in the created <i> tag | '' | 'fa-rotate90 myclass' eller other custom configuration |


### Supported icons
The 'icon' property supports these strings:
- 'home'
- 'glass'
- 'flag'
- 'star'
- 'bookmark'
- .... and many more, see: http://fortawesome.github.io/Font-Awesome/icons/
- Or: http://getbootstrap.com/components/#glyphicons

## Todo
- SVG shadows
- Adding more shapes
- Support for custom SVG

## License
- Leaflet.VectorMarkers and colored markers are licensed under the MIT License - http://opensource.org/licenses/mit-license.html.
- Font Awesome: http://fortawesome.github.io/Font-Awesome/license/
- Twitter Bootstrap: http://getbootstrap.com/

## Contact
- Website: http://www.hiasinho.com

0 comments on commit 754beb9

Please sign in to comment.