Powerful SVG-Editor for your browser
JavaScript HTML CSS Other
Clone or download
Permalink
Failed to load latest commit information.
build/tools (INCOMPLETE: ES6 Module conversion and linting) May 22, 2018
chrome-app (INCOMPLETE: ES6 Module conversion and linting) May 22, 2018
clipart Reidentify all elements imported into the drawing. Add tests for it. Feb 22, 2010
demos - Demos: Add svgcanvas demo (Neil Fraser) May 28, 2018
dist - Fix (npm): Update `load-stylesheets` to avoid recursion upon CSS lo… Jul 19, 2018
docs - Security fix: 'extPath', 'imgPath', 'extIconsPath', 'canvgPath', 'l… Jul 9, 2018
editor - Fix (Embedded editor): Workaround Chrome blocking issue Jul 19, 2018
examples - Linting (ESLint): Use two spaces for indent May 18, 2018
firefox-extension (INCOMPLETE: ES6 Module conversion and linting) May 22, 2018
opera-widget (INCOMPLETE: ES6 Module conversion and linting) May 22, 2018
screencasts - Breaking change: Extension now formatted as export (and `this` is s… Jun 11, 2018
test - Security fix: 'extPath', 'imgPath', 'extIconsPath', 'canvgPath', 'l… Jul 9, 2018
.babelrc - Breaking change: Rename config file to `svgedit-config-iife.js` (or… May 25, 2018
.eslintignore - Security fix: 'extPath', 'imgPath', 'extIconsPath', 'canvgPath', 'l… Jul 9, 2018
.eslintrc - Breaking change: Rename config file to `svgedit-config-iife.js` (or… May 25, 2018
.gitignore - Security fix: 'extPath', 'imgPath', 'extIconsPath', 'canvgPath', 'l… Jul 9, 2018
.npmignore - npmignore: Allow `docs` May 26, 2018
.remarkrc - Linting (HTML): Use double-quotes for attributes, remove redundant … May 13, 2018
AUTHORS - Linting (HTML): Use double-quotes for attributes, remove redundant … May 13, 2018
CHANGES.md - Enhancement: Link to rawgit/raw.githack for live master demos (fixes Jul 19, 2018
LICENSE-MIT.txt - Linting (HTML): Use double-quotes for attributes, remove redundant … May 13, 2018
Makefile - Security fix: 'extPath', 'imgPath', 'extIconsPath', 'canvgPath', 'l… Jul 9, 2018
README.md - Docs (README): Minor clarification Jul 19, 2018
build-html.js - Breaking change: Extension now formatted as export (and `this` is s… Jun 11, 2018
composer.json - Linting (HTML): Use double-quotes for attributes, remove redundant … May 13, 2018
grep-jsdoc.js - Security fix: 'extPath', 'imgPath', 'extIconsPath', 'canvgPath', 'l… Jul 9, 2018
package-lock.json - Fix (npm): Update `load-stylesheets` to avoid recursion upon CSS lo… Jul 19, 2018
package.json - npm: Add script for testing embedded API Jul 19, 2018
rollup-config.config.js - Breaking change: Extension now formatted as export (and `this` is s… Jun 11, 2018
rollup.config.js - Security fix: 'extPath', 'imgPath', 'extIconsPath', 'canvgPath', 'l… Jul 9, 2018
svgedit-config-es.js - Security fix: 'extPath', 'imgPath', 'extIconsPath', 'canvgPath', 'l… Jul 9, 2018
svgedit-config-iife.js - Fix (npm): Update `load-stylesheets` to avoid recursion upon CSS lo… Jul 19, 2018

README.md

alt text SVG-edit

SVG-edit is a fast, web-based, JavaScript-driven SVG drawing editor that works in any modern browser.

Demo

Try SVG-edit here

(Also available as a download in releases).

You may also try the latest pre-release (or its ES6-Module version, assuming a modern browser).

And for testing the latest version in master, you may try https://rawgit.com/SVG-Edit/svgedit/master/editor/svg-editor.html or https://raw.githack.com/SVG-Edit/svgedit/master/editor/svg-editor.html.

Installation

Quick install

  1. Clone or copy the repository contents (at least the editor directory).
  2. If you need programmatic customization, see its section below.
  3. 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.

  1. Create your npm package: npm init (complete the fields).
  2. Install SVG-edit into your package: npm i svgedit.
  3. Look within node_modules/svgedit/, e.g., node_modules/svgedit/editor/svg-editor.html for the files your package needs and use accordingly.
  4. npm publish

Programmatic customization

  1. 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.
  2. 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.
  3. Modify or utilize any options. See docs/tutorials/ConfigOptions.md ([ConfigOptions]{@tutorial ConfigOptions}).

ES6 Modules file

  1. 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).
  2. 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.
  3. JavaScript:
  4. Run npm install within the node_modules/svgedit directory to install the build tools for SVG-edit.
  5. Run npm run build-config within the node_modules/svgedit directory.
  6. 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.
  7. HTML:
  8. 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-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