はじめに
今回は、多彩なグラフを表示できるjQueryプラグイン「jQPlot」を解説します。この「jQPlot」最大の特長はこのプラグイン専用の多種多様な機能拡張スクリプトが揃っていること。そうしたスクリプトを使うことで、棒グラフ、折れ線グラフ、円グラフといった基本的なグラフのみならず、ドーナツグラフ、バブルチャートなど、多彩なグラフを描くことができます。
対象読者
- jQueryプラグインに興味があり、使ってみたい方
必要な環境と準備
執筆時点のjQueryの最新版は、1.8.1です。第1回を参考に、ダウンロードしてください。また、jQueryプラグインの基本的な使い方は、第3回を参照してください。
サンプルでは、htmlファイルと同じ階層に「plugins」というフォルダを作成し、「jQPlot」プラグインや機能拡張のスクリプトはこのフォルダに置きます。
jQPlotの基本的な使い方
jQPlotプラグインは、jQPlot専用の機能拡張を用いることにより、多種多様なグラフを描くことができます。まずはごく簡単な折れ線グラフを例に、基本的な使い方を見てみましょう。
jQuery Visualizeプラグインの使い方
jQPlotプラグインのダウンロードサイト上の「Download Now!」アイコンをクリックして、現時点での最新バージョン「jquery.jqplot.1.0.4r1120.zip」をダウンロードし、解凍します。解凍したフォルダ内の「dist」フォルダ直下からプラグイン本体の「jquery.jqplot.min.js」とバージョン9以前のInternet ExplorerでHTML5のcanvas要素を呼び出す「excanvas.min.js」を「plugins」フォルダ下に配置します。また「dist」フォルダ内の「plugins」フォルダにある機能拡張スクリプトも必要なものを「plugins」フォルダ下に配置します。そして解凍したフォルダ内の「css」フォルダをそのままコピーして使用します。
折れ線グラフを表示する際のjQPlotプラグインの使用例をリスト1に示します。
<!DOCTYPE html> <html> <head> <meta charset=UTF-8" /> <title>jQueryプラグイン(jQPlot) 折れ線グラフサンプル</title> <!--1.jQueryの読み込み--> <script language="javascript" type="text/javascript" src="./Scripts/jquery-1.8.1.min.js"></script> <!--2.IE9以前のバージョンへの対応--> <!--[if lt IE 9]> <script language="javascript" type="text/javascript" src="./plugins/excanvas.min.js"></script> <![endif]--> <!--3.プラグインの読み込み--> <script language="javascript" type="text/javascript" src="./plugins/jquery.jqplot.min.js"></script> <!--4.CSSの読み込み--> <link rel="stylesheet" type="text/css" href="./css/jquery.jqplot.min.css" /> </head> <body> <h1>jQueryプラグイン(jQPlot)折れ線グラフサンプル</h1> <!--5.プラグインの設定--> <script> jQuery(function(){ jQuery.jqplot( 'line', [ [[1,25],[2,94],[3,68],[4,81],[5,34]] ] ); } ); </script> <div id="line" style="height: 350px; width: 350px;"></div>
1.jQueryの読み込みで「Scripts」フォルダ内のjQuery本体「jquery-1.8.1.min.js」を呼び出した後、2.IE9以前のバージョンへの対応では、IE9より前のバージョンのIEでHTML5のcanvas要素を呼び出すため、「excanvas.min.js」を呼び出します。次に3.プラグインの読み込みで「plugin」フォルダ内のjQueryプラグイン「jquery.jqplot.min.js」を呼び出します。そして4.CSSの読み込みでcssファイルを呼び出します。
5.プラグインの設定では「jQuery(function(){});」の中に「jQuery.jqplot();」と記載し、jQPlotプラグインを機能させます。()内の「'line'」は後でdivタグを使ってグラフを表示するための適当な文字列をIDとして指定します。その後の[]内に折れ線グラフの点の数値を指定します。数値の指定方法は線で繋ぐ一つ一つの点のデータを[]内に[横軸の値,縦軸の値]といった形で記述し、これらのデータを[]で囲みます。
あとはdivタグで、「id='line'」といった記述で事前にIDとして指定した文字列を指定し、グラフの高さと幅を指定すれば、折れ線グラフを表示できます。