
|
|
棒グラフウィジェットは、プラットフォーム内の標準ウィジェットとして、および SDK からインポート可能な Web コンポーネントとして使用できます。
|
|
X 軸
|
Y 軸の値
|
Y 軸の値 N
|
|
|---|---|---|---|
|
フィールド定義
|
x:{name:'x',baseType:'STRING'}
|
value1:{name:'value1',baseType:'NUMBER'}
|
value2:{name:'value2',baseType:'NUMBER'}
|
|
使用
|
グラフの棒 (列) の X 軸の値を定義します。データのベースタイプは STRING でなければなりません。各行が X 軸上にカテゴリとして表示されます。この列に定義されている名前は、XAaxisField ウィジェットプロパティに選択する必要があるオプションです。
|
カテゴリの Y 軸の値と凡例ラベルを定義します。
|
追加した各データ系列の Y 軸の値と凡例ラベルを定義します。
|
|
ベースタイプ
|
STRING
|
NUMBER
|
NUMBER
|
|
行の例
|
x: 'Apple' - ここで、Apple は X 軸に表示するカテゴリ名
|
value1: 10 - カテゴリの Y 軸の値
|
value2: 30 - 2 つ目のデータ系列の Y 軸の値
|


|
|
大文字と小文字が区別されます。たとえば、"M" は月を表し、"m" は分を表します。
|
|
|
そのサービスがランタイムにイベントによってトリガーされることを確認します。
|
|
|
チャートデータをランタイムに自動的に更新するには、自動再表示関数を作成し、チャートデータを返すデータサービスにバインドします。詳細については、自動再表示を参照してください。
|

|
|
デフォルトでは、すべてのデータがプライマリ軸に表示されます。
|
|
プロパティ名
|
説明
|
ベースタイプ
|
デフォルト値
|
バインド可能か(Y/N)
|
ローカライズ可能か(Y/N)
|
|---|---|---|---|---|---|
|
SecondYAxis
|
セカンダリ Y 軸をチャートに追加します。
|
BOOLEAN
|
false
|
Y
|
N
|
|
SecondYAxisLabel
|
セカンダリ Y 軸のテキストラベルを指定します。
|
STRING
|
セカンダリ Y 軸
|
Y
|
Y
|
|
SecondYAxisLabelAlignment
|
セカンダリ Y 軸のラベルを整列します。ラベルの位置を「上」、「中間」、または「下」に設定できます。デフォルトでは、ラベルは中間に配置されます。
|
STRING
|
中間
|
いいえ
|
N
|
|
SecondYAxisFormat
|
セカンダリ Y 軸の値のフォーマットを設定します。このプロパティを使用して、データの表示形式を指定できます。たとえば、小数点以下の表示桁数を設定できます。
|
STRING
|
0000.0
|
Y
|
N
|
|
SecondYAxisMaxValue
|
セカンダリ Y 軸の値の最大範囲を設定します。デフォルトでは、範囲は自動的に計算され、すべてのデータが表示されます。
|
NUMBER
|
該当なし
|
Y
|
N
|
|
SecondYAxisMinValue
|
セカンダリ Y 軸の値の最大範囲を設定します。デフォルトでは、ウィジェットのデータに基づいて、範囲が自動的に計算されます。
|
NUMBER
|
該当なし
|
Y
|
N
|
|
UseSecondYAxis1..n
|
データ系列 n の値をセカンダリ Y 軸上に表示します。このプロパティは、NumberOfSeries を Auto から固定の数値に変更した場合に使用できます。
|
BOOLEAN
|
false
|
N
|
N
|
|
YAxisRulerAlignment
|
ルーラー線の基準として使用する Y 軸を指定します。プライマリ Y 軸またはセカンダリ Y 軸のデータ値マーカーとルーラー線を整列できます。
|
STRING
|
プライマリ Y 軸
|
Y
|
N
|
|
SecondYAxisSeriesDisplay
|
チャート上のセカンダリ Y 軸でデータ系列をどのように積み上げるかを制御します。値を積み上げて結合するか、合計値のパーセントとして積み上げるか、値をグループ化できます。デフォルトでは、データ系列はグループ化されます。
|
STRING
|
グループ
|
Y
|
N
|
|
プロパティ名
|
説明
|
ベースタイプ
|
デフォルト値
|
バインド可能か(Y/N)
|
ローカライズ可能か(Y/N)
|
||
|---|---|---|---|---|---|---|---|
|
ChartType
|
チャートのタイプを「棒グラフ」または「縦棒グラフ」に設定します。
|
STRING
|
棒グラフ
|
N
|
N
|
||
|
CustomClass
|
ウィジェットの最上位の div に適用するユーザー定義の CSS クラス。
スペースで区切って、複数のクラスを入力できます。
|
STRING
|
該当なし
|
Y
|
N
|
||
|
Data
|
チャートのインフォテーブルのデータソース。
|
INFOTABLE
|
該当なし
|
Y
|
N
|
||
|
DataField1 - DataField24
|
これらのプロパティは、NumberOfSereis を固定の数値に設定した場合にリストされます。これらのプロパティを使用して、各データ系列に使用するインフォテーブル列を選択できます。
|
インフォテーブル列
|
該当なし
|
N
|
N
|
||
|
DataLabel1 - DataLabel24
|
これらのプロパティは、NumberOfSereis を特定の数値に設定した場合にリストされます。これらのプロパティを使用して、凡例内のデータ系列ごとにカスタムラベルを指定できます。詳細については、チャートの凡例のカスタマイズを参照してください。
|
STRING
|
該当なし
|
N
|
Y
|
||
|
DataSeriesStyle
|
状態フォーマットのコンフィギュレーションダイアログボックスが開きます。このプロパティは、NumberOfSeries が「自動」に設定されている場合に表示されます。状態定義がチャート上のすべての系列に適用されます。
|
状態定義
|
該当なし
|
N
|
N
|
||
|
DataSeriesStyle1 - DataSeriesStyle24
|
これらのプロパティは、プロパティ NumberOfSereis に設定した数値に基づいてリストされます。これらのプロパティを使用して、チャート上のデータ系列ごとに別々の状態定義を適用できます。
|
状態定義
|
該当なし
|
N
|
|||
|
Disabled
|
マッシュアップ内のウィジェットを無効にします。
ウィジェットはマッシュアップ内に表示されますが、クリックまたは選択はできません。
|
BOOLEAN
|
false
|
Y
|
N
|
||
|
DirectSelectionZoom
|
グラフ上で 2 つのデータアイテムを選択することでズームインできます。
このプロパティに使用可能なオプションは、「水平軸」、「垂直軸」、「両方」、「なし」です。
このプロパティは HorizontalZoom を選択した場合にプロパティリストに表示されます。
|
STRING
|
なし
|
Y
|
N
|
||
|
DragSelectionZoom
|
表示するデータ範囲を囲むように選択ボックスを描画することで、グラフの特定の部分にズームインできます。
このプロパティに使用可能なオプションは、「水平軸」、「垂直軸」、「両方」、「なし」です。
このプロパティは HorizontalZoom を選択した場合にプロパティリストに表示されます。
|
STRING
|
なし
|
Y
|
N
|
||
|
EmptyChartIcon
|
チャートが空の場合に表示するアイコンを指定します。
|
メディアエンティティ
|
not visible
|
N
|
N
|
||
|
EmptyChartLabel
|
チャートが空の場合に表示するテキストを指定します。
|
STRING
|
[[ChartStateLabelEmpty]]
|
N
|
Y
|
||
|
ErrorStateIcon
|
チャートが空の場合に表示するアイコンを指定します。
|
メディアエンティティ
|
error
|
N
|
N
|
||
|
ErrorStateLabel
|
チャートが空の場合に表示するテキストを指定します。
|
STRING
|
N
|
Y
|
|||
|
LoadingIcon
|
チャートのデータがロード中である場合に表示するアイコンを指定します。
|
メディアエンティティ
|
chart loading icon
|
N
|
N
|
||
|
NoDataSourceIcon
|
チャートがデータソースにバインドされていない場合に表示するアイコンを指定します。
|
メディアエンティティ
|
bind
|
N
|
N
|
||
|
NoDataSourceLabel
|
チャートがデータソースにバインドされていない場合に表示するテキストを指定します。
|
STRING
|
[[ChartStateLabelNoData]]
|
N
|
Y
|
||
|
ExternalPadding
|
軸からのパディングを設定します。
パディングは棒の幅の割合で指定します。
|
NUMBER
|
25
|
Y
|
N
|
||
|
GroupPadding
|
データ系列のグループ間のパディングを設定します。
パディングは棒の幅の割合で指定します。
|
NUMBER
|
25
|
Y
|
N
|
||
|
HideLegend
|
凡例領域を非表示にします。
このプロパティを選択した場合、プロパティ LegendAlignment、LegendFilter、LegendMarkerShapes、LegendMaxWidth、および LegendPosition はプロパティリストに表示されません。
|
BOOLEAN
|
false
|
Y
|
N
|
||
|
HideDataTooltips
|
チャート上のデータポイントにマウスポインタを合わせるか、チャート上のデータポイントを選択すると表示されるツールヒントを非表示にします。
|
BOOLEAN
|
false
|
N
|
N
|
||
|
HideNotes
|
注記領域を非表示にします。
このプロパティを選択した場合、プロパティ Notes、NotesAlignment、および NotesPosition はプロパティリストに表示されません。
|
BOOLEAN
|
false
|
Y
|
N
|
||
|
HideValues
|
グラフ上のすべての値ラベルを非表示にします。
|
BOOLEAN
|
false
|
Y
|
N
|
||
|
HideXAxis
|
X 軸を非表示にします。
|
BOOLEAN
|
false
|
Y
|
N
|
||
|
HideYAxis
|
Y 軸を非表示にします。
|
BOOLEAN
|
false
|
Y
|
N
|
||
|
HorizontalAxisMaxHeight
|
水平軸の最大高さを設定します。
|
NUMBER
|
85
|
Y
|
N
|
||
|
HorizontalAxisLabelsRotation
|
水平軸上のラベルの回転角度を設定します。-180 から 180 の範囲の値を入力できます。
|
NUMBER
|
自動サイズ調整
|
N
|
N
|
||
|
HorizontalZoom
|
水平軸にズームインできます。
このプロパティを選択した場合、プロパティ HorizontalIntervalControl、HorizontalRangeZoom、HorizontalSliderZoom、DirectSelectionZoom、および DragSelectionZoom がプロパティリストに表示されます。
|
BOOLEAN
|
false
|
Y
|
N
|
||
|
HorizontalIntervalControl
|
特定の間隔で水平軸にズームインできる制御を追加します。
使用可能なオプションは「なし」 (デフォルトの選択) と「ドロップダウンリスト」です。
「ドロップダウンリスト」を選択した場合、プロパティ HorizontalIntervalControlLabel および HorizontalIntervalData がプロパティリストに表示されます。
|
STRING
|
なし
|
N
|
N
|
||
|
HorizontalIntervalControlLabel
|
水平軸の間隔ズーム制御のテキストラベルを指定します。
|
STRING
|
該当なし
|
Y
|
Y
|
||
|
HorizontalIntervalData
|
間隔ズーム制御オプションのデータソース。
水平間隔ドロップダウンリストからエントリを選択すると、選択した期間の値と開始/終了アンカー点に従ってグラフがズームインされます。
|
INFOTABLE
|
該当なし
|
Y
|
N
|
||
|
HorizontalIntervalAnchorPoint
|
データセット内の間隔範囲のアンカー位置を選択できます。
「開始」を選択してデータセットの先頭に間隔を配置するか、「終了」を選択して末尾に間隔を配置します。
たとえば、12 カ月のデータセットで 3 カ月の間隔を指定する場合、「開始」を選択して最初の 3 カ月分のデータセットを表示するか、「終了」を選択して最後の 3 カ月分のデータセットを表示できます。
このプロパティはプロパティ ShowHorizontalAnchorPointControl を選択した場合に表示されます。
|
STRING
|
開始
|
Y
|
N
|
||
|
HorizontalIntervalAnchorPointLabel
|
水平軸の間隔アンカー点のラベルを指定します。
このプロパティはプロパティ ShowHorizontalAnchorPointControl を選択した場合に表示されます。
|
STRING
|
該当なし
|
Y
|
Y
|
||
|
HorizontalRangeZoom
|
水平軸にズームインする値範囲を指定できる制御を追加します。
このプロパティを選択した場合、以下のプロパティ HorizontalStartZoomLabel および HorizontalEndZoomLabel がプロパティリストに表示されます。
|
BOOLEAN
|
false
|
Y
|
N
|
||
|
HorizontalRangeZoomDateFormat
|
範囲選択ズームを使用するときの日付選択ボックス内の日付の形式を設定します。サポートされる形式は Moment.js JavaScript ライブラリに基づいており、大文字と小文字が区別されます。
|
STRING
|
該当なし
|
N
|
N
|
||
|
HorizontalRangeZoomDateWidth
|
ズームが有効になったときの、水平軸上の日付選択ボックスの幅を設定します。
|
NUMBER
|
332px
|
N
|
N
|
||
|
HorizontalStartZoomLabel
|
範囲選択の開始位置のテキストラベルを指定します。
|
STRING
|
該当なし
|
Y
|
Y
|
||
|
HorizontalEndZoomLabel
|
範囲選択の終了位置のテキストラベルを指定します。
|
STRING
|
該当なし
|
Y
|
Y
|
||
|
HorizontalSliderZoom
|
水平軸上の最小値と最大値の間のデータを表示可能なスライダーコントロールを追加します。
このプロパティを選択した場合、プロパティ HorizontalSliderZoomMaxLabel および HorizontalSliderZoomMinLabel がプロパティリストに表示されます。
|
BOOLEAN
|
false
|
Y
|
N
|
||
|
HorizontalSliderZoomMaxLabel
|
スライダーズーム制御の最大値のラベルを指定します。
|
STRING
|
該当なし
|
Y
|
Y
|
||
|
HorizontalSliderZoomMinLabel
|
スライダーズーム制御の最小値のラベルを指定します。
|
STRING
|
該当なし
|
Y
|
Y
|
||
|
InternalPadding
|
データ系列間のパディングを設定します。
パディングは棒の幅の割合で指定します。
|
NUMBER
|
25
|
Y
|
N
|
||
|
Label
|
棒グラフのラベルテキストを表示します。
|
STRING
|
棒グラフ
|
Y
|
Y
|
||
|
LabelType
|
棒グラフのラベルタイプとして、「ヘッダー」、「サブヘッダー」、「ラベル」、または「本文」を選択します。
|
STRING
|
サブヘッダー
|
Y
|
N
|
||
|
LabelAlignment
|
棒グラフウィジェットのラベルを、「左」、「中央」、または「右」に整列します。
|
STRING
|
左
|
N
|
N
|
||
|
LabelPosition
|
ラベルの位置を、「上」または「下」に設定します。
|
STRING
|
上
|
N
|
N
|
||
|
LabelReset
|
ズームコントロールのリセットボタンに表示されるラベルを設定します。
|
STRING
|
リセット
|
Y
|
Y
|
||
|
LegendAlignment
|
凡例テキストを、「上」、「中間」、または「下」に整列します。
このプロパティで使用できるオプションは、LegendPosition プロパティの設定によって異なります。
|
STRING
|
上
|
N
|
N
|
||
|
LegendFilter
|
ランタイムにユーザーがチャートをフィルタできるように、凡例フィルタを追加します。
|
BOOLEAN
|
false
|
N
|
N
|
||
|
LegendMarkerShapes
|
凡例のマーカーシェイプを「四角形」または「円」に設定します。
|
STRING
|
四角形
|
N
|
N
|
||
|
LegendMaxWidth
|
凡例領域の最大幅を設定します。
|
NUMBER
|
736
|
Y
|
N
|
||
|
LegendPosition
|
凡例の位置を、「上」、「下」、「左」、または「右」に設定します。
|
STRING
|
右
|
N
|
N
|
||
|
MultipleDataSources
|
グラフ系列に複数のデータソースを使用します。これにより、複数のソースからのデータをグラフに表示できます。
|
BOOLEAN
|
false
|
N
|
N
|
||
|
Notes
|
グラフの注記領域内に表示するテキストを指定します。文字列を入力するか、ローカライズトークンを選択できます。
|
STRING
|
該当なし
|
Y
|
Y
|
||
|
NotesAlignment
|
注記領域内で注記テキストを「左」、「右」、または「中央」に整列します。
|
STRING
|
左
|
N
|
N
|
||
|
NumberOfReferenceLines
|
チャートに表示する基準線の数を指定します。最大 24 本の基準線を追加できます。基準線ごとに、追加のプロパティが追加されます。
|
NUMBER
|
Y
|
N
|
N
|
||
|
ReferecneLineNLabel
|
基準線のテキストラベルを設定します。
|
STRING
|
Y
|
Y
|
N
|
||
|
ReferecneLineNValue
|
基準線の値を設定します。軸のタイプに基づいて数値または日付の値を指定できます。
|
NUMBER または DATETIME
|
Y
|
N
|
N
|
||
|
ReferenceLineNAxis
|
基準線に使用する軸を指定します。このプロパティは、数値や日付の値などの連続データを持つ 2 本の軸がチャートに含まれている場合にのみ使用できます。
|
STRING
|
N
|
N
|
N
|
||
|
ReverseYAxis
|
Y 軸の値を逆の順序で表示します。
|
BOOLEAN
|
false
|
N
|
N
|
||
|
RulersInFront
|
データ値の前にルーラーを表示します。デフォルトでは、ルーラーはデータの後ろに表示されます。
|
BOOLEAN
|
false
|
Y
|
N
|
||
|
SeriesClicked
|
データポイントをクリックするとイベントがトリガーされます。
|
該当なし
|
該当なし
|
Y
|
N
|
||
|
SeriesDisplay
|
複数のデータ系列をグラフに表示するときの方法を制御します。「積み上げ」または「グループ」を使用して、各系列のデータ値を積み上げるかグループ化することができます。データ系列を合計値に対する割合として表示するには、「100% 積み上げ」を選択します。
|
STRING
|
グループ
|
Y
|
N
|
||
|
ShowHorizontalAnchorPointControl
|
水平軸のアンカー値を調整するための制御を追加します。
このプロパティを選択した場合、プロパティ HorizontalIntervalAnchorPoint および HorizontalIntervalAnchorPointLabel がプロパティリストに表示されます。
|
BOOLEAN
|
false
|
Y
|
N
|
||
|
ShowHideLegend
|
ランタイムでのチャートの凡例の表示/非表示を切り替える表示/非表示ボタンを追加します。
|
BOOLEAN
|
false
|
N
|
N
|
||
|
ShowXAxisRuler
|
X 軸ルーラーを表示します。
|
BOOLEAN
|
false
|
Y
|
N
|
||
|
ShowYAxisRuler
|
Y 軸ルーラーを表示します。
|
BOOLEAN
|
false
|
Y
|
N
|
||
|
ShowZeroValueRuler
|
ゼロの値のルーラーを表示します。
|
BOOLEAN
|
false
|
Y
|
N
|
||
|
ShowZoomButtons
|
水平ズームまたは垂直ズームが有効になっている場合に、チャートツールバーにズームインボタンとズームアウトボタンを表示します。
|
BOOLEAN
|
false
|
N
|
N
|
||
|
SparkView
|
グラフを簡略表示します。このプロパティを有効にすると、ラベル、凡例、およびルーラーが非表示になります。
|
BOOLEAN
|
false
|
Y
|
N
|
||
|
TabSequence
|
Tab キーを押したときの、棒グラフウィジェットのシーケンス番号。
|
NUMBER
|
該当なし
|
N
|
N
|
||
|
ValuesPosition
|
グラフの棒を基準としたデータ値ラベルの位置を「棒の外側」または「棒の内側」に設定します。
|
STRING
|
棒の外側
|
N
|
N
|
||
|
VerticalAxisMaxWidth
|
垂直軸の最大幅を設定します。
|
NUMBER
|
85
|
Y
|
N
|
||
|
VerticalZoom
|
垂直軸にズームインできます。
このプロパティを選択した場合、プロパティ VerticalSliderZoom がプロパティリストに表示されます。
|
BOOLEAN
|
false
|
Y
|
N
|
||
|
VerticalSliderZoom
|
垂直軸上の最小値と最大値の間のデータを表示可能なスライダーコントロールを追加します。
このプロパティを選択した場合、プロパティ VerticalZoomMaxLabel および VerticalZoomMinLabel がプロパティリストに表示されます。
|
BOOLEAN
|
false
|
Y
|
N
|
||
|
VerticalZoomMaxLabel
|
スライダーズーム制御の最大値のテキストラベルを指定します。
|
STRING
|
該当なし
|
Y
|
Y
|
||
|
VerticalZoomMinLabel
|
スライダーズーム制御の最小値のテキストラベルを指定します。
|
STRING
|
該当なし
|
Y
|
Y
|
||
|
XAxisField
|
X 軸の棒のコンテンツを表すインフォテーブルフィールド。
プロパティ MultipleDataSources を選択した場合、複数の XAxisField インフォテーブルソースがプロパティリストに表示されます。
|
INFOTABLE
|
該当なし
|
N
|
N
|
||
|
XAxisLabel
|
X 軸のテキストラベルを表示します。
|
STRING
|
X 軸
|
Y
|
Y
|
||
|
XAxisLabelAlignment
|
X 軸のラベルを「上」、「中間」、または「下」に整列します。
|
STRING
|
中間
|
N
|
N
|
||
|
YAxisFormat
|
Y 軸の値のフォーマットを設定します。
|
STRING
|
0000.0
|
Y
|
N
|
||
|
YAxisLabel
|
Y 軸のテキストラベルを表示します。
|
STRING
|
Y 軸
|
Y
|
Y
|
||
|
YAxisLabelAlignment
|
Y 軸ラベルを、「左」、「右」、または「中央」に整列します。
|
STRING
|
左
|
N
|
N
|
||
|
YAxisMaximumValues
|
Y 軸の値の最大範囲を設定します。
デフォルトでは、範囲はウィジェットデータに基づいて自動的に計算されます。グラフデータにこれより大きい値が含まれている場合、このプロパティの値は無視されます。
|
STRING
|
該当なし
|
Y
|
N
|
||
|
YAxisMinimumValues
|
Y 軸の値の最小範囲を設定します。
デフォルトでは、範囲はウィジェットデータに基づいて自動的に計算されます。グラフデータにこれより小さい値が含まれている場合、このプロパティの値は無視されます。
|
STRING
|
該当なし
|
Y
|
N
|
||
|
YAxisValuesFormat
|
Y 軸の値ラベルのフォーマットを設定します。
このプロパティは、HideValues を False に設定した場合に使用できます。
|
STRING
|
Y
|
N
|