数式による標準スパークライン
以下の関数を数式に使用することで、折れ線スパークライン、縦棒スパークライン、または勝敗スパークラインを作成できます。=LINESPARKLINE(data, dataOrientation, dateAxisData?, dateAxisOrientation?, setting?), =COLUMNSPARKLINE(data, dataOrientation, dateAxisData?, dateAxisOrientation?, setting?), =WINLOSSSPARKLINE(data, dataOrientation, dateAxisData?, dateAxisOrientation?, setting?)
有効なパラメータは次のとおりです。
data: スパークラインのデータを表すセル範囲の参照。「A1:C3」など。
dataOrientation: スパークラインデータの方向を表す数値。次のいずれかです。
vertical - 0
horizontal - 1
dateAxisData: (オプション)スパークラインの日付軸データを表すセル範囲の参照。「D1:F3」など。
dateAxisOrientation: (オプション)スパークラインの日付軸の方向を表す数値。次のいずれかです。
vertical - 0
horizontal - 1
setting: (オプション)JSON書式を使用した文字列。個々の要素は、GC.Spread.Sheets.Sparklines.SparklineSettingと同じ定義を持ちます。
作成したスパークラインに対しては、表示する値の種類(最大値、最小値、最初の値、最後の値、すべての負の値など)の定義、スパークラインの種類(折れ線、縦棒、勝敗)の変更、スタイルの適用、水平軸の表示/非表示の切り替えなどを行えます。
折れ線スパークラインでは、一部、またはすべてのマーカーを表示して、個々のデータマーカー(値)を強調できます。
showFirst:このスパークライングループにおいて、どのスパークラインでも、最初のデータポイントだけを異なる書式で表示するかどうかを指定します。
showHigh:このスパークライングループにおいて、どのスパークラインでも、最も高い値のデータポイントだけを異なる書式で表示するかどうかを指定します。
showLast:このスパークライングループにおいて、どのスパークラインでも、最後のデータポイントだけを異なる書式で表示するかどうかを指定します。
showLow:このスパークライングループにおいて、どのスパークラインでも、最も低い値のデータポイントだけを異なる書式で表示するかどうかを指定します。
showNegative:このスパークライングループにおいて、どのスパークラインでも、負のデータポイントだけを異なる書式で表示するかどうかを指定します。
showMarkers:このスパークライングループにおいて、各スパークラインにデータマーカーを表示するかどうかを指定します。
スパークラインのスタイルおよび書式を変更するには、以下のプロパティを使用します。
axisColor:軸の色
firstMarkerColor:このスパークライングループに含まれる各スパークラインの、最初のデータポイントの色
highMarkerColor:このスパークライングループに含まれる各スパークラインの、最大値のデータポイントの色
lastMarkerColor:このスパークライングループに含まれる各スパークラインの、最後のデータポイントの色
lowMarkerColor:このスパークライングループに含まれる各スパークラインの、最低値のデータポイントの色
markersColor:このスパークライングループに含まれる各スパークラインの、データマーカーの色
negativeColor:このスパークライングループに含まれる各スパークラインの、負の値のデータポイントの色
seriesColor:このスパークライングループに含まれる各スパークラインの色
スパークラインでは、その他の設定も行えます。たとえば、グラフのデータ系列に、空の値が含まれていることがあります。displayEmptyCellsAsオプションを使用すると、次の例に示すように、空白のセルを表示する方法を指定できます。
次のサンプルコードは、これらの設定を適用する方法を示します。
window.onload = function () {
var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"));
initSpread(spread);
};
function initSpread(spread) {
var spreadNS = GC.Spread.Sheets;
var sheet = spread.sheets[0];
sheet.suspendPaint();
for (var i = 2; i < 14; i++) {
sheet.setValue(i, 0, new Date(2020, i-2, 1));
}
sheet.setFormatter(-1, 0, "MMM");
sheet.setArray(1, 0, [["Month","Revenue (mln)","Line","Columns","Winloss"]
]);
sheet.setArray(2, 1, [[10],[20],[50],[100],[30],[-10],[-25],[60],[50],[30],[80],[88]]);
//styling
sheet.setColumnWidth(1,110);
sheet.setColumnWidth(2,200);
sheet.setColumnWidth(3,200);
sheet.setColumnWidth(4,200);
sheet.addSpan(2, 2, 12, 1);
sheet.setFormula(2, 2, '=LINESPARKLINE(B3:B14,0,A3:A14,0,"{displayXAxis:true}")');
sheet.addSpan(2, 3, 12, 1);
sheet.setFormula(2, 3, '=COLUMNSPARKLINE(B3:B14,0,A3:A14,0,"{displayXAxis:true}")');
sheet.addSpan(2, 4, 12, 1);
sheet.setFormula(2, 4, '=WINLOSSSPARKLINE(B3:B14,0,A3:A14,0,"{displayXAxis:true}")');
sheet.setRowHeight(0, 25);
sheet.addSpan(0, 0, 1, 5);
sheet.getCell(0, 0).value("Company Revenue 2020")
.font("17px Arial")
.vAlign(spreadNS.VerticalAlign.center)
.backColor("#82BC00")
.foreColor("white");
sheet.getRange(1, 0, 1, 5)
.font("bold 13px Arial")
.setBorder(new spreadNS.LineBorder("black", spreadNS.LineStyle.thin), { bottom: true });
sheet.resumePaint();
};
<!doctype html>
<html style="height:100%;font-size:14px;">
<head>
<meta name="spreadjs culture" content="ja-jp" />
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="stylesheet" type="text/css" href="$DEMOROOT$/ja/purejs/node_modules/@grapecity/spread-sheets/styles/gc.spread.sheets.excel2013white.css">
<script src="$DEMOROOT$/ja/purejs/node_modules/@grapecity/spread-sheets/dist/gc.spread.sheets.all.min.js" type="text/javascript"></script>
<script src="$DEMOROOT$/ja/purejs/node_modules/@grapecity/spread-sheets-resources-ja/dist/gc.spread.sheets.resources.ja.min.js" type="text/javascript"></script>
<script src="$DEMOROOT$/spread/source/js/license.js" type="text/javascript"></script>
<script src="app.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="styles.css">
</head>
<body>
<div class="sample-tutorial">
<div id="ss" style="width:100%;height:100%"></div>
</div></body>
</html>
.sample-tutorial {
position: relative;
height: 100%;
overflow: hidden;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}