基本应用 | 功能例子 | SpreadJS JavaScript 学习指南

要使用图表功能，请将SpreadJS Chart JS文件链接添加到文档的head部分您可以使用sheet.charts.add方法创建图表，如下所示：另外，您还可以指定图表的多个数据源：你可以通过 sheet.charts.get 方法来获取一个图表的实例，通过 sheet.charts.remove 方法来移除sheet上的一个图表，也可以通过 sheet.charts.clear 方法来清空sheet上的所有chart。一个图表是由许多子元素构成的，你可以通过chart的API来自定义它们: Chart Title: chart的标题你可以通过如下方式来获取或者设置一个chart的标题 (标题可设置的属性包括:text, back color, fore color, font and fontSize) Series: chart的系列你可以从chart的series collection中获取、添加或者移除一个系列, 也可以自定义一个系列的属性 (系列可设置的属性包括：name, border width, border color, yValue, xValue and fill color)，具体请参照如下的示例代码： Data Labels: 数据标签，用于标识数据点的详情你可以通过如下方式来获取或者设置一个chart的数据标签的样式 showValue showSeriesName showCategoryName showPercentage separator position format color transparency backColor backColorTransparency borderColor borderWidth borderColorTransparency SpreadJS 提供了28种chart类型，你可以获取当前chart的类型或者将它改为另一个不同的类型。 SpreadJS 图表支持对于空值单元格或#N/A值单元格的控制处理，如下。 gaps: 空值将被过滤 zero: 空值将被当做0值处理 connected: 空值将被过滤并且线形将跳过空值区域 SpreadJS 图表支持对于隐藏行列的控制处理，如下。 SpreadJS 支持导入时保留或者忽略不受支持的图标类型

<template>
<div class="sample-tutorial">
<gc-spread-sheets class="sample-spreadsheets" @workbookInitialized="initSpread">
<gc-worksheet />
</gc-spread-sheets>
<div class="options-container">
<p>
Highlight a range of cells, select a chart group and chart type then click “Add Chart” to add the chart to
the sheet.
Switch the axes with “Switch row/column” or remove the chart(s) with “Remove chart” or “Remove all charts”.
</p>
<div class="option-row">
<label>Group:</label>
<select id="groupSelect" style="width: 160px" v-model="groupType" @change="changeTypeSelect">
<option value="0">Column</option>
<option value="1">Line</option>
<option value="2">Pie</option>
<option value="3">Bar</option>
<option value="4">Area</option>
<option value="5">Scatter</option>
<option value="6">Stock</option>
</select>
</div>
<div class="option-row">
<label>Type:</label>
<select id="typeSelect" style="width: 160px" v-model="chartType"></select>
</div>
<div class="option-row">
<input type="button" style="width: 150px;margin:5px ;margin-bottom: 15px;" value="Add Chart"
id="insertChart" @click="insertChart" />
<input type="button" style="width: 150px;margin:5px" value="Switch row/column" id="switchRowColumn"
@click="switchRowColumn" />
<input type="button" style="width: 150px;margin:5px" value="Remove chart" id="removeChart"
@click="removeChart" />
<input type="button" style="width: 150px;margin:5px" value="Remove all charts" id="removeAllCharts"
@click="removeAllChart" />
</div>
<div class="option-row">
<label>Display Blanks Cells As:</label>
<select id="displayBlanksCells" style="width: 80px" v-model="displayBlanksCells"
@change="displayBlanksCell">
<option value="1">Gaps</option>
<option value="2">Zero</option>
<option value="0">Connect</option>
</select>
</div>
<div class="option-row">
<input type="checkbox" id="showNAAsBlanks" v-model="displayNaNAsBlank" @click="showNAAsBlanks" />
<label for="showNAAsBlanks">Display #N/A Cells As Blank Cells</label>
</div>
<div class="option-row">
<input type="checkbox" id="ignoreHidden" v-model="ignoreHidden" @change="ignoreHiddenRowAndColumn" />
<label for="ignoreHidden">Ingore Hidden Rows And Columns</label>
</div>
</div>
</div>
</template>
<script>
import Vue from "vue";
import "@grapecity-software/spread-sheets-vue";
import GC from "@grapecity-software/spread-sheets";
import "@grapecity-software/spread-sheets-charts";
import '@grapecity-software/spread-sheets-resources-zh';
GC.Spread.Common.CultureManager.culture("zh-cn");
import "./styles.css";
function _getElementById(id) {
return document.getElementById(id);
}
const chartType = [
[{
typeDesc: "Clustered Column",
type: GC.Spread.Sheets.Charts.ChartType.columnClustered
},
{
typeDesc: "Stacked Column",
type: GC.Spread.Sheets.Charts.ChartType.columnStacked
},
{
typeDesc: "100% Stacked Column",
type: GC.Spread.Sheets.Charts.ChartType.columnStacked100
}
],
[{
typeDesc: "Line",
type: GC.Spread.Sheets.Charts.ChartType.line
},
{
typeDesc: "Stacked Line",
type: GC.Spread.Sheets.Charts.ChartType.lineStacked
},
{
typeDesc: "100% Stacked Line",
type: GC.Spread.Sheets.Charts.ChartType.lineStacked100
},
{
typeDesc: "Line With Markers",
type: GC.Spread.Sheets.Charts.ChartType.lineMarkers
},
{
typeDesc: "Stacked Line With Markers",
type: GC.Spread.Sheets.Charts.ChartType.lineMarkersStacked
},
{
typeDesc: "100% Stacked Line With Markers",
type: GC.Spread.Sheets.Charts.ChartType.lineMarkersStacked100
}
],
[{
typeDesc: "Pie",
type: GC.Spread.Sheets.Charts.ChartType.pie
},
{
typeDesc: "Doughnut",
type: GC.Spread.Sheets.Charts.ChartType.doughnut
}
],
[{
typeDesc: "Clustered Bar",
type: GC.Spread.Sheets.Charts.ChartType.barClustered
},
{
typeDesc: "Stacked Bar",
type: GC.Spread.Sheets.Charts.ChartType.barStacked
},
{
typeDesc: "100% Stacked Bar",
type: GC.Spread.Sheets.Charts.ChartType.barStacked100
}
],
[{
typeDesc: "Area",
type: GC.Spread.Sheets.Charts.ChartType.area
},
{
typeDesc: "Stacked Area",
type: GC.Spread.Sheets.Charts.ChartType.areaStacked
},
{
typeDesc: "100% Stacked Area",
type: GC.Spread.Sheets.Charts.ChartType.areaStacked100
}
],
[{
typeDesc: "Scatter",
type: GC.Spread.Sheets.Charts.ChartType.xyScatter
},
{
typeDesc: "Scatter With Smooth Lines And Markers",
type: GC.Spread.Sheets.Charts.ChartType.xyScatterSmooth
},
{
typeDesc: "Scatter With Smooth Lines",
type: GC.Spread.Sheets.Charts.ChartType.xyScatterSmoothNoMarkers
},
{
typeDesc: "Scatter With Straight Lines And Markers",
type: GC.Spread.Sheets.Charts.ChartType.xyScatterLines
},
{
typeDesc: "Scatter With Straight Lines",
type: GC.Spread.Sheets.Charts.ChartType.xyScatterLinesNoMarkers
},
{
typeDesc: "Bubble",
type: GC.Spread.Sheets.Charts.ChartType.bubble
}
],
[{
typeDesc: "High-Low-Close",
type: GC.Spread.Sheets.Charts.ChartType.stockHLC
},
{
typeDesc: "Open-High-Low-Close",
type: GC.Spread.Sheets.Charts.ChartType.stockOHLC
},
{
typeDesc: "Volume-High-Low-Close",
type: GC.Spread.Sheets.Charts.ChartType.stockVHLC
},
{
typeDesc: "Volume-Open-High-Low-Close",
type: GC.Spread.Sheets.Charts.ChartType.stockVOHLC
}
]
];
let App = Vue.extend({
name: "app",
data: function() {
return {
spread: null,
groupType: "0",
chartType: "0",
displayBlanksCells: "1",
displayNaNAsBlank: false,
ignoreHidden: true
};
},
methods: {
initSpread(spread) {
this.spread = spread;
spread.suspendPaint();
spread.setSheetCount(2);
let sheet1 = spread.getSheet(0);
sheet1.name("Common Chart");
let sheet2 = spread.getSheet(1);
sheet2.name("Custom Chart");
this.initSheet(sheet1);
this.initSheet(sheet2);
//add chart
this.initChart(sheet1);
this.initChart(sheet2);
//custom chart
this.customChartStyle(sheet2);
spread.resumePaint();
this.changeTypeSelect();
},
initSheet(sheet) {
sheet.suspendPaint();
//prepare data for chart
let dataArray = [
["", "Chrome", "FireFox", "IE", "Safari", "Edge", "Opera", "Other"],
["2015", 0.5651, 0.1734, 0.1711, 0.427, 0, 0.184, 0.293],
["2016", 0.623, 0.1531, 0.1073, 0.464, 0.311, 0.166, 0.225],
["2017", 0.636, 0.1304, 0.834, 0.589, 0.443, 0.223, 0.246]
];
sheet.setArray(0, 0, dataArray);
sheet.resumePaint();
},
initChart(sheet) {
//add common chart
sheet.charts.add(
"Chart1",
GC.Spread.Sheets.Charts.ChartType.columnClustered,
0,
100,
800,
300,
"A1:H4"
);
},
customChartStyle(sheet) {
let changeChart = sheet.charts.all()[0];
this.changeChartStyle(changeChart);
},
changeChartStyle(chart) {
//change orientation
this.switchOrientation(chart);
//change legend
this.changeChartLegend(chart);
//change chartArea
this.changeChartArea(chart);
//change chartTitle
this.changeChartTitle(chart);
//change dataLabels
this.changeChartDataLabels(chart);
//change axisTitles
this.changeChartAxisTitles(chart);
//change axesLine
this.changeChartAxesLine(chart);
//change series
this.changeSeries(chart);
//change gridLine
this.changeGridLine(chart);
//change seriesBorder
this.changeSeriesBorder(chart);
},
switchOrientation(chart) {
chart.switchDataOrientation();
},
changeChartLegend(chart) {
let legend = chart.legend();
legend.visible = true;
let legendPosition = GC.Spread.Sheets.Charts.LegendPosition;
legend.position = legendPosition.top;
chart.legend(legend);
},
changeChartArea(chart) {
let chartArea = chart.chartArea();
chartArea.backColor = "rgba(93,93,93,1)";
chartArea.color = "rgba(255,255,255,1)";
chartArea.fontSize = 14;
chart.chartArea(chartArea);
},
changeChartTitle(chart) {
let title = chart.title();
title.text = "Browser Market Share";
title.fontSize = 18;
chart.title(title);
},
changeChartDataLabels(chart) {
let dataLabels = chart.dataLabels();
dataLabels.showValue = true;
dataLabels.showSeriesName = false;
dataLabels.showCategoryName = false;
dataLabels.format = "0.00%";
let dataLabelPosition = GC.Spread.Sheets.Charts.DataLabelPosition;
dataLabels.position = dataLabelPosition.outsideEnd;
chart.dataLabels(dataLabels);
let series0 = chart.series().get(0);
series0.dataLabels = {
showSeriesName: true,
showCategoryName: true,
separator: ";",
position: GC.Spread.Sheets.Charts.DataLabelPosition.Center,
color: "red",
backColor: "white",
borderColor: "blue",
borderWidth: 2
};
chart.series().set(0, series0);
let series2 = chart.series().get(2);
series2.dataLabels = {
showSeriesName: true,
separator: "/",
position: GC.Spread.Sheets.Charts.DataLabelPosition.insideEnd,
color: "yellow",
backColor: "white",
borderColor: "green",
borderWidth: 1
};
chart.series().set(2, series2);
let series4 = chart.series().get(4);
series4.dataLabels = {
showCategoryName: true,
separator: ":",
position: GC.Spread.Sheets.Charts.DataLabelPosition.above,
color: "blue",
backColor: "white",
borderColor: "red",
borderWidth: 2.5
};
chart.series().set(4, series4);
},
changeChartAxisTitles(chart) {
let axes = chart.axes();
axes.primaryCategory.title.text = "Year";
axes.primaryCategory.title.fontSize = 14;
chart.axes(axes);
},
changeChartAxesLine(chart) {
let axes = chart.axes();
axes.primaryValue.format = "0%";
chart.axes(axes);
},
changeSeries(chart) {
let series = chart.series();
let seriesItem = series.get(6);
seriesItem.backColor = "#a3cf62";
series.set(6, seriesItem);
},
changeGridLine(chart) {
let axes = chart.axes();
axes.primaryCategory.majorGridLine.visible = false;
axes.primaryValue.majorGridLine.visible = false;
chart.axes(axes);
},
changeSeriesBorder(chart) {
let series = chart.series().get();
for (let i = 0; i < series.length; i++) {
let seriesItem = series[i];
seriesItem.border.color = "rgb(255,255,255)";
seriesItem.border.width = 1;
chart.series().set(i, seriesItem);
}
},
getActiveChart(sheet) {
let activeChart = null;
sheet.charts.all().forEach(function(chart) {
if (chart.isSelected()) {
activeChart = chart;
}
});
return activeChart;
},
judgeIsEmptyOneCell(sheet, range) {
if (range.rowCount === 1 && range.colCount === 1) {
let cell = sheet.getCell(range.row, range.col);
if (!cell.text()) {
return true;
}
}
return false;
},
changeTypeSelect(e) {
let index = parseInt(this.groupType || 0);
if (index !== null && index !== undefined && index < chartType.length) {
_getElementById("typeSelect").innerHTML = "";
let typeArray = chartType[index];
for (let i = 0; i < typeArray.length; i++) {
let item = typeArray[i];
let option = document.createElement("option");
let value = document.createAttribute("value");
value.nodeValue = i;
option.setAttributeNode(value);
option.innerHTML = item.typeDesc;
_getElementById("typeSelect").appendChild(option);
}
}
},
insertChart() {
let activeSheet = this.spread.getActiveSheet();
let dataRange = activeSheet.getSelections()[0];
if (dataRange && !this.judgeIsEmptyOneCell(activeSheet, dataRange)) {
let rangeToFormula = GC.Spread.Sheets.CalcEngine.rangeToFormula;
let dataFormula = rangeToFormula(dataRange);
let groupIndex = parseInt(this.groupType);
let typeIndex = parseInt(this.chartType);
if (groupIndex < chartType.length) {
let typeArray = chartType[groupIndex];
if (typeIndex < typeArray.length) {
let type = typeArray[typeIndex].type;
try {
activeSheet.charts.add(
"",
type,
30,
120,
500,
300,
dataFormula,
GC.Spread.Sheets.Charts.RowCol.rows
);
} catch (e) {
alert(e.message);
}
}
}
}
},
switchRowColumn() {
let activeSheet = this.spread.getActiveSheet();
let activeChart = this.getActiveChart(activeSheet);
if (activeChart) {
let isSwitched = activeChart.switchDataOrientation();
if (!isSwitched) {
alert("'Can't switch row/column");
}
}
},
removeChart() {
let activeSheet = this.spread.getActiveSheet();
let activeChart = this.getActiveChart(activeSheet);
if (activeChart) {
activeSheet.charts.remove(activeChart.name());
}
},
removeAllChart() {
let activeSheet = this.spread.getActiveSheet();
activeSheet.charts.clear();
},
ignoreHiddenRowAndColumn(e) {
let activeSheet = this.spread.getActiveSheet();
let activeChart = this.getActiveChart(activeSheet);
activeChart && activeChart.ignoreHidden(this.ignoreHidden);
},
displayBlanksCell(e) {
let activeSheet = this.spread.getActiveSheet();
let activeChart = this.getActiveChart(activeSheet);
let index = parseInt(this.displayBlanksCells);
if (index !== null && index !== undefined) {
activeChart && activeChart.displayBlanksAs(index);
}
},
showNAAsBlanks(e) {
let activeSheet = this.spread.getActiveSheet();
let activeChart = this.getActiveChart(activeSheet);
activeChart && activeChart.displayNaNAsBlank(this.showNAAsBlanks);
}
}
});
new Vue({
render: h => h(App)
}).$mount("#app");
</script>

<!doctype html>
<html style="height:100%;font-size:14px;">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="stylesheet" type="text/css"
href="$DEMOROOT$/zh/vue/node_modules/@grapecity-software/spread-sheets/styles/gc.spread.sheets.excel2013white.css">
<!-- SystemJS -->
<script src="$DEMOROOT$/zh/vue/node_modules/systemjs/dist/system.src.js"></script>
<script src="systemjs.config.js"></script>
<script>
System.import('./src/app.vue');
System.import('$DEMOROOT$/zh/lib/vue/license.js');
</script>
</head>
<body>
<div id="app"></div>
</body>
</html>

.sample-tutorial {
position: relative;
height: 100%;
overflow: hidden;
}
.sample-spreadsheets {
width: calc(100% - 280px);
height: 100%;
overflow: hidden;
float: left;
}
.options-container {
float: right;
width: 280px;
padding: 12px;
height: 100%;
box-sizing: border-box;
background: #fbfbfb;
overflow: auto;
}
.option-row {
font-size: 14px;
padding: 2px;
margin-top: 2px;
}
.sample-options {
z-index: 1000;
}
label {
margin-bottom: 6px;
}
p{
padding:2px 10px;
background-color:#F4F8EB;
}
input {
padding: 2px 6px;
}
input[type=button] {
margin-top: 6px;
display: block;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}

(function(global) {
System.config({
transpiler: 'plugin-babel',
babelOptions: {
es2015: true
},
meta: {
'*.css': { loader: 'css' },
'*.vue': { loader: 'vue-loader' }
},
paths: {
// paths serve as alias
'npm:': 'node_modules/'
},
// map tells the System loader where to look for things
map: {
'@grapecity-software/spread-sheets-shapes': 'npm:@grapecity-software/spread-sheets-shapes/index.js',
'@grapecity-software/spread-sheets-shapes': 'npm:@grapecity-software/spread-sheets-shapes/index.js',
'@grapecity-software/spread-sheets-charts': 'npm:@grapecity-software/spread-sheets-charts/index.js',
'@grapecity-software/spread-sheets': 'npm:@grapecity-software/spread-sheets/index.js',
'@grapecity-software/spread-sheets-resources-zh': 'npm:@grapecity-software/spread-sheets-resources-zh/index.js',
'@grapecity-software/spread-sheets-vue': 'npm:@grapecity-software/spread-sheets-vue/index.js',
'@grapecity-software/jsob-test-dependency-package/react-components': 'npm:@grapecity-software/jsob-test-dependency-package/react-components/index.js',
'jszip': 'npm:jszip/dist/jszip.js',
'css': 'npm:systemjs-plugin-css/css.js',
'vue': 'npm:vue/dist/vue.min.js',
'vue-loader': 'npm:systemjs-vue-browser/index.js',
'tiny-emitter': 'npm:tiny-emitter/index.js',
'plugin-babel': 'npm:systemjs-plugin-babel/plugin-babel.js',
'systemjs-babel-build': 'npm:systemjs-plugin-babel/systemjs-babel-browser.js'
},
// packages tells the System loader how to load when no filename and/or no extension
packages: {
src: {
defaultExtension: 'js'
},
rxjs: {
defaultExtension: 'js'
},
"node_modules": {
defaultExtension: 'js'
}
}
});
})(this);