数式による標準スパークライン
以下の関数を数式に使用することで、折れ線スパークライン、縦棒スパークライン、または勝敗スパークラインを作成できます。=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"), { sheetCount: 3 });
spread.options.allowDynamicArray = true;
initSheet(spread.sheets[0]);
initSheet1(spread.sheets[1]);
initSheet2(spread.sheets[2]);
};
function initSheet(sheet) {
sheet.name("Line Sparkline");
sheet.suspendPaint();
sheet.setArray(2, 1, data[0]);
for(var i=4;i<14;i++)
{
sheet.setFormula(i-1, 8, '=LINESPARKLINE(C'+i+':H'+i+',1,,,"{showMarkers:true}")');
sheet.setRowHeight(i-1,30);
}
//format sheet
sheet.addSpan(0, 1, 1, 8);
sheet.getCell(0, 1).value("Sales by Country").font("bold 15px Arial")
.backColor("#DDDDDD");
sheet.setRowHeight(0,45);
sheet.getRange(2, 1, 1, 8)
.font("bold 13px Arial")
.setBorder(new GC.Spread.Sheets.LineBorder("black", GC.Spread.Sheets.LineStyle.thin), { bottom: true });
sheet.getRange(3, 2, 10, 6)
.formatter("$#,##0");
for(var j=2;j<8;j++)
{
sheet.setColumnWidth(j,80);
}
sheet.setColumnWidth(1,120);
sheet.setColumnWidth(8,150);
sheet.getRange(0, 0, 15, 9).vAlign(GC.Spread.Sheets.VerticalAlign.center);
sheet.resumePaint();
};
function initSheet1(sheet) {
sheet.name("Column Sparkline");
sheet.suspendPaint();
sheet.setArray(2, 1, data[1]);
for(var i=4;i<14;i++)
{
sheet.setFormula(i-1, 8, '=COLUMNSPARKLINE(C'+i+':H'+i+',1)');
sheet.setRowHeight(i-1,30);
}
//format sheet
sheet.addSpan(0, 1, 1, 8);
sheet.getCell(0, 1).value("Sales Data").font("15px Arial")
.backColor("#DDDDDD");
sheet.setRowHeight(0,45);
sheet.getRange(2, 1, 1, 8)
.font("bold 13px Arial")
.setBorder(new GC.Spread.Sheets.LineBorder("black", GC.Spread.Sheets.LineStyle.thin), { bottom: true });
sheet.getRange(3, 2, 10, 6)
.formatter("$#,##0");
for(var j=2;j<8;j++)
{
sheet.setColumnWidth(j,80);
}
sheet.setColumnWidth(1,120);
sheet.setColumnWidth(8,150);
sheet.getRange(0, 0, 15, 9).vAlign(GC.Spread.Sheets.VerticalAlign.center);
sheet.resumePaint();
};
function initSheet2(sheet) {
sheet.name("Winloss Sparkline");
sheet.suspendPaint();
sheet.getCell(2, 1).text("Target (tasks per week):").font("14px Arial");
sheet.getCell(2, 2).value(5).font("bold 14px Arial");
sheet.setArray(4, 1, data[2]);
for(var i=6;i<16;i++)
{
sheet.setFormula(i-1, 8, '=WINLOSSSPARKLINE(C'+i+':H'+i+'-$C$3,1,,,"{showNegative:true}")');
sheet.setRowHeight(i-1,30);
}
//format sheet
sheet.addSpan(0, 1, 1, 8);
sheet.getCell(0, 1).value("Employee Performance").font("15px Arial")
.backColor("#DDDDDD");
sheet.setRowHeight(0,45);
sheet.getRange(4, 1, 1, 8)
.font("bold 13px Arial")
.setBorder(new GC.Spread.Sheets.LineBorder("black", GC.Spread.Sheets.LineStyle.thin), { bottom: true });
sheet.setColumnWidth(1,180);
sheet.setColumnWidth(8,120);
sheet.getRange(0, 0, 15, 9).vAlign(GC.Spread.Sheets.VerticalAlign.center);
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/@mescius/spread-sheets/styles/gc.spread.sheets.excel2013white.css">
<script src="$DEMOROOT$/ja/purejs/node_modules/@mescius/spread-sheets/dist/gc.spread.sheets.all.min.js" type="text/javascript"></script>
<script src="$DEMOROOT$/ja/purejs/node_modules/@mescius/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="$DEMOROOT$/spread/source/data/standard-sparklines.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;
}
