概述
本 Demo 展示了 SpreadJS 支持的基本单元格类型的使用方法。Demo 包含两个工作表：第一个工作表演示了如何直接为单元格设置按钮、复选框、下拉框和超链接类型；第二个工作表演示了如何在数据绑定场景中将单元格类型绑定到数据列。
实现思路
创建不同类型的单元格对象（Button、CheckBox、ComboBox、HyperLink）
设置单元格类型的属性（如按钮文本、下拉选项、复选框状态文本等）
使用 setCellType 方法将单元格类型应用到指定单元格
绑定 ButtonClicked 和 CellClick 事件，响应用户交互
在第二个工作表中，通过 bindColumns 方法将单元格类型绑定到数据列
代码解析
创建并设置按钮单元格
这段代码创建了一个按钮单元格并设置了文本和边距。setCellType 方法将按钮类型应用到第 1 行第 2 列的单元格。
创建复选框单元格
复选框单元格支持设置三态模式和不同状态下的文本显示。isThreeState(false) 设置为两态模式（选中/未选中）。
创建下拉框单元格
下拉框单元格使用 items 方法设置选项列表，每个选项包含 text 和 value。editorValueType 设置编辑器返回值的类型。
创建超链接单元格
超链接单元格使用 text 方法设置显示文本，单元格的值设置为实际的链接地址。
响应单元格点击事件
ButtonClicked 事件在点击按钮、复选框或超链接时触发。事件参数 args 包含单元格位置信息，使用 getCellType 方法可以获取单元格类型并判断具体是哪种类型。
数据绑定中使用单元格类型
在数据绑定场景中，可以在列配置对象的 cellType 属性中指定单元格类型。使用 setDataSource 设置数据源，bindColumns 绑定列配置。
运行效果
第一个工作表展示了 4 种基本单元格类型：按钮、复选框、下拉框和超链接
点击按钮会在右侧文本框中显示 "You click a button"
点击复选框会切换选中状态，并在文本框中显示 "You click a check box"
点击下拉框会弹出选项列表，可以从中选择
点击超链接会打开对应网址，并在文本框中显示 "You click a hyperlink"
第二个工作表展示了数据绑定场景，数据列自动应用了配置的单元格类型
API 参考
setCellType 方法
row：行索引
col：列索引
value：单元格类型对象（Button、CheckBox、ComboBox、HyperLink 等）
sheetArea：可选，工作表区域，默认为 viewport
getCellType 方法
返回指定位置的单元格类型对象，可用于判断单元格类型。
bindColumns 方法
columns：列配置数组，每个配置对象可包含 name、displayName、size、cellType 等属性
ButtonClicked 事件
当用户点击按钮、复选框或超链接单元格时触发。事件参数包含 sheet、row、col、sheetArea 属性。
window.onload = function() {
var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"), { sheetCount: 2 });
initSpread(spread);
};
function initSpread(spread) {
var spreadNS = GC.Spread.Sheets,
sheet = spread.getSheet(0);
var eventTrigger = document.getElementById("eventTrigger");
spread.bind(spreadNS.Events.ButtonClicked, function(e, args) {
var text = "";
if (eventTrigger.value === "undefined") {
eventTrigger.value = "";
}
var sheet = args.sheet, row = args.row, col = args.col;
var cellType = sheet.getCellType(row, col);
if (cellType instanceof GC.Spread.Sheets.CellTypes.Button) {
text = eventTrigger.value + "You click a button.\n";
}
if (cellType instanceof GC.Spread.Sheets.CellTypes.CheckBox) {
text = eventTrigger.value + "You click a check box.\n";
}
if (cellType instanceof GC.Spread.Sheets.CellTypes.HyperLink) {
text = eventTrigger.value + "You click a hyperlink.\n";
}
eventTrigger.value = text;
});
spread.bind(spreadNS.Events.CellClick, function(e, args) {
var text = "";
if (eventTrigger.value === "undefined") {
eventTrigger.value = "";
}
var sheet = args.sheet, row = args.row, col = args.col;
var cellType = sheet.getCellType(row, col);
if (cellType instanceof GC.Spread.Sheets.CellTypes.ComboBox) {
text = eventTrigger.value + "You click a combo box.\n";
}
eventTrigger.value = text;
});
sheet.suspendPaint();
sheet.name('Basic Usage');
sheet.setColumnWidth(2, 140);
sheet.setColumnWidth(1, 120);
sheet.setRowHeight(1, 50);
var b0 = new spreadNS.CellTypes.Button();
b0.text("Margin");
b0.marginLeft(15);
b0.marginTop(7);
b0.marginRight(15);
b0.marginBottom(7);
sheet.setCellType(1, 2, b0, spreadNS.SheetArea.viewport);
sheet.setValue(1, 1, "ButtonCellType");
var c = new spreadNS.CellTypes.CheckBox();
c.isThreeState(false);
c.textTrue("Checked!");
c.textFalse("Check Me!");
sheet.setCellType(2, 2, c, spreadNS.SheetArea.viewport);
sheet.setValue(2, 1, "CheckBoxCellType");
var combo = new spreadNS.CellTypes.ComboBox();
combo.items([{ text: "Oranges", value: "11k" }, { text: "Apples", value: "15k" }, { text: "Grape", value: "100k" }]);
combo.editorValueType(spreadNS.CellTypes.EditorValueType.text);
sheet.getCell(3, 2, spreadNS.SheetArea.viewport).cellType(combo).value("Grape");
sheet.setValue(3, 1, "ComboBoxCellType");
var h = new spreadNS.CellTypes.HyperLink();
h.text("SpreadJS Overview");
sheet.setCellType(4, 2, h, spreadNS.SheetArea.viewport);
sheet.getCell(4, 2, spreadNS.SheetArea.viewport).value("https://www.grapecity.com.cn/developer/spreadjs").hAlign(spreadNS.HorizontalAlign.center);
sheet.setValue(4, 1, "HyperLinkCellType");
sheet.resumePaint();
var sheet1 = spread.getSheet(1);
sheet1.name('DataBind');
sheet1.suspendPaint();
var _lines = ["Computers", "Washers", "Stoves"];
var _colors = ["Red", "Green", "Blue", "White"];
var _ratings = ["Terrible", "Bad", "Average", "Good", "Great", "Epic"];
var lineCellType = new spreadNS.CellTypes.ComboBox();
lineCellType.items(_lines);
var colorCellType = new spreadNS.CellTypes.ComboBox();
colorCellType.items(_colors);
var checkBoxCellType = new spreadNS.CellTypes.CheckBox();
var ratingCellType = new spreadNS.CellTypes.ComboBox();
ratingCellType.items(_ratings);
var datasource = [
{ name: "Stoves S0", line: "Washers", color: "Green", discontinued: true, rating: "Average" },
{ name: "Computers C1", line: "Washers", color: "Green", discontinued: true, rating: "Average" },
{ name: "Washers W3", line: "Washers", color: "Green", discontinued: true, rating: "Average" }
];
var colInfos = [
{ name: "name", size: 100 },
{ name: "line", cellType: lineCellType, size: 80 },
{ name: "color", cellType: colorCellType },
{ name: "discontinued", cellType: checkBoxCellType, size: 80 },
{ name: "rating", cellType: ratingCellType }
];
sheet1.autoGenerateColumns = false;
sheet1.setDataSource(datasource);
sheet1.bindColumns(colInfos);
sheet1.resumePaint();
};
<!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">
此文本框将显示与不同单元格类型交互的相关信息。
<div class="option-row">
<textarea id="eventTrigger" style="width: 100%; height: 120px"></textarea>
</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;
overflow: auto;
padding: 12px;
height: 100%;
box-sizing: border-box;
background: #fbfbfb;
}
.option-row {
padding-bottom: 8px;
}
label {
padding-bottom: 4px;
display: block;
}
input {
width: 100%;
padding: 4px 8px;
box-sizing: border-box;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}
