Skip to content

Latest commit

 

History

History
149 lines (100 loc) · 7.18 KB

README.md

File metadata and controls

149 lines (100 loc) · 7.18 KB
Raw

Fabric.js is a framework that makes it easy to work with HTML5 canvas element. It is an interactive object model on top of canvas element. It is also an SVG-to-canvas parser.

Using Fabric.js, you can create and populate objects on canvas; objects like simple geometrical shapes — rectangles, circles, ellipses, polygons, or more complex shapes consisting of hundreds or thousands of simple paths. You can then scale, move, and rotate these objects with the mouse; modify their properties — color, transparency, z-index, etc. You can also manipulate these objects altogether — grouping them with a simple mouse selection.

Contributions are very much welcome!

Goals

  • Unit tested (1200+ tests at the moment)
  • Modular (~20 small "classes")
  • Cross-browser
  • Fast
  • Encapsulated in one object
  • No browser sniffing for critical functionality
  • Runs under ES5 strict mode
  • Runs on a server under Node.js

Supported browsers

  • Firefox 2+
  • Safari 3+
  • Opera 9.64+
  • Chrome (all versions should work)
  • IE9+

With help of Explorer Canvas

  • IE8 (incomplete — about 17 failing tests at the moment)
  • IE7,6 (incomplete - about 27 failing tests at the moment)

You can run automated unit tests right in the browser.

History

Fabric.js started as a foundation for design editor on printio.ru — interactive online store with ability to create your own designs. The idea was to create Javascript-based editor, which would make it easy to manipulate vector shapes and images on T-Shirts. Since performance was one of the most critical requirements, we chose canvas over SVG. While SVG is excellent with static shapes, it's not as performant as canvas when it comes to dynamic manipulation of objects (movement, scaling, rotation, etc.). Fabric.js was heavily inspired by Ernest Delgado's canvas experiment. In fact, code from Ernest's experiment was the foundation of an entire framework. Later, Fabric.js grew into a collection of distinct object types and got an SVG-to-canvas parser.

Building

  1. Install Node.js

  2. Build distribution file [~76K minified, ~22K gzipped]

     $ node build.js

    • Or build a custom distribution file, by passing (comma separated) module names to be included.

        $ node build.js modules=text,serialization,parser
  // or
  $ node build.js modules=text
  // or
  $ node build.js modules=parser,text
  // etc.

      By default (when none of the modules are specified) only basic functionality is included. See the list of modules below for more information on each one of them. Note that default distribution has support for static canvases only.

      To get minimal distribution with interactivity, make sure to include corresponding module:

        $ node build.js modules=interaction

    • You can also include all modules like so:

        $ node build.js modules=ALL

  3. Create a minified distribution file

     # Using YUICompressor (default option)
 $ node build.js modules=... minifier=yui
 
 # or Google Closure Compiler
 $ node build.js modules=... minifier=closure

  4. Optionally, you can build documentation

     $ node build_docs.js

Demos

Documentation

Documentation is always available at http://kangax.github.com/fabric.js/docs/. You can also build it locally, following step 4 from the "Building" section of this README.

Also see presentation from BK.js and presentation from Falsy Values for an overview of fabric.js, how it works, and its features.

Optional modules

These are the optional modules that could be specified for inclusion, when building custom version of fabric:

  • text — Adds support for fabric.Text
  • serialization — Adds support for loadFromJSON, loadFromDatalessJSON, and clone methods on fabric.Canvas
  • interaction — Adds support for interactive features of fabric — selecting/transforming objects/groups via mouse/touch devices.
  • parser — Adds support for fabric.parseSVGDocument, fabric.loadSVGFromURL, and fabric.loadSVGFromString
  • image_filters — Adds support for image filters, such as grayscale of white removal.
  • node — Adds support for running fabric under node.js, with help of jsdom and node-canvas libraries.

Examples of use

Adding red rectangle to canvas

<canvas id="canvas" width="300" height="300"></canvas>
...
var canvas = new fabric.Canvas('canvas');

var rect = new fabric.Rect({
  top: 100,
  left: 100,
  width: 60,
  height: 70,
  fill: 'red'
});

canvas.add(rect);

Staying in touch

Follow @fabric.js or @kangax on twitter. Questions, suggestions — fabric.js on Google Groups.

Credits

MIT License

Copyright (c) 2008-2012 Printio (Juriy Zaytsev, Maxim Chernyak)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.