- IMPROVEMENT Added
children
property in the LineTooltipItem, BarTooltipItem and ScatterTooltipItem which accepts a list of TextSpan. It allows you to have more customized texts inside the tooltip. See BarChartSample1 and ScatterSample2, #72, #294. - IMPROVEMENT Added
getTouchLineStart
andgetTouchLineEnd
in LineTouchData to give more customizability over showing the touch lines. see SampleLineChart9. - IMPROVEMENT Enabled
sectionsSpace
in PieChart for the web. - IMPROVEMENT Added Makefile commands which makes it comfortable for verifying your code before push (It is related to contributors, red more about it in CONTRIBUTING.md).
- IMPROVEMENT Added
FlDotCrossPainter
which extendsFlDotPainter
to paint X marks on line chart spots. - IMPROVEMENT Added
textDirection
property in LineTooltipItem, BarTooltipItem and ScatterTooltipItem. It allows you to support rtl languages in tooltips. - IMPROVEMENT Added
textDirection
property in SideTitles class, #531. It allows you to support rtl languages in side titles. - IMPROVEMENT Added
textDirection
property in AxisTitles class. It allows you to support rtl languages in axis titles. - BUGFIX Fixed some bugs on drawing PieChart (for example when we have only one section), #582,
- BREAKING Border of pieChart now is hide by default (you can show it using
borderData: FlBorderData(show: true)
. - BREAKING You cannot set
0
value on PieChartSectionData.value anymore, instead remove it from list. - BREAKING Removed
fullHeightTouchLine
property from LineTouchData. Now you can have a full line with following snippet:
LineTouchData(
...
getTouchLineStart: (barData, index) => -double.infinity // default: from bottom,
getTouchLineEnd: (barData, index) => double.infinity //to top,
...
)
- [IMPROVEMENT] We now use RenderObject as our default drawing system. It brings a lot of stability. Such as size handling, hitTest handling (touches), and It makes us possible to paint Widgets inside our chart (It might fix #383, #556, #582, #584, #591).
- [IMPROVEMENT] Added Radar Chart Documentations
- [IMPROVEMENT] Added
textAlign
property in the BarTooltipItem, LineTooltipItem, and ScatterTooltipItem, default isTextAlign.center
. - [IMPROVEMENT] Added
direction
property in the BarTouchTooltipData, and LineTouchTooltipData to specify the position of the tooltip (can beauto
,top
,bottom
), default isauto
. - [IMPROVEMENT] Updated touch flow, we now use hitTest for handling touch and interactions.
- [IMPROVEMENT] Added 'clickHappened' property in all of our TouchResponses (such as LineTouchResponse, BarTouchResponse, ...), #210.
- [IMPROVEMENT] Added
swapAnimationCurve
property to all chart widgets which handles the built-in animation Curve, #436. - [BREAKING] Some properties in ScatterTouchResponse, and PieTouchResponse moved to a wrapper class, you need to access them through that wrapper class.
- [BREAKING] Renamed
tooltipBottomMargin
totooltipMargin
property in the BarTouchTooltipData, and LineTouchTooltipData - [Bugfix] Fixed
double.infinity
in PieChartData .centerSpaceRadius, #584.
- [BREAKING] We now support flutter version 2.0 (null-safety), check out the migration guide.
- [NEW_CHART] We have added RadarChart. Thanks to Payam Zahedi!
- [BREAKING] We have migrated our project to null-safety. You may need to change your source-code to compile. check migration guide.
- [BREAKING] You cannot set null value on FlSpot any more (use FlSpot.nullSpot instead).
- [Bugfix] Fixed PieChart exception bug on sections tap, #514.
- [Bugfix] Fixed PieChart badges problem, #538.
- [Bugfix] Fixed Bug of drawing lines with strokeWidth zero, #558.
- [Improvement] Updated example app to support web.
- [Improvement] Show tooltips on mouse hover on Web, and Desktop.
- [Bugfix] Fixed PieChart badges draw in first frame problem, #513.
- [Improvement] Use CanvasWrapper to proxy draw functions (It does not have any effect on the result, it makes the code testable)
- [Bugfix] Fixed PieChart badges bug with re-implementing the solution, #507
- [Bugfix] Fix the setState issue using PieChart in the ListView, #467
- [Bugfix] Fixed formatNumber bug for negative numbers, #486.
- [Improvement] Added applyCutOffY property in BarAreaSpotsLine to inherit cutOffY property of its parent, #478.
- [Improvement] [BREAKING] Replaced
color
property withcolors
in BarChartRodData, and BackgroundBarChartRodData to support gradient in BarChart, instead of solid color, #166. Check BarChartSample3 - [Improvement] Improved gradient stops calculating algorithm.
- [Improvement] [BREAKING] Changed SideTitle's
textStyle
property togetTextStyles
getter (it gives you the axis value, and you must return a TextStyle based on it), It helps you to have a different style for specific text, #439. Check it here LineChartSample3 - [Improvement] Added
badgeWidget
, andbadgePositionPercentageOffset
in each PieChartSectionData to provide a widget to show in the chart, see this sample, #443. Providing a widget is an important step in our library, if it works perfectly, we will aplly this solution on other parts. Then I appreciate any feedback. - [Bugfix] Fixed aboveBarArea flickers after setState, #440.
- [Bugfix] Fixed drawing BarChart rods with providing minY (for positive), maxY (for negative) values bug, #404.
- [Bugfix] Fixed example app build fail error, by upgrading flutter_svg package to
0.18.1
- [Bugfix] Prevent show ScatterSpot if show is false, #385.
- [Improvement] Set default centerSpaceRadius to double.infinity in PieChartData, #384.
- [Improvement] Allowed to have topTitles in the BarChart, see BarChartSample5, #394.
- [Improvement] Added
touchedStackItem
andtouchedStackItemIndex
properties in the BarTouchedSpot to determine in which BarChartRodStackItem click happened, #393. - [Improvement] [BREAKING] Renamed
rodStackItem
torodStackItems
in BarChartRodData.
- [Improvement] Show barGroups
x
value instead ofindex
in bottom titles, #342. - [Improvement] [BREAKING] Use
double.infinity
instead ofdouble.nan
for lettingenterSpaceRadius
be as large as possible in the (PieChartData)[https://github.com/imaNNeoFighT/fl_chart/blob/master/repo_files/documentations/pie_chart.md#piechartdata], #377. - [Bugfix] Fixed PieChart bug with 1 section, #368.
- [IMPORTANT] BLACK LIVES MATTER
- [Improvement] Auto calculate interval in SideTitles and FlGridData, instead of hard coding 1, to prevent some performance issues like #101, #322. see BarChartSample4.
- [Bugfix] drawing dot on null spots
- [Bugfix] Fixed LineChart have multiple NULL spot bug.
- [Feature] Added
checkToShowTitle
property to the SideTitles, for checking show or not show titles in the provided value, #331. see LineChartSample8. - [Feature] Added compatibily to have customized shapes for FlDotData, just override
FlDotData.etDotPainter
and pass your own painter or use built-in ones, see this sample. - [Improvement] [BREAKING] Replaced
clipToBorder
withclipData
in LineChartData to support clipping 4 sides of a chart separately.
- [Bugfix] Fixed showing PieChart on web (we've ignored
groupSpace
on web, because some BlendModes are not working yet)
- [BugFix] Fixed groupBarsPosition exception, #313.
- [Improvement] Shadows default off, #316.
- [Feature] Added
shadow
property in LineChartData to have shadow effect in our LineChart, take a look at LineChartSampl5, #304. - [Feature] Added
isStepLineChart
, andlineChartStepData
in the LineChartData to support Step Line Chart, take a look at lineChartSample3, #303. - [Improvement] Added
barData
parameter to checkToShowDot Function in the FlDotData.
- Added
strokeWidth
,getStrokeColor
,getDotColor
in the FlDotData, also removeddotColor
from it (you should usegetDotColor
instead, it gives you more customizability), now we have more customizability on FlDotData, check line_chart_sample3, and line_chart_sample5, #233, #99, #274. - Added
equatable
library to solve some equation issues. - Implemented negative values feature for the BarChart, #106, #103.
- add Equatable for all models, it leads to have a better performance.
- Fixed a minor touch bug in the BarChart.
- Fixed ScatterChart built-in touch behaviour.
- Fixed drawing grid lines bug, #280.
- Implemented FlDotData.
getDotColor
in a proper way, it returns a color based on the LineChartBarData color, #274, #282. - Updated LineChartData.
showingTooltipIndicators
field type to list of ShowingTooltipIndicators to have a clean naming.
- Added
show
property in theVerticalLineLabel
and set default tofalse
, #256. - Fixed bug, when the screen size is square, #258.
- Fixed exception on extraLinesData, #251.
- Show extra lines value with 1 floating-point.
- Implemented multi-section lines in LineChart, check this issue (#26) and this merge request (#252)
- Added
fitInsideHorizontally
andfitInsideVertically
in ScatterTouchTooltipData - Fixed
clipToBorder
functionality basdd on the border sides.
- Improved documentations
- Added
preventCurveOvershootingThreshold
inLineChartBarData
for applying prevent overshooting algorithm, #193. - Fixed
clipToBorder
bug in the LineChartData, #228, #214. - Removed unused
enableNormalTouch
property from all charts TouchData. - Implemented ImageAnnotations feature (added
image
, andsizedPicture
in the VerticalLine, and the HorizontalLine, check this sample for more information. - Enable 'fitInsideTheChart' to support vertical tooltip overflow as well, #225.
- BREAKING CHANGE-> changed
fitInsideTheChart
tofitInsideHorizontally
and addedfitInsideVertically
to support both sides, #225.
- prevent to set BorderRadius with numbers larger than (width / 2), fixed #200.
- added
fitInsideTheChart
property insideBarTouchTooltipData
andLineTouchTooltipData
to force tooltip draw inside the chart (shift it to the chart), fixed #159.
- added
fullHeightTouchLine
in LineTouchData to show a full height touch line, see sample in merge request #208. - added
label
(HorizontalLineLabel) inside HorizontalLine and VerticalLine to show a lable text on the lines.
- yaaay, added some basic unit tests
- skipped the first and the last grid lines from drawing, #174.
- prevent to draw touchedSpotDot if
show
is false, #180. - improved paint order, more details in #175.
- added possibility to set
double.nan
incenterSpaceRadius
for the PieChart to let it to be calculated according to the view size, fixed #179.
- added functionallity to have dashed lines, in everywhere we draw line, there should be a property called
dashArray
(for example check LineChartBarData, and see LineChartSample8) - BREAKING CHANGE:
- swapped HorizontalExtraLines, and VerticalExtraLines functionalities (now it has a well definition)
- and also removed
showVerticalLines
, andshowHorizontalLines
from ExtraLinesData, if thehorizontalLines
, orverticalLines
is empty we don't show them
- added rangeAnnotations in the LineChartData to show range annotations, #163.
- removed
isRound
fiend in the BarChartRodData to add more customizability, and fixed #147 bug. - fixed sever bug of click on pie chart, #146.
- Fixed drawing borddr bug, #143.
- Respect text scale factor when drawing text.
- added
axisTitleData
field to all axis base charts (Line, Bar, Scatter) to show the axes titles, see LineChartSample4 and LineChartSample5.
- added
betweenBarsData
property in LineChartData, fixed #93.
- fixed calculating size for handling touches bug, #126
- added
rotateAngle
property to rotate the SideTitles, fixed issue #75 , see in this sample - BREAKING CHANGES:
- some property names updated in the FlGridData:
drawHorizontalGrid
->drawHorizontalLine
,getDrawingHorizontalGridLine
->getDrawingHorizontalLine
,checkToShowHorizontalGrid
->checkToShowHorizontalLine
(and same for vertical properties), fixed issue #92
- drawing titles using targetData instead of animating data, fixed issue #130.
- prevent to show touch indicators if barData.show is false in LineChart, #125.
- 💥 Added ScatterChart (read about it) 💥
- Added Velocity to in FlPanEnd to determine the Tap event.
- fixed a size bug, #100.
- direction support for gradient on the LineChart (added
gradientFrom
andgradientTo
in the LineChartBarData).
- implemented stacked bar chart, check the samples
- added `groupSpace in BarChartData to apply space between bar groups
- fixed drawing left and right titles of the BarChart
- fixed showing gridLines bug (the grid line of exact max value of each direction doesn't show)
- fixed handling disabled
handleBuiltInTouches
state bug
- BIG BREAKING CHANGES
- There is no
FlChart
class anymore, instead use LineChart, BarChart, and PieChart directly as a widget. - Touch handling system is improved and for sure we have some changes, there is no
touchedResultSink
anymore and usetouchCallback
function which is added to each TouchData like (LineTouchData), read more. TouchTooltipData
class insideLineTouchData
andBarTouchData
renamed toLineTouchTooltipData
andBarTouchTooltipData
respectively, and alsoTooltipItem
class renamed toLineTooltipItem
andBarTooltipItem
.spots
insideLineTouchResponse
renamed tolineBarSpots
and type changed fromLineTouchedSpot
toLineBarSpot
.FlTouchNormapInput
renamed toFlTouchNormalInput
(fixed typo)- added
showingTooltipIndicators
in LineChartData to show manually tooltips inLineChart
. - added
showingIndicators
in LineChartBarData to show manually indicators inLineChart
. - added
showingTooltipIndicators
in BarChartGroupData to show manually tooltips inBarChart
.
- BREAKING CHANGES
- swapped horizontal and vertical semantics in FlGridData, fixed this issue.
- BREAKING CHANGES
- added support for drawing below and above areas separately in LineChart
- added cutOffY feature in LineChart, see this issue
- added
aboveBarData
in LineChartBarData BelowBarData
class renamed to BarAreaData to reuse for both above and below areasbelowSpotsLine
renamed tospotsLine
in BarAreaDatacutOffY
andapplyCutOffY
fields are added in BarAreaData to handle cutting of drawing below or above areaBelowSpotsLine
renamed to BarAreaSpotsLine, and inside itcheckToShowSpotBelowLine
renamed tocheckToShowSpotLine
- provided default size (square with 30% smaller than screen) for the FLChart, fixed this issue.
- added
interval
field in SideTitles, fixed this issue
- 💥 Added Animations 💥, read about it.
- fixed a typo on CHANGELOG
- reformatted dart files with
flutter format
command
- fixed #64, added a technical debt :(
- fixed a critical got stuck in draw loop bug,
- set
BarChartGroupData
x as required property to keep consistency and prevent unpredictable bugs
- added
enableNormalTouch
property to chart's TouchData to handle normal taps, and enabled by default.
- reverted getPixelY() on axis_chart_painter to solve the regression bug (fixed issue #48)
- (fix) BelowBar considers its own color stops refs #46
- bugfix -> fixed draw bug on BarChart when y value is very low in high scale y values (#43).
- added
SideTitles
class to hold titles representation data, and used inFlTitlesData
to show left, top, right, bottom titles, instead of legacy direct parameters, and implemented a reversed chart sample using this update.
- added
preventCurveOverShooting
on BarData, check this issue
- nothing important
- added Touch Interactivity, read more about it here
- added backgroundColor to axis based charts (LineChart, BarChart) to draw a solid background color behind the chart
- added getDrawingHorizontalGridLine, getDrawingVerticalGridLine on FlGridData to determine how(color, strokeWidth) the grid lines should be drawn with the given value on FlGridLine
- added ExtraLinesData in the LineChartData to draw extra horizontal and vertical lines on LineChart
- added BelowSpotsLine in the BlowBarData to draw lines from spot to the bottom of chart on LineChart
- fixed charts repainting bug, #16
- added clipToBorder to the LineChartData to clip the drawing to the border, #3
- fixed bug of adding bar with y = 0 on bar chart #13
- renamed
FlChartWidget
toFlChart
(our main widget) and now you have to importpackage:fl_chart/fl_chart.dart
instead ofpackage:fl_chart/fl_chart_widget.dart
- renamed
FlChart*
toBaseChart*
(parent class of our charts likePieChart
) - renamed
FlAxisChart*
toAxisChart*
- fixed
minX
,maxX
functionality on LineChart - restricted to access private classes of the library