版本更新记录 v1
Fabric.js release highlights (v1)
Version 1.7.22 & 1.7.23
Fabric 1.x is in manteinence mode. Just bugfixes backported from ongoing 2.x
- BACKPORT gradient parsing float
- REVERT this.ctx fix from textbox
- BACKPORT Fix for typeError on removing textbox from mousedown
Version 1.7.21
Fabric 1.x is in manteinence mode. Just bugfixes backported from ongoing 2.x
- BACKPORT cache fuzzyness fix part 2
- BACKPORT freedrawing fix part 2
- BACKPORT toDataURL backstoreOnly resize
- BACKPORT Removal of unnecessary context creation on text init
Version 1.7.20
Fabric 1.x is in manteinence mode. Just bugfixes backported from ongoing 2.x
Group from object and subTargetCheckcache canvas deletioncache fuzzynessfree drawing and direction of start/end pointsnoScaleCache from stop refreshing cache of not transforming objectsVersion 1.7.19
Fabric 1.x is in manteinence mode. Just bugfixes no features or improvements.
Fixed drawing path displacement #4318Fixed the flip of images with scale equally #4313Fixed touch touch detection #4302Version 1.7.18
Fixed doubling of subtargets for preserveObjectStacking = true #4297Added a dirty set to objects in group destroy.Version 1.7.17
Small bugix release, mostly selection and text bugfixes reported by users
Change: swapped style white-space:nowrap with attribute wrap="off" since the style rule was creating problems in browsers like ie11 and safari. #4119Fix: Remove an object from activeGroup if removed from canvas #4120Fix: avoid bringFroward, sendBackwards to swap objects in active selections #4119Fix: avoid disposing canvas on mouse event to throw error #4119Fix: make svg respect white spaces #4119Fix: avoid exporting bgImage and overlayImage if excludeFromExport = true #4119Fix: Avoid group fromObject mutating original data #4111Version 1.7.16
Small bugix release.
Improvement: Add information to onChange and onComplete animation function #4068Improvement: avoid multiplying identity matrices in calcTransformMatrix functionFix: ativeGroup did not destroy correctly if a toObject was happeningImprovement: Pass the event to object:modified when available. #4061Version 1.7.15
Quick bug fix release and and 2 improvements. Shadow with no offset can be cached, and this is a speed boost if you are using shadow to do halos.
Added a note in text docs that allow devs to ovveride some custom key behaviour
Improvement: Made iText keymap public. #4053Improvement: Fix a bug in updateCacheCanvas that was returning always true #4051Version 1.7.14
Cache improvement release! Two new features are now in the cache system. The cache will not grow over certain sizes when scaling objects, and also the _cacheCanvas will be resized in advance by a 10% margin so that we do not have to resize each mousemove event.
Check here for more details
The staefull check has been speed up a bit taking inspiration from fast-deep-equal package on npm.
Some bug relative to deep state check and group that where invalidating the cache for weird reason have been hopefully solved.
Improvement: Avoid cache canvas to resize each mouse move step. #4037 Improvement: Make cache canvas limited in size. #4035 Fix: Make groups and statefull cache work. #4032 Add: Marked the hiddentextarea from itext so that custom projects can recognize it. #4022
Version 1.7.13
Small bugfix release
Fix: Try to minimize delay in loadFroJson #4007 Fix: allow fabric.Color to parse rgba(x,y,z,.a) without leading 0 #4006 Allow path to execute Object.initialize, make extensions easier #4005 Fix: properly set options from path fromDatalessObjects #3995 Check for slice before action.slice. Avoid conflicts with heavy customized code. #3992
Version 1.7.12
Bug fixes and some new properties added to mouse events.
Fix: removed possible memleaks from window resize event. #3984Fix: restored default cursor to noTarget only. unselectable objects get the standard hovercursor. #3953Cache fixes: fix uncached pathGroup, removed cache creation at initialize time #3982Improvement: nextTarget to mouseOut and prevTarget to mouseOver #3900Improvement: add isClick boolean to left mouse up #3898Fix: can start selection on top of non selectable object #3892Improvement: better management of right/middle click #3888Fix: subTargetCheck on activeObject/activeGroup was firing too many events #3909Fix: After addWithUpdate or removeWithUpdate object coords must be updated. #3911Version 1.7.11
Hotifx for broken PathGroups (SVGs)Version 1.7.10
Many fixes to be a minor release:
Fixes to SVG export for polygons and for radial gradients in general. Introducing a caching logic for groups that allow to smart cache what has not shadow as children object. This should reduce caching visual errors by much and still allowing for cache optimization.
Introduced some manual checks on the value of Math.cos so that we can output a correct angle of 90 or 270 degrees for objects.
Fix: correct svg export for radial gradients #3807Fix: Update fireout events to export the event object #3853Fix: Improve callSuper to avoid infinite loops (not all of them) #3844Fix: avoid selectionBackgroundColor leak on toDataUrl #3862Fix: toDatelessObject for Group #3863Improvement: better caching logic for groups #3864Fix: correct svg gradient export for radial in polygons #3866Fix: First draw could be empty for some objects #3870Fix: Always send event data to object:selected #3871Improvement: reduce angle calculation error #3872Version 1.7.9
Small fixes for text related problems. If you are using text in your application, you should update.
Fix: Avoid textarea wrapping from chome v57+ #3804Fix: double click needed to move cursor when enterEditing is called programatically #3804Fix: Style regression when inputing new style objects #3804Add: try to support crossOrigin for svg image tags #3804Version 1.7.8 and 1.7.7
This is maybe the last release of the 1.x branch. New important and api breaking work is in progress and will be labeled as fabric 2.x
The change i like most comes from a casual contributor, by12 and fixes path bounding box calculation. No more trimmed paths!
A change in translation on the cache canvas fixed blurriness introduced since 1.7.3, that is also worth an update.
For iText, Textbox typers, the style object does not get polluted with useless empty objects now.
And last but not the least, we have a new flag called fabric.StaticCanvas.prototype.skipOffscreen default to false that will calculate with objects aCoords if the object is on the screen or outside the screen and will skip the rendering part completely. This is an optional feature but it turns out to be very usefull when you are dealing with large number of objects and you are using zoom or panning much.
While object.oCoords needs to be updated every zoom/pan, aCoords are static with object position and are still valid when we change the viewport. This allows us to detect if they are offscreen simply calculating the viewportCoords at the expense of 2 transformed points calculation. A demo page will follow soon.
Fix: Fix dirty flag propagation #3782Fix: Path parsing error in bounding boxes of curves #3774Add: Middle click mouse management on canvas #3764Add: Add parameter to detect and skip offscreen drawing #3758Fix: textarea loosing focus after a drag and exit from canvas #3759Fix for opacity parsing in svg with nested opacities #3747Fix text initialization and boundingrect #3745Fix line bounding box #3742Improvement: do not pollute style object while typing if not necessary #3743fix for broken prototype chain when restoring a dataless object on fill an stroke #3735fix for deselected event not fired on mouse actions #3716fix for blurriness introduced on 1.7.3 #3721Version 1.7.6 ( plus 1.7.5 and 1.7.4)
New functionalities about coordinates: Now setCoords updates both the corner coords for mouse interaction and a new set called aCoords that is a set of absolute coordinates that a dev can use for its own calculation on positions.
Introduced a set of coordinates on canvas that let you figure out where the current viewport start and finish. A new method for objects, called `isOnScreen` let;s you find out if at least a corner of an object is visible in the current viewport Fabric.Color class now can export colors in HEX + opacity format Notable fixes: We switched some touch event handling to accomodate latest chrome changes Removed gaps on continuos textbackgroundColor on Itext
Fix: make the cacheCanvas created on the fly if not availableImprovement: draw textbackgroundColor in one single pass when possibleImprovement: fire selection changed event just if text is editingImprovement: Add object property 'needsItsOwnCache'Improvement: Skip unnecessary transform if they can be detected with a single ifFix: Moved all the touch event to passive false so that they behave as before chrome changesFix: force top and left in the object representation of a path to avoid reparsing on restoreAdd: Enable deselected event for activeObject switch. Ensure deactivateAll call exitEditingFix: Perform subtargetCheck also if the group is an active object and on activeGroupFix: Made cursor operation more precise at high canvas zoom levelAdd: Made getBoundingRect available to return both absolute or standard bounding rectAdd: Introduced calcViewportBoundaries() function for fabric.StaticCanvasAdd: Introduced isOnScreen() function for fabric.ObjectSubclassed Polygon from polylineFix: Removed reference to hovered target when target gets removedFix: Removed hover cursor for non selectable objectsFix: Switch to passive event for touch moveFix: Restart rendering of cursor after entering some textAdd: fabric.Color support toHexa() method nowVersion 1.7.3
Mixed release, cleaning and important bugfixes.
Objects fromObject methods have been reworked to be able to wait for Patterns full loading process before actually creating the object, so that the first render has the pattern ready to show. That was a longstanding bug since 2013.
Reworked some of the canvas background and overlay code so that gradient and patterns works and are saved and reloaded correctly.
During loadFromJSON process, if an image errors out, the process cotinue smooth, the reviver function is invoked with a third argument error equal to true.
Usuals objectCaching improvements: dirty flag propagation from childObjects to parents, added a couple of pixels around the cache canvas to avoid aliasing, added bigger padding for text with custom fonts.
Improvement: mousewheel event has target in the arguments as all the other events. object now fires mousewheelImprovement: Pattern loads for canvas background and overlay, corrected svg pattern export.Fix: Wait for pattern loading before calling callback.Fix: add 2 extra pixels to cache canvases to avoid aliasing cut.Fix: Rerender when deselect an itext editing object.Fix: save new state of dimensionProperties at every cache clear.Improvement: Better error managment in loadFromJSON.Improvement: do not reload backgroundImage as an image if is different type.Improvement: if a children element is set dirty, set the parent dirty as well.Version 1.7.2
Again a maintenance release for iText custom fonts and cache and a workaround for macOS sierra problem with ‘object:modified’
Fix: Textbox do not use stylemap for line wrapping #3546Fix: Fix for firing object:modfied in macOS sierra #3539Fix: Itext with object caching was not refreshing selection correctly. #3538Fix: stateful now works again with activeGroup and dinamyc swap between stateful false/true. #3537Fix: includeDefaultValues was not applied to child objects of groups and path-groups. #3497Fix: Itext style is cloned on paste action now, allow copie of styles to be independent. #3502Fix: Add subclasses properties to cacheProperties. #3490Add: Shift and Alt key used for transformations are now dinamic. #3479Fix: fix to polygon and cache. Added cacheProperties for all classes #3490Version 1.7.1
Just small bugfixes and support for custom properties in gradient and pattern toObject method.
Add: Gradients/Patterns support customAttributes in toObject method #3477Fix: IText/Textbox not blurring keyboard on ios 10 #3476Fix: Shadow on freedrawing and zoomed canvas #3475Fix: Fix for group returning negative scales #3474Fix: hotfix for textbox #3441 #3473Version 1.7.0
Introducing object caching, please refer to the example page for more information caching
Add: Object Caching #3417Improvement: group internal objects have coords not affected by canvas zoom #3420Fix: itext cursor trails on initDimension #3436Fix: null check on .setActive #3435Fix: function error in clone deep. #3434Version 1.6.7
A bugfix release with a new function, snap to angle during rotation.
How to activate it? Populate `snapAngle` and `snapTreshold` in the object properties
Add: Snap rotation added to objects. two parameter introduced, snapAngle and snapTreshold. \[#3383\]Fix: Pass target to right click event. \[#3381\]Fix: Correct rendering of bg color for styled text and correct clearing of itext area. \[#3388\]Add: Fire mouse:over on the canvas when we enter the canvas from outside the element. \[#3389\]Fix: Fix calculation of words width with spaces and justify. \[#3408\]Fix: Do not export defaults properties for bg and overlay if requested. \[#3415\]Version 1.6.6
A bugfix release with 2 new image filters, contrast and saturation
Add: Contrast and Saturate filters #3341Fix: Correct registering and removal of events to handle iText objects.Fix: Corrected 2 regression of 1.6.5 (dataurl export and itext clicks)Fix: Corrected path boundaries calculation for Arcs ( a and A )Version 1.6.5
A bugfix release with some small news:
New feature backgroundColor is now supported from all classes.
Clone and fromObject methods are now equal for all classes. You can use the callback for any cloning.
Right click mouse:down support. disabled by default can be enabled using the fireRightClick property and the canvas element context menu can be disabled enabling stopContextMenu on the fabric canvas.
The font-family quoting from 1.6.4 has been reverted because it made no possible to use multiple font family names. So if you are using a font family that has a name with spaces and numbers you have to wrap in in quotes by yourself.
Fix: charspacing, do not get subzero with charwidth.Improvement: add callback support to all object cloning. #3212Improvement: add backgroundColor to all classe #3248Fix: add custom properties to backgroundImage and overlayImage #3250Fix: Object intersection is calculated on boundingBox and boundingRect, intersection is fired if objects are overlapping #3252Change: Restored previous selection behaviour, added key to selection active object under overlaid target #3254Improvement: hasStateChanged let you find state changes of complex properties. #3262Fix: IText/Textbox shift click selection backward. #3270Revert: font family quoting was a bad idea. node-canvas stills use it. #3276Fix: fire mouse:over event for activeObject and activeGroup when using findTarget shourtcuts #3285Fix: clear method clear all properties of canvas #3305Fix: text area position method takes in account canvas offset #3306Improvement: Added event on right click and possibility to hide the context menu with a flag 3308Fix: remove canvas reference from object when object gets removed from canvas #3307Improvement: use native stroke dash if available #3309Fix: Export correct src when exporting to svg #3310Fix: Stop text to go on zero dimensions #3312Fix: Error in dataURL with multiplier was outputting very big canvas with retina #3314Fix: Error in style map was not respecting style if textbox started with space #3315Version 1.6.4
In fabric 1.6.4 we added some new features and refinement to text objects:
New feature charspacing has been added, charspacing is expressed in thousands of em unit, meaning that with a value of 1000 and a fontsize of 40, you will have an additional space of 40px between chars.
Lineheight managment has been improved, now the lineheight does not have an extra padding below the line if there are no other lines of text.
Now that HiddenTextarea of iText object can follow the typing cursor better, it has been attached again to body of document and thanks to this IE browsers copy paste has been fixed.
selection:changed event firing has been reduced so that it fires just when necessary
Fonts with particular names, like ‘Slabo 27px’ or ‘Exo 2’ should be handled correctly now.
We have one new filter, a generic ColorMatrix filter from one of our contributors.
An old missing feature has been finally added, when restoring object from JSON, the apply filter function is executed before firing the callback, so that we can re render the canvas when everything is properly set up
Other small fixes to svg import and zoomed canvas. Finally shift click to select and unselect should work on every canvas zoom/pan.
New event: object:deselected is fired when an object loose its active state. Other than that, to the before:selection:cleared and selection:cleared the target is passed as an argument to the event fired.
This is the raw changelog:
Improvement: Ignore svg: namespace during svg import. #3081Improvement: Better fix for lineHeight of iText/Text #3094Improvement: Support for gradient with 'Infinity' coordinates #3082Improvement: Generally "improved" logic of targeting #3111Fix: Selection of active group with transparency and preserveObjectStacking true or false #3109Fix: pattern brush now create the same pattern seen while drawing #3112Fix: Allow css merge during svg import #3114Improvement: added numeric origins handling fomr 0 to 1. #3121Fix: Fix a defect with shadow of objects in a scaled group. #3134Improvement: Do not fire unecessary selection:changed events. #3119Fix: Attached hiddenTextarea to body fixes IE, thanks to @plainview. #3137Fix: Shift unselect activegroup on transformed canvas. #3144Added: ColorMatrix filter #3139Fix: Fix condition in wich restoring from Object could cause object overwriting #3146Change: cloneAsImage for Object and toDataUrl for object are not retina enabled by default. Added option to enable. #3147Improvement: Added textSpacing support for text/itext/textbox #3097Fix: Quote font family when setting the context fontstyle #3191Fix: use getSrc during image export, make subclassing easier, return eventually the .src property if nothing else is available #3189Fix: Inverted the meaning of border scale factor #3154Improvement: Added support for RGBA in HEX notation. #3202Improvement: Added object deselected event. #3195Fix: loadFromJson callback now gets fired after filter are applied #3210Version 1.6.3
Biggest new in 1.6.3 is support of sub-targets in group. Group has a new property subTargetCheck default to false that allows the findTarget functions to go deep in the group nested objects.
Events will fire for both the group and all the list of sub targets found in case of nested groups
Other changes inclued better handling of pan and zooming. Transparency checking is now aware of current viewportTransform and 3 new functions have been added to center objects in the current viewport instead of canvas: viewportCenterObject, viewportCenterObjectH, viewportCenterObjectV. Viewport fixes include cursor width in text editiong mode and the 1.6.2 newly itroduced selectionBackgroundColor
This is the raw changelog:
Improvement: Use reviver callback for background and overlay image when doing svg export. #2975Improvement: Added object property excludeFromExport to avoid exporting the object to JSON or to SVG. #2976Improvement: Correct the calculation of text boundingbox. Improves svg import #2992Added: Export id property to SVG #2993Improvement: Call the callback on loadSvgFromURL on failed xml load with null agument #2994Improvement: Clear only the Itext area on contextTop during cursor animation #2996Added: Char widths cache has been moved to fabric level and not iText level. Added fabric.util.clearFabricCharWidthsCache(fontName) #2995Fix: do not set background or overlay image if the url load fails. #3003Fix: iText mousemove event removal, clear the correct area for Itext, stopped redrawing selection if not necessary #3016Fix: background image and overlay image scale and move with canvas viewportTransform, parameter available #3019Added: support sub targeting in groups in events #2997Fix: Select transparent object on mouse up because of \_maybeGroupObject #2997Fix: Remove reference to lastRenderedObject on canvas.remove #3023Fix: Wait for all objects to be loaded before deleting the properties and setting options. #3029Fix: Object Padding is unaffected by object transform. #3057Fix: Restore lastRenderedObject usage. Introduced Canvas.lastRenderedKey to retrieve the lastRendered object from down the stack #3057Fix: \_calcTextareaPosition correctly calculate the position considering the viewportTransform. #3057Fix: Fixed selectionBacgroundColor with viewport transform. #3057Improvement: Correctly render the cursor with viewport scaling, improved the cursor centering. #3057Fix: Use canvas zoom and pan when using is target transparent. #2980Improvement: Added additional methods to center object on canvas. #3044Version 1.6.2
With 1.6.2 we introduce some new customization options for controls and user interaction. It is now possible to customize the keys used for control interaction.
Before those where the predefined keys:
Alt Key: Switching from normal transform to centered transform during scaling objects. Shift Key: on br,bl,tr,lt was switching from proportional to free resize, on mt, ml, mr, bw was switching between resize and skew.
As of 1.6.2 is possible to use those configuration option to define which keys are used:
* values: altKey, shiftKey, ctrlKey, fabric.Object.uniScaleKey: key used to switch between proportional and not proportional scaling fabric.Object.altActionKey: key used to switch between different action on same corner (skew/scale) fabric.Object.centeredKey: key used to switch on/off the centered transform
hoverCursor now appears also on non selectable objects but moveCursor does not appear if the object can’t be moved. In addition moveCursor is now customizable with the property moveCursor.
The biggest change is the possibility of customizing the look of controls. Both border and controls can be filled and stroked and can also have a dash-array instead of a continue line. Corners can be both square or round.
To control those feature you can use those new properties:
borderDashArray: Dash stroke of borders cornerDashArray: Dash stroke of corners cornerStrokeColor: If corners are filled, this property controls the color of the stroke cornerStyle: standrd ‘rect’ or ‘circle’ selectionBackgroundColor: add an opaque or transparent layer to the selected object.
Small bugfixes includes: Itext firing object:modified on text change, possibility to restore custom canvas properties other than objects during canvas loadFromJSON, some SVG color output fix and some dataURL improvements.
This is the raw changelog:
Fix: restore canvas properties on loadFromJSON with includeProperties. #2921Fix: Allow hoverCursor on non selectable objects, moveCursor does not appear if the object is not moveable. Added object.moveCursor to specify a cursor for moving per object. #2924Fix: Add missing stroke.live translation, allow gradientTransform for dashed line. #2926Improvement: Allow customization of keys that iteract with mouse action ( multiselect key, free tranform key, alternative action key, centered transform key ) #2925Added: Make iText fires object:modified on text change on exit editing #2927Added: \[control customization part 1\] cornerDashArray, borderDashArray. Now borderScaleFactor influences both border and controls, changed default corner size to 13 #2932Fix: createSVGFontFacesMarkup was failing to retrieve fonts in style #2935Fix: shadow not scaled with dataUrl to multiplier #2940Added: \[control customization part 2\] cornerStrokeColor. Now is possible to specify separate stroke and fill color for the controls #2933Fix: Itext width calculation with caching false was returning nan. #2943Added: \[control customization part 3\] Rounded corners. It is possible to specify cornerStyle for the object. 'rect' or 'circle' #2942Added: \[control customization part 4\] Selection background. It is possible to specify selectionBackgroundColor for the object. #2950Fix: Behaviour of image with filters with resize effects and Object to/from json #2954Fix: Svg export should not output color notation in rgba format #2955Fix: minScaleLimit rounding bug #2964Fix: Itext spacing in justify mode bug #2971Fix: Object.toDataUrl export when some window.devicepixelRatio is present (retina or browser zoom) #2972