planit v1.0.2
Planit.js
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.
Documentation
The basics are documented here, but you can find API documentation and some examples at planit.seancdavis.me.
Installation
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>Downloads
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.
Usage
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.
Questions, Bugs & Ideas
Please log all communication as an issue in this repo's issue tracker
Contributing
To get set up locally, you'll need npm and
gulp installed.
$ git clone https://github.com/seancdavis/planit.git
$ cd planit
$ npm install
$ gulpgulp 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