A jQuery Image Annotation plugin that can create Flickr-like comments on images embedded in web pages.
This plugin works with jQuery ~1.8.1.
Extract this zip file into a directory on your web server and navigate to demo-static.html
or view a live preview.
To use the plugin you first need to reference the jQuery and jQuery UI libraries in your page. Add
the jquery.annotate.js
and annotation.css
files to enable the plugin.
<style type="text/css" media="all">@import "css/annotation.css";</style>
<script type="text/javascript" src="dist/js/jquery.min.js"></script>
<script type="text/javascript" src="dist/js/jquery-ui.min.js"></script>
<script type="text/javascript" src="js/jquery.annotate.js"></script>
Once you've added in the necessary scripts, hook up an image on the page by using the following syntax:
<script language="javascript">
$(window).load(function() {
$("#toAnnotate").annotateImage({
editable: true,
useAjax: false,
notes: [ { "top": 286,
"left": 161,
"width": 52,
"height": 37,
"text": "Small people on the steps",
"id": "e69213d0-2eef-40fa-a04b-0ed998f9f1f5",
"editable": false },
{ "top": 134,
"left": 179,
"width": 68,
"height": 74,
"text": "National Gallery Dome",
"id": "e7f44ac5-bcf2-412d-b440-6dbb8b19ffbe",
"editable": true } ]
});
});
</script>
It is important to use the $(function() { ... });
function as this will fire once the page and
all it's images have loaded. Failing to do so will result in the plugin executing before the image
dimensions have been determined.
The HTML markup for the page looks like this:
<html>
<head>
<title>Demo Page</title>
</head>
<body>
<div>
<img id="toAnnotate" src="images/trafalgar-square-annotated.jpg" alt="Trafalgar Square" />
</div>
</body>
</html>
A copy of all this code is included in the release.
A minimized distribution of the plugin and required resources is available in dist/
.
To rebuild yourself do:
# Download jQuery dependencies
bower install
# Delete dist directory
grunt clean
# Build
grunt
dist/js/jquery.annotate.concat.min.js
includes all of the required javascript
minimized and concated into one file.
- Upgraded jQuery to version 1.7.1
-
Fixed a bug when creating a new annotation via AJAX.
-
The Id of the annotation is expected to be returned as a JSON object from the response of the save call, e.g.
{ "annotation_id": "000001" }
- Fixed jQuery UI 1.3.2 compatibility.
- Forked source for jQuery 1.2.x and 1.3.x
- Notes now fade in/out - be sure to add correct jQuery UI components.
- Tidied up CSS/positioning.
- Fixed bug when annotating an image with no previous annotations.
- Initial release
Based on the Drupal extension:
Image Annotations by Ronan Berder
hunvreus@gmail.com
http://drupal.org/project/image_annotate
http://drupal.org/user/49057
http://teddy.fr
FamFamFam Icons by:
Mark James
http://www.famfamfam.com/
Trafalgar Square image by:
Maurice
http://www.flickr.com/photos/mauricedb/2742966709/
Released under the GNU license.