Planit is a javascript library, built on top of jQuery, that makes it nice and simple add interactive hotspots (markers) to a blank container or an image.
The basics are documented here, but you can find API documentation and some examples at planit.seancdavis.me.
Make sure you load jQuery, then you're ready to add Planit.js. Best practice is
to add your scripts to the bottom of your <body>
. And don't forget the
styles.
If you take this approach you'll need to ensure the script for your page is loaded after the Planit library is loaded. It's not a bad idea to take advantage of a JavaScript module loader to ensure they are loaded in the correct order. Checkout RequireJS for more information.
<link rel="stylesheet" href="//cdn.jsdelivr.net/jquery.planit/1.0.1/planit.min.css">
<script src="//cdn.jsdelivr.net/jquery/1.11.2/jquery.min.js"></script>
<script src="//cdn.jsdelivr.net/jquery.planit/1.0.1/planit.min.js"></script>
You can download both of these items using the links below. v1.0 will come with hosted releases of the distribution.
There's also a zip of the two files together.
The Planit
class is loaded into a global planit
variable. Without options,
this is simply:
planit.new()
When you have no options, Planit looks for a container with an id of planit
.
<div id="planit"></div>
See the doc site for options and examples.
Please log all communication as an issue in this repo's issue tracker
To get set up locally, you'll need npm
and
gulp
installed.
$ git clone https://github.com/seancdavis/planit.git
$ cd planit
$ npm install
$ gulp
gulp
will watch for changes, but will stop compiling CoffeeScript files after
finding an error. Keep that log accessible or you may get tripped up.
Then, follow the typical GitHub workflow:
- Fork it ( https://github.com/[my-github-username]/githole/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request