source: Dev/trunk/RGraph/docs/gutters.html @ 77

Last change on this file since 77 was 77, checked in by fpvanagthoven, 14 years ago

RGraph
File size: 10.4 KB
Line 
1<?php ob_start('ob_gzhandler') ?>
2<!DOCTYPE html >
3<html>
4<head>
5    <meta http-equiv="X-UA-Compatible" content="chrome=1">
6    <!--
7        /**
8        * o------------------------------------------------------------------------------o
9        * | This file is part of the RGraph package - you can learn more at:             |
10        * |                                                                              |
11        * |                          http://www.rgraph.net                               |
12        * |                                                                              |
13        * | This package is licensed under the RGraph license. For all kinds of business |
14        * | purposes there is a small one-time licensing fee to pay and for non          |
15        * | commercial  purposes it is free to use. You can read the full license here:  |
16        * |                                                                              |
17        * |                      http://www.rgraph.net/LICENSE.txt                       |
18        * o------------------------------------------------------------------------------o
19        */
20    -->
21    <title>RGraph: Javascript charts and graph library - Variable gutter sizes</title>
22   
23    <meta name="keywords" content="rgraph html5 canvas chart docs variable gutter sizes" />
24    <meta name="description" content="RGraph: Javascript charts and graph library - Variable gutter sizes" />
25   
26    <meta property="og:title" content="RGraph: Javascript charts and graph library" />
27    <meta property="og:description" content="A charts library based on the HTML5 canvas tag" />
28    <meta property="og:image" content="http://www.rgraph.net/images/logo.jpg"/>
29
30    <link rel="stylesheet" href="../css/website.css" type="text/css" media="screen" />
31    <link rel="icon" type="image/png" href="../images/favicon.png">
32   
33    <script src="../libraries/RGraph.common.core.js" ></script>
34    <script src="../libraries/RGraph.common.tooltips.js" ></script>
35    <script src="../libraries/RGraph.common.context.js" ></script>
36    <script src="../libraries/RGraph.common.zoom.js" ></script>
37    <script src="../libraries/RGraph.bar.js" ></script>
38    <!--[if IE 8]><script src="../excanvas/excanvas.original.js"></script><![endif]-->
39   
40    <script>
41        window.onload = function (e)
42        {
43            var bar = new RGraph.Bar('cvs', [0.2,0.2,0.5,0.6,0.5,0.3,0.5,0.1,0.2,0.7,4.2,3.5]);
44            bar.Set('chart.ymax', 5);
45            bar.Set('chart.labels', ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December']);
46            bar.Set('chart.tooltips', ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December']);
47            bar.Set('chart.text.angle', 45);
48            bar.Set('chart.contextmenu', [['Zoom in', RGraph.Zoom]]);
49            bar.Set('chart.zoom.hdir', 'left');
50            bar.Set('chart.title', '2010 statistics (tooltips)');
51            bar.Set('chart.ylabels.specific', ['100,000','10,000','1,000','100','10']);
52            bar.Set('chart.background.grid.autofit', true);
53            bar.Set('chart.background.grid.autofit.align', true);
54            bar.Set('chart.title.vpos', 0.5);
55
56            bar.Set('chart.gutter.left', 65);
57            bar.Set('chart.gutter.right', 5);
58            bar.Set('chart.gutter.bottom', 60);
59
60            bar.Draw();
61        }
62    </script>
63
64    <script>
65      var _gaq = _gaq || [];
66      _gaq.push(['_setAccount', 'UA-54706-2']);
67      _gaq.push(['_trackPageview']);
68   
69      (function() {
70        var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
71        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
72        var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
73      })();
74    </script>
75   
76    <style>
77        ol li {
78            margin-top: 0;
79        }
80    </style>
81
82</head>
83<body>
84
85    <!-- Social networking buttons -->
86        <div id="social_icons" class="warning" style="border-radius: 10px; top: 1px; position: fixed">
87            <a title="Bookmark with delicious" href="http://delicious.com/save?jump=close&v=4&noui&jump=close&url=http://www.rgraph.net&notes=RGraph%20is%20a%20HTML5%20based%20javascript%20charts%20library%20supporting%20a%20wide%20range%20of%20different%20charts%20types&title=RGraph:Javascript%20charts%20and%20graphs%20library" target="_blank"><img src="../images/delicious.png" alt="Bookmark with delicious" width="22" height="22" border="0" align="absmiddle" /></a>
88            <a href="http://twitter.com/home/?status=RGraph%3A%20Javascript+charts+and+graph+library+http%3A%2F%2Fwww.rgraph.net+%23rgraph+%23html5+%23canvas+%23javascript+%23charts+@_rgraph" target="_blank"><img src="../images/twitter.png" id="twitter_icon" alt="tweet this site" width="22" height="22" border="0" align="absmiddle" /></a>
89        </div>
90
91        <script>
92            // Opera fix
93            if (navigator.userAgent.indexOf('Opera') == -1) {
94              document.getElementById("social_icons").style.position = 'fixed';
95            }
96        </script>
97    <!-- Social networking buttons -->
98
99    <div id="breadcrumb">
100        <a href="../index.html">RGraph: Javascript charts and graph library</a>
101        >
102        <a href="index.html">Documentation</a>
103        >
104        Variable gutter sizes
105    </div>
106
107    <h1>RGraph: <span>Javascript charts and graph library</span> - Variable gutter sizes</h1>
108
109    <script>
110        if (RGraph.isIE8()) {
111            document.write('<div style="background-color: #fee; border: 2px dashed red; padding: 5px"><b>Important</b><br /><br /> Internet Explorer 8 does not natively support the HTML5 canvas tag, so if you want to see the charts, you can either:<ul><li>Install <a href="http://code.google.com/chrome/chromeframe/">Google Chrome Frame</a></li><li>Use ExCanvas. This is provided in the RGraph Archive.</li><li>Use another browser entirely. Your choices are Firefox 3.5+, Chrome 2+, Safari 4+ or Opera 10.5+. </li></ul> <b>Note:</b> Internet Explorer 9 fully supports the canvas tag. Click <a href="http://support.rgraph.net/message/rgraph-in-internet-explorer-9.html" target="_blank">here</a> to see some screenshots.</div>');
112        }
113    </script>
114
115    <ul>
116        <li>
117            <a href="#upgrading">Upgrading from a previous version of RGraph</a>
118        </li>
119    </ul>
120
121    <canvas id="cvs" width="620" height="300" style="border: 1px dashed gray; float: right">[No canvas support]</canvas>
122   
123    <p>
124        New in June 2011 is the much requested feature of seperate gutter sizing. As the chart to the right shows, this means
125        that you can now easily set the left/right/top/bottom gutters independently. This makes it easy to give
126        yourself the space that you need for labels, which will be most noticeable with the Bar chart, the Line chart
127        and similar chart types. There is another example on the <a href="../examples/hbar.html#gutter-example">HBar example page</a>.
128    </p>
129   
130    <p>
131        Because of the fundamental nature of this change (every chart type has been affected)
132        you should rigorously test your charts if you choose to upgrade.
133    </p>
134   
135    <p>
136        The new properties are:
137    </p>
138   
139    <ul>
140        <li>chart.gutter.left</li>
141        <li>chart.gutter.right</li>
142        <li>chart.gutter.top</li>
143        <li>chart.gutter.bottom</li>
144    </ul>
145   
146    <p>
147         They all default to 25 pixels (with a few exceptions) and each can be set independently.
148    </p>
149   
150    <p>
151        These new properties eliminate the need for certain others. So starting immediately the following properties are no longer
152        used:
153    </p>
154   
155    <ul>
156        <li>chart.gutter</li>
157        <li>chart.width</li>
158        <li>chart.height</li>
159        <li>chart.tooltips.coords.adjust</li>
160        <li>chart.resize.handle.adjust</li>
161    </ul>
162   
163    <p>
164        The <i>chart.gutter</i> property has been completely removed, so you will need to start using the new properties immediately.
165        The <i>chart.width</i> and <i>chart.height</i> properties are completely unused from this point and the last two
166        will be phased out starting immediately.
167    </p>
168
169        <br clear="all" />
170
171        <pre class="code">
172&lt;script&gt;
173        window.onload = function (e)
174        {
175            var bar = new RGraph.Bar('cvs', [0.2,0.2,0.5,0.6,0.5,0.3,0.5,0.1,0.2,0.7,4.2,3.5]);
176            bar.Set('chart.ymax', 5);
177            bar.Set('chart.labels', ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December']);
178            bar.Set('chart.tooltips', ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December']);
179            bar.Set('chart.text.angle', 45);
180            bar.Set('chart.contextmenu', [['Zoom in', RGraph.Zoom]]);
181            bar.Set('chart.zoom.hdir', 'left');
182            bar.Set('chart.title', '2010 statistics (tooltips)');
183            bar.Set('chart.ylabels.specific', ['100,000','10,000','1,000','100','10']);
184            bar.Set('chart.background.grid.autofit', true);
185            bar.Set('chart.background.grid.autofit.align', true);
186            bar.Set('chart.title.vpos', 0.5);
187
188            <span style="color: green">bar.Set('chart.gutter.left', 65);
189            bar.Set('chart.gutter.right', 5);
190            bar.Set('chart.gutter.bottom', 60);</span>
191
192            bar.Draw();
193        }
194&lt;/script&gt;
195</pre>
196
197    <a name="upgrading"></a>
198    <h2>Upgrading from a previous version of RGraph</h2>
199   
200    <p>
201        If you're upgrading from a previous version of RGraph then there are a few points you should bear in mind:
202    </p>
203   
204    <ol>
205        <li>
206            Remove any calls to .translate().
207            If you use the .translate() method to give yourself extra space, this should be converted to the new gutter properties.
208        </li>
209       
210        <li>
211            If you use <i>chart.tooltips.coords.adjust</i> or <i>chart.resize.handle.adjust</i> then you should remove them. These
212            properties will cease to have any effect eventually, but not immediately.
213        </li>
214       
215        <li>
216            If you use caching, then you may need to use a CTRL/SHIFT+Refresh on your page to bypass any cached copy of the RGraph
217            libraries.
218        </li>
219    </ol>
220</body>
221</html>
Note: See TracBrowser for help on using the repository browser.