Summary: チャートでキーを使うことについてのドキュメントです。 キーは、識別する必要のある複数のデータセットがある場合に使用できます。 インタラクティブ キーは、これをさらに強化することができます

  • はじめに
  • キー構成プロパティ
  • アクティブ キー要素
  • グラフでインタラクティブ キーを使用するHTML キー

はじめに

チャート上でキーを使用すると、チャート上に表示されているデータセットが何を表しているかについての情報を提供することができます。

キーは、チャートの余白に配置するように設計された水平のものと、チャートの上に配置するように設計された垂直のものの2つのモードで使用することができます。

キー設定プロパティ

利用可能なキー プロパティとそのデフォルトを以下に示します(チャート タイプによっては、デフォルトが若干異なる場合があります)。

Key properties

Property Description Default
key キー要素の配列(これはキーで表示するテキストになります。 (空の配列)
keyHalign キーの水平方向の配置 right
keyPosition キーの位置/レイアウトが決定されます。 graph
keyPositionMarginBoxed false
keyPositionGraphBoxed key がグラフ モードのときボックスの中にあるかどうかを決定します。 true
keyPositionX これでキーのX座標を指定することができます。 null
keyPositionY これにより、キーのY座標を指定できます。 false
keyShadowOffsetx シャドウのXオフセットをコントロールします。 2
keyShadowOffsety これは、シャドウのYオフセットをコントロールします。 #666
keyShadowBlur シャドウに適用されるぼかしを制御します。 3
keyColors 計算された色が見たい色でない場合、これは独自の色を指定できます。 null
keyColorShape これはカラーブロブが取る形です。 四角形(形状の配列も可能)
keyBackground キーの背景を指定します。 white
keyRounded キーの角を四角にするか丸くするか。 true
keyLinewidth キーに使用する線幅を指定します。 1
keyLabelsFont キーのテキストに使用されるフォントです。
keyLabelsColor キー内のテキストの色。 black
keyLabelsBold キー内のテキストが太字かどうかを指定します。 false
keyLabelsItalic キー内のテキストがイタリックかどうか。 false
keyLabelsOffsetx キーテキストへのX座標に適用されるオフセットを指定します。 0
keyLabelsOffsety キーテキストのY座標に適用されるオフセットです。 0
keyTextAccessible デフォルトでは、キー テキストはアクセスできませんが、この設定を使用すると、これを上書きすることができます。 すべてのチャートタイプがこれをサポートしているわけではありません。 false
keyInteractiveHighlightChartFill インタラクティブキーでチャートをハイライトするために使用するハイライトフィル色 rgba(255,255,255,0.0).7)
keyInteractiveHighlightChartStroke The highlight stroke color used to highlight the chart by the interactive key. black
key
A array of key elements (this is the text that is displayed in the key.
Default.Of the key elements: (空の配列)
keyHalign
キーの水平アライメント
Default: right
keyPosition
キーの位置/レイアウトを決定する。
Default: graph
keyPositionMarginBoxed
key が margin モードの場合、ボックス内に配置されるかどうかを決定します。
Default: false
keyPositionGraphBoxed
key が graph モードの場合、ボックスに配置かどうかを決定します。
Default: true
keyPositionX
key のX座標を設定することが可能です。
Default: null
keyPositionY
キーのY座標を指定します。
Default: null
keyShadow
キーに影があるかないかを制御します。
Default: false
keyShadowOffsetx
これは、シャドウのXオフセットを制御します。
Default: 2
keyShadowOffsety
これは、シャドウのYオフセットを制御します。
Default: 3
keyColors
計算された色が見たい色でない場合、これは独自の色を指定することができます。
Default: null
keyColorShape
これは色の塊が取る形状を表します。
Default: square (can be a array of shapes)
keyBackground
The background of the key.
Default: white
keyRounded
keys of the corners are square or rounded.これは、キーの角が四角か丸かどうかを指定します。
Default: true
keyLinewidth
キーに使用される線幅.
Default: 1
keyLabelsFont
キーテキストに使用するフォント.
Default: 1
keyLabelsFont
キーに使用するフォント.Definition: true
Default: 1
keyLabelFontkeyLabelsSize
キーのテキストの大きさ.
Default:
keyLabelsColor
キー中のテキストの色
Default: black
keyLabelsBold
キー中のテキストが太字かどうか。
Default: false
keyLabelsItalic
キー内のテキストがイタリックかどうか。
Default: false
keyLabelsOffsetx
キーテキストへのX座標に適用されるオフセットを指定します。
Default: 0
keyLabelsOffsety
キーテキストのY座標に適用されるオフセット。
Default: 0
keyTextAccessible
デフォルトではキーテキストはアクセスできませんが、この設定によりこれをオーバーライドできます。
Default: false
keyInteractiveHighlightChartFill
インタラクティブキーでチャートをハイライトするために使用されるハイライト塗りつぶし色
Default: rgba(255,255,255,0.7)
keyInteractiveHighlightChartStroke
HighlightStroke 色は、インタラクティブ キーでチャートをハイライトするために使用されます。 したがって、イベント リスナーでは、次のようにキー エントリを判断できます。

key = RGraph.Registry.get('key-element');

そして、このような使い方ができます。

// Assume that the  variable is your line chart objectline.canvas.onmousemove = function (e){ var key = RGraph.Registry.get('key-element'); if (key) { // Log the details of the object to the console console.log(key); }};

Using interactive keys on your charts

Note: インタラクティブ キーは、キーに DOM テキストではなく、標準のキャンバス テキストを使用します。 必要に応じて textAccessible を有効にすることができますが、対話型キーはこれを無視します。

以前は、対話型キーは線グラフと円グラフに対してのみ実装されていました。 しかし、2013 年半ばの時点で書き直され、より多くのチャート タイプで利用できるようになりました。 インタラクティブ・キーのデモ・ページがダウンロード・アーカイブにあります。

書き直されたインタラクティブキーは、描画 API Rect オブジェクトとダイナミックライブラリを使用するようになりました。

<script src="RGraph.common.core.js"></script><script src="RGraph.common.dynamic.js"></script><script src="RGraph.common.key.js"></script><script src="RGraph.drawing.rect.js"></script><script> line = new RGraph.Line({ id: 'cvs', data: , , ], options: { xaxisLabels: , tickmarksStyle: 'endcircle', linewidth: 3, xaxisTickmarksCount: 12, spline: true, key: , keyPosition: 'margin', keyInteractive: true, textSize: 14 } }).draw();</script>

HTML キー

2013 年 12 月に RGraph に機能が追加され、チャートの横に HTML ベースのキーを使用できるようになりました。 このキーは DIV タグと SPAN タグで構成されているため、より簡単に操作できると思われます。 HTMLキーについては、こちらのページで詳しく解説しています。

コメントを残す

メールアドレスが公開されることはありません。