bricks/docs/ja/line.md

ChartLine

コントロール機能：折れ線グラフを表示するためのコントロール。ECharts を拡張して実装されており、データソース、フィールドマッピング、グラフオプションの設定に基づいて、複数の折れ線を動的に生成するデータ可視化をサポートしています。
タイプ：通常コントロール
親コントロール：bricks.EchartsExt

初期化パラメータ

パラメータ名	型	説明
data_url	文字列	（任意）グラフデータを取得するAPIのURL。指定した場合、自動的にデータをリクエストします。
data_params	オブジェクト	（任意）リクエスト時に送信するパラメータ。data_urlと併用します。
method	文字列	（任意）データ取得時に使用するHTTPメソッド。デフォルトは 'GET'。
data	配列	（任意）直接渡す静的データ配列。オブジェクトの配列形式。例：[{ name: 'A', value1: 10, value2: 20 }]
line_options	オブジェクト	（任意）追加のEChartsシリーズ設定項目。ラインスタイルやアニメーションなどのカスタマイズに使用します。
nameField	文字列	X軸に表示するデータ内のフィールド名を指定します（例：時間やカテゴリーフィールド）。
valueFields	配列	1つ以上の数値フィールドを指定します。各フィールドに対して1本の折れ線が生成されます。例：['sales', 'profit']

注：data と data_url のいずれか一方を指定できます。両方が存在する場合は、data_url を優先してデータを取得します。

主なイベント

• load
  発火タイミング：コントロールの初期化後、データの読み込み・レンダリングが成功した後に発火します。
  コールバックパラメータ：{ chart: EChartsインスタンス, data: 現在レンダリングされたデータ }
  使用用途：チャート描画後にカスタム処理を実行するために使用できます（例：マークポイントの追加、外部とのインタラクション連携など）。

• click
  発火タイミング：ユーザーがチャート内の特定の点をクリックしたときに発火します。
  コールバックパラメータ：EChartsのネイティブclickイベントオブジェクト。seriesName、name、value、data などの情報を含みます。
  使用用途：データポイントの詳細表示や、他のコンポーネントとの連動操作などを実装する際に使用します。

• datafetch
  発火タイミング：data_url からデータを正常に取得した後、レンダリングする前に発火します。
  コールバックパラメータ：{ data: サーバーから返された生データ }
  使用用途：データの加工処理前にデータを捕捉・変更する際に使用します。