Web Components チャート データ ツールチップ
Ignite UI for Web Components では、DataToolTip は、シリーズの値とタイトル、およびシリーズの凡例バッジをツールチップに表示します。さらに、シリーズの行と値の列をフィルタリングし、値をスタイル設定し、書式を設定するための IgcDataLegendComponent
の多くの構成プロパティを提供します。このツールチップ タイプは、IgcCategoryChartComponent
、IgcFinancialChartComponent
、および IgcDataChartComponent
コンポーネントのプロット領域内でマウスを動かすと更新されます。
Web Components データ ツールチップのプロパティ
IgcDataToolTipLayerComponent
のすべてのプロパティには DataToolTip のプレフィックスが付けられ、IgcCategoryChartComponent
および IgcFinancialChartComponent
コンポーネントの API で公開されます。ただし、ラジアル チャート、極座標チャート、散布図で使用する場合は、IgcDataToolTipLayerComponent
のインスタンスを作成し、それを IgcDataChartComponent
コンポーネントのシリーズ コレクションに追加する必要があります。
Web Components データ ツールチップの要素
DataToolTip は、3 種類の行と 4 種類の列のセットを使用してコンテンツを表示します。
Web Components データ ツールチップの行
DataToolTip の行には、ヘッダー行、シリーズ行、および集計行が含まれます。
ヘッダー行には、ホバーされたポイントの軸ラベルが表示され、dataToolTipHeaderText
プロパティを使用して変更できます。
シリーズ行は、実際には、チャートにプロットされた各シリーズに対応する行のセットにすることができます。これらの行には、凡例バッジ、シリーズ タイトル、シリーズの実際の値 / 省略値、および指定されている場合は省略記号と単位が表示されます。
最後に、すべてのシリーズ値の合計を表示する集計行があります。デフォルトの集計タイトルは、凡例の dataToolTipSummaryTitleText
プロパティを使用して変更できます。また、dataToolTipSummaryType
プロパティを使用して、シリーズ値の合計、最小、最大、または平均を集計行に表示するかどうかをカスタマイズできます。
次の例は、集計が適用されたデータ ツールチップを示しています。
Web Components データ ツールチップの列
IgcDataToolTipLayerComponent
の列には、タイトル、ラベル、値、および単位の列が含まれます。チャートの各シリーズには、凡例の dataToolTipIncludedColumns
または dataToolTipExcludedColumns
コレクションに応じて、ラベル、値、および単位の複数の列を含めることができます。
タイトル列には、チャートにプロットされた各 IgcSeriesComponent
の title
プロパティに由来する凡例バッジとシリーズ タイトルが表示されます。
ラベル列には、ツールチップの dataToolTipIncludedColumns
または dataToolTipExcludedColumns
コレクション内のさまざまなプロパティパスの名前または省略形が表示されます。
値の列には、一連の値が省略形のテキストとして表示されます。この省略形は、dataToolTipValueFormatAbbreviation
プロパティを使用して書式設定でき、このプロパティを Auto
または Shared
に設定することですべての数値に同じ省略形を適用できます。または、ユーザーは Independent
、Kilo
、Million
などの他の省略形を選択できます。省略値の精度は、最小桁数と最大桁数にそれぞれ dataToolTipValueFormatMinFractions
と dataToolTipValueFormatMaxFractions
を使用して制御されます。
単位の列には、省略記号や単位のテキストが表示されます。これらは、すべての列に dataToolTipUnitsText
を設定するか、チャートの各系列で次のプロパティを使用して、DataToolTip で設定できます:
- カテゴリ シリーズ (例: ColumnSeries):
- ValueMemberAsLegendUnit="K"
- 財務物価シリーズ:
- OpenMemberAsLegendUnit="K"
- LowMemberAsLegendUnit="K"
- HighMemberAsLegendUnit="K"
- CloseMemberAsLegendUnit="K"
- 範囲シリーズ:
- LowMemberAsLegendUnit="K"
- HighMemberAsLegendUnit="K"
- ラジアル シリーズ:
- ValueMemberAsLegendUnit="km"
- 極座標シリーズ:
- RadiusMemberAsLegendUnit="km"
- AngleMemberAsLegendUnit="degrees"
上記のプロパティには、前述のラベル列のテキストを決定するための MemberAsLegendLabel で終わる対応するプロパティがあります。
dataToolTipIncludedColumns
および dataToolTipExcludedColumns
コレクションに含まれる列は、通常、基になるデータ項目の値パスに対応しますが、ファイナンシャル シリーズには、正しくプロットするために必要な High
、Low
、Open
、Close
パス、および、いくつかの特別なパスを含めるオプションがあります 。ツールチップ内に TypicalPrice
、Change
、および Volume
オプションを表示することができます。
次の例は、Open、High、Low、Close、および Change の列が追加されたデータ ツールチップを示しています。
Web Components データ チャートのデータ ツールチップのグループ化
DataLegendGroup
は、すべてのタイプのシリーズで、データ凡例内のシリーズ グループを分類する文字列に設定できます。各グループには、別のシリーズ グループが表示される前に、独自の集計行が表示されます。デフォルトでは、DataLegend はグループ名を非表示にしますが、GroupRowVisible
プロパティを true に設定するとグループ名を表示できます。データ ツールチップ レイヤーで groupingMode
を 「Grouped」 に設定し、labelDisplayMode
を 「Visible」 に設定する必要があります。
Web Components カテゴリ チャート & ファイナンシャル チャートのデータ ツールチップのグループ化と配置
dataToolTipGroupingMode
プロパティを Grouped
または Individual
に設定して、複数のシリーズのコンテンツを 1 つのツールチップにグループ化するか、各シリーズのコンテンツを複数のツールチップに分割することができます。Grouped
モードでは、dataToolTipGroupedPositionModeX
プロパティと dataToolTipGroupedPositionModeY
プロパティを設定することにより、ツールチップが表示される場所をカスタマイズできます。これにより、ツールチップの水平方向と垂直方向の配置を、マウス位置に最も近いシリーズ ポイントに追従させるか、プロット領域の端に固定するかをカスタマイズできます。
次の例は、チャートの右上に配置されたデータ ツールチップを示しています。
Web Components データ ツールチップ値の書式設定
DataToolTip は、その dataToolTipValueFormatAbbreviation
プロパティを使用して、大きな数の自動省略形を提供します。これにより、単位の列に kilo、million、billion などの乗数が追加されます。dataToolTipValueFormatMinFractions
および dataToolTipValueFormatMaxFractions
を設定することにより、表示される小数桁数をカスタマイズできます。これにより、小数点以下に表示される最小桁数と最大桁数をそれぞれ決定できます。
次の例は、最小分数と最大分数が設定された DataToolTip を示しています。
Web Components データ ツールチップの値モード
レイヤーの dataToolTipValueFormatMode
プロパティを変更することにより、DataToolTip 内の値のデフォルトの 10 進表示を通貨表示に変更できます。DataToolTip は、dataToolTipValueFormatCulture
プロパティを使用し、対応するカルチャ タグに設定することにより、表示されている通貨記号のカルチャを変更する機能も公開します。たとえば、次のサンプルは、dataToolTipValueFormatCulture
が 「en-GB」 に設定されたチャートを示しています。
Web Components データ ツールチップのスタイル設定
DataToolTip は、各タイプの列をスタイル設定するためのプロパティを提供します。これらの各プロパティ名は、Title、Label、Value、Units で始まり、テキストの色、フォント、およびマージンのスタイルを設定できます。たとえば、これらのそれぞれのテキストの色を設定する場合は、dataToolTipTitleTextColor
、dataToolTipLabelTextColor
、dataToolTipValueTextColor
、および dataToolTipUnitsTextColor
プロパティを設定します。
次の例は、上記のスタイル設定プロパティの使用法を示しています:
ツールチップのグループ化部分を含むいくつかのプロパティが公開されています。
GroupTextMargin
GroupTextColor
GroupTextFontSize
GroupTextFontFamily
GroupTextFontStyle
GroupTextFontStretch
GroupTextFontWeight
HeaderTextMargin
headerTextColor
HeaderTextFontSize
HeaderTextFontFamily
HeaderTextFontStyle
HeaderTextFontStretch
HeaderTextFontWeight
API リファレンス
dataToolTipExcludedColumns
dataToolTipGroupedPositionModeX
dataToolTipGroupedPositionModeY
dataToolTipGroupingMode
dataToolTipHeaderText
dataToolTipIncludedColumns
dataToolTipLabelTextColor
IgcDataToolTipLayerComponent
dataToolTipSummaryTitleText
dataToolTipSummaryType
dataToolTipTitleTextColor
dataToolTipUnitsTextColor
dataToolTipUnitsText
dataToolTipValueFormatAbbreviation
dataToolTipValueFormatCulture
dataToolTipValueFormatMaxFractions
dataToolTipValueFormatMaxFractions
dataToolTipValueFormatMinFractions
dataToolTipValueFormatMode
dataToolTipValueTextColor
MemberAsLegendLabel