[]
        
(Showing Draft Content)

Wijmo_Chart.Flexchart

FlexChart クラス

FlexChart コントロールは、データを視覚化する強力で柔軟な方法を提供します。

FlexChart コントロールを使用して、棒グラフ、折れ線グラフ、シンボルチャート、 バブルチャートなどのさまざまな形式でデータを表示するチャートを作成できます。

FlexChart コントロールを使用するには、FlexChart.itemsSource プロパティに データオブジェクトから成る配列を設定してから、1つ以上のSeries オブジェクトを FlexChart.series プロパティに追加します。

FlexChart.chartType プロパティを使用して、すべての系列でデフォルトとして 使用されるChartType を定義します。FlexChart.series 配列のメンバのSeries.chartType プロパティを設定することで、系列ごとにチャートタイプを オーバーライドできます。

階層

コンストラクタ

constructor

  • new FlexChart(element: any, options?: any): FlexChart
  • FlexChart クラスの新しいインスタンスを初期化します。

    引数

    • element: any

      コントロールをホストするDOM要素、またはホスト要素のCSS セレクター(例: '#theCtrl')。

    • オプション options: any

      コントロールの初期化データを含むJavaScriptオブジェクト。

    戻り値 FlexChart

プロパティ

axes

Axis オブジェクトのコレクションを取得します。

axisX

axisX: Axis

メインのX軸を取得または設定します。

axisY

axisY: Axis

メインのY軸を取得または設定します。

binding

binding: string

Yの値を含むプロパティの名前を取得または設定します。

bindingX

bindingX: string

Xデータ値を含むプロパティの名前を取得または設定します。

chartType

chartType: ChartType

作成するチャートのタイプを取得または設定します。

このプロパティのデフォルト値はChartType.Columnです。

collectionView

collectionView: ICollectionView

チャートデータを含むICollectionView オブジェクトを取得します。

dataLabel

dataLabel: DataLabel

ポイントのデータラベルを取得または設定します。

footer: string

チャートのフッタに表示されるテキストを取得または設定します。

footerStyle

footerStyle: any

チャートのフッタスタイルを取得または設定します。

header: string

チャートのヘッダに表示されるテキストを取得または設定します。

headerStyle

headerStyle: any

チャートのヘッダスタイルを取得または設定します。

interpolateNulls

interpolateNulls: boolean

データ内のnull値を補間するかどうかを決定する値を取得または設定します。

trueの場合は、隣接するポイントに基づいて、欠けているデータの値が補間されます。 falseの場合は、null値のあるポイントで、線や領域に切れ目ができます。

このプロパティのデフォルト値は falseです。

itemFormatter

itemFormatter: Function

チャート要素の外観をカスタマイズするための項目書式設定関数を取得または設定します。

指定されている場合、関数は、チャート上に要素を描画するIRenderEngine 、 描画する要素を記述するHitTestInfo パラメータ、 および項目のデフォルトの描画を提供する関数の3つのパラメータを受け取る必要があります。

次に例を示しています。v

itemFormatter: function (engine, hitTestInfo, defaultRenderer) {
  var ht = hitTestInfo,
      binding = 'downloads';

  // 正しい系列/要素であることを確認します
  if (ht.series.binding == binding && ht.pointIndex > 0 &&
      ht.chartElement == ChartElement.SeriesSymbol) {

    // 現在値と前の値を取得します
    var chart = ht.series.chart,
        items = chart.collectionView.items,
        valNow = items[ht.pointIndex][binding],
        valPrev = items[ht.pointIndex - 1][binding];

    // 値が増加している場合は行を追加します
    if (valNow > valPrev) {
      var pt1 = chart.dataToPoint(ht.pointIndex, valNow),
          pt2 = chart.dataToPoint(ht.pointIndex - 1, valPrev);
      engine.drawLine(pt1.x, pt1.y, pt2.x, pt2.y, null, {
        stroke: 'gold',
        strokeWidth: 6
      });
    }
  }

  // 要素を通常通りに描画します
  defaultRenderer();
}

itemsSource

itemsSource: any

チャートの作成に使用されるデータを含む配列またはICollectionView オブジェクトを取得または設定します。

legend

legend: Legend

チャートの凡例を取得または設定します。

legendToggle

legendToggle: boolean

凡例項目をクリックしたときにチャート上の系列の表示/非表示を切り替えるかどうかを示す値を取得または設定します。

このプロパティのデフォルト値はfalse です。

options

options: any

さまざまなチャートオプションを取得または設定します。

以下のオプションがサポートされます。

bubble.maxSize:バブルチャートのシンボルの最大サイズ を指定します。デフォルト値は30ピクセルです。

bubble.minSize:バブルチャートのシンボルの最小サイズ を指定します。デフォルト値は5ピクセルです。

chart.options = {
  bubble: { minSize: 5, maxSize: 30 }
}

funnel.neckWidth:ファンネルグラフのネックの幅をパーセント値で指定します。 デフォルト値は0.2です。

funnel.neckHeight:ファンネルグラフのネックの高さをパーセント値で指定します。 デフォルト値は0です。

funnel.type:ファンネルグラフのタイプを指定します。これは、'rectangle'または'default'である必要があります。 タイプがrectangleに設定されている場合、neckWidthとneckHeightは機能しません。

chart.options = {
  funnel: { neckWidth: 0.3, neckHeight: 0.3, type: 'rectangle' }
}

groupWidth:縦棒グラフのグループ幅または 横棒グラフのグループ高さを指定します。グループ幅は、ピクセル単位 または有効なスペースに対するパーセント値で指定できます。デフォルト値は'70%'です。

chart.options = {
  groupWidth : 50; // 50ピクセル
}
chart.options = {
  groupWidth : '100%'; // 100%ピクセル
}

palette

palette: string[]

系列の表示に使用されるデフォルトの色の配列を取得または設定します。

配列にはCSSの色を表す文字列が含まれています。 次に例を示します。

// 名前で指定された色を使用します
chart.palette = ['red', 'green', 'blue'];
// または、RGBA値で指定された色を使用します
chart.palette = [
  'rgba(255,0,0,1)',
  'rgba(255,0,0,0.8)',
  'rgba(255,0,0,0.6)',
  'rgba(255,0,0,0.4)'];

Palettes クラスにある事前定義されたパレットのセットを使用できます。次に例を示します。

chart.palette = Palettes.coral;

plotAreas

PlotArea オブジェクトのコレクションを取得します。

plotMargin

plotMargin: any

プロットマージン(ピクセル単位)を取得または設定します。

プロットマージンは、コントロールの端からプロット領域の端までの領域を表します。

デフォルトでは、この値は軸ラベルに必要なスペースに基づいて自動的に計算されますが、 コントロール内のプロット領域の位置を精密に制御したい場合(たとえば、 複数のチャートコントロールをページ上に整列させるときなど)はこれをオーバーライドできます。

このプロパティは数値またはCSSスタイルのマージン指定に設定できます。例:

// すべての側のプロットマージンを20ピクセルに設定します
chart.plotMargin = 20;
// 上側、右側、下側、左側のプロットマージンを設定します
chart.plotMargin = '10 15 20 25';
// 上側/下側(10px)および左側/右側(20px)のプロットマージンを設定します
chart.plotMargin = '10 20';

rotated

rotated: boolean

Xが垂直、Yが水平になるように軸を反転するかどうかを示す値を

取得または設定します。

このプロパティのデフォルト値はfalse です。

selection

selection: SeriesBase

選択されているチャート系列を取得または設定します。

selectionMode

selectionMode: SelectionMode

ユーザーがチャートをクリックしたときに何が選択されるかを示す列挙値を取得または設定します。

このプロパティのデフォルト値はSelectionMode.Noneです。

series

Series オブジェクトのコレクションを取得します。

stacking

stacking: Stacking

系列オブジェクトを積み重ねるかどうかを決定する値と、積み重ねる場合はその方法を取得または設定します。

このプロパティのデフォルト値はStacking.Noneです。

symbolSize

symbolSize: number

このFlexChart のすべてのSeriesオブジェクトに使用されるシンボルのサイズを取得または設定します。

このプロパティは、各Series オブジェクトのsymbolSizeプロパティによってオーバーライドできます。

このプロパティのデフォルト値は10 ピクセルです。

tooltip

tooltip: ChartTooltip

チャートのTooltip オブジェクトを取得します。

ツールチップの内容は、次のパラメータを含むテンプレートを使用して生成されます。

  • propertyName: このポイントによって表されるデータオブジェクトの任意のプロパティ。
  • seriesName: データポイントを含む系列の名前(FlexChartのみ)。
  • pointIndex: データポイントのインデックス。
  • value: データポイントのFlexChart の場合はy値、FlexPie の場合は項目値)。
  • x: データポイントのx値(FlexChartのみ)。
  • y: データポイントのy値(FlexChartのみ)。
  • name: データポイントの名前FlexChart の場合はx値、FlexPie の場合は凡例エントリ)。

テンプレートを変更するには、ツールチップのコンテンツプロパティに新しい値を割り当てます。 次に例を示します。

chart.tooltip.content = '<b>{seriesName}</b> ' +
   '<img src="resources/{x}.png"/><br/>{y}';

チャートのツールチップを無効にできます。それには、テンプレートを空の文字列に設定します。

tooltip プロパティを使用して、次のように、Tooltip.showDelayTooltip.hideDelay などの ツールチップパラメータをカスタマイズすることもできます。

chart.tooltip.showDelay = 1000;

詳細とオプションについては、ChartTooltip プロパティを参照してください。

メソッド

dataToPoint

  • dataToPoint(pt: any, y?: number): Point
  • Point をデータ座標からコントロール座標に変換します。

    引数

    • pt: any

      データ座標のPoint 、またはデータ座標のポイントのX座標。

    • オプション y: number

      ポイントのY座標(最初のパラメーターが数値の場合)。

    戻り値 Point

    The Point in control coordinates.

hitTest

  • 指定したポイントに関する情報を含む HitTestInfo オブジェクトを取得します。

    引数

    • pt: any

      調べるポイント(ウィンドウ座標単位)。

    • オプション y: number

      ポイントのY座標(最初のパラメーターが数値の場合)。

    戻り値 HitTestInfo

    A HitTestInfo object with information about the point.

onRendered

onRendering

onSelectionChanged

onSeriesVisibilityChanged

pageToControl

  • pageToControl(pt: any, y?: number): Point
  • ページ座標をコントロール座標に変換します。

    引数

    • pt: any

      ページ座標のポイントまたはページ座標のx値。

    • オプション y: number

      ページ座標のy値。 ptが数値型の場合、値は数値である必要があります。 ただし、ptがPoint型の場合は、yパラメータはオプションになります。

    戻り値 Point

pointToData

  • pointToData(pt: any, y?: number): Point
  • Point をコントロール座標からチャートデータ座標に変換します。

    引数

    • pt: any

      変換するポイント(コントロール座標単位)。

    • オプション y: number

      ポイントのY座標(最初のパラメーターが数値の場合)。

    戻り値 Point

    The point in chart data coordinates.

refresh

  • refresh(fullUpdate?: boolean): void
  • チャートを更新します。

    引数

    • オプション fullUpdate: boolean

      内容だけでなくコントロールのレイアウトも更新するかどうかを示す値。

    戻り値 void

saveImageToDataUrl

  • saveImageToDataUrl(format: ImageFormat, done: Function): void
  • チャートを画像ファイルに保存します。

    このメソッドはIEブラウザでは機能しないことにご注意ください。 IEのサポートが必要な場合は、 flex-chart.render モジュールをページに追加してください。

    引数

    • format: ImageFormat

      エクスポートされる画像のImageFormat

    • done: Function

      データURLの生成後に呼び出される関数。この関数は、引数としてデータURLに渡されます。

    戻り値 void

saveImageToFile

  • saveImageToFile(filename: string): void
  • チャートを画像ファイルに保存します。

    このメソッドはIEブラウザでは機能しないことにご注意ください。 IEのサポートが必要な場合は、 flex-chart.render モジュールをページに追加してください。

    引数

    • filename: string

      拡張子を含む、エクスポートされる画像ファイルの名前。サポートされているタイプは、PNG、JPEG およびSVGです。

    戻り値 void

イベント

rendered

rendered: Event

チャートのレンダリングが完了した後に発生します。

rendering

rendering: Event

チャートデータのレンダリングが開始される前に発生します。

selectionChanged

selectionChanged: Event

プログラムコードまたはユーザーがチャートをクリックしたことによって選択が変更された後に発生します。 これは、たとえば詳細情報を示すテキストボックスを更新して現在の 選択を表示するような場合に役立ちます。

seriesVisibilityChanged

seriesVisibilityChanged: Event

系列の表示/非表示が変更されたときに発生します。たとえば、legendToggleプロパティをtrueに設定したり、ユーザーが凡例をクリックしたときです。