RGraph news and updates
Version 5.01 of RGraph has been releasedWritten by Richard Heyes, 27th May 2019
It's been four months and feels like longer but version 5.01 of RGraph has finally been released. This version is not nearly as comprehensive as version 5.00 was - naturally. It also "finishes things off" that I missed in the long road to version 5.00.So what has changed? For that you should consult the RGraph changelog. This release also has a few backwards-compatibility changes so you'll also want to consult the backwards-compatibility notices and advisories page too - particularly if you're upgrading from a past version. Some of the changes include:
hmarginproperty has been changed to
marginInneracross all of the libraries - so if you use it you will need to update your code.
Both the canvas and SVG versions of the Google Sheets connector have been
updated to support fetching a matrix of cells - such as this:
sheet.get('A2:E12')This returns a matrix of cells (ie a 2D array), so this means that you have to write less code when using the Sheets library. The PHP version of the accessor has also been updated.
RGraph.parseDate()function has been updated to be the same as the SVG version of the function. This version is far more versatile when parsing date and time values so more date and time formats are accepted. The older version of the function is still in the
RGraph.common.core.jsfile and has been renamed to
RGraph.parseDateOld()If, for some reason, you want this older version instead of the newer version you should be able to just change
- The RGraph blog (that you're currently reading) has been changed to an RGraph news repository and will be treated as such from now on and only significant announcements will be added there. It has also been trimmed down from about 100 entries to just 20-25. A few articles have been kept - such as the "Spotlight on..." series as well as release announcements.
The name of the Waterfall chart
textAngleproperty has been changed to
xaxisLabelsAngle. You'll need to update this in your code if you use it.
The RGraph Google Sheets connector has been upgradedWritten by Richard Heyes, 13th May 2019
Previously the Google Sheets connector supported fetching rows, columns and
cells by using the
This method has now been updated to also support the fetching of a matrix of cells.
So whereas previously you could fetch individual rows, columns and cells - you can now fetch
multiple rows of information in a single operation. For example:
var matrix = sheet.get('A2:E13');
You can see this in action by viewing the example chart on the Google Sheets documentation page.
Also new recently is the PHP version of the Google Sheets connector. So now there are versions available for the canvas and SVG libraries - and now one for PHP too. You may ask why a PHP version is relevant - there are a couple of reasons that come to mind immediately:
You don't want to embed the ID of your Google Sheet into the page.
Maybe you don't want to share this information - despite the spreadsheet not being publicly available.
You need to incorporate the data into your back-end code.
Perhaps you need to use the data from your spreadsheet in your PHP or other server-based code.
If you don't use PHP then it shouldn't be too difficult for you to take this code and convert it into whatever language that you do use - PHP isn't exactly difficult to read and understand!
So that's now three libraries for Google Sheets - two of which are essentially the same and another for when you're looking to access your spreadsheet from PHP.
If you don't already use Google Sheets then it's well worth a look. It's essentially a web-based Excel. It doesn't have all of the features of Excel but if your usage isn't too intense then it could save you a lot of money (since Google Sheets is basically free).
Version 5.00 of RGraph now available!Written by Richard Heyes, 20th January 2019
Version 5 of RGraph is now available to download. You can get it from the download page:the changelog. The main changes with this release include the improvement of property names for all chart types (for example
gutterLefthas been changed to
marginLeft) and the implementation of new text configuration properties (ie font/size/color/bold/italic for all bits of text). So if you choose to upgrade you will definitely have to consult the API documentation for your chart type(s) to determine the correct property names you need to use from now on. On a separate note - I've removed the demos from the website so they're now just available in the download. Meaning that the website is down to just 375ish pages - about 355 of which are indexed. This led to a stint at position 15 on Google. However yesterday, mid-morning, it dropped 5 places immediately down to 20. And now it's 24 (ie on page 3). So it's clear (to me) that some sort of penalty is in place. What else would cause a 5 place drop like that? I just don't know what the penalty is or why I have it.
A new stable version of RGraph is now available - 4.68Written by Richard Heyes, 26th October 2018
Well I've finally got through my TODO list so I've released a new version of RGraph - version 4.68. Woo! You can see all of the changes that went into this release by looking through the changelog ( https://www.rgraph.net/changelog.html ). Some of the changes in this release include:
- Curved sticks for the Pie chart (which, I might add, are very sexy!)
- The gradient syntax has been extended with a JSON syntax alternative which allows you a little bit of extra control over the gradient
- Some defaults have been changed for the Rose and RScatter charts
The SVG Rose chart has two new effects (
- The Gantt chart method of configuration has been changed to an object (ie with textual indexes). This should make it easier to read and write - though if you choose to upgrade you'll need to update to the new syntax.
The canvas Line chart has a new
animationTraceCentereffect. There's an example in the download archive of the new effect that demonstrates it.
The CSV reader
and the Google Sheets connector
have been made to work standalone - ie without the
RGraph.common.core.jsfile. This means that can use them in your own code if you wish to (and not have to include the
RGraph.common.core.jsfile in your page.
backgroundGridHlinesCount. Some of the property names really need this.
Finally! A new version of RGraph is now available.Written by Richard Heyes, 14th August 2018
That time has come - I've dusted off the release script - tidied up the download
section - and finally gone through with it and released a new version of RGraph.
Woo! Yes calm down people (all 2 of you...) - version 4.67 is now available for
download from the website. There's nothing particularly massive in it but there
are bug fixes to the canvas Bipolar chart, new documentation for getting RGraph
PhantomJS (ie via the command line), a new SVG Gauge
chart, the Google Sheets import utility can now be used without the rest of RGraph
(ie standalone in your own apps) and angled X axis text for SVG charts. You can read
the changelog and download the new version with these links:
A spotlight on the CSV connectorWritten by Richard Heyes, 26th July 2018
This news article is the last in the series of the 'Spotlight on...' posts and it
concentrates on the dedicated CSV import object. This object is more comprehensive
than the basic
getCSV() AJAX function.
getCSV()as a quick and dirty function whereas the CSV import object is more comprehensive and versatile. If you have your own CSV import facility then by all means use that - you shouldn't have any trouble using it with RGraph.
A spotlight on the AJAX connector functionsWritten by Richard Heyes, 24th July 2018
A continuation of yesterday's spotlight on the Google Sheets connector and this one focuses on the AJAX functionality that RGraph comes with. There are two separate sets of AJAX functions - one for SVG and one for canvas.They do anything from fetch a single number to fetching and parsing a
JSONfile. There's also a general AJAX fetch function so you can get hold of any page you wish to.When using RGraph you're not limited to the AJAX functions that come with RGraph - you can quite happily use your own (or the jQuery AJAX functions for example).
A spotlight on the Google Sheets connectorWritten by Richard Heyes, 23rd July 2018
This news article shines a spotlight on the SVG Google Sheets connector (there's one for canvas too). Using this you can connect the charts that are displayed on your website directly to a spreadsheet in the online Google Sheets application - without any intervention on your part or having to export it first. This way you can update a value in your spreadsheet and your website is updated immediately.
Initially the Google Sheets connector was created for use with RGraph but it's designed so that there are few dependencies - only a few functions in the RGraph core library and for the next release this will be removed from both the canvas and the SVG versions of the library so if you want to use this connector with your own code then you can - and it's going to be easier as of the next release.
A new stable release of RGraphWritten by Richard Heyes, 27th August 2017
The time has finally come! Yes finally I've added version 4.63 to the website so you can download it from the download page (www.rgraph.net/download.html) if you want to. Since the gap between this and version 4.62 has been approximately 3 months there's a little bit more in this release than there previously has been so the full list of changes is on the changelog page if you want to read it (www.rgraph.net/changelog.html). Since the gap has been so long there may well be things that I've overlooked or forgotten to check so if you find anything - please let me know. Worthy of note though, I think, is the fact that I've used the Xenu Link Sleuth tool (home.snafu.de/tilman/xenulink.html) to try to find as many broken links on the site as I can and clean them (and there were A LOT!) so maybe Google now will see my site as higher quality and move me up the rankings... Or perhaps I'm just destined to rot at the bottom of page 2 for ever. Hopefully it's the former though!
10 example charts to get you started with RGraphWritten by Richard Heyes, 5th June 2017
Here's 10 examples of SVG charts that you can make with RGraph to get you started and up and running. With these you can take the code and add your own configuration as required to help you cut the time required to get your charts looking the way you want. There's Bar, Line and Pie charts amongst others, so like the demos that are in the download, feel free to take the code, adapt it (or don't!) and use it yourself.
New stable version of RGraphWritten by Richard Heyes, 10th May 2017
On Sunday I added the latest version (4.62 stable) of RGraph to the website. You can download it from the download page (www.rgraph.net/download.html#stable). There's a new SVG Rose chart which has four distinct modes, various fixes to the SVG libraries. You can read the full changelog here: www.rgraph.net/changelog.html
10 good looking SVG charts that will set your pants on fire!Written by Richard Heyes, 6th March 2017
As with the canvas chart libraries creating good looking charts with the SVG libraries is not difficult at all. This is an article that shows you 10 examples of nice looking charts that have been made with the SVG libraries. You can find more good looking examples by browsing the demos that are included in the download archive.
A new stable release of RGraph is now availableWritten by Richard Heyes, 18th February 2017
I've just released a new version of RGraph - version 4.61. You can read the changelog
by clicking on the link. This release adds a new SVG based Scatter chart and Waterfall
chart. To go with the Scatter chart there's a new
function that accepts a wide variety of formats - eg: 2012-01-06 12:14:12 ,
6 Jan 2012 12:14 , 31st , January 2012 12:14:12 , 31st January 2012 , 31st January ,
January 31 , 2012 January 31 . You can read the full list of changes on the changelog.
SVG style paths for canvas with the RGraph path() functionWritten by Richard Heyes, 3rd September 2015
As stated elsewhere canvas paths are (unnecessarily) verbose. The W3C has attempted to
aid the issue by introducing support for SVG paths in the new
This new object, however, is not currently widely supported. So RGraph provides a
work-around using the
RGraph.path() function. This is a description of that
function and a version of it that has been extracted from the RGraph code and works
9 Good looking charts that you can find in the demosWritten by Richard Heyes, 16th August 2015
Creating good looking charts isn't terribly difficult - for some people. If like me you're rather limited in graphical abilities then creating attractive charts is not always as straight-forward as it sounds.If you have a graphical designer on hand it can be easy - simply ask them for a mock-up that you can copy the graphical styling from or present them with a chart and say "Make it look pretty!". But if you're not fortunate enough to have a graphical designer to hand then you're on your own. Almost, (by the way, on a completely unrelated side-note did you know that Google Image Search is a very good tool). Just thought I would throw that in to the mix.