SVG-edit
SVG-edit is a fast, web-based, JavaScript-driven SVG drawing editor that
works in any modern browser.
Demo
See the latest release
(or its ES6-Module version, which requires a modern browser).
You may also try it at https://unpkg.com/svgedit/editor/svg-editor.html (which
redirects to a versioned URL).
You may also obtain URLs for specific releases.
For testing the latest version in master
, you may use
https://raw.githack.com/SVG-Edit/svgedit/master/editor/svg-editor.html.
Installation
Quick install
- Clone or copy the repository contents (at least the
editor
directory). - If you need programmatic customization, see its section below.
- Otherwise, just add an iframe to your site, adding any extensions or
configuration (see
docs/tutorials/ConfigOptions.md
([ConfigOptions]{@tutorial ConfigOptions})) within the URL:
<iframe src="svgedit/editor/svg-editor.html?extensions=" width="100%" height="100%"></iframe>
Integrating SVG-edit into your own npm package
These steps are only needed if you wish to set up your own npm package
incorporating SVGEdit.
- Create your npm package:
npm init
(complete the fields). - Install SVG-edit into your package:
npm i svgedit
. - Look within
node_modules/svgedit/
, e.g., node_modules/svgedit/editor/svg-editor.html
for the files your package needs and use accordingly. npm publish
Programmatic customization
- If you are not concerned about supporting ES6 Modules (see the
"ES6 Modules file" section), you can add your config directly to
svgedit-config-iife.js
within the SVG-Edit project root. - Note: Do not remove the
import svgEditor...
code which is responsible for
importing the SVG edit code. Versions prior to 3.0 did not require this,
but the advantage is that your HTML does not need to be polluted with
extra script references. - Modify or utilize any options. See
docs/tutorials/ConfigOptions.md
([ConfigOptions]{@tutorial ConfigOptions}).
ES6 Modules file
svg-editor-es.html
is an HTML file directly using ES6 modules.
It is only supported in the latest browsers. It is probably mostly
useful for debugging, as it requires more network requests.
If you would like to work with this file, you should make configuration
changes in svgedit-config-es.js
(in the SVG-Edit project root).- If you are working with the ES6 Modules config but also wish to work with
the normal
svg-editor.html
version (so your code can work in older
browsers or get the presumable performance benefits of this file which
references JavaScript rolled up into a single file), you can follow these
steps after any config changes you make, so that your changes can also be
automatically made available to both versions. - JavaScript:
1. Run
npm install
within the node_modules/svgedit
directory to
install the build tools for SVG-edit.
1. Run npm run build-config
within the node_modules/svgedit
directory.
- This will rebuild
svgedit-config-iife.js
(applying Babel to allow
it to work on older browsers and applying Rollup to build all
JavaScript into one file). The file will then contain non-ES6 module
JavaScript that can work in older browsers. Note that it bundles all
of SVGEdit, so it is to be expected that this file will be much larger
in size than the original ES6 config file.
- HTML:
1. If you wish to make changes to both HTML files, it is recommended that you
work and test on
svg-editor-es.html
and then run npm run build-html
to have the changes properly copied to svg-editor.html
.
Recent news
- 2018-10-24 Published 3.1.0 (Redirect on modular page for non-module-support;
versions document (for migrating))
- 2018-10-22 Published 3.0.1 (Revert fix affecting polygon selection)
- 2018-10-21 Published 3.0.0 (misc. improvements including centering canvas and
key locale fixes since last RC)
- 2018-09-30 Published 3.0.0-rc.3 with security and other fixes
- 2018-07-31 Published 3.0.0-rc.2 with misc. fixes
- 2018-07-19 Published 3.0.0-rc.1 allowing for extensions and locales to be
expressed as modules
- 2018-05-26 Published 3.0.0-alpha.2 with ES6 Modules support
- 2017-07 Added to Packagist: https://packagist.org/packages/svg-edit/svgedit
- 2015-12-02 SVG-edit 2.8.1 was released.
- 2015-11-24 SVG-edit 2.8 was released.
- 2015-11-24 Code, issue tracking, and docs are being moved to github (previously code.google.com).
- 2014-04-17 2.7 and stable branches updated to reflect 2.7.1 important bug fixes for the embedded editor.
- 2014-04-07 SVG-edit 2.7 was released.
- 2013-01-15 SVG-edit 2.6 was released.
Videos
Supported browsers
The following browsers had been tested for 2.6 or earlier and will probably continue to work with 3.0.
- Firefox 1.5+
- Opera 9.50+
- Safari 4+
- Chrome 1+
- IE 9+ and Edge
Further reading and more information