bricks/docs/ja/bar.md
2025-11-19 12:30:39 +08:00

2.5 KiB
Raw Permalink Blame History

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には、messageurlstatusなどのエラー情報が含まれます。

注:イベントはカスタムイベント機構を通じて発行されます。addEventListener('chart:loaded', handler)のようにしてイベントを監視できます。