Release notes for 2021

The release notes and information regarding upgrades that you should read for the 2021 releases. You should read this when you're upgrading from an older version of RGraph to a newer one in case something that affects you has changed.

March
January

March 2021 (v5.28)

All of the canvas charts that can show a title have had the properties titleOffsetx and titleOffsety added.
The Meter chart properties labelsValuePoint and labelsValueThousand have been added.
The Meter chart properties labelsValueText* have changed to labelsValue*
The Bipolar chart colors option has been changed - the colors red blue and yellow have been added to the start of the colors array. If you don't like this then you can set it back to the original colors array which is commented out in the source code. Simply open the Bipolar chart source file (RGraph.bipolar.js) and uncomment the colors option which is commented out. Search for the following text in the file and remove the // at the start of the line: //colors:
A Bipolar chart tooltip positioning bug when the textAccessible feature is disabled and the variant is set to 3d has been resolved. The positioning of tooltips in general has been improved.
A Horizontal Bar chart tooltip positioning bug when the textAccessible feature is disabled and the variant is set to 3d has been resolved. The positioning of tooltips in general has been improved.
A Bar chart tooltip positioning bug when the textAccessible feature is disabled and the variant is set to 3d has been resolved. The positioning of tooltips in general has been improved.
The border color and the shadow for the annotating mini-palette have been tweaked ever-so-slightly.
The Pie chart variation - the Activity meter - has now been promoted to its own chart type. The consequences of this are not large and it means a better grow() animation. You can view the full documentation page here. This chart type now also supports tooltips.
The Pie chart variation - the Segmented donut chart - has now been promoted to its own chart type. The consequences of this are not large and it means a better grow() animation. You can view the full documentation page here.
The Pie chart variation - the Horseshoe meter - has now been promoted to its own chart type. The consequences of this are not large and it means a better grow() animation. You can view the full documentation page here.
The SVG 3D Bar chart tooltips weren't taking into account the 3D effect when being positioned. This has been remedied and the tooltips for 3D charts look much better.
The property xaxisLabelsClass has been added to the canvas Bar, Line, Scatter, Gantt and Waterfall charts which allows you to add a CSS class to the tooltips. This property is called yaxisLabelsClass with the HBar chart and labelsClass for charts without axes (eg the Rose chart).

January 2021 (v5.27)

The responsive() function has been rewritten to use the standard window.matchMedia API instead of the window.onresize event. You can read more about this on the RGraph blog . This is a significant change to the responsive() function but the usage of the function has only changed marginally. Now you should list the screen size clauses from largest to smallest like this:
```
.responsive([
    {maxWidth: null,width:600,height:250,options:{marginInner: 10,textSize:12}},
    {maxWidth: 800,width:400,height:200,options:{marginInner: 5,textSize:10}}
]);
```
Otherwise the usage of the function is no different.

In both the canvas and SVG libraries the String.format() function has been extended. Previously you could do this with the function:

str        = '{1} works as a {2}';
name       = 'Richard';
occupation = 'web developer';

str.format(name, occupation);

And this:

str        = '%1 works as a %2.';
name       = 'Richard';
occupation = 'web developer';

str = str.format(name, occupation)

Now though, as well as that, you can do this too:

occupation = 'web developer';
name       = 'Richard';
str        = '{name} works as a {occupation}'.format();

All of the libraries now accommodate having the data given to them as strings as well as real JavaScript arrays. So RGraph now accommodates this type of thing:
```
new RGraph.Bar({
    id: 'cvs',
    data: '4,8,6,5,3,2,5',        // Result: [4,8,6,5,3,2,5]
    // ['5','3','7','2','4'],     // Result: [5,3,7,2,4]
    // ['4,8,6','4,5,2','4,8,6'], // Result: [[4,8,6],[4,5,2],[4,8,6]]
    options: {
    }
}).draw();
```
You should of course give RGraph real JavaScript data structures (arrays containing numbers for example) - this is simply there for ease of use purposes.
The Horizontal Bar chart now has a tooltipsHotspotYonly option so you can still get at tooltips when the value of a bar is zero.
The 3D Bar chart hotspots for tooltips are now drawn more accurately which makes clicking on the bars easier.
The CSV reader has had some aliases added to the getCol() and getRow() API functions. These are:
```
csv.row();
csv.col();
csv.column();
csv.getColumn();
```
The label labelUnitsPre labelUnitsPost labelPoint labelThousand and labelDecimals properties were added to the Horseshoe Meter.

The RGraph.redraw() API function can now accept a canvas as the argument (as well as a color) to limit the clearing to a specific canvas tag. For example:

RGraph.redraw();                // Pre-existing usage
RGraph.redraw('red');           // Pre-existing usage
RGraph.redraw(myCanvas);        // New addition
RGraph.redraw(myCanvas, 'red'); // New addition

Fixed a bug with the Bar chart grow effect when supplying data to it. It wouldn't respect a maximum Y scale value that you had set.
The properties tooltipsFormattedListType and tooltipsFormattedListItems have been added to both the canvas and SVG chart types (those that support tooltips). These two properties give you the ability to easily show HTML lists (either ordered or unordered) in your tooltips by using the %{list} macro. There are demos available of charts that use lists in tooltips in the download archive.

You can download RGraph here