- #1104 - Bugfix: correct sorting and stacking horizontal bars with categorical data
- #1088 - Bugfix: don’t ignore angle: 0 for text styles
- #1091 - Fix inconsistent defaultBrushArea behavior. Thanks @bees
- #1093 - Remove trailing whitespace and incorrect zeroes in transform strings
- #1094 - Support direction prop for VictoryLabel and Text primitive
- #1096 - Fix bug in horizontal zooming and panning
- #1101 - Fix arguments in
VictoryVoronoiContainer
label function. Thanks @evsheino
- #1072 Fixes a bug related to correctly stacking grouped components
- #1074 Fixes a bug that was causing time scale data to be ignored by
VictoryVoronoiContainer
when calculating voronoi layouts - #1076 Implements a whitelist based on
static role
when calculating data and domain from child components. - #1077 Prevents
VictoryZoonContainer
from downsampling stacked data - #1078 Adds
barWidth
andcandleWidth
props toVictoryBar
andVictoryCandlestick
. AddscandleRatio
prop toVictoryCandlestick
- #1079 Adds
onBrushCleared
callback prop forVictoryBrushContainer
- #1080 Changes how tooltips are deactivated so that multiple sources may reactivate tooltips (i.e. multiple triggers in
VictorySharedEvents
or direct triggers and voronoi triggers) #1081 Legends now render title and border when data is an empty array (previously nothing was rendered)
-1061 Fixes default bar width for chart with only one bar. Thanks @40x
-1062 Improvements for victory-native
stability
- Supports
clipPath
prop on all primitive components - generates keys based on
name
orid
prop. -1063 Makesprop-types
a real dependency
Victory is becoming a monorepo!
This will not be a breaking change for the majority of users, especially those importing all components from the main victory
npm package
Breaking Changes
- The
Axis
/Grid
primitive component has been renamedLineSegment
- Victory no longer supports git installs
victory-chart
andvictory-core
packages export different sets of packages than they used to. See the complete list below
New Package Organization
victory
exports everything exported from the packages belowvictory-axis@30.0.0
exportsVictoryAxis
victory-area@30.0.0
exportsVictoryArea
andArea
victory-bar@30.0.0
exportsVictoryBar
andBar
victory-box-plot@30.0.0
exportsVictoryBoxPlot
victory-brush-container@30.0.0
exportsVictoryBrushContainer
,BrushHelpers
andbrushContainerMixin
victory-brush-line@30.0.0
exportsVictoryBrushLine
victory-candlestick@30.0.0
exportsVictoryCandlestick
andCandle
victory-chart@30.0.0
exportsVictoryChart
victory-core@30.0.0
still exports several packages that are used by several Victory components:VictoryAnimation
VictoryClipContainer
VictoryContainer
VictoryLabel
VictoryPortal
andPortal
VictoryTheme
VictoryTransition
- Several primitive components:
Arc
,Border
/Box
,Circle
,ClipPath
,LineSegment
(formerlyAxis
/Grid
),Line
,Path
,Point
,Rect
,Text
,TSpan
,Whisker
- Several utilities:
addEvents
,Axis
,Collection
,CommonProps
,Data
,DefaultTransitions
,Domain
,Events
,Helpers
,Immutable
,LabelHelpers
,Log
,PropTypes
,Scale
,Selection
,Style
,TextSize
,Timer
,Transitions
,Wrapper
victory-create-container@30.0.0
exportscreateContainer
,combineContainerMixins
andmakeCreateContainerFunction
victory-cursor-container@30.0.0
exportsVictoryCursorContainer
,CursorHelpers
andcursorContainerMixin
victory-errorbar@30.0.0
exportsVictoryErrorBar
andErrorBar
victory-group@30.0.0
exportsVictoryGroup
victory-legend@30.0.0
exportsVictoryLegend
victory-line@30.0.0
exportsVictoryLine
andCurve
victory-pie@30.0.0
exportsVictoryPie
andSlice
victory-scatter@30.0.0
exportsVictoryScatter
victory-selection-container@30.0.0
exportsVictorySelectionContainer
,SelectionHelpers
andselectionContainerMixin
victory-shared-events@30.0.0
exportsVictorySharedEvents
victory-stack@30.0.0
exportsVictoryStack
victory-tooltip@30.0.0
exportsVictoryTooltip
andFlyout
victory-voronoi@30.0.0
exportsVictoryVoronoi
andVoronoi
victory-voronoi-container@30.0.0
exportsVictoryVoronoiContainer
,VoronoiHelpers
andvoronoiContainerMixin
victory-zoom-container@30.0.0
exportsVictoryZoomContainer
,RawZoomHelpers
,ZoomHelpers
andzoomContainerMixin
VictoryPie
-182 Adds optional radius
and origin
props to VictoryPie
. The radius
prop should be given as a single number. The origin
prop should be given as an object with number values specified for "x" and "y". When these props are not given, radius and origin are determined by width
, height
, and padding
as previously.
VictoryCore
-390 Breaking Change for other Victory packages
This PR changes how the exported helper reduceChildren
operates, and removes getDomainFromGroupedData
-392 Make sure transforms are applied to primitive components
VictoryChart
-555 Refactors how VictoryStack
and VictoryGroup
interact with child data. Fixes bugs related to stacked and grouped charts in VictoryVoronoiContainer
Breaking Changes
- Refactors utility methods. This is an internal breaking change, but should not be a breaking change for most Victory users. See victory-core/380 for details
- Upgrades to
react-fast-compare@^2.0.0
which changes function comparison. This means that Victory components will update when functions are not equal. This closes several Victory issues, but may cause a slight performance decline
New Features
- Adds
minDomain
andmaxDomain
props. These props may be used to set one edge of a domain while allowing the other edge to be determined by data or other props.minDomain
andmaxDomain
overridedomainPadding
. - Adds
singleQuadrantDomainPadding
prop. This prop may be given as a boolean or an object with boolean values for x and y. When this prop is set tofalse
for a given dimension, anydomainPadding
applied in that dimension will not be constrained to existing quadrants.
VictoryCore
-374 Consistent PropTypes
for clipId
-373 Evaluate styles for polar bars
-372 Support top and bottom cornerRadius for bars. Support functional cornerRadius
-371 Evaluate Whisker styles
-370 Refactor to remove lifecycle methods
VictoryChart
-594 Support functional cornerRadius
and objects with cornerRadius
defined for "top" and "bottom"
-593 Add defaultBrushArea
prop with supported options "all", "none" and "disable"
-591 Ensure that VictoryVoronoiContainer
works correctly with VictoryGroup
data.
BREAKING CHANGES
Disable arbitrary styles from data This change deprecates Victory's ability to automatically pick up style attributes from the data object. This change will improve performance, but will be a breaking change for many users. Fortunately the upgrade path is simple:
If your data object looks like
data={[
{ x: 1, y: 1, fill: "red", opacity: 0.2 },
...
]}
Add the following functional styles:
style={{ data: { fill: (d) => d.fill, opacity: (d) => d.opacity } }}
and everything will work as before.
Limit Pre-calculating label props Base props for labels will no longer be pre-calculated unless a labels prop exists. This change improves performance, but it will be a breaking change for users who were using events for adding labels to elements that did not already have them using an event mutation like:
events={[{
target: "data",
eventHandlers: {
onClick: () => {
return [{ target: "labels", mutation: () => ({ text: "clicked" }) }];
}
}
}]}
If you are using this pattern, you can make labels work as expected by adding a dummy labels prop like: labels={() => null}
Note: This change does not affect tooltips, which exist, but are invisible until they receive the active
prop
All Changes VictoryCore -364 Perf: Remove style whitelist filter. -369 Ensure state -368 Audit lodash methods -367 Simplify state filtering -365 Perf: Return early when label content is null or undefined -362 Perf: Filter falsey mutations from state
VictoryChart
-587 Disable styles on data
-584 Check for labels prop before computing baseProps for labels
-589 Audit lodash methods
-583 Perf improvement for VictorySelectionContainer
VictoryPie -176 Disable styles on data -177 Audit lodash methods
VictoryCore
-343 Changes the render order of lines and areas in the Area
primitive
-344 bug fix for VictoryTransition
with fewer children
-334 Add Whisker
primitive for VictoryBoxPlot
VictoryChart
-557 VictoryBoxPlot
-575 Stack datasets with differeing domains
-574 Refactor helper method exports
VictoryPie -168 Refactor helper method exports
VictoryChart -573 Use fallback styles in VictoryBrushLine
VictoryCore
-339 Adds a "minus" option for Point
VictoryChart -571
- Adds
selectionBlacklist
toVictorySelectionContainer
- Adds
activateData
andactivateLabels
toVictoryVoronoiContainer
(true by default) - Adds
activateSelectedData
toVictorySelectionContainer
(true by default) -572 Changes behavior oflabels
inVictoryVoronoiContainer
labels
is now called withpoint, index, points
instead ofpoint, active
. This will not be a breaking change for most users, as this function was only called when labels wereactive
-570 Add "minus" option forVictoryScatter
symbol
prop -569 Fixes a bug increateContainer
-568 AddsbrushAreaWidth
prop forVictoryBrushLine
-567 Fixes brushArea active state inVictoryBrushLine
-565 Prevent re-renders with disable prop
VictoryCore -341 Improve sCU logic for primitive components
VictoryChart
-563 stopPropagation
when panning or selecting VictoryBrushLine
-565 Adds disable
prop to all interactive containers and addon components
-victory-chart/562 Bugfix for VictoryCursorContainer
-918 Add `sideEffects: false
VictoryCore
-337 Add sideEffects: false
-338 Fix bar path bug in Firefox
VictoryChart
-560 Add sideEffects: false
-561 Bugfix for createContainer
VictoryPie
-167 Add sideEffects: false
Major Features
VictoryBrushLine
for multi-brush support
Breaking Changes
Candle
expects a new set of props fromVictoryCandlestick
- The
Line
component has been renamed toAxis
/Grid
- Internal methods for all Victory primitive components have changed. This will be a breaking change for users who are extending primitive components, including
victory-native
.
VictoryCore
-336 Fixes key names for ErrorBar
-325 Adds a getDimension
static method for VictoryLegend
-326 Adds a fallback prop for VictoryLegend
titleOrientation
-327 Use pointerEvents: "painted"
for grid styles
-328 Adds inline
prop for VictoryLabel
-329 Bugfix add-events
-330 Adds wickStyleWidth
prop for Candle
This is a breaking change as it changes the expected props for Candle
-331 Bugfix portal rendering
-333 Whitelist style attributes
-335 Update primitives
This is a breaking change for victory-native
and anyone extending primitive components.
*This is a breaking change for for the Line
component. Renamed Axis
/ Grid
VictoryChart
-551 Bux fixes and improvements for VictoryStack
-553 Allow renderInPortal to be false for tooltips in VictoryVoronoiContainer
-554 Add support for wickStrokeWidth
in VictoryCandlestick
This is a breaking change as the expected props for Candle
are changed
-556 Fixes undefined context variable
-558 Allow func
PropType for color
on VictoryGroup
-559 Implement VictoryBrushLine
and use updated primitive components
**This is a breaking change for anyone using the Line
primitive. It has been renamed to Axis
/ Grid
.
This may be a breaking change for anyone who was extending Victory primitives
VictoryPie -166 Update Victory primitives
VictoryCore
- 324 Adds support for external event mutations
- Adds
externalEventMutations
prop toVictorySharedEvents
and all components enhanced with theadd-events
HOC externalEventMutations
prop format:
externalEventMutations: PropTypes.arrayOf(PropTypes.shape({ callback: PropTypes.function, childName: PropTypes.oneOfType([ PropTypes.string, PropTypes.array ]), eventKey: PropTypes.oneOfType([ PropTypes.array, CustomPropTypes.allOfType([CustomPropTypes.integer, CustomPropTypes.nonNegative]), PropTypes.string ]), mutation: PropTypes.function, target: PropTypes.oneOfType([ PropTypes.string, PropTypes.array ]) }))
- Adds
Note: eventKey
and target
must be specified for externalEventMutations. When using extenalEventMutations
with shared events (i.e. events on VictoryChart etc), childName
is also required.
Note: The callback
supplied to externalEventMutations
should be used for clearing mutations. This is crucial for animating charts
-323 Add support for immutable data structures
note: compatible with immutable@v3.8.x
and will be compatible with immutable@v4.0.x
when released
VictoryChart
- 550 Fixes a bug related to voronoi tooltip positioning
- 549 Fixes a prop type warning for
categories
supplied toVictoryAxis
- 548 Adds a
voronoiBlacklist
prop toVictoryVoronoiContainer
- 547 Fixes downsampling in
VictoryZoomContainer
with function plotting - 545 Fixes a bug related to panning in
VictoryZoomContainer
- 544 Adds support for external event mutations
- 543 Fixes a bug related to dates in
VictoryBrushContainer
- 545 Fixes a bug in
VictoryZoomContainer
- 542 Adds support for immutable data note: compatible with
immutable@v3.8.x
and will be compatible withimmutable@v4.0.x
when released
VictoryPie
VictoryCore
- 320 Adds
rowGutter
and support for asymmetric gutters for bothgutter
androwGutter
inVictoryLegend
- 322 Adds support for a
sortOrder
prop with values "ascending" or "descending"
VictoryChart
- [540] (FormidableLabs/victory-chart#540) Adds
allowSelection
boolean prop forVictorySelectionContainer
(true by default) - 541 Implements
sortOrder
prop with "ascending" and "descending" options
VictoryPie
- 160 Add
sortOrder
prop
VictoryCore
- [316] (FormidableLabs/victory-core#316)
- adds
cornerRadius
prop forBar
- adds
barRatio
prop forBar
- removes rounding from calculated paths
- fixes a domain bug for negative bars and areas
- adds
VictoryChart
- Update infrastructure for React 16
- victory-chart/534 Add
allowResize
andallowDrag
props forVictoryBrushContainer
Breaking Changes
- victory-chart/527
- adds an
invertAxis
prop forVictoryAxis
that will flip the domain of a given axis when true. Changing theorientation
prop of a given axis will no longer flip the domain on that axis unless theinvertAxis
prop is also set. tickFormat
as an array will set the number of ticks iftickValues
are not given.tickValues
will be forced to a unique array.tickFormat
may still have non-unique values.tickCount
will now always have an effect when set. Previously, this prop would do nothing whentickValues
were provided. NowtickCount
will downsample any array provided to eithertickValues
ortickFormat
.
- adds an
Other Changes
VictoryChart
- 529
VictoryChart
no longer calculatestickValues
ortickFormat
for axis children.stringMap
andcategories
are passed to axis components instead. - 528 and 530 Remove numeric keys from styles
- 526 Always set animation state
VictoryCore
- 310 Add
getPath
prop forPoint
to support custom path calculation - 311 Fix bug in
TextSize
- 313 Use
tickFormat
for calculating a stringMap when appropriate - 314 Theme changes: Change
pointerEvents
to "visible" for grids
- victory-core/307 Adds a default className for containers
- victory-core/308 Fix borderWidth on error bars
- victory-core/309 Fix non-responsive container styles, add container ref
- victory-chart/524 Fix naming changes for
VictoryCursorContainer
BREAKING CHANGES:
victory-core/299 Containers are now rendered in parent divs. This may be a breaking change for parent styles.
victory-chart/518 Naming changes for container props
VictoryBrushContainer
dimension
->brushDimension
selectionComponent
->brushComponent
selectedDomain
->brushDomain
selectionStyle
->brushStyle
onDomainChange
->onBrushDomainChange
VictoryCursorContainer
dimension
->cursorDimension
onChange
->onCursorChange
VictorySelectionContainer
dimension
->selectionDimension
VictoryVoronoiContainer
dimension
->voronoiDimension
VictoryZoomContainer
dimension
->zoomDimension
onDomainChange
->onZoomDomainChange
Other Changes
-
victory-core/300 Fixes path rendering for decimal values
-
victory-core/302 Adds an
alignment
prop for<Bar/>
so that bars may be rendered with "start", "middle" (default), or "end" alignment relative to their value. -
victory-core/304
VictoryLabel
positioning is calculated fromdatum
whenx
andy
positioning props are not provided. This features supports data annotations -
victory-core/305 Adds a
groupComponent
prop forVictoryPortal
. This prop is used byVictoryZoomContainer
so that children rendered withinVictoryPortal
may still be clipped when zooming -
victory-chart/516 Ensure that
VictoryZoomContainer
respectsclipId
-
victory-chart/517
VictoryZoomContainer
andVictoryVoronoiCOntainer
should ignore legend children -
victory-chart/519 Adds an
alignment
prop forVictoryBar
so that bars may be rendered with "start", "middle" (default), or "end" alignment relative to their value. -
victory-chart/520 Adds an
allowPan
prop forVictoryZoomContainer
. (Default true) -
victory-chart/521 Changes how children of
VictoryZoomContainer
are clipped to enable better zooming forVictoryPortal
-
victory-chart/522 Fixes a bug in
VictoryZoomContainer
that effected time scale charts withzoomDomain
specified
- victory-core/297 Adjusts automatic width in
VictoryLegend
- victory-core/296 Fixes layout bug in
VictoryLegend
BREAKING CHANGES: Styling and layout for VictoryTooltip
and VictoryLegend
are impacted
- victory-core/293 This may be a breaking change
Removes the default theme from
VictoryTooltip
. See PR for additional details. - victory-core/294 This may be a breaking change Improvements for
VictoryLegend
- Adds a legend border that can be styled or replaced with a custom component
- new props:
borderComponent={<Border/>}
andborderPadding
- new style / event namespace: "border"
- new props:
- Adds new primitive component
Border
which renders arect
element- props: common props +
width
,height
,x
andy
- props: common props +
- Adds a legend title with supporting props for positioning and centering titles
- new props: title, titleComponent={}, titleOrientation, centerTitle
- new style / event namespace: "title"
- Adds a legend border that can be styled or replaced with a custom component
- victory-core/295 Fixes deprecation error for React 16
VictoryCore
- 289 Bugfix: createContainer + containerId
- 287 Allow users to override
touchAction
style in containers - 286 bugfix: tooltip positioning with
dx
anddy
VictoryChart
- 510 Render axis line under other axis elements
VictoryPie
- 153 Bugfix for asymmetric padding
VictoryCore
- 285 bugfix: tooltips with
activateData
- 278 Support touch events
- 280 Fix tooltip rendering in VictoryPortal
- 281 bugfix: functional label padding
- 282 bugfix: fix "unknown props on
<g>
tag" warning - 283 Allow boolean value for animate prop
- 284 Sort arrays by "key" when animating. See #684
- 274 Fixes automatic bar width calculation for horizontal bars
- 275 Adds an optional
containerId
prop for all Victory containers - 276 Adds
downsample
method forData
VictoryChart
- 504 bugfix: padding bug in
VictoryCursorContainer
- 505 Support touch events on all containers
- 506 Add
props
argument forVictoryVoronoiContainer
callbacks - 507 bugfix: Support array styles for
VictoryLabel
when it is used as a direct child ofVictoryChart
or other wrappers - 508 Add support for
animate
as a boolean prop - 509 Add
props
as the last argument for all container callbacks - 502 Fix bug in
VictoryZoomContainer
- 503 Add downsample option for
VictoryZoomContainer
- 504 Fix padding bug in
VictoryCursorContainer
VictoryPie
VictoryCore
- 267 Correct single-point domain logic
- 268 Correct stacked domain logic
- 269
VictoryLabel
accepts percentage values forx
andy
- 270
VictoryLegend
supports events. Also enforces consistent parent styles as other Victory components. Breaking style change for VictoryLegend - 272 Aggressive
shouldComponentUpdate
logic for evented Victory components Breaking change for some components usingaddEvents
VictoryChart
- 496
VictoryZoomContainer
improvements for real-time, updating data - 497 bugfix: apply
domainPadding
to explicit domains - 498
VictoryAxis
determines its own defaulttickFormat
- 499 Fix label prop merge order for
VictoryVoronoiContainer
labels - 500 Support performance improvements for evented components e.g.
VictoryArea
,VictoryBar
...
Victory:
- 651 Support Webpack 3 and ES6 exports
VictoryCore:
VictoryChart:
- 495 Support Webpack 3 and ES6 exports
- 494 Ensure that
tickFormat
has access totick
,index
, andticks
- 491 Corrects dependent axis for
innerRadius
- 490 Fixes a bug in domain calculation for polar axes
- 488
VictoryZoomContainer
only updates the domain in the dimension it controls - 489 Adds support for
innerRadius
on polar charts
VictoryPie:
- 149 Support Webpack 3 and ES6 exports
- 148 Translates individual slices rather than an entire group translation for pie and labels
Minor bug fixes:
VictoryCore
- victory-core/255 style typo
- victory-core/257 single point domain calculation bug
- victory-core/259 Area render bug
- victory-core/260 Area render order
- victory-core/515 Bugfix for ARIA title and desc. Now both have unique IDs.
- victory-core/262 Consistent widths for polar bars. This change may require style adjustments to maintain visual continuity
VictoryChart
- victory-chart/482 Add
minBubbleSize
prop toVictoryScatter
- victory-chart/484 Remove inappropriate interpolation options for
VictoryArea
andVictoryLine
- victory-chart/487 Fix a bug in
VictoryPolarAxis
domain calculation
- victory-core/240 Polar Charts
- victory-chart/466 Polar Charts
- victory-chart/475 Brush and Zoom fixes
- victory-chart/476 Zoom Improvements
Breaking Changes
- Removes default bar width from themes
- Changes how default bar widths are calculated
- Changes render methods for
Area
,Bar
andCurve
primitives (Breaking change forvictory-native
and others extending primitives) - Changes function signatures for
Selection.getDomainCoordinates
andSelection.getDataCoordinates
(Breaking change forvictory-native
)
Overview
- Supports polar charts by adding the
polar
prop to charts. - Polar charts are supported for
VictoryArea
,VictoryChart
,VictoryGroup
,VictoryLine
,VictoryScatter
VictoryStack
andVictoryVoronoi
- Polar charts are supported for
VictoryBar
, but horizontal (radial) bars are not yet supported - Polar charts work with
VictoryVoronoiContainer
- Polar charts work with
VictorySelectionContainer
, but the dimension prop is not supported for polar selections - Polar charts work with
VictoryZoomContainer
, but zooming is limited to centered radial zooming. Panning has no effect. - Polar-specific default animations for
VictoryLine
andVictoryArea
- horizontal polar charts are not yet supported
VictoryCandlestick
andVictoryErrorBar
do not yet work with polar chartsVictoryCursorContainer
does not yet work with polar chartsVictoryBrushContainer
does not work with polar chartsVictoryZoomContainer
has limitations for polar charts
Planned additional work
- Support for radial bars
- Support for spider charts (i.e. linear grid lines rather than arcs on polar charts)
- Support separate theming for polar charts (at least axes)
- Support for a polar version of
VictoryCursorContainer
- Minimal support for polar versions of
VictoryCandleStick
andVictoryErrorBar
(Elements will be correctly positioned and angled, but path elements will not be altered to reflect curvature, i.e. candles will still berects
rather than arc paths) - Investigate hollow polar charts
Details
- Adds
VictoryPolarAxis
with new props:axisAngle
startAngle
,endAngle
, andlabelPlacement
- Adds
polar
,startAngle
,endAngle
, anddefaultPolarAxes
props forVictoryChart
- Adds
polar
,origin
, andrange
props to all chart types. - Adds
defaultPolarTransitions
static methods toVictoryLine
andVictoryArea
- Uses
LabelHelpers
to simplify allhelper-methods
- Adds a new
Arc
primitive which is used for polar axes and grid lines - Adds
polar
andorigin
props to rendered components (primitives,VictoryLabel
,VictoryClipContainer
VictoryContainer
) - Supports radial areas for
Area
andCurve
. These props have no effect for cartesian charts - Adds an
openPath
prop forCurve
. This prop is used to determine whether radial curves should be closed. Curves are closed by default, but when this prop is set to true they will not be. This prop has no effect for cartesian charts - Supports polar bars in the
Bar
primitive. (Angular bars only, radial bars are not yet supported) - Adds a
labelPlacement
prop toVictoryLabel
andVictoryTooltip
. Values are "parallel", "perpendicular", and "vertical". These flags help to appropriately position labels in polar charts. Polar charts will use "parallel" label placement by default. Cartesian charts will only use "'vertical" placement. - Adds support for circular clipPath
- Adds support for polar animation transitions for continuous chart types. During
onLoad
, all points grow from zero. DuringonEnter
andonExit
new points are added / removed at the location of an adjacent point to keep path interpolation as smooth as possible. This implementation obviates the need for radial clip-path animations for these chart types. before
andafter
callbacks foronLoad
,onEnter
andonExit
are now called withdatum
,index
, anddata
instead of onlydatum
.- Adds
LabelHelpers
- Adds helper methods for polar charts
Breaking Changes
-victory-chart/471 Passes the string value of ticks to the tickFormat
function rather than the associated index. This may be a breaking change for users who are using categorical data and formatting tick values by index
New Features
-victory-chart/474 Adds support for a y0 accessor so that users can have granular control over the baseline of components like VictoryArea
-victory-core/246 Adds an itemsPerRow
prop to VictoryLegend
to support automatic legend wrapping
Minor Changes
-victory-chart/472 Fixes a bug that was causing VictoryGroup
to override styles on any independent VictoryLabel
children
-victory-core/244 Passes missing datum
and index
props to Flyout
-victory-chart/250 Audits shouldComponentUpdate
logic for all primitive components so that changes to optional props like className
will cause components to re-render.
-victory-pie/146 Rounds label positions for VictoryPie
- victory-chart/469 Adds
VictoryCursorContainer
- victory-core/241 Adds optional
title
andesc
props toVictoryLabel
- victory-core/243 Improvements to
VictoryContainer
- Automatic
overflow: "visible"
for elements rendered inVictoryPortal
(tooltips) VictoryContainer
no longer rendersg
tags (this was causing confusion with evented containers)- Default responsive styles are now
width: "100%"
height: "100%"
(fixes a bug in safari) - Changes the merge order for responsive styles so that
width
andheight
attrs may be overridden
- Automatic
- victory-core/244 adds missing
index
anddatum
props toFlyout
- victory-core/245 fixes
dy
calculation inVictoryLabel
BREAKING CHANGE
- Updates to
react@^15.5.0
- Uses separate
prop-types
package - Projects using Victory must also depend on
prop-types
- Removes
VictoryVoronoiTooltip
- Supports combining container behaviors with the
createContainer
method. - Individual
combineContainerMixins
are also exported. - For more detail, see victory-chart/453
victory-chart/447 Improves performance for container components
Minor bug fixes -508 -509 -510 -517 -520
- Support multi-repo tooling
(VictoryVoronoiContainer)
BREAKING CHANGES
VictoryTooltip
no longer automatically adds theactive
prop to data when hovered. To turn this behavior on, set the newactivateData
boolean prop onVictoryTooltip
- Deprecates
label
in favor oflabels
inVictoryLine
andVictoryArea
, allowing individual data labels for these components like in other Victory components. This will be a breaking change for anyone using thelabel
prop inVictoryLine
orVictoryArea
. Series labels will need to be configured manually. VictoryZoomContainer
now zooms both x and y dimensions, use the propdimension="x"
to return to the old behaviorVictoryZoomContainer
now centers zoom behavior on the mouse position rather than the center of the chartVictoryZoomContainer
has a minimum zoom level of the extent of the domain / 1000. Set a custom minimum with theminimumZoom
prop, which takes an object with numeric values for x and/ or y.VictoryBrushContainer
no longer hasdimension="x"
as the default value.
Deprecation Notice
VictoryVoronoi
and VictoryVoronoiTooltip
have been replaced by VictoryVoronoiContainer
and will be deprecated in version 0.20.0
VictoryTooltip
no longer automatically adds theactive
prop to data when hovered. To turn this behavior on, set the newactivateData
boolean prop onVictoryTooltip
- Adds a
theme
prop toVictoryContainer
so that custom containers may pick up themes from their parents - Removes default
title
anddesc
props fromVictoryContainer
- Adds support for providing
text
as an array forVictoryLabel
- Adds support for providing
style
as an array forVictoryLabel
so that each line of a multi-line label may be styled independently - Changes how null data values are handled by
Area
andCurve
primitives - Adds a
reduceChildren
method toHelpers
to ensure order consistency when working with nested children
- implements data sorting for all components with a
sortKey
props
- Adds
VictoryVoronoiContainer
for hover events (tooltips).VictoryVoronoiContainer
has several benefits overVictoryVoronoi
andVictoryVoronoiTooltip
- Supports multi-dataset voronoi
- Much better performance (voronoi polygons are not actually rendered, so the number of nodes rendered is dramatically lower)
- Supports multi-data tooltips
- Supports rectangular selections with a dimension prop
i.e.
dimension="x"
creates vertical hover areas for every unique x value in all child data
- Deprecates
label
in favor oflabels
inVictoryLine
andVictoryArea
, allowing individual data labels for these components like in other Victory components. This will be a breaking change for anyone using thelabel
prop inVictoryLine
orVictoryArea
. Series labels will need to be configured manually - Changes how null values are handled in
VictoryArea
, and groups all line and area segments (i.e. split by null values) into the sameeventKey
, so that they operate as a single line for the purposes of events.
- Supports x and y dimension zooming in
VictoryZoomContainer
- Adds a
minimumZoom
prop forVictoryZoomContainer
- Zooming centers on mouse position rather than in the center of the chart
- Adds a
translateY
prop forClipPath
to support x, y zoom behavior - Removes default
clipPadding
inClipPath
- victory-core/195
- Fixes null event state bug
- victory-chart/431
- Sets a maximum amount of scale per zoom event for smoother interaction with fast onWheel events
- victory-chart/429
- Throttles
onWheel
andonMouseMove
events on Victory container components - Exports container event helpers
This release includes major breaking changes related to VictoryZoom
- victory-core/189 and 191
- Adds
VictoryLegend
component
- Adds
- victory-core/190
- Allows
VictoryContainer
to render either<g>
or<svg>
depending on the value of the standalone prop - Passes a timer down in context for
VictorySharedEvents
- Event handlers have access to the context they are being called from via an argument
- i.e.
onClick: (event, targetProps, eventKey, context) => {...}
- i.e.
- Enhances
addEvents
so that evented components can pick up "parentControllerProps" from parent state- useful for
VictoryZoomContainer
- useful for
- Adds the ability to define callbacks in the events prop that will be called after
setState
- useful for allowing
VictoryZoomContainer
to call methods likeresumeAnimation
- useful for allowing
- Allows
- victory-chart/427
- Adds
VictoryBrushContainer
- Adds
VictoryZoomContainer
to replaceVictoryZoom
- See pull request for examples
- Deprecates
VictoryZoom
- Changes default styles for
VictorySelectionContainer
- Adds override-able
selectionComponent
forVictorySelectionContainer
- Adds
domain
andstandalone
to list of props that get stored in parent state - Simplifies and standardizes container rendering across components.
- Adds
- Adds
VictorySelectionContainer
- Changes when functional styles and props are evaluated (this may be a breaking change)
Functional styles and props are now evaluated in the primitive components (
Point
,Bar
etc.) - Supports an
active
prop on all primitive components that is used when evaluating functional styles and props - Tooltips now trigger
active: true
on both labels and data components defaultEvents
are supported forcontainerComponents
- Fixes date handling in VictoryZoom
- Adds support for className in primitive components
- Fixes minor animation bugs
- Fixes bugs in VictoryZoom
- Adds
pointerEvent: "none"
to tooltip
This may be a breaking change for animating VictoryArea and VictoryLine. Animation behavior is changed.
- Change how animations behave for continuous data i.e. VictoryArea and VictoryLine
- clipPath curtain will never be smaller than the range except during
onLoad
- clipPath curtain will never be smaller than the range except during
- Simplify transitions code
- Ensure that animations and transitions use the global timer passed in context or create their own
- Fix
bypassAnimation
bug - Ensure that clipPath width and height are never negative
- Fix timer issues and export VictoryZoom
- Temporarily revert global animation timer and VictoryZoom changes
- Export VictoryZoom
- Add global animation timer
- Add VictoryZoom
- Stricter npmignore
- Uses
publishr
to reduce npm installed package size #413 - Fixes a bug where label padding was not being applied to tick labels #408
- Removes default tick padding in themes
- Changes how the domain is calculated when there is only one data point, or when the minimum and maximum of the data is equal in a given dimension #407
- Removes hard-coded
<g>
fromVictorySharedEvents
#402 - Ensures that ticks array is not empty after filtering zeroes for crossed axes
- Fixes naming for "stack" and "group" roles
- Allows npm 2 installs
- Fixes incorrect Aria roles
- Removes support for
children
for VictoryLabel. Usetext
instead - Upgrades all d3 packages
- Greater consistency of props for props passed to primitive components
- Adds
VictoryPortal
which renders any child elements in a top level portal container if it exists VictoryTooltip
usesVictoryPortal
by default- Adds
VictoryClipContainer
which renders children in a group container with aclipPath
ifclipPath
props exist. This component is used for animating continuous data types likeVictoryLine
. It should not be used for custom clipPaths. VictoryArea
andVictoryLine
useVictoryClipContainer
as theirgroupComponent
- Removes
clipPath
properties fromVictoryLine
andVictoryArea
- Extracts event logic into a new inverted inheritance higher order component
addEvents
which is used by all chart components - Fixes a bug in
VictoryTransition
that was causing unnecessary rerendering - Exposes
Data
,Domain
,Scale
, and other helpers - Fixes date related domain bugs
- Fixes stacking for time scale data
- Supports separate theming for x and y axes
- Fixes ordering for stacked and grouped data
- Fixes broken tooltips in Safari
- Fixes tooltip fill bug
- Corrects
propTypes
inVictoryTooltip
- Removes unused
flyoutProps
prop inVictoryVoronoiTooltip
This is a breaking change for label placement in VictoryPie
- Adds support for
VictoryTooltip
- Adds
VictoryVoronoi
component - Adds
VictoryVoronoiTooltip
- Moves all primitive rendered components to
victory-core
where they are exported for external use - Enhances
VictoryGroup
so that it can accept adata
prop which it will pass to all children. This also allows groups of components to be stacked as one - Adds support for
defaultEvents
in any primitive component (i.e.dataComponent
,labelComponent
) - Adds
onLoad
animations - Adds a
sortKey
prop toVictoryLine
to allow sorting by fields other than "x" - Adds a
fixLabelOverlap
boolean prop toVictoryAxis
. When enables, this feature renders a smaller subset of ticks when the full set of ticks would cause overlapping labels. This feature is currently limited to evenly spaced labels. - Fixes a bug related to
bubbleProperty
inVictoryScatter
- Allows string data in
VictoryCandlestick
andVictoryErrorBar
- Performance optimizations
This is a breaking change for themes across all components and for label placement in VictoryPie
- Updates VictoryTheme API, uses
VictoryTheme.grayscale
for default styling - Alters label placement in VictoryPie so that when label styles include padding, the
innerRadius
of the pie does not effect label placement. - Adds a
displayName
to all components for ease of debugging - Improves animation for continuous data components (i.e. VictoryLine, VictoryArea) using clipPath
- Improves performance by simplifying scale type checking for VictoryBar and VictoryArea
- Supports for arrays of
childName
in events - Fixes a bug related to bar width
- Fix PropType warnings in React 15.3+
- Add animationInfo as 2nd argument to victory-animation child function call
- Fixes minor domainPadding bugs for stacked and grouped charts
- Fixes a bug in generated data
- Fix animation and style bugs for VictoryCandlestick
- Fix layout bug effecting negative axes in VictoryChart
- Update docs
- Fix minor error bar bug
- Fix minor axis style bugs
Breaking Changes
- Default styles and some default props have changed across all components in this release.
VictoryTheme
- All Victory components support a
theme
prop that can be used to define styles and props across different component types. victory-core
includes the material theme
VictoryCandlestick
- The new
VictoryCandlestick
component may be used standalone or in conjunction withVictoryChart
. It has an identical API and feature set as other chart compatible components with the exception of thedata
and data accessor props.VictoryCandlestick
expectsdata
in the form[{x: value, high: NUMBER, low: NUMBER, open: NUMBER, close: NUMBER}...]
, and includes data accessor propsx
,high
,low
,open
, andclose
.
VictoryErrorBar
- The new
VictoryErrorBar
component may be used standalone or in conjunction withVictoryChart
. It has an identical API and feature set as other chart compatible components with the exception of thedata
and data accessor props.VictoryErrorBar
expectsdata
in the form[{x: value, y: value, errorX: ERR, errorY: ERR}...]
, WhereERR
is a number or a two value array for asymmetric errors.VictoryErrorBar
also includes data accessor propserrorX
anderrorY
.
VictoryNative
- Changes have been made across all components in order to support victory-native.
VictoryNative
has an identical API toVictory
, and reuses most of the code. Changes made toVictory
to supportVictoryNative
are all non-breaking, and minimal. They include the addition of agroupComponent
prop in all components (which defaults to<g>
), removing svg transforms whenever possible in favor of absolute positioning, and code reorganization.
Performance improvements
- Low-hanging performance improvements included in this release:
- Replace
Object.assign
with lodashassign
- Replace
map
/reduce
array methods with length-cachedfor
loops in methods responsible for rendering elements
- Replace
Misc
- Improvements for
domainPadding
domainPadding
is supported in all components compatible withVictoryChart
- Negative and asymmetric
domainPadding
is supported. Example:domainPadding={{x: [-20, 20], y: 50}}
- Grouped bar charts get automatic
domainPadding
so that bars wont overflow axes in most cases.
- Adds Aria roles for all rendered elements
- Fixes bugs related to log scales
- Fixes a bug related to time scales
- Improves consistency for charts with empty and single value data arrays
- Removes
reduce-calc-css
as a dependency
Events enhancements
- Supports events on parent containers (i.e. top level
<svg>
) via theparent
namespace in theevents
prop - In VictoryChart,
parent
events have access towidth
,height
,style
and the calculatedscale
(withdomain
andrange
already applied). Where applicableparent
events also have access todata
- in VictoryPie
parent
events have access towidth
,height
,style
and the calculatedslices
and the calculatedpathFuncton
- When mutating elements via the return from event handlers, mutation objects may now take arrays for
eventKey
to target several individual elements, or the special value "all" to apply changes to all elements of a particular target type - Associates parent events with child events via a
container
prop onVictorySharedEvents
. This is useful where shared events are automatic as inVictoryChart
,VictoryStack
andVictoryGroup
VictoryContainer
- Supports a custom
containerComponent
in all chart types. containerComponent
defaults to the newVictoryContainer
which renders an<svg>
with defaulttitle
anddescription
aria roles
Full support for horizontal bar charts
- Fixes bugs related to axis layout of horizontal bar charts
Misc improvements
- Adds
vectorEffect: "non-scaling-stroke"
where applicable for improved readability in responsive charts - Increases default
fontSizes
for improved readability - Removes parent transform from
VictoryAxis
so that custom elements can be absolutely positioned more easily - Alters
VictoryAxis
render order to that grids are rendered under labels - Alters the render order of default axes in
VictoryChart
so that default axes will render under data. Explicitly defined axes will still render in whatever order they are defined - Adds a
cornerRadius
prop toVictoryPie
to enable pie slices with rounded corners. Thanks @judikdavid! - Renders all pie slices before labels to prevent slices from overlapping labels
Bug fixes
- Fixes a bug related to transforms for
VictoryLabel
- Fixes a bug in
VictoryGroup
that was causing customlabelComponents
in its children to be overridden. - Fixes a bug related to incorrect an incorrect default
tickFormat
being applied to dates
- Upgrades to React 15
- Supports wrapped components in
VictoryChart
- Adds
VictorySharedEvents
wrapper for coordinating events between supported Victory Components. An annotated example of the new events API:
<VictorySharedEvents
events={[
{
childName: "firstBar", // if a child name is not provided, event will be attached to all children.
target: "data", // what type of element to attach to. Matches the style namespaces
eventKey: 1, // What event key of element to attach to. Defaults to the index in data.
eventHandlers: {
onClick: () => {
return {
childName: "secondBar", // the child to be modified
// props here are the props that define the targeted component i.e. what is passed to an individual bar
mutation: (props) => {
return {style: merge({}, props.style, {fill: "blue"})}; // Whatever is returned here will override the existing props
}
};
}
}
}, {
childName: "secondBar",
target: "data",
eventKey: 0,
eventHandlers: {
onClick: () => { // event handlers can return an array of mutation objects with different targeted elements
return [
{
childName: "firstBar",
mutation: (props) => {
return {style: merge({}, props.style, {fill: "cyan"})};
}
}, {
mutation: (props) => { // the default target element is whatever element the handler is attached to
return {style: merge({}, props.style, {fill: "orange"})};
}
}, {
target: "labels",
eventKey: 1,
mutation: () => {
return {text: "CLICKED"};
}
}
];
}
}
}
]}
>
<VictoryBar
name="firstBar" // if children don't have name props they can be referenced by index in shared events
style={{
data: {width: 25, fill: "gold"}
}}
data={[{x: "a", y: 2}, {x: "b", y: 3}, {x: "c", y: 4}]}
/>
<VictoryBar
name="secondBar"
data={[{x: "a", y: 2}, {x: "b", y: 3}, {x: "c", y: 4}]}
/>
</VictorySharedEvents>
-
improves consistency for
labelComponent
anddataComponent
props. Replaces a custom label components withVictoryLabel
to make the api more consistent and predictable. This is a breaking change for custom label components, asVictoryLabel
expects a different set of props than the previous label components. See VictoryLabel for more detail. -
Custom components are now supported for all rendered axis elements (axis, axisLabel, grid, ticks, tickLabels)
-
All data and label components now have access to scale so that they can create correctly scaled elements from data i.e. error bars.
-
Functional styles and props are now all evaluated before they are passed as props to
labelComponent
ordataComponent
, so that custom components will have access to the final values. -
events are bound and partially applied prior to being passed as props to
labelComponent
ordataComponent
-
it is now possible to specify
angle
andverticalAnchor
props forVictoryLabel
via the style object -
event return values are stored differently on state to facilitate interaction between data and labels. This is a breaking change for events as event handlers must now return an object with
data
and/orlabels
keys so that these values may be applied appropriately to data and label elements respectively.
- Fixes a bug in VictoryChart, VictoryGroup and VictoryStack, which was causing null animation props to be ignored.
BREAKING CHANGES
- VictoryBar and VictoryArea no longer support multiple datasets.
- VictoryStack and VictoryGroup define stacked and grouped layouts for their children
- Custom data components supported on for VictoryBar, VictoryLine, VictoryScatter,
VictoryArea, and VictoryPie via the
dataComponent
prop - Enter and exit transitions animate. Enter and exit transition defaults defined
VictoryBar, VictoryArea, VictoryScatter, VictoryLine and VictoryPie. Custom transitions may be
defined via the
onExit
andonEnter
properties of theanimation
prop - Top level svgs are all responsive by default (using svg viewBox). To render a fixed size
component, set the
standalone
prop to false and render the component inside an svg tag
- Adds VictoryArea as a data type compatible with VictoryChart.
- Supports custom label components
- Upgrades all repos to lodash 4
- Remove dependency on Radium
- Many performance improvements via memoization and replacing expensive merge operations
- Ignore source maps for smaller NPM installation
- Add
npm start
andnpm test
scripts for easier contribution dev workflow - Show gzipped size for minified distribution file
- Code reorganization
- Update roadmap
- Data Accessors are supported on all relevant components
- Shared code has been factored into VictoryUtil
Breaking Changes:
- VictoryLine and VictoryScatter:
- plotting functions via the
y
prop must now be expressed as functions of data rather than functions of x. i.e.y={(data) => Math.sin(data.x)}
- plotting functions via the
- VictoryBar:
- the domain of the dependent axis will automatically include zero unless a domain is specified via props
- automatic alphabetic data sorting has been removed
- automatic 1% domain padding has been removed
- VictoryChart:
- automatic 1% domain padding has been removed
- default line data has been removed, so
<VictoryChart/>
with no additional props will now only render a set of axes with no data
- Demo application now works with hot reloading.
- Application dependencies like
radium
andlodash
now live in components, not in the Builder archetype. This is a breaking change. FormidableLabs#176
- Upgrade to Radium 0.16.2. This is a breaking change if you're using media queries or keyframes in your components. Please review upgrade guide at https://github.com/FormidableLabs/radium/blob/master/docs/guides/upgrade-v0.16.x.md
- Fix build
- Add Cumulative min and max
- Fix Firefox date issue
- Fix issue with exported
dist
file. You can now include Victory vianpmcdn
:https://npmcdn.com/victory/dist/victory.min.js
The following components documented and ready to use; API subject to change:
- victory-animation
- victory-axis
- victory-bar
- victory-chart
- victory-label
- victory-line
- victory-pie
- victory-scatter
Functional styles and functional props (where appropriate) are implemented for all the data primitives (VictoryBar, VictoryLine etc.) and VictoryAxis
Components use d3-modules
Basic code coverage across all Victory components.
We make no promises about any code prior to this release. From this point on, you can expect a regular release schedule (~every two weeks) with detailed release notes. Check out our roadmap for upcoming features