2.5 KiB
2.5 KiB
ChartBar
コントロール機能:棒グラフ(Bar Chart)を表示するためのもので、ECharts を拡張して実装されています。指定されたデータソースからデータを取得し、複数系列の棒グラフを動的に描画できます。
タイプ:通常コントロール
親クラスコントロール:bricks.EchartsExt
初期化パラメータ
| パラメータ名 | 型 | 説明 |
|---|---|---|
data_url |
文字列 | 任意。チャートデータを非同期で読み込むためのリクエストURL。 |
data_params |
オブジェクト | データリクエスト時に送信する追加パラメータ。data_urlと併用します。 |
method |
文字列 | データリクエストの方法。例:'GET'または'POST'。デフォルトは'GET'。 |
data |
配列 | 任意。直接ローカルのデータ配列を渡す場合に使用。オブジェクトの配列形式で、各オブジェクトが1レコードを表します。 |
nameField |
文字列 | X軸のカテゴリ名(例:分類、時間など)として使用するフィールドを指定します。 |
valueFields |
配列 | 文字列の配列。Y軸の数値として使用する1つ以上のフィールドを指定し、複数のデータシリーズ(series)を生成します。 |
データ構造の例:
[ { "category": "A", "value1": 10, "value2": 20 }, { "category": "B", "value1": 15, "value2": 25 } ]
nameField = "category"、valueFields = ["value1", "value2"]の場合、2つの棒グラフシリーズが生成されます。
主なイベント
| イベント名 | 発生タイミング | コールバックパラメータの説明 |
|---|---|---|
chart:loaded |
チャートデータの読み込みが完了し、正しく描画された後に発生 | event.detailには、元のデータと最終的に生成されたEChartsの設定オプション(options)が含まれます。 |
chart:error |
データの読み込み失敗または解析エラーが発生した際に発生 | event.detailには、message、url、statusなどのエラー情報が含まれます。 |
注:イベントはカスタムイベント機構を通じて発行されます。
addEventListener('chart:loaded', handler)のようにしてイベントを監視できます。