IM-BloomMaker グラフエレメントの使い方（基本編）

このCookBookでは、intra-mart Accel Platform 2019 Winter から利用可能になった IM-BloomMaker のグラフエレメントの使い方について紹介しています。
折れ線グラフを例にグラフエレメントの使い方を説明します。

グラフエレメントは、Highcharts を利用してグラフを表示するエレメントです。
Highcharts の仕様については、Highcharts が公開している以下のリファレンスを参照してください。
https://api.highcharts.com/highcharts/

完成サンプル

以下の完成サンプルをダウンロードしてご活用ください。
IM-BloomMakerのインポート機能を利用してインポートしてください。

画面サンプルインポートファイル : cookbook_169226.zip
ローカル環境で表示させる場合は、以下のURLにアクセスしてください。
http://localhost:8080/imart/bloommaker/designer/im_cookbook_169226?css-framework=imui&content-definition-type=content
なおベースURLである以下の部分は、環境に合わせて適宜変更してください。
http://localhost:8080/imart

レシピ

この CookBook で行う内容を以下に示します。

1. グラフに表示するデータを作成する
2. グラフエレメントを配置し、データを設定する
3. プロパティを編集し、グラフの見た目を整える

1. グラフに表示するデータを作成する

• デザイナ画面の右ペインの変数タブを開き、プルダウンが「変数」になっていることを確認してください。
  

• 以下の JSON を JSON エディタに貼り付けて変数を作成してください。

2. グラフを配置し、データを設定する

• エレメントパレットの「グラフ」から、「折れ線グラフ」をページに配置してください。
  

• 配置した「折れ線グラフ」エレメントを選択し、右ペインの「プロパティ」タブを開いてください。
  

• 「series」プロパティに「$variable.series」を設定してください。
  

3. プロパティを編集し、グラフの見た目を整える

• 「title」プロパティに「Transition in smartphone ownership rate (Japan)」を設定してください。
  

• 「yAxisTitle」プロパティに「Number of people」を設定してください。
  

• 「yAxisLabelsFormat」に「{value} %」を設定してください。
  

yAxisLabelsFormat プロパティでグラフのY軸のラベルのフォーマットを変更することができます。
「{value}」 は Highcharts が用意している変数で、Y軸の値を保持しています。
例えば、Y軸が距離を表す場合は、「{value} km」のように入力することで、Y軸のラベルに「km」の単位を表示することができます。

• 「xAxisCategories」に「2011,2012,2013,2014,2015,2016」を設定してください。
  

xAxisCategories プロパティは、X軸のラベルに表示する文字列を指定するプロパティです。
固定値の場合は、ラベルに表示したい文字列をカンマ区切りで入力してください。
入力した文字列がカンマ区切りで分割され、X軸の左から順番に割り当てられます。

変数値の場合は、文字列型の変数か、配列を設定してください。
文字列型の変数の場合は、固定値と同様に文字列がカンマ区切りで分割されX軸に割り当てられます。
配列の場合は、配列の要素がX軸の左から順番に割り当てられます。

以上で、グラフエレメントの設定は完了です。
必要に応じて、その他のプロパティを編集してください。
「プレビュー」ボタンをクリックして、配置したグラフエレメントの動作確認を行ってください。
グラフ上のポイントにマウスオーバーすると、そのポイントの情報がツールチップで表示されます。
グラフの下部にある凡例をクリックすると、対象のデータ要素の表示/非表示を切り替えることができます。