taggd
v4.0.0
Published
A tool to show and add tags to images
Downloads
275
Maintainers
Readme
Taggd
Taggd is a tool that allows you to tag pictures with additional information.
Installation
- Download the latest release
- npm:
npm install taggd
- Bower:
bower install taggd
- cdnjs: https://cdnjs.com/libraries/taggd
Usage
You need to include the stylesheet in the <head>
-tag, and the script in the <body>
-tag. Both files are in the dist
directory.
<link rel="stylesheet" href="/path/to/taggd/dist/taggd.css">
The stylesheet has no default theme, so they will be dull default buttons ready for you to style!
<script src="/path/to/taggd/dist/taggd.js"></script>
Finally, you can initialise taggd:
const image = document.getElementById('my-image');
const options = {};
const tags = [];
const taggd = new Taggd(image, options, tags);
The options
parameter is a list of options. The tags
parameter is a list of Tags. These are the buttons and popup that will render over your image. You can generate these using the Taggd tags generator.
Note on import strategy
If you’re importing Taggd via the ES2015 syntax with a bundler that respects the module
field in package.json
, Taggd
and Tag
are exported separately:
import { Taggd, Tag } from 'taggd';
new Taggd(image, options, [
new Tag(...),
]);
If you include the UMD bundle, Tag
is part of the Taggd
class:
new Taggd(image, options, [
new Taggd.Tag(...),
]);
The former allows ES2015+ environments to use imports as intended. The latter prevents having to expose multiple classes.
If you have better ideas to have best of both worlds, please create an issue.
Documentation
For more information, check out the documentation.
License
The code is released under the MIT license.