IMPORTANT This repository is work in progress. I am building the next major release of Annotorious. If you are looking for the most recent official release, visit the main project homepage. Documentation in this Readme is only for the upcoming alpha release and will not work with Annotorious 2.7.x!
Add image annotation functionality to any web page with a few lines of JavaScript.
npm install --save @annotorious/annotorious
Create an annotator instance on an existing Image element.
import { createImageAnnotator } from '@annotorious/annotorious';
// Import essential CSS styles
import '@annotorious/annotorious/annotorious.css';
// Image element ID or DOM element
const anno = createImageAnnotator('sample-image');
// Load annotations in W3C Web Annotation format
anno.loadAnnotations('./annotations.w3c.json');
// Attach listeners to handle annotation events
anno.on('createAnnotation', function(annotation) {
console.log('created', annotation);
});
<html>
<head>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@annotorious/annotorious@latest/dist/annotorious.css">
<script src="https://cdn.jsdelivr.net/npm/@annotorious/annotorious@latest/dist/annotorious.js"></script>
</head>
<body>
<img id="my-image" src="my-image.jpg" />
<script>
window.onload = function() {
var anno = Annotorious.createImageAnnotator('my-image');
}
</script>
</body>
</html>
Annotorious provides seamless integration with the OpenSeadragon viewer for zoomable images and IIIF.
npm install @annotorious/openseadragon
Set up your OpenSeadragon viewer first, and then create an annotator instance for the viewer. Note that Annotorious requires OpenSeadragon 3 or higher.
import { createOSDAnnotator } from '@annotorious/openseadragon';
// Import essential CSS styles
import '@annotorious/annotorious/annotorious-openseadragon.css';
window.onload = function() {
var viewer = OpenSeadragon({
id: 'openseadragon',
tileSources: {
type: 'image',
url: '/my-image.jpg'
}
});
var anno = createOSDAnnotator(viewer);
anno.loadAnnotations('./annotations.w3c.json');
anno.on('createAnnotation', function(annotation) {
console.log('created', annotation);
});
}
<html>
<head>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@annotorious/openseadragon@latest/dist/annotorious-openseadragon.css">
<script src="https://cdn.jsdelivr.net/npm/@annotorious/openseadragon@latest/dist/annotorious-openseadragon.js"></script>
</head>
<body>
<div id="openseadragon"></div>
<script>
window.onload = function() {
var viewer = OpenSeadragon({
id: 'openseadragon',
tileSources: {
type: 'image',
url: '/my-image.jpg'
}
});
var anno = AnnotoriousOSD.createOSDAnnotator(viewer);
}
</script>
</body>
</html>
Annotorious provides React bindings for both the standard and the OpenSeadragon module.
npm install @annotorious/react
The <Annotorious>
component provides a root context for all Annotorious utility hooks.
Use <ImageAnnotator>
or <OpenSeadragonAnnotator>
to attach annotation layers on images
or OpenSeadragon.
import { Annotorious, ImageAnnotator } from '@annotorious/react';
import '@annotorious/react/annotorious-react.css';
export function AnnotatableImage() {
return (
<Annotorious>
<ImageAnnotator>
<img src="my-image.jpg" alt="Example" />
</ImageAnnotator>
</Annotorious>
)
}