概述
本 Demo 展示了如何通过代码调用 fillAuto 方法实现单元格区域的自动填充。Demo 提供了交互式界面，允许用户选择起始范围、目标范围，并通过下拉菜单配置填充参数，包括填充类型、填充序列、方向、步长和终止值等选项。
实现思路
创建 Spread 实例，并初始化两个 FormulaTextBox 控件用于选择起始范围和整个范围
提供下拉菜单让用户选择填充方法（自动填充、按方向填充、线性填充、增长填充、日期填充）
根据选择的填充方法动态显示对应的参数选项（填充序列、填充方向、日期单位、步长、终止值）
为每个填充按钮绑定点击事件，调用 fillAuto 方法执行填充操作
使用 getRange 辅助函数将用户输入的范围字符串转换为 Range 对象
代码解析
初始化公式文本框用于范围选择
这段代码创建了两个公式文本框控件，设置 rangeSelectMode: true 启用范围选择模式。用户可以在表格中直接选择单元格范围，选择的范围会自动显示在文本框中。
自动填充
自动填充会根据源单元格的值类型自动判断填充方式：字符串值会被复制到其他单元格，数字值会通过 TREND 公式生成新值。
线性填充
线性填充适用于数值类型，通过 step 参数指定步长，每个新值通过当前值加上步长计算得出。stop 参数可选，用于设置终止值。
日期填充
日期填充需要指定 unit 参数（日、工作日、月、年），新日期通过在当前值上添加步长计算得出。
范围字符串转换为 Range 对象
这个辅助函数将用户输入的范围字符串（如 "Sheet1!A1:C2"）转换为 SpreadJS 的 Range 对象。
运行效果
在左侧表格中输入初始数据（如在 A1 单元格输入数值 1）
在右侧面板的"起始范围"文本框中选择源单元格范围（如 Sheet1!A1）
在"整个范围"文本框中选择目标范围（如 Sheet1!A1:C2）
从"填充方法"下拉菜单中选择填充类型
根据需要设置填充序列、步长、终止值等参数
点击对应的填充按钮，表格会按照指定参数自动填充数据
例如：选择 A1 作为起始范围，A1:A10 作为整个范围，选择"线性填充"，步长设为 2，终止值设为 20，点击"线性填充"按钮后，A 列会生成 1, 3, 5, 7… 的等差数列。
API 参考
fillAuto 方法
startRange：起始范围，类型为 GC.Spread.Sheets.Range
wholeRange：完整填充范围，类型为 GC.Spread.Sheets.Range
options：填充选项对象，包含以下属性：
fillType：填充类型，使用 GC.Spread.Sheets.Fill.FillType 枚举
series：填充序列，使用 GC.Spread.Sheets.Fill.FillSeries 枚举（column 或 row）
direction：填充方向，使用 GC.Spread.Sheets.Fill.FillDirection 枚举（left、right、up、down）
step：步长值，用于线性填充和增长填充
stop：终止值，可选
unit：日期填充单位，使用 GC.Spread.Sheets.Fill.FillDateUnit 枚举（day、workday、month、year）
FillType 枚举
auto：自动填充类型
direction：按方向填充
linear：线性填充类型
growth：增长填充类型
date：日期填充类型
window.onload = function () {
var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"), {sheetCount: 1});
initSpread(spread);
};
function initSpread(spread) {
var startRangeFormulaTextBox = new GC.Spread.Sheets.FormulaTextBox.FormulaTextBox(document.getElementById('startRange'), {rangeSelectMode: true});
var wholeRangeFormulaTextBox = new GC.Spread.Sheets.FormulaTextBox.FormulaTextBox(document.getElementById('wholeRange'), {rangeSelectMode: true});
startRangeFormulaTextBox.workbook(spread);
wholeRangeFormulaTextBox.workbook(spread);
spread.options.newTabVisible = false;
var sheet = spread.getSheet(0);
sheet.setValue(0, 0, 1);
_getElementById("fillDirectionSet").style.display='none';
_getElementById("fillDateUnitSet").style.display='none';
_getElementById("fillStepAndStop").style.display='none';
_getElementById("btnFillAutobyDirection").style.display='none';
_getElementById("btnFillLinear").style.display='none';
_getElementById("btnFillGrowth").style.display='none';
_getElementById("btnFillDate").style.display='none';
_getElementById("fillMethods").addEventListener('change',function () {
switch (_getElementById("fillMethods").value) {
case '0':
_getElementById("fillSeriesSet").style.display='block';
_getElementById("btnFillAuto").style.display='block';
_getElementById("fillDateUnitSet").style.display='none';
_getElementById("fillDirectionSet").style.display='none';
_getElementById("btnFillAutobyDirection").style.display='none';
_getElementById("btnFillLinear").style.display='none';
_getElementById("btnFillGrowth").style.display='none';
_getElementById("btnFillDate").style.display='none';
_getElementById("fillStepAndStop").style.display='none';
break;
case '1':
_getElementById("fillDirectionSet").style.display='block';
_getElementById("btnFillAutobyDirection").style.display='block';
_getElementById("fillDateUnitSet").style.display='none';
_getElementById("fillSeriesSet").style.display='none';
_getElementById("btnFillAuto").style.display='none';
_getElementById("btnFillLinear").style.display='none';
_getElementById("btnFillGrowth").style.display='none';
_getElementById("btnFillDate").style.display='none';
_getElementById("fillStepAndStop").style.display='none';
break;
case '2':
_getElementById("fillSeriesSet").style.display='block';
_getElementById("btnFillLinear").style.display='block';
_getElementById("fillStepAndStop").style.display='block';
_getElementById("fillDateUnitSet").style.display='none';
_getElementById("fillDirectionSet").style.display='none';
_getElementById("btnFillAuto").style.display='none';
_getElementById("btnFillAutobyDirection").style.display='none';
_getElementById("btnFillGrowth").style.display='none';
_getElementById("btnFillDate").style.display='none';
break;
case '3':
_getElementById("fillSeriesSet").style.display='block';
_getElementById("btnFillGrowth").style.display='block';
_getElementById("fillStepAndStop").style.display='block';
_getElementById("fillDateUnitSet").style.display='none';
_getElementById("fillDirectionSet").style.display='none';
_getElementById("btnFillAuto").style.display='none';
_getElementById("btnFillAutobyDirection").style.display='none';
_getElementById("btnFillLinear").style.display='none';
_getElementById("btnFillDate").style.display='none';
break;
case '4':
_getElementById("fillSeriesSet").style.display='block';
_getElementById("btnFillDate").style.display='block';
_getElementById("fillStepAndStop").style.display='block';
_getElementById("fillDateUnitSet").style.display='block';
_getElementById("fillDirectionSet").style.display='none';
_getElementById("btnFillAuto").style.display='none';
_getElementById("btnFillAutobyDirection").style.display='none';
_getElementById("btnFillGrowth").style.display='none';
_getElementById("btnFillLinear").style.display='none';
break;
}
});
_getElementById("btnFillAuto").addEventListener('click',function() {
var sheet = spread.getActiveSheet();
var startRange = getRange(sheet, startRangeFormulaTextBox.text());
var wholeRange = getRange(sheet, wholeRangeFormulaTextBox.text());
if(parseInt(_getElementById("fillSeries").value) === 1) {
wholeRange.rowCount = startRange.rowCount;
} else {
wholeRange.colCount = startRange.colCount;
}
sheet.fillAuto(startRange, wholeRange, {
series: parseInt(_getElementById("fillSeries").value),
fillType: GC.Spread.Sheets.Fill.FillType.auto
});
});
_getElementById("btnFillAutobyDirection").addEventListener('click',function () {
var sheet = spread.getActiveSheet();
var startRange = getRange(sheet, startRangeFormulaTextBox.text());
var wholeRange = getRange(sheet, wholeRangeFormulaTextBox.text());
sheet.fillAuto(startRange, wholeRange, {
direction: parseInt(_getElementById("fillDirection").value),
fillType: GC.Spread.Sheets.Fill.FillType.direction
});
});
_getElementById("btnFillLinear").addEventListener('click',function () {
var sheet = spread.getActiveSheet();
var startRange = getRange(sheet, startRangeFormulaTextBox.text());
var wholeRange = getRange(sheet, wholeRangeFormulaTextBox.text());
var step = parseInt(_getElementById("step").value);
var stopString = _getElementById("stop").value;
var stop;
if (stopString !== '') {
stop = parseInt(stopString);
}
sheet.fillAuto(startRange, wholeRange, {
series: parseInt(_getElementById("fillSeries").value),
step: step,
stop: stop,
fillType: GC.Spread.Sheets.Fill.FillType.linear
});
});
_getElementById("btnFillGrowth").addEventListener('click',function () {
var sheet = spread.getActiveSheet();
var startRange = getRange(sheet, startRangeFormulaTextBox.text());
var wholeRange = getRange(sheet, wholeRangeFormulaTextBox.text());
var step = parseInt(_getElementById("step").value);
var stopString = _getElementById("stop").value;
var stop;
if (stopString !== '') {
stop = parseInt(stopString);
}
sheet.fillAuto(startRange, wholeRange, {
series: parseInt(_getElementById("fillSeries").value),
step: step,
stop: stop,
fillType: GC.Spread.Sheets.Fill.FillType.growth
});
});
_getElementById("btnFillDate").addEventListener('click',function () {
var sheet = spread.getActiveSheet();
var startRange = getRange(sheet, startRangeFormulaTextBox.text());
var wholeRange = getRange(sheet, wholeRangeFormulaTextBox.text());
var step = parseInt(_getElementById("step").value);
var stop = null;
if (_getElementById("stop").value !== '') {
stop = new Date(_getElementById("stop").value);
}
sheet.fillAuto(startRange, wholeRange, {
series: parseInt(_getElementById("fillSeries").value),
unit: parseInt(_getElementById("fillDateUnit").value),
step: step,
stop: stop,
fillType: GC.Spread.Sheets.Fill.FillType.date
});
});
};
function getRange(sheet, rangeString) {
try{
var rangeObject = GC.Spread.Sheets.CalcEngine.formulaToExpression(sheet, rangeString).getRange(0, 0);
var range = new GC.Spread.Sheets.Range(rangeObject.row, rangeObject.col, rangeObject.rowCount, rangeObject.colCount);
return range;
}catch (e){
throw new Error("Select Ranges are not right");
}
}
function _getElementById(id){
return document.getElementById(id);
}
<!doctype html>
<html style="height:100%;font-size:14px;">
<head>
<meta name="spreadjs culture" content="zh-cn" />
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="stylesheet" type="text/css"
href="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets/styles/gc.spread.sheets.excel2013white.css">
<script src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets/dist/gc.spread.sheets.all.min.js"
type="text/javascript"></script>
<script
src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets-resources-zh/dist/gc.spread.sheets.resources.zh.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" class="sample-spreadsheets"></div>
<div class="options-container">
<p>
使用“起始范围”字段选择开始填充的范围，使用“整个范围”字段选择要填充的完整范围，并使用“填充方法”和“填充序列”字段更改填充方式。
</p>
<p>
尝试选择 Sheet1!A1 作为起始范围，Sheet1!A1:C2 作为整个范围，保持填充方法为 fillAuto，填充序列为列。然后点击“fillAuto”按钮，查看工作表填充这些单元格的效果。
</p>
<div class="option-row">
<label>起始范围</label>
<div id="startRange" spellcheck="false"
style="display:inline-block;border: 1px solid #808080;width:134px;vertical-align: middle;">
</div>
</div>
<div class="option-row">
<label>整个范围</label>
<div id="wholeRange" spellcheck="false"
style="display:inline-block;border: 1px solid #808080;width:134px;vertical-align: middle;">
</div>
</div>
<div class="option-row">
<label>填充方法</label>
<select id="fillMethods">
<option value='0' selected>自动填充</option>
<option value='1'>按方向自动填充</option>
<option value='2'>线性填充</option>
<option value='3'>增长填充</option>
<option value='4'>日期填充</option>
</select>
</div>
<div class="option-row">
<div id="fillSeriesSet">
<label>填充序列</label>
<select id="fillSeries">
<option value='0' selected>列</option>
<option value='1'>行</option>
</select>
</div>
<div id="fillDirectionSet">
<label>填充方向</label>
<select id="fillDirection">
<option value='0' selected>向左</option>
<option value='1'>向右</option>
<option value='2'>向上</option>
<option value='3'>向下</option>
</select>
</div>
</div>
<div class="option-row" id="fillDateUnitSet">
<label>日期填充单位</label>
<select id="fillDateUnit">
<option value='0' selected>日</option>
<option value='1'>工作日</option>
<option value='2'>月</option>
<option value='3'>年</option>
</select>
</div>
<div class="option-row" id="fillStepAndStop">
<label>步长</label>
<input type="text" id="step" />
<label>终止值</label>
<input type="text" id="stop" />
</div>
<div class="option-row">
<label></label>
<input type="button" id="btnFillAuto" value="自动填充" />
<input type="button" id="btnFillAutobyDirection" value="按方向自动填充" />
<input type="button" id="btnFillLinear" value="线性填充" />
<input type="button" id="btnFillGrowth" value="增长填充" />
<input type="button" id="btnFillDate" value="日期填充" />
</div>
</div>
</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: 5px;
margin-top: 10px;
}
input, select {
padding: 4px 8px;
}
input {
width: 100%;
margin-top: 6px;
box-sizing: border-box;
}
label {
display:inline-block;
min-width: 85px;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}
